Bu sayfa, Firebase projeleri hakkında bazı önemli kavramlara kısa bir genel bakış sunar. Mümkün olduğunda, özellikler, hizmetler, araçlar ve en iyi uygulamalar hakkında daha ayrıntılı bilgi bulmak için bağlantıları izleyin.
Firebase projeleri, uygulamaları ve ürünleri arasındaki ilişki
Bir Firebase projesi, Firebase için en üst düzey varlıktır. Bir projede 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ı ekleyebilirsiniz.
Platformunuz için Başlarken kılavuzunda bu süreç hakkında daha ayrıntılı bilgi edinin:
iOS+ | Android | web | birlik | C++ | çarpıntı
Firebase projelerinin hiyerarşisini anlama
Bu şema, bir Firebase projesinin temel hiyerarşisini gösterir. İşte temel ilişkiler:
Bir Firebase projesi , tüm uygulamalarınız ve proje için sağlanan tüm kaynaklar ve hizmetler için bir kapsayıcı gibidir.
Bir Firebase projesinde kayıtlı bir veya daha fazla Firebase Uygulaması olabilir (örneğin, bir uygulamanın hem iOS hem de Android sürümleri veya 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 tüm aynı kaynaklara ve hizmetlere erişime sahiptir . İşte bazı örnekler:
Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage ve Cloud Functions gibi aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları aynı arka uçları paylaşır.
Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları, aynı Google Analytics mülküyle ilişkilidir ve her bir Firebase Uygulaması, söz konusu 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, ardından Firebase'i daha sonra projeye ekleyebilirsiniz. Bir Google Cloud projesini veri, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz.
Tüm Firebase projeleri için, Firebase'in Google Cloud Console'daki projeniz için Etiketler sayfasına otomatik olarak bir firebase:enabled
etiketi 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 hem Firebase konsolunda hem de Google Cloud Console ve Google APIs konsolunda etkileşim kurabilirsiniz.
Bir projede hem Firebase hem de Google Cloud'daki ürünleri ve API'leri kullanabilirsiniz.
Bir proje için faturalandırma ve izinler , Firebase ve Google Cloud arasında paylaşılır.
Bir proje için benzersiz tanımlayıcılar ( proje numarası ve proje kimliği gibi) Firebase ve Google Cloud arasında paylaşılır.
Bir projenin silinmesi projeyi Firebase ve Google Cloud'da siler.
Firebase projesi oluşturma ve uygulamaları kaydetme
Bir Firebase projesi ayarlayabilir ve Firebase konsolunda (veya gelişmiş kullanım durumları için Firebase Management REST API veya Firebase CLI aracılığıyla) uygulamaları kaydedebilirsiniz. Bir proje kurup uygulamaları kaydettiğinizde, bazı organizasyonel kararlar almanız ve yerel projelerinize Firebase'e özel yapılandırma bilgileri eklemeniz gerekir.
Üretim uygulamaları için, genellikle birden çok ortamın kullanılmasını içeren net bir geliştirme iş akışı oluşturmanız gerekir. Geliştirme iş akışınızı oluşturmak için Firebase projelerini kurmaya ve 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.
Bir Firebase projesiyle etkileşim kurma
Ürün SDK'larının yanı sıra, birkaç farklı araç ve arabirim 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, ayarlar seçeneğine tıklayarak bir projenin entegrasyonları , erişim izinlerini ve faturalandırmayı içerir.
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ünlerle ilgili istatistikleri görüntüleyen bir panoya dönüşür.
Bir Firebase projesi aynı zamanda bir Google Cloud projesi olduğundan, çeşitli görevlerin veya ürünlerin Firebase konsolu yerine Google Cloud Konsolunu kullanmanızı gerektirebileceğini unutmayın.
Firebase CLI (bir komut satırı aracı)
Firebase ayrıca Firebase Barındırma, Firebase için Bulut İşlevleri ve Firebase Uzantıları gibi belirli Firebase ürünlerini yapılandırmak ve yönetmek için Firebase CLI sunar.
CLI'yi yükledikten sonra, global firebase
komutuna erişiminiz olur. 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şlev güncellemelerini dağıtın .
Firebase Yönetimi REST API'si
Firebase Management REST API'yi kullanarak bir Firebase projesini programlı olarak yönetebilirsiniz. Örneğin, bir uygulamayı bir projeye programlı olarak kaydedebilir veya halihazırda kayıtlı olan uygulamaları listeleyebilirsiniz ( iOS+ | Android | web ).
Firebase proje tanımlayıcıları
Bir Firebase projesi, proje adı , proje numarası ve proje kimliği gibi farklı tanımlayıcılar kullanılarak Firebase arka ucunda ve çeşitli geliştirici arayüzlerinde tanımlanabilir.
proje adı
Bir proje oluşturduğunuzda, bir proje adı sağlarsınız . Bu tanımlayıcı, Firebase konsolu , Google Cloud Konsolu ve Firebase CLI'daki bir projenin yalnızca dahili adıdır . Proje adı, herkese açık herhangi bir Firebase veya Google Cloud ürününde, hizmetinde veya kaynağında gösterilmez; birden çok proje arasında daha kolay ayrım yapmanıza yardımcı olur.
Bir proje adını istediğiniz zaman Firebase konsolunun Proje ayarları ayarlarında . 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 küresel olarak benzersiz standart tanımlayıcıdır. Entegrasyonları yapılandırırken ve/veya Firebase, Google veya üçüncü taraf hizmetlere 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 hiçbir proje tarafından kullanılamaz.
Aşağıdaki seçeneklerden birini kullanarak Firebase projenizin proje numarasını bulun:
Firebase konsolunu kullanarak : Proje ayarları'na tıklayın. Proje numarası üst bölmede görüntülenir.
Firebase CLI'yi kullanma :
firebase projects:list
. 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ı için bir proje için benzersiz bir tanımlayıcı eklemeniz gerekir. Pek çok API proje kimliğini kabul etse de Firebase, Google veya üçüncü taraf hizmetlere 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 ilişkili Google Cloud projesinin ) bir proje kimliği vardır. Bu, tüm Firebase ve Google Cloud'da 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 atıfta bulunmak için uygun bir diğer 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ı'na tıklayın. Proje kimliği üst bölmede görüntülenir.
Firebase CLI'yi kullanma :
firebase projects:list
. 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, herkes tarafından görülebilen Firebase kaynaklarında görüntülenir, örneğin:
- Varsayılan Barındırma alt alanı —
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 Bulut Depolama grubu adı —
PROJECT_ID .appspot.com
Yukarıda belirtilen tüm kaynaklar 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 , Realtime Database'i parçalara ayırabilir ve birden çok Cloud Storage grubu oluşturabilirsiniz (platforma özgü Başlarken sayfasını ziyaret edin).
Bazı kullanım durumlarında, aynı yerel uygulama dizini ile ilişkilendirilmiş birden çok Firebase projeniz olabilir. Bu durumlarda, Firebase CLI'yi kullandığınızda, hangi Firebase projesiyle etkileşim kurmak istediğinizi bildirmek için --project
işaretini firebase
komutlarıyla iletmeniz gerekir.
Ayrıca, proje kimliklerini hatırlamak zorunda kalmamak için her bir Firebase projesi için bir proje takma adı ayarlayabilirsiniz.
Birçok API çağrısı için bir proje için 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ı Firebase projesine kaydettirdiğ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 edinebilirsiniz .
Bir Firebase yapılandırma dosyası veya nesnesi, bir uygulamayı belirli bir Firebase projesi ve kaynakları (veritabanları, depolama grupları vb.) ile ilişkilendirir. Yapılandırma, Firebase ve Google hizmetlerinin Firebase sunucu API'leriyle iletişim kurmak ve istemci verilerini Firebase projesi ve Firebase uygulamasıyla ilişkilendirmek için gerektirdiği parametreler olan "Firebase seçeneklerini" içerir. İşte gerekli, minimum "Firebase seçenekleri":
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'da 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 atıfta bulunmak 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 tüm Firebase genelinde platforma özel bir biçimde benzersiz tanımlayıcısı:
- 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ı:
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 ve Firebase projesine özgü değerler dahil olmak üzere Firebase yapılandırma dosyasının veya nesnesinin içeriği genel kabul edilir. Cloud Storage paket adı. Bu nedenle, verilerinizi ve dosyalarınızı Realtime Database , Cloud Firestore ve Cloud Storage'da korumak için Firebase Güvenlik Kurallarını kullanın.
Açık kaynak projeleri için genellikle uygulamanın Firebase yapılandırma dosyasının veya nesnesinin kaynak denetimine dahil edilmesini önermiyoruz çünkü çoğu durumda kullanıcılarınızın kendi Firebase projelerini oluşturması ve uygulamalarını kendi Firebase kaynaklarına yönlendirmesi gerekir (kendi Firebase yapılandırmaları aracılığıyla) 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ı
- Kıvılcım fiyatlandırma planı — Proje oluşturma kotası, daha düşük proje sayısıyla sınırlıdır (genellikle 5-10 civarında).
- Blaze fiyatlandırma planı — Hesap başına proje oluşturma kotası, ilişkili Cloud Billing hesabı iyi durumda olduğu sürece önemli ölçüde artar.
Proje oluşturma kotasındaki sınır, çoğu geliştirici için nadiren endişe kaynağıdır, ancak gerekirse, proje kotasında bir artış talep edebilirsiniz.
Bir projenin tamamen silinmesinin 30 gün gerektirdiğini ve proje tamamen silinene kadar proje kotasına dahil edildiğini unutmayın.
Proje başına uygulama sayısı
Firebase, bir Firebase projesi içindeki toplam Firebase Uygulaması sayısını 30 ile sınırlar.
Tek bir Firebase projesi içindeki 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 uygulamalar dokümanlarımızda çoklu kiracılık hakkında daha fazla bilgi edinin.
SSS'de proje başına uygulama sınırı hakkında daha fazla bilgi edinin.
Proje başına Barındırma sitesi sayısı
Firebase Barındırma ç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.
- Birden fazla Firebase hizmetinde projenizin 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.