Firebase projelerini anlama

Bu sayfada Firebase projeleriyle ilgili birçok önemli kavrama kısa genel bakış sunulmaktadır. Mevcut olduğunda özellikler, hizmetler, araçlar ve en iyi uygulamalar hakkında daha ayrıntılı bilgi edinmek için bağlantıları izleyin.

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

Firebase projesi, Firebase'in en üst düzey varlığıdır. Bir projeye 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.

Platformunuza yönelik Başlangıç ​​kılavuzundan bu süreç hakkında daha ayrıntılı bilgi edinin:
iOS+ | Android | ağ | Birlik | C++ | Çarpıntı .

Firebase projelerinin hiyerarşisini anlama

Proje, kayıtlı uygulamaları ve sağlanan kaynakları ve hizmetleri de dahil olmak üzere bir Firebase projesinin temel hiyerarşisini gösteren diyagram Bu şemada bir Firebase projesinin temel hiyerarşisi gösterilmektedir. İşte temel ilişkiler:

  • Firebase projesi, tüm uygulamalarınız ve proje için sağlanan kaynaklar ve hizmetler için bir kapsayıcı gibidir.

  • Bir Firebase projesinde kayıtlı bir veya daha fazla Firebase Uygulaması bulunabilir (örneğin, bir uygulamanın hem iOS hem de Android sürümleri ya da 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 kaynakların ve hizmetlerin tümüne erişebilir ve bunlara erişebilir . İşte bazı örnekler:

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

    • Aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları aynı Google Analytics mülküyle ilişkilidir; burada her Firebase Uygulaması, o 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, daha sonra Firebase'i projeye ekleyebilirsiniz. Bir Google Cloud projesini veriler, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz.

Firebase'in, tüm Firebase projeleri için Google Cloud Console'daki projenizin Etiketler sayfasına otomatik olarak firebase:enabled etiketini 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 :

Firebase projesi oluşturma ve uygulamaları kaydetme

Bir Firebase projesi oluşturabilir ve uygulamaları Firebase konsoluna kaydedebilirsiniz (veya gelişmiş kullanım örnekleri için Firebase Management REST API veya Firebase CLI aracılığıyla). Bir proje oluşturup uygulamaları kaydettiğinizde bazı organizasyonel kararlar almanız ve Firebase'e özgü yapılandırma bilgilerini yerel projelerinize eklemeniz gerekir.

Üretim uygulamaları için genellikle birden fazla ortamın kullanılmasını içeren net bir geliştirme iş akışı ayarlamanız gerekir. Firebase projeleri oluşturmaya ve geliştirme iş akışınızı oluşturmak için 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.

Firebase projesiyle etkileşim kurma

Ürün SDK'larının yanı sıra birçok farklı araç ve arayüz 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üzenlenmiş Firebase ürünlerini listeler. Sol taraftaki panelin üst kısmında, tıklayarak bir projenin ayarlarına erişin. 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ünlerin istatistiklerini görüntüleyen bir kontrol paneline dönüşür.

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 Hosting, Cloud Functions for Firebase ve Firebase Extensions gibi belirli Firebase ürünlerini yapılandırmak ve yönetmek için Firebase CLI'yi de 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 Yönetimi REST API'si

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

Firebase proje tanımlayıcıları

Bir Firebase projesi, Firebase arka ucunda ve çeşitli geliştirici arayüzlerinde proje adı , proje numarası ve proje kimliği gibi farklı tanımlayıcılar kullanılarak 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ı, herkese açık olarak görülebilen herhangi bir Firebase veya Google Cloud ürününde, hizmetinde veya kaynağında gösterilmez; yalnızca birden fazla projeyi daha kolay ayırt etmenize yardımcı olmaya yarar.

Bir proje adını istediğiniz zaman Firebase konsolunun Proje ayarlarından . 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 global benzersiz standart 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.

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 onunla 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 bunu proje kurulumu sırasında düzenleyebilirsiniz. Bu tanımlayıcı genellikle projeye referans vermek için uygun bir 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 .

Firebase yapılandırma dosyası veya nesnesi, bir uygulamayı belirli bir Firebase projesiyle ve onun kaynaklarıyla (veritabanları, depolama paketleri vb.) 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 gerektirdiği 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 şifrelenmiş 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 referans vermek 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 tamamında platforma özel bir formata sahip 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ğildir .
    • 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 (Apple paket kimliği veya Android paket adı) ve API Anahtarı, proje kimliği, Gerçek Zamanlı Veritabanı URL'si gibi Firebase projesine özgü değerler dahil olmak üzere herkese açık olarak kabul edilir. Cloud Storage paketi adı. Bunu göz önünde bulundurarak, Gerçek Zamanlı Veritabanı , 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ın kendi Firebase projelerini oluşturması ve uygulamalarını kendi Firebase kaynaklarına (kendi Firebase yapılandırmaları aracılığıyla) yönlendirmesi gerekir. 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 sayıda projeyle sınırlıdır (genellikle 5-10 civarında).
    • Blaze fiyatlandırma planı — İlgili Bulut Faturalandırma hesabı iyi durumda olduğu sürece hesap başına proje oluşturma kotası önemli ölçüde artar.

    Proje oluşturma kotasının sınırı çoğu geliştirici için nadiren endişe vericidir, ancak gerekirse proje kotasının artırılmasını talep edebilirsiniz.

    Bir projenin tamamen silinmesinin 30 gün gerektirdiğini ve proje tamamen silinene kadar proje kotasına dahil edileceğini unutmayın.

  • Proje başına uygulama sayısı

    Firebase, bir Firebase projesindeki toplam Firebase Uygulaması sayısını 30 ile sınırlandırır.

    Tek bir Firebase projesindeki 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 belgelerimizde çoklu kiracılık hakkında daha fazla bilgi edinin.

    SSS'den proje başına uygulama sınırı hakkında daha fazla bilgi edinin.

  • 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şlatılıyor