App Hosting için çerçeveler ve araçlar

Firebase App Hosting, özellikle çerçeve odaklı modern web uygulaması geliştirmeyi desteklemek için tasarlanmıştır. Bu sayfayı, App Hosting'ün doğrudan desteklediği araç ve çerçeveler için referans olarak ve ilgili çerçeveler ve araçlar hakkında bilgi edinmek için başlangıç noktası olarak kullanın.

Web çerçeveleri ve App Hosting

App Hosting, modern web çerçeveleri için iki geniş destek düzeyi sunar: önceden yapılandırılmış derleme ve dağıtım desteği ve çıkış paketi spesifikasyonuna uygun açık kaynak katkıları aracılığıyla topluluk düzeyinde destek. Her iki durumda da çerçeve bağdaştırıcısı bileşeni, belirli bir çerçevenin App Hosting ile entegrasyonunu sağlar.

Önceden yapılandırılmış derleme ve dağıtım desteğine sahip çerçeveler

Önceden yapılandırılmış derleme ve dağıtım desteğiyle Firebase, package-lock.json dosyasını veya diğer kilit dosyasını inceleyerek hangi çerçeveyi kullandığınızı belirler ve uygulamanız için derleme ve dağıtım süreçlerini optimize eder. Google, bu çerçeveler için desteği sürdürmeye kararlıdır ve Firebase destek ekibi sorun raporlarını ve özellik isteklerini kabul edebilir.

Bu destek düzeyi aşağıdakiler için sağlanır:

  • Next.js
  • Angular

Belirli sürümler ve destek düzeyleriyle ilgili ayrıntılar için destek programlarına bakın.

Kilit dosyası eksik olan bir Node.js uygulamasını dağıtmaya çalışırsanız App Hosting, uygulamanızı oluşturamaz ve çalıştıramaz. Kök dizininizde npm install'yi çalıştırarak package-lock.json oluşturabilirsiniz.

Topluluk tarafından desteklenen çerçeveler

App Hosting, Next.js ve Angular'a ek olarak çıktı paketi spesifikasyonumuzla eşleşen bir derleme çıkışı sağlayabilen tüm web çerçevelerini de destekler. Çerçeve yazarları, çerçevelerinin App Hosting tarafından desteklenmesini sağlamak için çıkış paketi spesifikasyonundan yararlanabilir. Örneğin, popüler Nuxt çerçevesi Nitro ekibi tarafından desteklenir. Bu ekip, App Hosting'de Nuxt uygulama dağıtımını etkinleştirmek için bir Firebase bağdaştırıcısı oluşturmuştur.

App Hosting tarafından desteklenen ek çerçeveler görmek istiyorsanız bir çerçeve bağdaştırıcısı oluşturabilir veya derleme çıkışlarını App Hosting biçimine dönüştürmek için çerçevenin koruyucularıyla iletişime geçebilirsiniz. Next.js ve Angular bağdaştırıcılar, bağdaştırıcılar oluşturan herkes için iyi referans örnekleridir.

Topluluk tarafından desteklenen çerçevelerle ilgili bilgileri Firebase Open Source'da bulabilirsiniz. Topluluk tarafından desteklenen çerçevelerle ilgili sorunlar ve özellik istekleri, açık kaynak topluluğuna veya çerçeve yazarlarına yönlendirilmelidir. Bazı durumlarda Google size yardımcı olabilir ancak bu adaptörler için ilk destek kaynağı topluluktur.

App Hosting çerçeve adaptörleri

App Hosting'te hem önceden yapılandırılmış hem de topluluk tarafından desteklenen çerçeveler için destek, çerçeve bağdaştırıcılar aracılığıyla sağlanır. App Hosting çerçeve bağdaştırıcıların iki temel işlevi vardır:

  • Bunlar, kaynak kodunuzu ve çerçeveye özgü tüm yapılandırma dosyalarını (next.config.js gibi) ayrıştırır ve App Hosting altyapısının geri kalanı tarafından işlenebilecek bir çıkış paketi oluşturur.
  • Statik öğeler oluşturmak ve uygulamanızın üretime yönelik optimize edilmiş bir sürümünü oluşturmak için uygulamanızın derleme komutunu çalıştırırlar.

Çerçeve bağdaştırıcılar, Node.js uygulamanızı npm run build ile oluşturur ve her çerçevenin varsayılan derleme komut dosyalarıyla en iyi şekilde çalışır: Next.js için next build ve Angular için ng build. App Hosting, özel derleme komutlarıyla derleme yapmayı dener ancak başarının güvenilir bir şekilde garanti edilemeyeceğini belirtir. apphosting.yaml'de derleme ve çalıştırma komut dosyalarını geçersiz kılabilirsiniz.

Next.js ve Angular bağdaştırıcıların kaynağı firebase-framework-tools'da mevcuttur.

App Hosting için çalışma zamanları

Node.js uygulamanız, App Hosting tarafından derlenip kullanıma sunulduktan sonra Cloud Run düzeltmesinde çalışır. Bu nedenle, uygulamanızın çalışma zamanı sürümü hem Cloud Run'ın desteklediği aralık hem de seçtiğiniz web çerçevesinin aralığında olmalıdır. Angular ve Next.js için önceden yapılandırılmış destekte, aşağıdaki Node.js sürümleri desteklenir:

  • Next.js 13.5.x ve sonraki sürümler
  • Angular 18.2.x ve üzeri
  • Node.js 18 ve üzeri sürümler

App Hosting, yeni yayınlanan çerçeve sürümleri için otomatik olarak etkin destek sağlamaz. Şu anda "etkin" olarak belirttiğimiz sürümden daha yeni sürümler, App Hosting için resmi olarak "etkin" olarak işaretlenene kadar "önizleme" durumunda kabul edilir.

App Hosting, ana sürümün en son küçük sürümü için uzun süreli destek (LTS) sunar. Bu küçük sürümdeki en son yama sürümlerine düzenli olarak güncelleme yapmanız koşuluyla, LTS desteği etkin destek döneminden itibaren bir yıl boyunca sunulur. Next.js ve Angular ile ilgili ayrıntılar için aşağıdaki tablolara bakın.

Next.js destek programı

Sürüm Durum Kullanımdan Kaldırma
13.5.x lts 2026-10-9
14.2.x lts 2026-10-9
15.0.x etkin 9.10.2025'ten önce değil
15.1.x etkin 9.10.2025'ten önce değil
15.2.x etkin -

Angular destek programı

Sürüm Durum Kullanımdan Kaldırma
18.2.x lts 2026-10-9
19.0.x etkin 9.10.2025'ten önce değil
19.1.x etkin 9.10.2025'ten önce değil
19.2.x etkin -

Paket yöneticileri

App Hosting, bağımlılık yükleme işlemini yürütmek için Cloud Native Buildpacks'i kullanır ve uygulamayı npm, yarn veya pnpm kullanarak oluşturur. JSR gibi diğer paket yöneticileri desteklenmez.

AİOY

  • NPM, varsayılan paket yöneticisidir.
  • Üretim dışı bağımlılıklar, derleme işlemi başarıyla tamamlandıktan sonra budanır.
  • package.json dosyanızdaki engines.npm alanını kullanarak npm sürüm bölümünü belirtebilirsiniz.

Yumak

  • Projenize yarn.lock dosyası eklediğinizde bunun yerine Yarn kullanılır.
  • package.json dosyanızın engines.yarn veya packageManager alanında kullanılacak iplik sürümünü belirtebilirsiniz.
  • App Hosting, Yarn2 PnP modunu destekler.

Pnpm

  • Projenize pnpm-lock.yaml dosyasını eklediğinizde bunun yerine Pnpm kullanılır.
  • package.json dosyanızın engines.pnpm veya packageManager alanında pnpm sürümünü belirtebilirsiniz.
  • Çalışan bir örnek için sample-node-pnpm dosyasına bakın. görüntüleyin.

App Hosting için monorepo'lar

App Hosting, Nx tabanlı uygulamaları destekler. Ayrıntılı bilgi için App Hosting ile tek depo kullanma başlıklı makaleyi inceleyin.

Aşağıdaki Nx sürümleri desteklenir:

Sürüm Durum Kullanımdan Kaldırma
19.5.x bakım 2025-10-9
19.6.x bakım 2025-10-9
19.7.x bakım 2025-10-9
19.8.x lts 2026-10-9
20.0.x etkin 9.10.2025'ten önce değil
20.1.x etkin 9.10.2025'ten önce değil
20.2.x etkin 9.10.2025'ten önce değil
20.3.x etkin 9.10.2025'ten önce değil
20.4.x etkin 9.10.2025'ten önce değil
20.5.x etkin 9.10.2025'ten önce değil
20.6.x etkin 9.10.2025'ten önce değil
20.7.x etkin —

Diğer tek depolu çalışma alanı türleriyle ilgili desteğe ihtiyacınız varsa Firebase UserVoice üzerinden bize bildirin.