Google 致力于为黑人社区推动种族平等。查看具体举措

Firebase projelerini anlama

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 iOS, 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.

Başlarken kılavuzlarında Bu işlem hakkında daha detaylı bilgi edinin ( iOS | Android | web | Birlik | C ++ ).

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 projesi yana bir Google Cloud projedir:

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.

  • Firebase Yönetimi REST API: Çağrı projects.list . Yanıt gövde proje sayı içerir FirebaseProject nesne.

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.app ve PROJECT_ID .firebaseapp.com
  • Standart Gerçek Zamanlı Veri Tabanı URL - PROJECT_ID -default-rtdb.firebaseio.com veya 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 Yönetimi REST API: Çağrı projects.list . Yanıt gövde proje kimliği içeren FirebaseProject nesne.

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ı (iOS/Android uygulamaları) veya bir yapılandırma nesnesi (web uygulamaları) sağlar.

  • İOS uygulamalarında, bir ekleme GoogleService-Info.plist yapılandırma dosyası.
  • Android uygulamaları, bir eklemek google-services.json yapı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 IOS 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 )

Uygulamanın platforma özel kimliği (iOS 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.

Firebase konsolu - projeye genel bakış ekranı

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 . Bir projenin ayarları dahil entegrasyonları , erişim izinlerini ve fatura .

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 kullanın bir Firebase projesi için yerel uygulama dizini bağlamak , ardından dağıtmak işlevlerine 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 iOS, 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ı iOS kimlikleri veya tanımlanmış Android paketi adları paket ile 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 iOS 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