Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Firebase projelerini anlayın

Bu sayfa, Firebase projeleriyle ilgili birkaç önemli kavramın kısa bir özetini sunar. Mevcut olduğunda, özellikler, hizmetler ve hatta diğer platformlar hakkında daha ayrıntılı bilgi bulmak için bağlantıları takip edin. Bu sayfanın altında, Firebase projeleri için genel en iyi uygulamaların bir listesini bulun.

Firebase projeleri, uygulamaları ve ürünleri arasındaki ilişki

Firebase projesi, Firebase için en üst düzey varlıktır. Bir projede iOS, Android veya web uygulamalarınızı kaydederek Firebase uygulamaları oluşturursunuz. Uygulamalarınızı Firebase'e kaydettikten sonra, Analytics, Cloud Firestore, Performance Monitoring veya Remote Config gibi herhangi bir sayıda Firebase ürünü için Firebase SDK'larını ekleyebilirsiniz.

Başlarken kılavuzlarında ( iOS | Android | web | Unity | C ++ ) bu işlem hakkında daha ayrıntılı bilgi edinin.

Firebase projeleri ile Google Cloud Platform (GCP) arasındaki ilişki

Firebase konsolunda yeni bir Firebase projesi oluşturduğunuzda, aslında perde arkasında bir Google Cloud Platform (GCP) projesi oluşturursunuz . Bir GCP projesini veri, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz. Firebase projesi, Firebase'e özgü ek yapılandırmalar ve hizmetler içeren bir GCP projesidir. Hatta önce bir GCP projesi oluşturabilir, ardından Firebase'i projeye daha sonra ekleyebilirsiniz.

Bir Firebase projesi yana bir GSO bir projedir:

Firebase projesi kurma ve uygulamaları kaydetme

Bir Firebase projesi oluşturabilir ve uygulamaları Firebase konsolunda (veya gelişmiş kullanım durumları için Firebase Management REST API veya Firebase CLI aracılığıyla ) kaydedebilirsiniz . Bir proje kurduğunuzda ve uygulamaları kaydettiğinizde, bazı kurumsal kararlar vermeniz ve yerel projelerinize Firebase'e özel yapılandırma bilgileri eklemeniz gerekir.

Bir proje oluşturmadan ve uygulamaları kaydetmeden önce proje düzeyinde bazı en iyi uygulamaları (bu sayfanın alt kısmında) gözden geçirdiğinizden emin olun.

Proje adı

Bir proje oluşturduğunuzda, bir proje adı sağlarsınız . Bu tanımlayıcı bir proje için yalnızca dahili adıdır Firebase konsolunda , İKU konsolda ve Firebase CLI . Proje adı, herkese açık herhangi bir Firebase veya GCP ürünü, hizmeti veya kaynağında gösterilmez; birden fazla projeyi daha kolay ayırt etmenize 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 projesinin (ve ilişkili GCP projesinin ) bir proje numarası vardır . Bu, proje için Google tarafından küresel olarak atanan benzersiz kanonik 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.

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 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 proje numarasını kullanma hakkında daha fazla bilgi edinin.

Proje numarasını bulun

  • Firebase konsolu: Proje ayarları'nı tıklayın. Proje numarası üst panoda görüntülenir.

  • firebase projects:list CLI: firebase projects:list çalıştırın firebase projects:list . Proje numarası, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.

  • Firebase Management REST API: projects.list çağırın. Yanıt gövdesi, FirebaseProject nesnesindeki proje numarasını içerir.

Proje kimliği

Bir Firebase projesinin (ve ilişkili GCP projesinin ) bir proje kimliği vardır . Bu, tüm Firebase ve GCP'de 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 takma ad olarak ele alınmalıdır.

Bir projeyi silerseniz, proje kimliği de silinir ve başka hiçbir proje tarafından bir daha asla kullanılamaz.

Firebase kaynakları ve proje kimliği

Proje kimliği, herkese açık Firebase kaynaklarında görüntülenir, örneğin:

  • Varsayılan Barındırma alt alanı - PROJECT_ID .web.app ve PROJECT_ID .firebaseapp.com
  • Varsayılan Gerçek Zamanlı Veritabanı URL'si - PROJECT_ID .firebaseio.com
  • Varsayılan Cloud Storage PROJECT_ID .appspot.com 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 alanları Firebase tarafından barındırılan bir siteye bağlayabilir , Gerçek Zamanlı Veritabanını parçalayabilir ve birden çok Cloud Storage paketi oluşturabilirsiniz (platforma özel Başlarken sayfasını ziyaret edin).

Firebase CLI ve proje kimliği

Bazı kullanım durumlarında, aynı yerel uygulama diziniyle ilişkilendirilmiş birden çok 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ı.

Proje kimliklerini hatırlamak zorunda kalmamak için her Firebase projesi için bir proje takma adı da ayarlayabilirsiniz.

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 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 proje numarasını kullanma hakkında daha fazla bilgi edinin.

Proje kimliğini bulun

  • Firebase konsolu: Proje ayarları'nı tıklayın. Proje kimliği, üst bölmede görüntülenir.

  • firebase projects:list CLI: firebase projects:list çalıştırın firebase projects:list . Proje kimliği, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.

  • Firebase Management REST API: projects.list çağırın. Yanıt gövdesi, FirebaseProject nesnesindeki proje kimliğini içerir.

Firebase yapılandırma dosyaları ve nesneleri

Bir Firebase projesine sahip bir uygulamayı 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.

  • GoogleService-Info.plist uygulamaları için bir GoogleService-Info.plist yapılandırma dosyası GoogleService-Info.plist .
  • 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 paketleri vb.) İle 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 gerekli 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 şifreli dize (örnek değer: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • Proje Kimliği : Tüm Firebase ve GCP'de 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 bir kolaylık takma adı olarak ele alınmalıdır. (örnek değer: myapp-project-123 )

  • Uygulama Kimliği ("AppID") : Platforma özel bir biçimde tüm Firebase genelinde Firebase uygulamasının benzersiz tanımlayıcısı:

    • Firebase iOS uygulamaları: GOOGLE_APP_ID (örnek değer: 1:1234567890:ios:321abc456def7890 )
      Bu bir Apple paketi kimliği değildir.
    • mobilesdk_app_id 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 yapılandırma dosyasının veya nesnesinin içeriği, uygulamanın platforma özgü kimliği (iOS paket kimliği veya Android paket adı) ve API Anahtarı, proje kimliği, Gerçek Zamanlı Veritabanı URL'si gibi Firebase projeye özgü değerler ve Depolama paketi adı. Bu göz önüne alındığında, Realtime Database , 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 kendi Firebase projelerini oluşturmalı ve uygulamalarını kendi Firebase kaynaklarına yönlendirmelidir (kendi Firebase dosya veya nesne).

Firebase projesini yönetme

Bir Firebase projesini yönetme şeklinizi etkileyebilecek hususlar için genel proje düzeyindeki en iyi uygulamaları (bu sayfanın alt kısmında) gözden geçirdiğinizden emin olun.

Bir projeyi yönetmek için araçlar

Firebase konsolu

Firebase konsolu , Firebase ürünlerini, uygulamalarını ve proje düzeyindeki ayarları yönetmek için en zengin ortamı sunar.

Firebase konsolu - projeye genel bakış ekranı

Konsolun sol tarafındaki panel, üst düzey kategorilere göre düzenlenmiş Firebase ürünlerini listeler. Tıklayarak bir projenin ayarları sol yan panel, erişim üst kısmında . Bir projenin ayarları entegrasyonları , erişim izinlerini ve faturalandırmayı içerir .

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 kontrol paneline dönüşür.

Firebase CLI (bir komut satırı aracı)

Firebase ayrıca Firebase Hosting ve Firebase için Cloud Functions 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ş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 Management REST API

Firebase Management REST API'yi kullanarak, bir Firebase projesini programlı olarak yönetebilirsiniz. Örneğin, bir uygulamayı bir projeye programlı olarak kaydedebilir veya önceden kaydedilmiş uygulamaları listeleyebilirsiniz ( iOS | Android | web ).

Genel en iyi uygulamalar

Bir projeye uygulama ekleme

Bir projedeki tüm uygulamaların , son kullanıcı açısından aynı uygulamanın platform varyantları olduğundan emin olun . Aynı uygulamanın veya oyunun iOS, Android ve web sürümlerini aynı Firebase projesiyle kaydettirmeniz önerilir. Bir projedeki tüm uygulamalar genellikle aynı Firebase kaynaklarını (veritabanı, depolama paketleri vb.) Paylaşır.

Farklı iOS paket kimliklerine veya tanımlanmış Android paket adlarına sahip birden çok derleme varyantınız varsa her bir varyantı ayrı bir Firebase projesine kaydedebilirsiniz. Ancak, aynı Firebase kaynaklarını paylaşan varyantlarınız varsa bunları aynı Firebase projesine kaydedin.

Bir proje içindeki uygulamaların sayısında herhangi bir kısıtlama olmasa da, bir uygulamanın kaydedilmesi bir veya daha fazla temel OAuth 2.0 istemci kimliği oluşturabilir. Tek bir proje içinde oluşturulabilecek yaklaşık 30 müşteri kimliği sınırı vardır.

Çok kiracılık

Mantıksal olarak bağımsız birkaç farklı uygulamayı ve / veya web sitesini tek bir projeye (genellikle "çoklu kiralama" olarak adlandırılır) bağlamak ö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 dahil olmak üzere ciddi yapılandırma ve veri gizliliği sorunlarına yol açabilir.

Genel olarak, bir dizi uygulama aynı verileri ve yapılandırmaları paylaşmazsa her uygulamayı farklı bir Firebase projesine kaydetmeyi kesinlikle düşünün.

Örneğin, bir beyaz etiket uygulaması geliştirirseniz, bağımsız olarak etiketlenen her uygulamanın kendi Firebase projesi olmalıdır. Her uygulama (gizlilik nedeniyle) verileri başkalarıyla paylaşmaz ve paylaşmamalıdır.

Firebase projeleri, uygulamaları ve siteleri için bazı genel sınırlamalara dikkat edin:

  • Hesap başına proje sayısı

    • Ücretsiz katmanlı Kıvılcım planı - Proje oluşturma kotası, daha az sayıda projeyle sınırlıdır (genellikle 5-10 civarında).
    • Ücretli planlar - Faturalandırma hesabı başına proje oluşturma kotası, ilişkili Bulut faturalandırma hesabı iyi durumda olduğu sürece önemli ölçüde artar.

    Proje oluşturma kotasına ilişkin 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 sürdüğünü ve proje tamamen silinene kadar proje kotasına dahil edildiğini unutmayın.

  • Proje başına uygulama sayısı

    Bir proje içindeki uygulamaların sayısında herhangi bir kısıtlama olmasa da, bir uygulamayı kaydettirmek bir veya daha fazla temel OAuth 2.0 istemci kimliği oluşturabilir. Tek bir proje içinde oluşturulabilecek yaklaşık 30 müşteri kimliği sınırı vardır.

  • 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şlatma