Bu sayfa, Firebase projeleriyle ilgili birkaç önemli kavramın kısa bir özetini sunar. Mümkün olduğunda, özellikler, hizmetler ve hatta diğer platformlar hakkında daha ayrıntılı bilgi bulmak için bağlantıları izleyin. Bu sayfanın alt kısmında, bir bir listeleme bulmak genel iyi uygulamalar Firebase projeleri için.
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ı kaydettirerek Firebase uygulamaları oluşturursunuz. Eğer Firebase ile uygulamalarınızı kaydettikten sonra herhangi sayısı için Firebase SDK'lerini ekleyebilir Firebase ürünleri Analytics gibi, Bulut Firestore, Performans İzleme veya Uzaktan Konfig'teki.
Firebase projeleri ile Google Cloud arasındaki ilişki
Eğer Firebase konsolunda yeni Firebase proje oluştururken, aslında bir oluştururken , Google Cloud projesini perde arkasında. Bir Google Cloud projesini veri, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz. Firebase projesi, Firebase'e özel ek yapılandırmalara ve hizmetlere sahip bir Google Cloud projesidir. Hatta önce bir Google Cloud projesi oluşturabilir, ardından projeye Firebase'i ekleyebilirsiniz.
Bir Firebase proje bu yana bir Google Cloud projedir:
Bir projede hem Firebase hem de Google Cloud'daki ürünleri ve API'leri kullanabilirsiniz.
Bir projeyi silmek, onu Firebase ve Google Cloud'da siler.
Bir Firebase projesi oluşturma ve uygulamaları kaydetme
Bir Firebase projesini kurmak ve uygulamaları kaydedebilirsiniz Firebase konsoluna (aracılığıyla, gelişmiş kullanım örnekleri veya Firebase Yönetimi REST API ya Firebase CLI ). Bir proje oluşturduğunuzda ve uygulamaları kaydettiğinizde, bazı kurumsal kararlar almanız ve yerel projelerinize Firebase'e özel yapılandırma bilgileri eklemeniz gerekir.
Bazı mutlaka inceleyin genel proje düzeyinde en iyi uygulamaları bir proje kurma ve uygulamaları kayıt olmadan önce (bu sayfanın alt kısmında).
proje adı
Bir proje oluştururken, bir proje adı sağlarlar. Bu tanımlayıcı bir proje için yalnızca dahili adıdır Firebase konsolunda , Google Cloud Console ve Firebase CLI . Proje adı, herkesin görebileceği herhangi bir Firebase veya Google Cloud ürününde, hizmetinde veya kaynağında gösterilmez; sadece birden fazla proje arasında daha kolay ayrım yapmanıza yardımcı olur.
Sen herhangi bir zamanda bir proje adı düzenleyebilir Proje ayarları Firebase konsolunun. Proje adı üst bölmede görüntülenir.
proje numarası
Bir Firebase projesi (ve ilişkili Google Cloud projesi ) bir proje numarası vardır. Bu, proje için Google tarafından atanan küresel 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.
API çağrıları ve proje numarası
Birçok API çağrısı için bir proje için benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API'ler kabul rağmen proje kimliğine , o Firebase, Google'da veya üçüncü taraf hizmetleri için API çağrıları yapmak için proje numarası kullanmanız önerilir.
Google'ın içinde, özellikle proje numarası proje tanımlayıcıları kullanma hakkında daha fazla bilgi AIP 2510 standardına .
Proje numarasını bulun
Firebase konsolu: öğesini tıklayın Proje ayarları . Proje numarası üst bölmede görüntülenir.
Firebase CLI: Çalışma
firebase projects:list. Proje numarası, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.
proje kimliği
Bir Firebase projesi (ve ilişkili Google Cloud projesi ) 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 proje kurulumu sırasında bunu düzenleyebilirsiniz. Bu tanımlayıcı genellikle projeye referans vermek için bir kolaylık takma adı olarak ele alınmalıdır.
Bir projeyi silerseniz, proje kimliği de silinir ve bir daha asla başka bir proje tarafından kullanılamaz.
Firebase kaynakları ve proje kimliği
Proje kimliği, herkesin görebileceği Firebase kaynaklarında görüntülenir, örneğin:
- Standart Hosting alt alan -
PROJECT_ID .web.appve
PROJECT_ID .firebaseapp.com
- Standart Gerçek Zamanlı Veri Tabanı URL -
PROJECT_ID -default-rtdb.firebaseio.comveya
PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
- Standart Bulut Depolama grup adı -
PROJECT_ID .appspot.com
Yukarıda belirtilen kaynakların tümü için varsayılan olmayan örnekler oluşturabilirsiniz. Varsayılan olmayanların genel olarak görülebilen adları tamamen özelleştirilebilir. Sen olabilir özel alanlarını bağlamak , bir Firebase barındırılan siteye Gerçek Zamanlı Veritabanı yatay ve çoklu Bulut Depolama grup oluştururuz (platforma özel Başlayın sayfasını ziyaret).
Firebase CLI ve proje kimliği
Bazı kullanım durumlarında, aynı yerel uygulama dizini ile ilişkilendirilmiş birden fazla Firebase projeniz olabilir. Kullandığınızda Bu gibi durumlarda, Firebase CLI , sen geçmesi gerekiyor
--project işaretleyin
firebase sizinle etkileşime istediğiniz Firebase projesi iletişim komutları.
Ayrıca kurabilirsiniz proje takma proje kimlikleri hatırlamak zorunda kalmamak için her Firebase proje için.
API çağrıları ve proje kimliği
Birçok API çağrısı için bir proje için benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API'ler proje kimliğine kabul olsa da, kullandığınız önerilir proje numarasını Firebase, Google'da veya üçüncü taraf hizmetleri için API çağrıları yapmak için.
Google'ın içinde, özellikle proje numarası proje tanımlayıcıları kullanma hakkında daha fazla bilgi AIP 2510 standardına .
Proje kimliğini bulun
Firebase konsolu: öğesini tıklayın Proje ayarları . Proje kimliği üst bölmede görüntülenir.
Firebase CLI: Çalışma
firebase projects:list. Proje kimliği, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.
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ında, arkasına bir
GoogleService-Info.plistyapılandırma dosyası.
- Android uygulamaları, bir eklemek
google-services.jsonyapılandırma dosyası.
- Web uygulamaları için bir Firebase yapılandırma nesnesi eklersiniz.
Herhangi bir zamanda, şunları yapabilirsiniz Bir uygulamanın Firebase yapılandırma dosyası veya nesneyi elde .
Bir Firebase yapılandırma dosyası veya nesnesi, bir uygulamayı belirli bir Firebase projesi ve kaynaklarıyla (veritabanları, depolama paketleri vb.) ilişkilendirir. Yapılandırma, Firebase sunucu API'leriyle iletişim kurmak ve istemci verilerini Firebase projesi ve Firebase uygulamasıyla ilişkilendirmek için Firebase ve Google hizmetlerinin gerektirdiği parametreler olan "Firebase seçenekleri"ni içerir. Gerekli, minimum "Firebase seçenekleri" şunlardır:
API anahtarı : erişim özel kullanıcı verileri gerekmez bazı API'leri çağırıken basit şifrelenmiş dizisi (örneğin değeri:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)
Proje kimliği : Firebase ve Google Cloud tamamında proje için kullanıcı tanımlı bir benzersiz 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 bir kolaylık takma adı olarak ele alınmalıdır. (örnek değeri:
myapp-project-123)
Uygulama numarası ( "Appıd") platforma özel biçimi ile Firebase tamamında Firebase uygulama için benzersiz bir tanımlayıcı:
- Firebase Elma uygulamalar:
GOOGLE_APP_ID(örnek değer:
1:1234567890:ios:321abc456def7890)
Bu bir Apple paketi kimliği değildir.
- Firebase Android uygulamaları:
mobilesdk_app_id(örnek değer:
1:1234567890:android:321abc456def7890)
Bu bir Android paket adı veya Android uygulaması kimliği değil.
- Firebase Web uygulamaları:
appId(örnek değer:
1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
- Firebase Elma uygulamalar:
Uygulamanın platforma özel kimliği (Apple paket kimliği veya Android paket adı) ve API Anahtarı, proje kimliği, Gerçek Zamanlı Veritabanı URL'si ve Cloud Storage paketi adı. Bu göz önüne alındığında, kullanım Firebase Güvenlik Kuralları da verileri ve dosyaları korumak için Gerçek Zamanlı Veritabanı , Bulut Firestore ve Bulut Depolama .
Açık kaynak projeleri 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 kendi Firebase projelerini oluşturmalı ve uygulamalarını kendi Firebase kaynaklarına yönlendirmelidir (kendi Firebase yapılandırmaları aracılığıyla). dosya veya nesne).
Firebase projesini yönetme
Mutlaka inceleyin genel proje düzeyinde en iyi uygulamaları bir Firebase projeyi yönetmek şeklini etkileyebilecek hususlar için (bu sayfanın alt kısmında).
Bir projeyi yönetmek için araçlar
Firebase konsolu
Firebase konsol teklifler Firebase ürünlerini, uygulama ve proje düzeyinde ayarları yönetmek için zengin bir ortam.
Konsolun sol tarafındaki panel, üst düzey kategorilere göre düzenlenen Firebase ürünlerini listeler. Tıklayarak bir projenin ayarları sol yan panel, erişim üst kısmında entegrasyonları , erişim izinlerini ve fatura .. Bir projenin ayarları dahil
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.
Firebase CLI (bir komut satırı aracı)
Firebase da sunmaktadır Firebase CLI Firebase Firebase için Hosting ve Bulut Fonksiyonlar gibi, belirli Firebase ürünlerini yapılandırmak ve yönetmek için.
CLI yükledikten sonra, erişebilir küresel
firebase komutu . İçin CLI Use bir Firebase projesine yerel app dizini link sonra deploy functions yeni Firebase tarafından barındırılan içeriğin sürümlerini veya güncellemeleri.
Firebase Management REST API
Kullanılması Firebase Yönetimi DİNLENME API , programlı bir Firebase projeyi yönetebilir. Örneğin, programlı bir proje ile bir uygulamayı kaydetmek veya zaten kayıtlı olan uygulamaları listeleyebilirsiniz ( iOS + | Android | web ).
Genel en iyi uygulamalar
Bir projeye uygulama ekleme
Bir proje içinde tüm uygulamaların bir son kullanıcı açısından aynı uygulamanın platformu varyantları olduğundan emin olun. Aynı uygulama veya oyunun Apple, Android ve web sürümlerini aynı Firebase projesine kaydetmeniz önerilir. Bir projedeki tüm uygulamalar genellikle aynı Firebase kaynaklarını (veritabanı, depolama paketleri vb.) paylaşır.
Birden inşa farklı paket kimlikleri veya tanımlanmış Android paketi adlarıyla varyantları varsa, ayrı bir Firebase projesi ile her varyasyonunu kaydedebilirsiniz. Ancak, varsa aynı Firebase proje ile bunları kayıt, bu pay aynı Firebase kaynakları varyantları.
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 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 kota sınırı nadiren çoğu geliştiriciler için bir husustur, fakat gerekirse şunları yapabilirsiniz proje kota artışı talebinde .
Bir projenin tamamen silinmesinin 30 gün gerektirdiğini ve proje tamamen silinene kadar proje kotasına sayılacağını 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. Daha fazlası için en iyi uygulamalar hakkında okuyun çoklu kiracılığınız altında.
Hakkında daha fazla bilgi proje başına uygulamalarda sınırı SSS.
Proje başına Barındırma sitesi sayısı
Çoklu özelliğini Barındırma Firebase proje başına 36 sitelerin maksimum destekler.
Çok kiracılık
Mantıken bağımsız birkaç farklı uygulamanın ve/veya web sitesinin tek bir Firebase projesine (genellikle "çoklu kiracılık" olarak adlandırılır) bağlanması önerilmez. Çoklu kiracılık, analitik toplama, paylaşılan kimlik doğrulama, aşırı karmaşık veritabanı yapıları ve güvenlik kurallarıyla ilgili zorluklar gibi istenmeyen sorunlar dahil olmak üzere ciddi yapılandırma ve veri gizliliği sorunlarına yol açabilir.
Uygulamalar bir dizi aynı veri ve yapılandırmaları paylaşmayan Genellikle, güçlü bir farklı Firebase proje ile her uygulamayı kayıt düşünün.
Örneğin, beyaz etiketli bir uygulama geliştirirseniz, bağımsız olarak etiketlenen her uygulamanın kendi Firebase projesi olmalıdır, ancak bu etiketin Apple platformu ve Android sürümleri aynı projede olabilir. Bağımsız olarak etiketlenmiş her uygulama (gizlilik nedenleriyle) verileri başkalarıyla paylaşmamalıdır.
Uygulamanızı başlatma
- Set up bütçe uyarıları Google Bulut Konsolu proje için.
- Monitör Kullanımı ve fatura dashboard birden Firebase hizmetlerinde projenizin kullanım genel bir resim elde etmek Firebase konsolunda.
- İnceleme Firebase fırlatma kontrol listesi .