Bu sayfada Firebase projeleriyle ilgili birçok önemli kavrama kısa genel bakış sunulmaktadır. Mevcut olduğunda özellikler, hizmetler, araçlar ve en iyi uygulamalar hakkında daha ayrıntılı bilgi edinmek için bağlantıları izleyin.
Firebase projeleri, uygulamaları ve ürünleri arasındaki ilişki
Firebase projesi, Firebase'in en üst düzey varlığıdır. Bir projeye Apple, Android veya web uygulamalarınızı kaydedebilirsiniz. Uygulamalarınızı Firebase'e kaydettirdikten sonra Analytics, Cloud Firestore, Performance Monitoring veya Remote Config gibi istediğiniz sayıda Firebase ürünü için Firebase SDK'larını ekleyebilirsiniz.
Platformunuza yönelik Başlangıç kılavuzundan bu süreç hakkında daha ayrıntılı bilgi edinin:
iOS+ | Android | ağ | Birlik | C++ | Çarpıntı .
Firebase projelerinin hiyerarşisini anlama
Bu şemada bir Firebase projesinin temel hiyerarşisi gösterilmektedir. İşte temel ilişkiler:
Firebase projesi, tüm uygulamalarınız ve proje için sağlanan kaynaklar ve hizmetler için bir kapsayıcı gibidir.
Bir Firebase projesinde kayıtlı bir veya daha fazla Firebase Uygulaması bulunabilir (örneğin, bir uygulamanın hem iOS hem de Android sürümleri ya da bir uygulamanın hem ücretsiz hem de ücretli sürümleri).
Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları , proje için sağlanan kaynakların ve hizmetlerin tümüne erişebilir ve bunlara erişebilir . İşte bazı örnekler:
Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları, Firebase Barındırma, Kimlik Doğrulama, Gerçek Zamanlı Veritabanı, Cloud Firestore, Cloud Storage ve Cloud Functions gibi aynı arka uçları paylaşır.
Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları aynı Google Analytics mülküyle ilişkilidir; burada her Firebase Uygulaması, o mülkte ayrı bir veri akışıdır.
Firebase projeleri ile Google Cloud arasındaki ilişki
Yeni bir Firebase projesi oluşturduğunuzda aslında perde arkasında bir Google Cloud projesi oluşturuyorsunuz. Hatta önce bir Google Cloud projesi oluşturabilir, daha sonra Firebase'i projeye ekleyebilirsiniz. Bir Google Cloud projesini veriler, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz.
Firebase'in, tüm Firebase projeleri için Google Cloud Console'daki projenizin Etiketler sayfasına otomatik olarak firebase:enabled
etiketini eklediğini unutmayın. SSS bölümümüzde bu etiket hakkında daha fazla bilgi edinin.
Firebase projesi bir Google Cloud projesi olduğundan :
Bir projeyle Firebase konsolunun yanı sıra Google Cloud Console ve Google API konsolunda da etkileşimde bulunabilirsiniz.
Bir projede hem Firebase hem de Google Cloud'un ürünlerini ve API'lerini kullanabilirsiniz.
Bir projenin faturalandırması ve izinleri Firebase ve Google Cloud arasında paylaşılır.
Bir projenin benzersiz tanımlayıcıları ( proje numarası ve proje kimliği gibi) Firebase ve Google Cloud genelinde paylaşılır.
Bir projenin silinmesi, projenin Firebase ve Google Cloud genelinde silinmesine neden olur.
Firebase projesi oluşturma ve uygulamaları kaydetme
Bir Firebase projesi oluşturabilir ve uygulamaları Firebase konsoluna kaydedebilirsiniz (veya gelişmiş kullanım örnekleri için Firebase Management REST API veya Firebase CLI aracılığıyla). Bir proje oluşturup uygulamaları kaydettiğinizde bazı organizasyonel kararlar almanız ve Firebase'e özgü yapılandırma bilgilerini yerel projelerinize eklemeniz gerekir.
Üretim uygulamaları için genellikle birden fazla ortamın kullanılmasını içeren net bir geliştirme iş akışı ayarlamanız gerekir. Firebase projeleri oluşturmaya ve geliştirme iş akışınızı oluşturmak için uygulamaları kaydetmeye yönelik genel en iyi uygulamalar ve genel güvenlik yönergeleri de dahil olmak üzere, geliştirici iş akışlarıyla ilgili belgelerimizi inceleyin.
Firebase projesiyle etkileşim kurma
Ürün SDK'larının yanı sıra birçok farklı araç ve arayüz kullanarak bir Firebase projesiyle doğrudan etkileşim kurabilirsiniz.
Firebase konsolu
Firebase konsolu, Firebase ürünlerini, uygulamalarını ve proje düzeyindeki ayarları yönetmek için en zengin ortamı sunar.
Konsolun sol tarafındaki panel, üst düzey kategorilere göre düzenlenmiş Firebase ürünlerini listeler. Sol taraftaki panelin üst kısmında, entegrasyonları , erişim izinlerini ve faturalandırmayı içerir.
tıklayarak bir projenin ayarlarına erişin. Bir projenin ayarları;Konsolun ortasında, çeşitli uygulama türlerini kaydetmek için kurulum iş akışlarını başlatan düğmeler görüntülenir. Firebase'i kullanmaya başladıktan sonra konsolun ana alanı, kullandığınız ürünlerin istatistiklerini görüntüleyen bir kontrol paneline dönüşür.
Firebase projesi aynı zamanda bir Google Cloud projesi olduğundan, çeşitli görevlerin veya ürünlerin Firebase konsolu yerine Google Cloud Console'u kullanmanızı gerektirebileceğini unutmayın.
Firebase CLI (bir komut satırı aracı)
Firebase ayrıca Firebase Hosting, Cloud Functions for Firebase ve Firebase Extensions gibi belirli Firebase ürünlerini yapılandırmak ve yönetmek için Firebase CLI'yi de sunar.
CLI'yi yükledikten sonra global firebase
komutuna erişebilirsiniz. Yerel uygulama dizininizi bir Firebase projesine bağlamak için CLI'yi kullanın, ardından Firebase tarafından barındırılan içeriğin yeni sürümlerini veya işlevlere yönelik güncellemeleri dağıtın .
Firebase Yönetimi REST API'si
Firebase Management REST API'yi kullanarak bir Firebase projesini programlı bir şekilde yönetebilirsiniz. Örneğin, bir uygulamayı bir projeye programlı olarak kaydedebilir veya önceden kayıtlı olan uygulamaları listeleyebilirsiniz ( iOS+ | Android | web ).
Firebase proje tanımlayıcıları
Bir Firebase projesi, Firebase arka ucunda ve çeşitli geliştirici arayüzlerinde proje adı , proje numarası ve proje kimliği gibi farklı tanımlayıcılar kullanılarak tanımlanabilir.
Proje adı
Bir proje oluşturduğunuzda bir proje adı sağlarsınız. Bu tanımlayıcı, Firebase konsolu , Google Cloud Console ve Firebase CLI'deki bir projenin yalnızca dahili adıdır . Proje adı, herkese açık olarak görülebilen herhangi bir Firebase veya Google Cloud ürününde, hizmetinde veya kaynağında gösterilmez; yalnızca birden fazla projeyi daha kolay ayırt etmenize yardımcı olmaya yarar.
Bir proje adını istediğiniz zaman Firebase konsolunun Proje ayarlarından . Proje adı üst bölmede görüntülenir.
Proje numarası
Bir Firebase projesinin (ve onunla ilişkili Google Cloud projesinin ) bir proje numarası vardır. Bu, proje için Google tarafından atanan global benzersiz standart tanımlayıcıdır. Entegrasyonları yapılandırırken ve/veya Firebase, Google veya üçüncü taraf hizmetlerine API çağrıları yaparken bu tanımlayıcıyı kullanın.
Bir proje numarasını düzenleyemezsiniz. Bir projeyi silerseniz proje numarası da silinir ve bir daha asla başka bir proje tarafından kullanılamaz.
Aşağıdaki seçeneklerden birini kullanarak Firebase projenizin proje numarasını bulun:
Firebase konsolunu kullanarak : Proje ayarları'nı tıklayın. Proje numarası üst bölmede görüntülenir.
Firebase CLI'yi kullanma :
firebase projects:list
çalıştırın. Proje numarası, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.Firebase Management REST API'yi kullanma :
projects.list
çağırın. Yanıt gövdesi,FirebaseProject
nesnesindeki proje numarasını içerir.
Birçok API çağrısında projeye yönelik benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API proje kimliğini kabul etse de Firebase, Google veya üçüncü taraf hizmetlerine API çağrıları yapmak için proje numarasını kullanmanız önerilir.
Google'ın AIP 2510 standardında proje tanımlayıcılarını, özellikle de proje numarasını kullanma hakkında daha fazla bilgi edinin.
Proje kimliği
Bir Firebase projesinin (ve onunla ilişkili Google Cloud projesinin ) bir proje kimliği vardır. Bu, tüm Firebase ve Google Cloud genelinde proje için kullanıcı tanımlı benzersiz bir tanımlayıcıdır. Bir Firebase projesi oluşturduğunuzda, Firebase projeye otomatik olarak benzersiz bir kimlik atar ancak bunu proje kurulumu sırasında düzenleyebilirsiniz. Bu tanımlayıcı genellikle projeye referans vermek için uygun bir takma ad olarak ele alınmalıdır.
Aşağıdaki seçeneklerden birini kullanarak Firebase projenizin proje kimliğini bulun:
Firebase konsolunu kullanarak : Proje ayarları'nı tıklayın. Proje kimliği üst bölmede görüntülenir.
Firebase CLI'yi kullanma :
firebase projects:list
çalıştırın. Proje kimliği, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.Firebase Management REST API'yi kullanma :
projects.list
çağırın. Yanıt gövdesi,FirebaseProject
nesnesindeki proje kimliğini içerir.
Proje kimliği, herkese açık Firebase kaynaklarında görüntülenir; örneğin:
- Varsayılan Hosting alt alan adı —
PROJECT_ID .web.app
vePROJECT_ID .firebaseapp.com
- Varsayılan Gerçek Zamanlı Veritabanı URL'si —
PROJECT_ID -default-rtdb.firebaseio.com
veyaPROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
- Varsayılan Cloud Storage paketi adı —
PROJECT_ID .appspot.com
Yukarıda belirtilen kaynakların tümü için varsayılan olmayan örnekler oluşturabilirsiniz. Varsayılan olmayanların herkes tarafından görülebilen adları tamamen özelleştirilebilir. Özel etki alanlarını Firebase tarafından barındırılan bir siteye bağlayabilir , Gerçek Zamanlı Veritabanını parçalayabilir ve birden fazla Bulut Depolama grubu oluşturabilirsiniz (platforma özel Başlarken sayfasını ziyaret edin).
Bazı kullanım örneklerinde aynı yerel uygulama dizini ile ilişkilendirilmiş birden fazla Firebase projeniz olabilir. Bu durumlarda, Firebase CLI'yi kullandığınızda, hangi Firebase projesiyle etkileşim kurmak istediğinizi bildirmek için firebase
komutlarıyla birlikte --project
bayrağını iletmeniz gerekir.
Ayrıca her Firebase projesi için bir proje takma adı da ayarlayabilirsiniz, böylece proje kimliklerini hatırlamak zorunda kalmazsınız.
Birçok API çağrısında projeye yönelik benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API proje kimliğini kabul etse de Firebase, Google veya üçüncü taraf hizmetlerine API çağrıları yapmak için proje numarasını kullanmanız önerilir.
Google'ın AIP 2510 standardında proje tanımlayıcılarını, özellikle de proje numarasını kullanma hakkında daha fazla bilgi edinin.
Firebase yapılandırma dosyaları ve nesneleri
Bir uygulamayı bir Firebase projesine kaydettiğinizde Firebase konsolu, doğrudan yerel uygulama dizininize eklediğiniz bir Firebase yapılandırma dosyası (Apple/Android uygulamaları) veya bir yapılandırma nesnesi (web uygulamaları) sağlar.
- Apple uygulamaları için bir
GoogleService-Info.plist
yapılandırma dosyası eklersiniz. - Android uygulamaları için bir
google-services.json
yapılandırma dosyası eklersiniz. - Web uygulamaları için bir Firebase yapılandırma nesnesi eklersiniz.
İstediğiniz zaman bir uygulamanın Firebase yapılandırma dosyasını veya nesnesini alabilirsiniz .
Firebase yapılandırma dosyası veya nesnesi, bir uygulamayı belirli bir Firebase projesiyle ve onun kaynaklarıyla (veritabanları, depolama paketleri vb.) ilişkilendirir. Yapılandırma, Firebase ve Google hizmetlerinin Firebase sunucu API'leriyle iletişim kurmak ve müşteri verilerini Firebase projesi ve Firebase uygulamasıyla ilişkilendirmek için gerektirdiği parametreler olan "Firebase seçeneklerini" içerir. Gerekli minimum "Firebase seçenekleri" şunlardır:
API anahtarı : özel kullanıcı verilerine erişmesi gerekmeyen belirli API'leri çağırırken kullanılan basit bir şifrelenmiş dize (örnek değer:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
)Proje Kimliği : Tüm Firebase ve Google Cloud genelinde proje için kullanıcı tanımlı benzersiz bir tanımlayıcı. Bu tanımlayıcı, bazı Firebase kaynaklarının URL'lerinde veya adlarında görünebilir, ancak genellikle projeye referans vermek için uygun bir takma ad olarak ele alınmalıdır. (örnek değer:
myapp-project-123
)Uygulama Kimliği ("AppID") : Firebase uygulamasının tamamında platforma özel bir formata sahip benzersiz tanımlayıcı:
- Firebase Apple uygulamaları:
GOOGLE_APP_ID
(örnek değer:1:1234567890:ios:321abc456def7890
)
Bu bir Apple paket kimliği değil . - Firebase Android uygulamaları:
mobilesdk_app_id
(örnek değer:1:1234567890:android:321abc456def7890
)
Bu bir Android paket adı veya Android uygulama kimliği değildir . - Firebase Web uygulamaları:
appId
(örnek değer:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c
)
- Firebase Apple uygulamaları:
Firebase yapılandırma dosyasının veya nesnesinin içeriği, uygulamanın platforma özgü kimliği (Apple paket kimliği veya Android paket adı) ve API Anahtarı, proje kimliği, Gerçek Zamanlı Veritabanı URL'si gibi Firebase projesine özgü değerler dahil olmak üzere herkese açık olarak kabul edilir. Cloud Storage paketi adı. Bunu göz önünde bulundurarak, Gerçek Zamanlı Veritabanı , Cloud Firestore ve Cloud Storage'daki verilerinizi ve dosyalarınızı korumak için Firebase Güvenlik Kurallarını kullanın .
Açık kaynaklı projeler için genellikle uygulamanın Firebase yapılandırma dosyasını veya nesnesini kaynak kontrolüne dahil etmenizi önermiyoruz çünkü çoğu durumda kullanıcılarınızın kendi Firebase projelerini oluşturması ve uygulamalarını kendi Firebase kaynaklarına (kendi Firebase yapılandırmaları aracılığıyla) yönlendirmesi gerekir. dosya veya nesne).
Firebase projeleri, uygulamaları ve siteleri için genel sınırlar
Firebase projeleri, uygulamaları ve siteleri için bazı genel sınırlar şunlardır:
Hesap başına proje sayısı
- Spark fiyatlandırma planı — Proje oluşturma kotası daha düşük sayıda projeyle sınırlıdır (genellikle 5-10 civarında).
- Blaze fiyatlandırma planı — İlgili Bulut Faturalandırma hesabı iyi durumda olduğu sürece hesap başına proje oluşturma kotası önemli ölçüde artar.
Proje oluşturma kotasının sınırı çoğu geliştirici için nadiren endişe vericidir, ancak gerekirse proje kotasının artırılmasını talep edebilirsiniz.
Bir projenin tamamen silinmesinin 30 gün gerektirdiğini ve proje tamamen silinene kadar proje kotasına dahil edileceğini unutmayın.
Proje başına uygulama sayısı
Firebase, bir Firebase projesindeki toplam Firebase Uygulaması sayısını 30 ile sınırlandırır.
Tek bir Firebase projesindeki tüm Firebase Uygulamalarının, son kullanıcı açısından aynı uygulamanın platform varyantları olduğundan emin olmalısınız. En iyi uygulama belgelerimizde çoklu kiracılık hakkında daha fazla bilgi edinin.
SSS'den proje başına uygulama sınırı hakkında daha fazla bilgi edinin.
Proje başına Barındırma sitesi sayısı
Firebase Hosting çoklu site özelliği, proje başına maksimum 36 siteyi destekler.
Uygulamanız başlatılıyor
- Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase başlatma kontrol listesini inceleyin.