Firebase projelerini anlama

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

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

Firebase projesi, Firebase için üst düzey varlıktır. Bir projede Apple, Android veya web uygulamalarınızı kaydetme. Uygulamalarınızı Firebase SDK'larını istediğiniz sayıda Analytics gibi Firebase ürünleri, Cloud Firestore, Performance Monitoring veya Remote Config.

Başlarken bölümünde bu süreçle ilgili daha ayrıntılı bilgi edinebilirsiniz platformunuz için kılavuz:
iOS+ | Android | web | Unity | C++ | Flutter.

Firebase projelerinin hiyerarşisini anlama

. Bu şema, bir Firebase projesinin temel hiyerarşisini gösterir. Önemli adımlar ilişkiler:

• Firebase projesi tüm uygulamalarınız ve kaynaklarınız için bir kapsayıcı gibidir hizmetleri kapsar.

• Bir Firebase projesine kayıtlı bir veya daha fazla Firebase Uygulaması olabilir (örneğin, bir uygulamanın hem iOS hem de Android sürümleri) ya da hem ücretsiz hem de ücretsiz bir uygulamanın ücretli sürümleri)

• Aynı Firebase projesine kayıtlı tüm Firebase uygulamaları paylaşmak ve proje için sağlanan tüm kaynak ve hizmetlere erişim Aşağıda bazı örnekler verilmiştir:

  • Aynı Firebase projesine kayıtlı tüm Firebase uygulamaları aynı şeyi paylaşır. Firebase Hosting, Authentication, Realtime Database, Cloud Firestore ve Cloud Storage ve Cloud Functions.

  • Aynı Firebase projesine kayıtlı tüm Firebase uygulamaları ilişkilendirilir aynı Google Analytics mülküyle ilişkilendirilir. Burada, her Firebase uygulaması bu mülkte ayrı veri akışı olacak.

Firebase projeleri ile Google Cloud arasındaki ilişki

Yeni bir Firebase projesi oluşturduğunuzda aslında Google Cloud projesi perde arkasında neler yaşandığını görelim. Önce bir Google Cloud projesi bile oluşturabilirsiniz. daha sonra Firebase'i projeye ekleyin. Aklınıza bir Google Cloud projesi geliyor. veri, kod, yapılandırma ve hizmetler için sanal container olarak kullanılır.

Önemli Nokta: Firebase projesi aslında Firebase'e özel ek yapılandırmalar ve hizmetler etkin.

Firebase, tüm Firebase projeleri için otomatik olarak firebase:enabled içinde Etiketler sayfası Google Cloud Console'da görüntüleyebilirsiniz. Bu etiket hakkında daha fazla bilgi için: SSS bölümüne göz atın.

Firebase projesi bir Google Cloud projesi olduğu için:

• Bir projeyle Firebase konsolunda ve aynı zamanda "the" Google Cloud konsolu ve Google API'leri konsolunda bulabilirsiniz.

• Hem Firebase hem de Google Cloud ürünlerini ve API'lerini belirler.

• Faturalandırma ve bir projenin izinleri Firebase ve Google Cloud.

• Projenin benzersiz tanımlayıcıları (ör. proje numarası ve proje kimliği) Firebase ve Google Cloud arasında paylaşılır.

• Silinen bir proje Firebase ve Google Cloud genelinde silinir.

Firebase projesi oluşturma ve uygulamaları kaydetme

Firebase konsolunda Firebase projesi oluşturabilir ve uygulamaları kaydedebilirsiniz (veya gelişmiş kullanım alanları için Firebase Management REST API veya Firebase KSA). Bir proje oluştururken ve uygulamaları kaydettirdikten sonra, bazı kurumsal kararlar vermeniz ve Yerel projelerinize Firebase'e özel yapılandırma bilgileri ekleyin.

Üretim uygulamaları için net bir geliştirme iş akışı oluşturmanız gerekir. Bu da genelde birden fazla ortam kullanmayı içerir. Şu konudaki dokümanlarımızı inceleyin: geliştirici iş akışlarını ve dahil genel en iyi uygulamalar ve genel güvenlik yönergelerini Firebase projeleri oluşturmak ve geliştirme sürecinizi oluşturmak üzere uygulama kaydetmek için iş akışını takip edin.

Firebase projesiyle etkileşim kurma

Ürün SDK'larının yanı sıra bir Firebase projesiyle de doğrudan etkileşimde bulunabilirsiniz. birkaç farklı araç ve arayüz kullanarak.

Firebase konsolu

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

Konsolun sol tarafındaki panelde, Firebase ürünleri üst düzey kategorilere ayırın. Sol panelin üst kısmından bir projenin Ayarlar'ı tıklayın. Projenin ayarlar şunları içerir: entegrasyonlardan erişim izinleri, ve faturalandırma ile ilgili daha fazla bilgiyi kullanabilirsiniz.

Konsolun ortasında, kullanıcıların izlemesi için kurulum iş akışlarını başlatan farklı türlerde uygulamaları kaydetme. Firebase'i kullanmaya başladıktan sonra ana her bir kontrol paneli aracılığıyla, yayınladığınız ürünlere ilişkin istatistikleri pek de iyi olmadığını unutmayın.

Firebase projesi aynı zamanda bir Google Cloud projesi olduğundan, çeşitli görevlerin veya ürünlerin Google Cloud konsolunu kullanmaya başladım.

Firebase CLI (komut satırı aracı)

Firebase, Google Analytics 360'ı kullanarak yapılandırma ve Firebase Hosting gibi belirli Firebase ürünlerini yönetmek, Cloud Functions for Firebase ve Firebase Extensions.

CLI'yı yükledikten sonra global firebase komutuyla çalışır. KSA'yı şu işlemler için kullanın: yerel uygulama dizininizi bir Firebase projesi, ardından Firebase tarafından barındırılan içeriklerin yeni sürümlerini dağıtın veya fonksiyon güncellemeleri yapıldı.

Firebase Management REST API'si

Her bir Firebase Management REST API'yi kullanarak şunları yapabilirsiniz: Firebase projesini programatik olarak yönetebilirsiniz. Örneğin, şunları yapabilirsiniz: bir projeye programatik olarak kaydedebilir veya zaten kayıtlı (iOS+ | Android | web) kullanıyor.

Firebase proje tanımlayıcıları

Firebase projesi, Firebase arka ucunda ve farklı bölümlerde tanımlanabilir. proje adı dahil olmak üzere farklı tanımlayıcılar kullanan geliştirici arayüzleri proje numarası ve proje kimliği girilmelidir.

Önemli Nokta: Proje numarası ve proje kimliği, bir projenin gerçekten benzersiz tanımlayıcılarıdır

Projenin adı

Proje oluşturduğunuzda bir proje adı sağlarsınız. Bu tanımlayıcı bir projenin yalnızca dahili adı Firebase konsolunda, Google Cloud konsolunuza ve Firebase CLI'yı kullanın. Proje adı herkes tarafından görülebilen Firebase veya Google Cloud ürünü, hizmeti ya da kaynağı; o birden fazla projeyi daha kolay ayırt etmenize yardımcı olur.

Bir proje adını istediğiniz zaman Projesi ayarlarını Firebase konsolu. Proje adı üst bölmede görüntülenir.

Proje numarası

Firebase projesi (ve ilişkili Google Cloud projesi) proje numarası. Bu, Google tarafından atanmış global olarak benzersiz standart URL'dir tanımlayıcısını kullanabilirsiniz. Entegrasyonları yapılandırırken bu tanımlayıcıyı kullanın ve/veya Firebase, Google ya da üçüncü taraf hizmetlerine API çağrıları yapmak.

Proje numarasını düzenleyemezsiniz. Bir projeyi silerseniz proje numarası silinir ve bir daha başka proje tarafından kullanılamaz.

Proje numarasını bulun

Aşağıdaki seçeneklerden birini kullanarak Firebase projenizin proje numarasını bulun:

• Firebase konsolunu kullanarak: Proje Ayarlar'a gidin. İlgili içeriği oluşturmak için kullanılan proje numarası üst bölmede görüntülenir.

• Firebase CLI'ı kullanma: firebase projects:list komutunu çalıştırın. Proje numarası, hesap.

• Firebase Management REST API'yi kullanma: Çağrı projects.list. Yanıt gövdesi, FirebaseProject nesnesini tanımlayın.

API çağrıları ve proje numarası

Birçok API çağrısına projeye benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API proje kimliğini kabul etse de Firebase, Google veya üçüncü taraf hizmetleri.

Proje tanımlayıcılarını, özellikle de proje numarasını şurada kullanma hakkında daha fazla bilgi edinin: Google'ın AIP 2510 standardı.

Proje kimliği

Firebase projesi (ve ilişkili Google Cloud projesi) proje kimliğine tabidir. Bu tanımlayıcı, projenin tüm ilgili Firebase'i ve Google Cloud'u kullanabilirsiniz. Bir Firebase projesi oluşturduğunuzda Firebase, projeye otomatik olarak benzersiz bir kimlik atar, ancak bunu sırasında düzenleyebilirsiniz en iyi uygulamaları paylaşacağım. Bu tanımlayıcı, genellikle kolaylık sağlamak için düşünülmelidir. takma adı verilmiştir.

Firebase, Firebase için kaynakları sağladıktan sonra projenin kimliğini değiştiremezsiniz. Bir projeyi silerseniz proje kimliği de silinir ve bir daha hiçbir zaman başka bir proje tarafından kullanılamaz.

Proje kimliğini bulma

Aşağıdaki seçeneklerden birini kullanarak Firebase projenizin proje kimliğini bulun:

• Firebase konsolunu kullanarak: Proje Ayarlar'a gidin. İlgili içeriği oluşturmak için kullanılan proje kimliği üst bölmede görüntülenir.

• Firebase CLI'ı kullanma: firebase projects:list komutunu çalıştırın. Proje kimliği hesap.

• Firebase Management REST API'yi kullanma: Çağrı projects.list. Yanıt gövdesi, FirebaseProject nesnesini tanımlayın.

Firebase kaynakları ve proje kimliği

Proje kimliği, herkese açık Firebase kaynaklarında gösterilir. Örneğin:

• Varsayılan Hosting alt alan adı: PROJECT_ID.web.app ve PROJECT_ID.firebaseapp.com
• Varsayılan Realtime Database URL'si: PROJECT_ID-default-rtdb.firebaseio.com veya PROJECT_ID-default-rtdb.REGION_CODE.firebasedatabase.app
• Varsayılan Cloud Storage paketi adı: PROJECT_ID.appspot.com

Yukarıda belirtilen kaynakların tümü için varsayılan olmayan örnekler oluşturabilirsiniz. Varsayılan olmayanların herkes tarafından görülebilen adları tamamen özelleştirilebilir. Şunları yapabilirsiniz: özel alanları Firebase tarafından barındırılan bir siteye bağlayın. Realtime Database'i parçalama ve birden fazla Cloud Storage paketi oluşturun ( platforma özgü Başlarken sayfası) kaldırın.

Firebase, bir Firebase projesinin proje kimliğini değiştiremezsiniz. Belirli bir Firebase kaynakları için tanımlayıcı kullanıyorsanız projenin ilk aşamasıdır.

Firebase CLI ve proje kimliği

Bazı kullanım alanları için aynı yerel uygulama dizininde bulabilirsiniz. Böyle durumlarda, Firebase CLI ile birlikte --project işaretini Etkileşim kurmak istediğiniz Firebase projesini bildirmek için firebase komutları somut olarak ortaya koyar.

Ayrıca her bir kuruluş için proje takma adı da belirleyebilirsiniz Böylece proje kimliklerini hatırlamak zorunda kalmazsınız.

API çağrıları ve proje kimliği

Birçok API çağrısına projeye benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API proje kimliğini kabul etse de Firebase, Google ve Firebase'e API çağrıları yapmak için kullanılan proje numarası veya üçüncü taraf hizmetlerini kullanabilir.

Proje tanımlayıcılarını, özellikle de proje numarasını şurada kullanma hakkında daha fazla bilgi edinin: Google'ın AIP 2510 standardı.

Firebase yapılandırma dosyaları ve nesneleri

Bir uygulamayı Firebase projesine kaydettiğinizde Firebase konsolu bir Firebase yapılandırma dosyası (Apple/Android uygulamaları) veya nesne (web uygulamaları) içerir.

• 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, uygulamanın Firebase yapılandırma dosyasını veya nesnesini edinme.

Not: Flutter uygulamalarında platformlar arası Firebase kullanabilirsiniz. firebase_options.dart adlı yapılandırma dosyası.
. Flutter uygulamalarınız bu dosyayı kullanıyorsa güncel tutmak için Flutter proje dizininizden flutterfire configure.

Firebase'in Firebase'e kayıtlı Flutter uygulamaları, flutterfire configure --out=my_options.dart.

Bir Firebase yapılandırma dosyası veya nesnesi, uygulamayı belirli bir Firebase ile ilişkilendirir proje ve kaynakları (veritabanları, depolama paketleri vb.) temel alınır. Yapılandırma ve Firebase'in gerektirdiği parametreler olan "Firebase seçenekleri"ni içerir. Firebase sunucu API'leriyle iletişim kurmak ve istemciyi ilişkilendirmek için verilerini Firebase projesiyle ve Firebase uygulamasıyla ilişkilendirebilirsiniz. Bunlar, izin verilen minimum ve zorunlu "Firebase seçenekleri":

• API anahtarı: Basit bir erişmesi gerekmeyen belirli API'leri çağırırken kullanılan şifrelenmiş dize gizli kullanıcı verileri (örnek değer: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

• Proje Kimliği: kullanıcı tanımlı bir projenin Firebase ve Google Cloud genelinde benzersiz bir tanımlayıcısıdır. Bu tanımlayıcı, bazı Firebase kaynaklarının URL'lerinde veya adlarında görünebilir ancak bu ad, genellikle, alan adına başvuran belirler. (örnek değer: myapp-project-123)

• Uygulama Kimliği ("AppID"): Firebase uygulaması için benzersiz tanımlayıcıdır tüm Firebase için aynı formatı kullanabilirsiniz:

  • Firebase Apple uygulamaları: GOOGLE_APP_ID (örnek değer: 1:1234567890:ios:321abc456def7890)
    Bu bir Apple paket kimliği değildir.
  • 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)

ziyaret edin.

Dikkat: Bir uygulamanın Firebase yapılandırma dosyasını manuel olarak değiştirmenizi veya nesnesini tanımlayın. Bunlardan herhangi biri için geçersiz veya eksik değerlerle bir uygulamayı başlatırsanız "Firebase seçenekleri"ni zorunlu kılmıyorsa son kullanıcılarınız ciddi sorunlarla karşılaşabilir.

Firebase yapılandırma dosyasının veya nesnesinin içeriği herkese açık olarak kabul edilir. uygulamanın platforma özgü kimliği (Apple paket kimliği veya Android paket adı) ve Firebase projesine özgü değerleri (ör. API Anahtarı, proje kimliği, Realtime Database URL'si ve Cloud Storage paket adı. Yani, Firebase Güvenlik Kuralları'nı kullanarak Gerçek Zamanlı Veritabanı Cloud Firestore, ve Cloud Storage.

Açık kaynak projeleri için genellikle uygulamanın Kaynak kontrolündeki Firebase yapılandırma dosyasını veya nesnesini kullanıcılar kendi Firebase projelerini oluşturmalı ve uygulamalarını Firebase yapılandırma dosyaları veya nesneleri aracılığıyla, Firebase'e sahip olamaz.

Firebase projeleri, uygulamaları ve siteleri için genel sınırlar

Önemli: Lütfen genel en iyi uygulamalar . Bu kılavuzda Firebase ile ilgili sorular yanıtlanmaktadır. uygulama varyantlarınızı kaydetme ve çok kiracılı yapı gibi konuları ele aldık.

Firebase projeleri, uygulamaları ve siteleri için bazı genel sınırlar aşağıda belirtilmiştir:

• Hesap başına proje sayısı

  • Spark fiyatlandırma planı - Proje oluşturma kotası daha düşük bir sayıyla sınırlıdır (genellikle 5-10 civarındadır)
  • Blaze fiyatlandırma planı: Hesap başına proje oluşturma kotasındaki artışlar olduğu müddetçe, ilişkili Cloud Faturalandırma Hesabı iyi durumdasınız.

  Proje oluşturma kotasıyla ilgili sınır, çoğu geliştiriciyi nadiren ilgilendirir. ancak gerekirse reklamınızın kullanım süresinde proje kotası ekleyin.

  Bir projenin tamamen silinmesi için 30 gün gerektiğini ve bir projenin proje tam olarak silinene kadar proje kotasını aşmamalıdır.

• Proje başına uygulama sayısı

  Firebase, bir Firebase projesindeki toplam Firebase Uygulamaları sayısını kısıtlar 30'a kadar.

  Tek bir Firebase projesindeki tüm Firebase uygulamalarının doğru olduğundan emin olmalısınız. son kullanıcı açısından bakıldığında aynı uygulamanın platform varyantları Okunanlar hakkında daha fazla bilgi çok kiracılı yapı en iyi uygulamalar belgelerimize göz atın.

  Şu konu hakkında daha fazla bilgi edinin: proje başına uygulama sınırını SSS bölümünde bulabilirsiniz.

• Proje başına Barındırma sitesi sayısı

  Firebase Hosting çoklu site özelliği proje başına maksimum 36 siteyi desteklemektedir.

Uygulamanızı kullanıma sunma

• Bütçe ayarlama uyarılar Google Cloud Console'da görüntüleyebilirsiniz.
• Kullanımı ve faturalandırmayı izleme kontrol paneli Firebase konsolunda projenizin genel görünümüne birden fazla Firebase hizmetinde nasıl kullanıldığını gösterir.
• Firebase lansmanı kontrol listesini inceleyin.