Firebase projelerini anlama

Bu sayfa, Firebase projeleri hakkında bazı önemli kavramlara kısa bir genel bakış 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ı ekleyebilirsiniz.

Platformunuz için Başlarken kılavuzunda bu süreç hakkında daha ayrıntılı bilgi edinin:
iOS+ | Android | web | 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 temel 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 projesinde kayıtlı bir veya daha fazla Firebase Uygulaması 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 projesine kayıtlı tüm Firebase Uygulamaları, proje için sağlanan tüm aynı kaynaklara ve hizmetlere erişime sahiptir . İşte bazı örnekler:

    • Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage ve Cloud Functions gibi aynı Firebase projesine kayıtlı tüm Firebase Uygulamaları aynı arka uçları paylaşır.

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

Tüm Firebase projeleri için, Firebase'in Google Cloud Console'daki projeniz için Etiketler sayfasına otomatik olarak bir firebase:enabled etiketi 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 ayarlayabilir ve Firebase konsolunda (veya gelişmiş kullanım durumları için Firebase Management REST API veya Firebase CLI aracılığıyla) uygulamaları kaydedebilirsiniz. Bir proje kurup uygulamaları kaydettiğinizde, bazı organizasyonel kararlar almanız ve yerel projelerinize Firebase'e özel yapılandırma bilgileri eklemeniz gerekir.

Üretim uygulamaları için, genellikle birden çok ortamın kullanılmasını içeren net bir geliştirme iş akışı oluşturmanız gerekir. Geliştirme iş akışınızı oluşturmak için Firebase projelerini kurmaya ve 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.

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üzenlenmiş Firebase ürünlerini listeler. Sol taraftaki panelin üst kısmında, ayarlar seçeneğine tıklayarak bir projenin 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ü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 Konsolunu 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 sunar.

CLI'yi yükledikten 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 Yönetimi REST API'si

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 gibi 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 Konsolu ve Firebase CLI'daki bir projenin yalnızca dahili adıdır . Proje adı, herkese açık herhangi bir Firebase veya Google Cloud ürününde, hizmetinde veya kaynağında gösterilmez; birden çok 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 onunla ilişkili Google Cloud projesinin ) bir proje numarası vardır. Bu, proje için Google tarafından atanan küresel olarak 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 hiç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'da 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 diğer ad olarak ele alınmalıdır.

Firebase yapılandırma dosyaları ve nesneleri

Bir uygulamayı Firebase projesine kaydettirdiğ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 edinebilirsiniz .

Bir Firebase yapılandırma dosyası veya nesnesi, bir uygulamayı belirli bir Firebase projesi ve kaynakları (veritabanları, depolama grupları vb.) ile ilişkilendirir. Yapılandırma, Firebase ve Google hizmetlerinin Firebase sunucu API'leriyle iletişim kurmak ve istemci verilerini Firebase projesi ve Firebase uygulamasıyla ilişkilendirmek için gerektirdiği parametreler olan "Firebase seçeneklerini" içerir. İşte gerekli, minimum "Firebase seçenekleri":

  • 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'da 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 uygun bir takma ad olarak ele alınmalıdır. (örnek değer: myapp-project-123 )

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

    • 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 )

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 ve Firebase projesine özgü değerler dahil olmak üzere Firebase yapılandırma dosyasının veya nesnesinin içeriği genel kabul edilir. Cloud Storage paket adı. Bu nedenle, verilerinizi ve dosyalarınızı Realtime Database , Cloud Firestore ve Cloud Storage'da 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ın veya nesnesinin kaynak denetimine dahil edilmesini önermiyoruz çünkü çoğu durumda kullanıcılarınızın kendi Firebase projelerini oluşturması ve uygulamalarını kendi Firebase kaynaklarına yönlendirmesi gerekir (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ı

    • Kıvılcım 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ındaki 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 gerektirdiğini ve proje tamamen silinene kadar proje kotasına dahil edildiğini 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 uygulamalar dokümanlarımızda ç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şlatılıyor