查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

Firebase projelerini anlama

Bu sayfa, Firebase projeleriyle ilgili birkaç önemli kavramın kısa bir özetini 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ını ekleyebilirsiniz.

Platformunuz için Başlarken kılavuzunda bu süreç hakkında daha ayrıntılı bilgi edinin:
iOS+ | Android | | birlik | C++ | çarpıntı

Firebase projelerinin hiyerarşisini anlama

Proje, kayıtlı uygulamaları ve sağlanan kaynakları ve hizmetleri dahil olmak üzere bir Firebase projesinin temel hiyerarşisini gösteren diyagram Bu şema, bir Firebase projesinin temel hiyerarşisini gösterir. İşte kilit 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 projesi, kendisine kayıtlı bir veya daha fazla Firebase Uygulamasına sahip 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 proje paylaşımına kayıtlı tüm Firebase Uygulamaları, proje için sağlanan tüm aynı kaynaklara ve hizmetlere erişime sahiptir . İşte bazı örnekler:

    • Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları, Firebase Barındırma, Kimlik Doğrulama, Gerçek Zamanlı Veritabanı, Bulut Firestore, Bulut Depolama ve Bulut İşlevleri gibi aynı arka uçları paylaşır.

    • Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları, her bir Firebase Uygulamasının o mülkte ayrı bir veri akışı olduğu aynı Google Analytics mülküyle ilişkilendirilir.

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 projeye Firebase'i ekleyebilirsiniz. Bir Google Cloud projesini veri, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz.

Firebase projesi bir Google Cloud projesi olduğundan:

Bir Firebase projesi oluşturma ve uygulamaları kaydetme

Bir Firebase projesi oluşturabilir ve uygulamaları Firebase konsolunda (veya ileri düzey kullanım durumları için Firebase Management REST API veya Firebase CLI aracılığıyla) kaydedebilirsiniz. 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.

Üretim uygulamaları için, genellikle birden çok ortam kullanmayı içeren net bir geliştirme iş akışı ayarlamanız gerekir. Geliştirme iş akışınızı oluşturmak için Firebase projelerini ayarlamak ve uygulamaları kaydetmek için genel en iyi uygulamalar ve genel güvenlik yönergeleri 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.

Firebase konsolu - projeye genel bakış ekranı

Konsolun sol tarafındaki panel, üst düzey kategorilere göre düzenlenen Firebase ürünlerini listeler. Sol taraftaki panelin üst kısmında, ayarlar öğesine tıklayarak bir projenin erişin. Bir projenin ayarları arasında entegrasyonlar , erişim izinleri ve faturalandırma bulunur.

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 Console'u 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'yi sunar.

CLI'yi kurduktan 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 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 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 dahil olmak üzere 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 Console ve Firebase CLI'deki bir projenin yalnızca dahili adıdır . 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.

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 ilişkili Google Cloud projesinin ) 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.

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.

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

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 .

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ı : ö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 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 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 özgü bir biçimde tüm Firebase genelinde Firebase uygulaması için 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ğil .
    • Firebase Web uygulamaları: appId (örnek değer: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

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ı. Bunu göz önünde bulundurarak, 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 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 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 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ı sınırı, çoğu geliştirici için nadiren endişe kaynağıdır, ancak gerekirse proje kotasında artış talep edebilirsiniz.

    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. En iyi uygulama belgelerimizden ç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şlatma