FAQ dan pemecahan masalah

Halaman ini memberikan jawaban atas pertanyaan umum (FAQ) tentang App Hosting.

App Hosting FAQ

Apakah App Hosting mendukung framework selain Next.js dan Angular?

App Hosting menyediakan dukungan build dan deployment yang telah dikonfigurasi sebelumnya untuk Next.js dan Angular, yang kami berkomitmen untuk memahami framework tersebut dan menafsirkan konfigurasi aslinya. Untuk sejumlah framework lainnya, komunitas developer mendukung adaptor framework App Hosting. Selain itu, untuk aplikasi Node.js dengan skrip build dan mulai, App Hosting akan mencoba build, tetapi tidak dapat menjamin keberhasilan secara andal. Lihat Integrasi framework.

Wilayah mana yang didukung Firebase App Hosting?

Wilayah untuk App Hosting kemungkinan akan diperluas seiring waktu. Lihat lokasi App Hosting untuk mengetahui informasi terbaru.

Dapatkah saya menggunakan GitLab atau penyedia Git selain GitHub untuk deployment?

Saat ini Anda tidak dapat melakukannya, tetapi dukungan untuk penyedia lain ada dalam rencana jangka panjang untuk App Hosting.

Mengapa saya tidak dapat menemukan repositori saya di UI Firebase console? 

Jika repositori Anda tidak muncul dalam daftar opsi saat Anda membuat backend baru di Firebase console, coba pilih Refresh list terlebih dahulu. Jika repositori pilihan masih belum tersedia, Anda mungkin perlu menambahkannya menggunakan opsi Beri akses ke repositori baru di GitHub.

Selain itu, Anda dapat mengelola repositori dengan aplikasi GitHub Firebase App Hosting. Untuk melakukannya, buka profil GitHub Anda, lalu pilih Settings, lalu Applications. Di baris tabel untuk aplikasi Firebase App Hosting, klik Konfigurasi untuk mengelola repositori.

Mengapa situs saya tidak ditampilkan secara normal di WebView aplikasi seluler Android? 

Aplikasi yang mengonfigurasi domain kustom dengan Firebase console sebelum Kuartal 3 2025 mungkin mendapati bahwa situs tidak ditampilkan dengan benar di Android WebView. Hal ini terjadi karena data CNAME yang digunakan selama periode tersebut tidak kompatibel dengan Android WebView.

Untuk mengatasi masalah ini, hapus domain kustom dari backend App Hosting dan tambahkan kembali. UI konsol yang diperbarui akan menyediakan 3 data baru, yaitu data A dan TXT untuk domain, serta CNAME untuk subdomain verifikasi ACME (untuk sertifikat); gunakan data ini sebagai pengganti data CNAME sebelumnya.

Bagaimana cara mengubah repositori yang terkait dengan project App Hosting saya?

Saat ini, repositori tidak dapat diubah. Namun, Anda dapat membuat backend baru yang terkait dengan repositori pilihan dalam project yang sama, atau membuat backend baru dalam project terpisah.

Bagaimana cara menyetel header untuk situs App Hosting saya?

Header bergantung pada framework. Lakukan apa pun yang biasanya Anda lakukan untuk framework Anda.

Apakah ada emulator untuk pengembangan lokal dengan App Hosting?

Ya, Anda dapat melakukan pengujian lokal aplikasi sebelum deployment App Hosting menggunakan emulator App Hosting, yang merupakan bagian dari Firebase Local Emulator Suite. Lihat Menguji deployment aplikasi Anda secara lokal .

Mengapa saya melihat error di App Hosting, tetapi tidak di Cloud Build?

Dalam kasus seperti itu, kemungkinan error Anda berasal dari Cloud Run. Periksa status peluncuran untuk memastikannya.

Bagaimana cara mengubah atau menghapus akun GitHub tertaut?

Untuk menghapus akun GitHub tertaut, buka Developer Connect, pastikan project Anda dipilih, lalu hapus koneksi firebase-app-hosting-github-oath dan koneksi yang dimulai dengan apphosting-github-conn-. Saat membuka App Hosting di konsol Firebase, Anda kini dapat menyiapkan koneksi GitHub baru.

Bagaimana cara menyetel cookie untuk situs App Hosting saya?

Meskipun tidak tersedia saat peluncuran pratinjau App Hosting, header respons HTTP Set-Cookie kini berfungsi seperti yang diharapkan.

Batasan dan pemecahan masalah umum App Hosting

• CDN App Hosting hanya dapat menyertakan serangkaian header permintaan tertentu dalam kunci cache-nya. Daftar tersebut mencakup header RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch, dan Next-Url NextJS, serta header Accept, Accept-Encoding, Access-Control-Request-Headers, Access-Control-Request-Method, Origin, Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site, X-Goog-Allowed-Resources, dan X-Origin standar Cloud CDN. Jika respons berisi header Vary dengan nilai yang tidak tercantum di sini, CDN kami tidak akan meng-cache-nya.
• File statis yang tidak di-cache ditayangkan dari Cloud Run; dalam rilis selanjutnya, file tersebut akan disimpan dan ditayangkan dari asal App Hosting untuk performa yang lebih baik.
• Konsol Firebase dapat menampilkan error "build tidak ditemukan dan tidak valid" secara berkala saat pembuatan backend.
• Semua backend dalam project yang sama berbagi akun/org. GitHub. Akun tersebut dapat terhubung ke repositori yang berbeda di organisasi/akun tersebut. Untuk membuat backend yang terhubung ke akun GitHub yang berbeda, tempatkan backend tersebut dalam project terpisah.

Batasan dan pemecahan masalah aplikasi Angular

Meskipun dukungan App Hosting untuk Angular sedang dalam pengembangan aktif dan diperluas, dukungan ini memiliki batasan berikut:

• I18n: Meskipun fungsi I18n inti berfungsi, navigasi langsung ke halaman SSR dapat menyebabkan error.
• Pelokalan: Membangun versi untuk berbagai lokalitas tidak didukung.
• Pembangun: Saat ini hanya Pembangun aplikasi yang didukung.
• Lingkungan dan Alat Monorepo: Project Angular yang memiliki lebih dari satu target aplikasi akan gagal. Untuk dukungan monorepo yang lebih lengkap, gunakan Nx.

Batasan dan pemecahan masalah Next.js

• Secara default, pengoptimalan gambar NextJS bawaan dinonaktifkan di App Hosting kecuali jika Anda secara eksplisit menyetel images.unoptimized ke false atau menggunakan Pemuat Gambar kustom. Lihat Mengoptimalkan pemuatan gambar di Next.js.
• Jalur URL yang berisi karakter berenkode persen didekode oleh Cloud Run. Hal ini dapat menyebabkan masalah pada fitur yang hanya mengharapkan jalur URL yang dienkode, seperti perutean paralel Next.js.
• Saat ini, App Hosting membatasi penyiapan cache untuk aplikasi NextJS menggunakan middleware. Seiring waktu, rasio cache ditemukan akan meningkat.
• Jalur URL yang berisi karakter yang dienkode dengan persen didekode oleh Cloud Run. Hal ini dapat menyebabkan masalah pada fitur yang hanya mengharapkan jalur URL yang dienkode, seperti perutean paralel Next.js