SSS ve sorun giderme

Bu sayfada, App Hosting hakkında sık sorulan soruların (SSS) yanıtları yer almaktadır.

App Hosting SSS

App Hosting, Next.js ve Angular dışındaki çerçeveleri destekliyor mu?

App Hosting, Next.js ve Angular için önceden yapılandırılmış derleme ve dağıtım desteği sunar. Bu çerçeveleri anlamayı ve yerel yapılandırmalarını yorumlamayı taahhüt ederiz. Birçok başka çerçeve için geliştirici topluluğu App Hosting çerçeve bağdaştırıcılarını destekler. Ayrıca, derleme ve başlatma komut dosyası olan tüm Node.js uygulamaları için App Hosting derleme girişiminde bulunur ancak başarıyı güvenilir bir şekilde garanti edemez. Framework integration (Framework entegrasyonu) başlıklı makaleyi inceleyin.

Firebase App Hosting hangi bölgelerde desteklenir?

App Hosting için bölgeler zamanla genişleyebilir. En güncel bilgiler için App Hosting konumlarını inceleyin.

Dağıtımlar için GitHub dışında GitLab veya başka Git sağlayıcıları kullanabilir miyim?

Şu anda bu mümkün değildir ancak diğer sağlayıcılar için destek, App Hosting'nın uzun vadeli yol haritasında yer almaktadır.

Depomu neden Firebase konsol kullanıcı arayüzünde bulamıyorum?

Firebase konsolunda yeni bir arka uç oluştururken deponuz seçenekler listesinde görünmüyorsa önce Listeyi yenile'yi seçmeyi deneyin. Tercih edilen depo hâlâ kullanılamıyorsa GitHub'da yeni bir depoya erişim izni ver seçeneğini kullanarak depoyu eklemeniz gerekebilir.

Ayrıca, Firebase App Hosting GitHub uygulamasıyla depoları yönetebilirsiniz. Bunu yapmak için GitHub profilinize gidip Ayarlar'ı ve ardından Uygulamalar'ı seçin. Firebase App Hosting uygulamasının tablo satırında, depoları yönetmek için Yapılandır'ı tıklayın.

Sitem neden Android mobil uygulama WebView'da normal şekilde görüntülenmiyor?

2025'in 3. çeyreğinden önce Firebase konsoluyla özel alan yapılandıran uygulamalarda, sitenin Android WebView'da düzgün şekilde görüntülenmediği görülebilir. Bunun nedeni, söz konusu dönemde kullanılan CNAME kayıtlarının Android WebView ile uyumlu olmamasıdır.

Bu sorunu çözmek için özel alanı App Hosting arka uçtan kaldırıp yeniden ekleyin. Güncellenen konsol kullanıcı arayüzünde 3 yeni kayıt sağlanır: alan için bir A ve bir TXT kaydı ile ACME sorgulaması alt alanı için bir CNAME kaydı (sertifikalar için). Bu kayıtları önceki CNAME kaydı yerine kullanın.

App Hosting projemle ilişkili depoyu nasıl değiştiririm?

Şu anda, depoyu değiştirmek mümkün değildir. Ancak aynı proje içinde tercih edilen depoyla ilişkili yeni bir arka uç oluşturabilir veya ayrı bir projede yeni bir arka uç oluşturabilirsiniz.

App Hosting sitem için nasıl başlık ayarlayabilirim?

Başlıklar, çerçeveye bağlıdır. Çerçeveniz için normalde yaptığınız işlemi yapın.

App Hosting ile yerel geliştirme için emülatör var mı?

Evet, Firebase Local Emulator Suite'in bir parçası olan App Hosting emülatörünü kullanarak App Hosting uygulamanızın dağıtımından önce yerel testler yapabilirsiniz. Uygulama dağıtımınızı yerel olarak test etme başlıklı makaleyi inceleyin.

Neden App Hosting'da hata görüyorum ancak Cloud Build'de görmüyorum?

Bu gibi durumlarda, hatanızın Cloud Run'dan kaynaklanması mümkündür. Emin olmak için kullanıma sunma durumunu kontrol edin.

Bağlı bir GitHub hesabını nasıl değiştirir veya kaldırırım?

Bağlı GitHub hesabını kaldırmak için Geliştirici Bağlantısı'nı açın, projenizin seçildiğinden emin olun ve firebase-app-hosting-github-oath bağlantısını ve apphosting-github-conn- ile başlayan bağlantıyı silin. Firebase konsolunda App Hosting'ı açtığınızda artık yeni bir GitHub bağlantısı oluşturabilirsiniz.

App Hosting sitem için nasıl tanımlama bilgileri ayarlayabilirim?

App Hosting önizlemesinin kullanıma sunulduğu sırada kullanılamasa da Set-Cookie HTTP yanıt başlığı artık beklendiği gibi çalışıyor.

Genel App Hosting sınırlamalar ve sorun giderme

• Cloud Run altyapısındaki bir sorun nedeniyle, kaynak oluşturma veya güncelleme işlemleri us-central1 gibi bazı bölgelerde beklenenden daha yavaş olabilir. Belirli bir bölgede dağıtım gecikmesi sorun oluşturuyorsa Google, başka bir bölgeye dağıtım yapmanızı önerir.
• App Hosting'nın CDN'si, önbellek anahtarlarına yalnızca belirli bir istek başlığı grubunu dahil edebilir. Bu listede NextJS'in RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch ve Next-Url başlıklarının yanı sıra Cloud CDN'nin standart 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 ve X-Origin başlıkları yer alır. Bir yanıtta burada listelenmeyen bir değere sahip Vary başlığı varsa CDN'miz bunu önbelleğe almaz.
• Önbelleğe alınmamış statik dosyalar Cloud Run konumundan sunulur. Daha sonraki bir sürümde, daha iyi performans için App Hosting kaynağında depolanıp sunulacaktır.
• Firebase konsolu, arka uç oluşturma sırasında aralıklı olarak "build was not found and is invalid" (derleme bulunamadı ve geçersiz) hatası gösterebilir.
• Aynı projedeki tüm arka uçlar, bir GitHub kuruluşunu/hesabını paylaşır. Bu kuruluş/hesap altındaki farklı depolara bağlanabilirler. Farklı GitHub hesaplarına bağlı arka uçlar oluşturmak için bu arka uçları ayrı projelere yerleştirin.

Angular uygulaması sınırlamaları ve sorun giderme

Angular için App Hosting desteği aktif olarak geliştirilmekte ve genişletilmekte olsa da aşağıdaki sınırlamaları vardır:

• Uluslararasılaştırma: Temel uluslararasılaştırma işlevleri çalışsa da SSR sayfalarına doğrudan gitmek hatalara neden olabilir.
• Yerelleştirme: Farklı yerel ayarlar için sürüm oluşturma desteklenmez.
• Oluşturucular: Şu anda yalnızca uygulama oluşturucu desteklenmektedir.
• Ortamlar ve Monorepo Araçları: Birden fazla uygulama hedefi olan Angular projeleri başarısız olur. Daha kapsamlı monorepo desteği için Nx'i kullanın.

Angular SSR'de HTTP 400 Hataları ve Proxy Güveni

Firebase App Hosting üzerine dağıtılan Angular uygulamanızda HTTP 400 (Bad Request) hataları, ana makine doğrulama engelleyicileri veya proxy güveni hataları oluşursa Angular sürümünüz için önerilen çözümü uygulayın:

• Angular v19, v20 ve v21: Bu HTTP 400 hatalarını çözmek için iki seçeneğiniz vardır:
  • Bağımlılıkları yükseltme: Mevcut Angular sürümünüz için en son yama sürümünü yüklemek üzere npm update @angular/core @angular/ssr komutunu çalıştırın.
  • Manuel yapılandırma: Sunucu yapılandırmanızda trustProxyHeaders: true değerini ayarlayarak kod düzeyinde bir yapılandırma geri dönüşü uygulayın (Angular belgelerindeki Güvenilir proxy başlıklarını yapılandırma bölümüne bakın).
• Angular v22: Yeni bir arka uçtaki ilk derleme 400 hatası döndürebilir. Sorunu çözmek için ikinci bir derleme oluşturun. Sonraki tüm derlemeler beklendiği gibi çalışmalıdır.

Next.js sınırlamaları ve sorun giderme

• Yerleşik NextJS resim optimizasyonu, images.unoptimized değerini açıkça false olarak ayarlamadığınız veya özel bir Image Loader kullanmadığınız sürece App Hosting'de varsayılan olarak devre dışıdır.Next.js'te resim yüklemeyi optimize etme başlıklı makaleyi inceleyin.
• Yüzde kodlamalı karakterler içeren URL yollarının kodu Cloud Run tarafından çözülür. Bu durum, yalnızca kodlanmış URL yollarının beklendiği özelliklerde (ör. Next.js paralel yönlendirme) sorunlara neden olabilir.
• Şu anda App Hosting, middleware kullanan NextJS uygulamaları için önbelleğe almayı sınırlandırmaktadır. Zamanla önbellek isabet oranları artar.
• Yüzde kodlu karakterler içeren URL yollarının kodu Cloud Run tarafından çözülür. Bu durum, yalnızca kodlanmış URL yolları bekleyen özelliklerle (ör. Next.js paralel yönlendirme) ilgili sorunlara neden olabilir.