Firebase projelerini anlama

Bu sayfada, Firebase projeleriyle ilgili çeşitli önemli kavramlara kısaca göz atabilirsiniz. Mevcut olduğunda, özellikler, hizmetler, araçlar ve en iyi uygulamalar hakkında daha ayrıntılı bilgi edinmek için bağlantıları takip edin.

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

Firebase projesi, Firebase'in üst düzey öğesidir. Bir projede Apple, Android veya web uygulamalarınızı kaydedebilirsiniz. Uygulamalarınızı Firebase'e kaydettikten sonra Analytics, Cloud Firestore, Performance Monitoring veya Remote Config gibi dilediğiniz sayıda Firebase ürünü için Firebase SDK'larını ekleyebilirsiniz.

Bu süreç hakkında daha ayrıntılı bilgi edinmek için platformunuzun Başlangıç Kılavuzu'na göz atın:
iOS+ | Android | web | Unity | C++ | Flutter.

Firebase projelerinin hiyerarşisini anlama

Proje, kayıtlı uygulamaları, temel hazır kaynaklar ve hizmetler dahil olmak üzere Firebase projesinin temel hiyerarşisini gösteren şema Bu şemada, bir Firebase projesinin temel hiyerarşisi gösterilmektedir. Temel ilişkiler şunlardır:

  • Firebase projesi, tüm uygulamalarınızın ve proje için temel hazırlığı yapılan tüm kaynakların ve hizmetlerin kapsayıcısı gibidir.

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

  • Aynı Firebase projesine kayıtlı tüm Firebase uygulamaları, proje için sağlanan tüm kaynakları ve hizmetleri paylaşır ve bunlara erişebilir. Aşağıda bazı örnekler verilmiştir:

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

    • Aynı Firebase projesine kayıtlı tüm Firebase uygulamaları aynı Google Analytics mülküyle ilişkilendirilir. Bu mülkte her Firebase uygulaması ayrı bir veri akışıdır.

Firebase projeleri ile Google Cloud arasındaki ilişki

Yeni bir Firebase projesi oluşturduğunuzda aslında arka planda bir Google Cloud projesi oluşturursunuz. Dilerseniz önce bir Google Cloud projesi oluşturup daha sonra Firebase'i projeye ekleyebilirsiniz. Google Cloud projelerini veri, 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 konsolundaki projenize Etiketler sayfasında otomatik olarak firebase:enabled etiketi eklediğini unutmayın. Bu etiket hakkında daha fazla bilgiyi SSS sayfamızda bulabilirsiniz.

Firebase projeleri Google Cloud projesi olduğundan:

  • Projeye Firebase konsolundan, Google Cloud konsolundan ve Google API'leri konsolundan erişebilir ve projeyle etkileşim kurabilirsiniz.

  • Firebase CLI, gcloud CLI ve Google'ın herhangi bir Terraform kaynağını kullanarak projeyle etkileşim kurabilirsiniz.

  • Projede hem Firebase hem de Google Cloud'teki ürünleri ve API'leri kullanabilirsiniz.

  • Projenin IAM izinleri ve rolleri Firebase ile Google Cloud arasında paylaşılır. Bir proje üyesinin (yani asıl kullanıcının) Google Cloud projenize sahip olduğu tüm erişimler Firebase projeniz için de geçerlidir (ve bunun tersi de geçerlidir).

  • Projenin faturalandırması Firebase ile Google Cloud arasında paylaşılır. Google Cloud projenizde faturalandırma etkinse Firebase projeniz Firebase'in kullandıkça öde Blaze fiyatlandırma planında olur.

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

  • Google Cloud projenize uygulanan tüm kaynak hiyerarşileri (ör. kuruluş, klasörler vb.) Firebase projenize de uygulanır.

  • Proje silindiğinde Firebase ve Google Cloud'te de silinir.

  • Projedeki bir kaynağın veya verilerin silinmesi ya da değiştirilmesi, Firebase ve Google Cloud için geçerlidir.

Firebase projesi oluşturma ve uygulamaları kaydetme

Firebase konsolunda Firebase projesi oluşturabilir ve uygulama kaydedebilirsiniz (veya ileri seviye kullanım alanları için Firebase Management REST API veya Firebase CLI üzerinden). Proje oluşturup uygulamaları kaydettiğinizde bazı kuruluş kararları almanız ve yerel projelerinize Firebase'e özgü yapılandırma bilgileri eklemeniz gerekir.

Üretim uygulamaları için genellikle birden fazla ortamın kullanılmasını gerektiren net bir geliştirme iş akışı oluşturmanız gerekir. Geliştirme iş akışınızı oluşturmak için Firebase projeleri oluşturma ve uygulama kaydettirme ile ilgili genel en iyi uygulamalar ve genel güvenlik yönergeleri dahil olmak üzere geliştirici iş akışları ile ilgili dokümanlarımızı inceleyin.

Firebase projesiyle etkileşim kurma

Ürün SDK'larının yanı sıra çeşitli farklı araç ve arayüzleri kullanarak Firebase projeleriyle doğrudan etkileşime geçebilirsiniz.

Firebase konsol

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

Konsolu sol tarafındaki panelde, üst düzey kategorilere göre düzenlenmiş Firebase ürünleri listelenir. Sol panelin üst kısmında simgesini tıklayarak proje ayarlarına erişin. Proje ayarlarında entegrasyonlar, erişim izinleri ve faturalandırma yer alır.

Console'un ortasında, çeşitli uygulama türlerini kaydettirmek için kurulum iş akışlarını başlatan düğmeler gösterilir. Firebase'i kullanmaya başladıktan sonra konsolun ana alanı, kullandığınız ürünlerle ilgili istatistikleri gösteren bir kontrol paneline dönüşür.

Firebase projeleri aynı zamanda Google Cloud projeleri olduğundan, çeşitli görevler veya ürünler için Firebase konsolu yerine Google Cloud konsolunu kullanmanız gerekebileceğini unutmayın.

Firebase KSA (komut satırı aracı)

Firebase, Firebase Hosting, Cloud Functions for Firebase ve Firebase Extensions gibi belirli Firebase ürünlerini yapılandırma ve yönetmek için Firebase CLI'yi de sunar.

KSA'yı yükledikten sonra genel firebase komutuna erişebilirsiniz. Yerel uygulama dizininizi bir Firebase projesine bağlamak ve ardından Firebase tarafından barındırılan içeriğin yeni sürümlerini veya işlev güncellemelerini dağıtmak için KSA'yı kullanın.

Firebase Management REST API

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

Firebase proje tanımlayıcılar

Firebase projeleri, 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ı

Proje oluştururken bir proje adı belirtirsiniz. Bu tanımlayıcı, Firebase konsolu, Google Cloud konsolu ve Firebase CLI'de bir projenin yalnızca dahili adı'dır. Proje adı, herkese açık herhangi bir Firebase veya Google Cloud ürünü, hizmeti ya da kaynağında gösterilmez. Yalnızca birden fazla projeyi daha kolay ayırt etmenize yardımcı olur.

Proje adlarını dilediğiniz zaman Firebase konsolunun Proje ayarları bölümünden düzenleyebilirsiniz. Proje adı üst bölmede gösterilir.

Proje numarası

Firebase projelerinin (ve ilişkili Google Cloud projelerinin) proje numarası vardır. Bu, proje için Google tarafından atanan, dünya genelinde benzersiz olan standart tanımlayıcıdır. Entegrasyonları yapılandırırken ve/veya Firebase, Google ya da üçüncü taraf hizmetlere API çağrıları yaparken bu tanımlayıcıyı kullanın.

Proje numarasını düzenleyemezsiniz. Sildiğiniz projelerin numaraları da silinir ve başka bir proje tarafından hiçbir zaman kullanılamaz.

Proje kimliği

Firebase projelerinin (ve ilişkili Google Cloud projelerinin) proje kimliği vardır. Bu, Firebase ve Google Cloud genelinde proje için kullanıcı tanımlı benzersiz bir tanımlayıcıdır. Firebase bir proje oluşturduğunuzda projeye otomatik olarak benzersiz bir kimlik atar ancak projeyi ayarlarken bu kimliği düzenleyebilirsiniz. Bu tanımlayıcı, projeye referans vermek için genellikle ayırt edici bir takma ad olarak düşünülmelidir.

Firebase yapılandırma dosyaları ve nesneleri

Bir uygulamayı Firebase projesine kaydettiğinizde Firebase konsolu, doğrudan yerel uygulama dizininize eklediğiniz bir Firebase yapılandırma dosyası (Apple/Android uygulamaları) veya yapılandırma nesnesi (web uygulamaları) sağlar.

  • Apple uygulamaları için GoogleService-Info.plist yapılandırma dosyası ekleyin.
  • Android uygulamaları için google-services.json yapılandırma dosyası ekleyin.
  • Web uygulamaları için bir Firebase yapılandırma nesnesi eklersiniz.

Dilediğiniz zaman bir uygulamanın Firebase yapılandırma dosyasını veya nesnesini edinebilirsiniz.

Firebase yapılandırma dosyası veya nesnesi, bir uygulamayı belirli bir Firebase projesiyle ve projenin kaynaklarıyla (veritabanları, depolama alanları vb.) ilişkilendirir. Yapılandırma, Firebase ve Google hizmetlerinin Firebase sunucu API'leriyle iletişim kurması ve istemci verilerini Firebase projesi ve Firebase uygulamasıyla ilişkilendirmesi için gereken parametreler olan "Firebase seçenekleri"ni içerir. Gerekli minimum "Firebase seçenekleri" şunlardır:

  • API anahtarı: Gizli 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: Firebase ve Google Cloud'in tamamında proje için kullanıcı tanımlı benzersiz tanımlayıcı. Bu tanımlayıcı, bazı Firebase kaynaklarının URL'lerinde veya adlarında gösterilebilir ancak genel olarak projeye referans veren ayırt edici bir takma ad olarak düşünülmelidir. (örnek değer: myapp-project-123)

  • Uygulama kimliği ("AppID"): Firebase'in tamamında platforma özel bir biçimde Firebase uygulamasının benzersiz tanımlayıcısıdır:

    • 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, 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, Realtime Database URL'si ve Cloud Storage paket adı gibi Firebase projesine özgü değerler dahil olmak üzere herkese açık kabul edilir. Bu nedenle, Realtime Database, Cloud Firestore ve Cloud Storage'deki verilerinizi ve dosyalarınızı korumak için Firebase Security Rules'u kullanın.

Açık kaynak projelerde, kullanıcılarınızın çoğu durumda kendi Firebase projelerini oluşturması ve uygulamalarını kendi Firebase kaynaklarına (kendi Firebase yapılandırma dosyaları veya nesneleri aracılığıyla) yönlendirmesi gerektiğinden, uygulamanın Firebase yapılandırma dosyasını veya nesnesini kaynak denetimine dahil etmeyi genellikle önermeyiz.

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

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

  • Google Hesabı (e-posta adresi) başına proje sayısı

    • Spark fiyatlandırma planı: Proje oluşturma kotası, az sayıda projeyle (genellikle 5-10) sınırlıdır.
    • Blaze fiyatlandırma planı: Proje oluşturma kotası sınırlı olsa da iyi durumdaki bir Cloud Billing hesabının bağlanmasıyla artabilir.

    Proje oluşturma kotasıyla ilgili sınır, çoğu geliştirici için nadiren sorun teşkil eder. Ancak gerekirse proje kotasında artış isteğinde bulunabilirsiniz.

    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ı

    Firebase, bir Firebase projesindeki toplam Firebase uygulaması sayısını 30 ile sınırlar.

    Tek bir Firebase projesindeki tüm Firebase uygulamalarının, son kullanıcı açısından aynı uygulamanın platform varyantları olduğundan emin olmanız gerekir. En iyi uygulamalar dokümanlarımızda çok kiralılık hakkında daha fazla bilgi edinin.

    Proje başına uygulama sınırı hakkında daha fazla bilgiyi SSS bölümünde bulabilirsiniz.

  • Proje başına Hosting sitesi sayısı

    Firebase Hosting çok siteli özellik, proje başına en fazla 36 siteyi destekler.

Uygulamanızı başlatma