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 diğer ç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ı içeren 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ı 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 konsolu 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, depoları Firebase App Hosting GitHub uygulamasıyla da 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 uygulamasının WebView'ında 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 görüntülenmediği görülebilir. Bunun nedeni, bu 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 kaydı ve bir TXT kaydı, 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 deponun değiştirilmesi 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şlemleri 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 uygulamanızın App Hosting dağıtımından önce yerel testlerini gerçekleştirebilirsiniz. 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 Developer Connect'i açın, projenizin seçili olduğundan emin olun ve firebase-app-hosting-github-oath bağlantısını ve apphosting-github-conn- ile başlayan bağlantıyı silin. App Hosting'yı Firebase konsolunda açtığınızda artık yeni bir GitHub bağlantısı oluşturabilirsiniz.

App Hosting sitem için tanımlama bilgileri nasıl 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

• App Hosting'nın CDN'si, önbellek anahtarlarına yalnızca belirli bir istek başlığı grubunu ekleyebilir. 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şu/hesabı paylaşır. Bu depolar, söz konusu kuruluş/hesap altındaki farklı depolara bağlanabilir. Farklı GitHub hesaplarına bağlı arka uçlar oluşturmak için bunları ayrı projelere yerleştirin.

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

Angular için App Hosting desteği etkin olarak geliştirilip genişletilse de 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.

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

• Varsayılan olarak, 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 yerleşik NextJS resim optimizasyonu devre dışıdır. Next.js'te resim yüklemeyi optimize etme başlıklı makaleye bakın.
• 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. Zaman içinde ö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 ilgili sorunlara neden olabilir. Örneğin, Next.js paralel yönlendirme