Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Firebase projelerini anlayın

Bu sayfa, Firebase projeleriyle ilgili birkaç önemli kavramın kısa bir özetini sunar. Mevcut olduğunda, özellikler, hizmetler ve hatta diğer platformlar hakkında daha ayrıntılı bilgi bulmak için bağlantıları takip edin. Bu sayfanın altında, Firebase projeleri için genel en iyi uygulamaların bir listesini bulun.

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

Firebase projesi, Firebase için en üst düzey varlıktır. Bir projede iOS, Android veya web uygulamalarınızı kaydederek Firebase uygulamaları oluşturursunuz. Uygulamalarınızı Firebase'e kaydettikten sonra, Analytics, Cloud Firestore, Performance Monitoring veya Remote Config gibi herhangi bir sayıda Firebase ürünü için Firebase SDK'larını ekleyebilirsiniz.

Başlarken kılavuzlarında ( iOS | Android | web | Unity | C ++ ) bu işlem hakkında daha ayrıntılı bilgi edinin.

Firebase projeleri ve Google Cloud arasındaki ilişki

Firebase konsolunda yeni bir Firebase projesi oluşturduğunuzda, aslında perde arkasında bir Google Cloud projesi oluşturuyorsunuz. Bir Google Cloud projesini veri, kod, yapılandırma ve hizmetler için sanal bir kapsayıcı olarak düşünebilirsiniz. Firebase projesi, Firebase'e özgü ek yapılandırmalar ve hizmetler içeren bir Google Cloud projesidir. Hatta önce bir Google Cloud projesi oluşturabilir, daha sonra projeye Firebase ekleyebilirsiniz.

Bir Firebase projesi yana bir Google Cloud projedir:

Firebase projesi kurma ve uygulamaları kaydetme

Bir Firebase projesi oluşturabilir ve uygulamaları Firebase konsolunda (veya gelişmiş kullanım durumları için Firebase Management REST API veya Firebase CLI aracılığıyla ) kaydedebilirsiniz . Bir proje kurduğunuzda ve uygulamaları kaydettiğinizde, bazı kurumsal kararlar vermeniz ve yerel projelerinize Firebase'e özel yapılandırma bilgileri eklemeniz gerekir.

Bir proje oluşturmadan ve uygulamaları kaydetmeden önce genel proje düzeyindeki bazı en iyi uygulamaları (bu sayfanın altında) gözden geçirdiğinizden emin olun.

Proje adı

Bir proje oluşturduğunuzda, bir proje adı sağlarsınız . Bu tanımlayıcı bir proje için yalnızca dahili adıdır Firebase konsolunda , Google Cloud Console ve Firebase CLI . Proje adı, herkes tarafından görülebilen herhangi bir Firebase veya Google Cloud ürünü, hizmeti veya kaynağında gösterilmez; birden fazla projeyi daha kolay ayırt etmenize yardımcı olur.

Sen herhangi bir zamanda bir proje adı düzenleyebilir Proje ayarları Firebase konsolunun. 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 olarak benzersiz kanonik 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.

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

Birçok API çağrısı için, bir proje için benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API proje kimliğini kabul etse de, Firebase, Google veya üçüncü taraf hizmetlere API çağrıları yapmak için proje numarasını kullanmanız önerilir.

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

Proje numarasını bulun

  • Firebase konsolu: Proje ayarları'nı tıklayın. Proje numarası üst panoda görüntülenir.

  • firebase projects:list CLI: firebase projects:list çalıştırın firebase projects:list . Proje numarası, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.

  • Firebase Management REST API: projects.list çağırın. Yanıt gövdesi, FirebaseProject nesnesindeki proje numarasını içerir.

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 bunu proje kurulumu sırasında düzenleyebilirsiniz. Bu tanımlayıcı genellikle projeye atıfta bulunmak için uygun bir takma ad olarak ele alınmalıdır.

Bir projeyi silerseniz, proje kimliği de silinir ve başka hiçbir proje tarafından bir daha asla kullanılamaz.

Firebase kaynakları ve proje kimliği

Proje kimliği, herkese açık Firebase kaynaklarında görüntülenir, örneğin:

  • Varsayılan Barındırma alt alanı - PROJECT_ID .web.app ve PROJECT_ID .firebaseapp.com
  • Varsayılan Gerçek Zamanlı Veritabanı URL'si - PROJECT_ID -default-rtdb.firebaseio.com veya PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • Varsayılan Cloud Storage PROJECT_ID .appspot.com adı - PROJECT_ID .appspot.com

Yukarıda belirtilen tüm kaynaklar için, varsayılan olmayan örnekler oluşturabilirsiniz. Varsayılan olmayanların herkes tarafından görülebilen adları tamamen özelleştirilebilir. Özel alanları Firebase tarafından barındırılan bir siteye bağlayabilir , Gerçek Zamanlı Veritabanını parçalayabilir ve birden çok Cloud Storage paketi oluşturabilirsiniz (platforma özel Başlarken sayfasını ziyaret edin).

Firebase CLI ve proje kimliği

Bazı kullanım durumlarında, aynı yerel uygulama diziniyle ilişkilendirilmiş birden çok Firebase projeniz olabilir. Kullandığınızda Bu gibi durumlarda, Firebase CLI , sen geçmesi gerekiyor --project işaretleyin firebase sizinle etkileşime istediğiniz Firebase projesi iletişim komutları.

Proje kimliklerini hatırlamak zorunda kalmamak için her Firebase projesi için bir proje takma adı da ayarlayabilirsiniz.

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

Birçok API çağrısı için, bir proje için benzersiz bir tanımlayıcı eklemeniz gerekir. Birçok API proje kimliğini kabul etse de, Firebase, Google veya üçüncü taraf hizmetlere API çağrıları yapmak için proje numarasını kullanmanız önerilir.

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

Proje kimliğini bulun

  • Firebase konsolu: Proje ayarları'nı tıklayın. Proje kimliği, üst bölmede görüntülenir.

  • firebase projects:list CLI: firebase projects:list çalıştırın firebase projects:list . Proje kimliği, hesabınızla ilişkili tüm Firebase projeleriyle birlikte görüntülenir.

  • Firebase Management REST API: projects.list çağırın. Yanıt gövdesi, FirebaseProject nesnesindeki proje kimliğini içerir.

Firebase yapılandırma dosyaları ve nesneleri

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

  • GoogleService-Info.plist uygulamaları için bir GoogleService-Info.plist yapılandırma dosyası GoogleService-Info.plist .
  • 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 paketleri vb.) İle 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 gerekli 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 ş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 ("Uygulama Kimliği") : Platforma özel bir biçimde tüm Firebase genelinde Firebase uygulamasının benzersiz tanımlayıcısı:

    • Firebase iOS uygulamaları: GOOGLE_APP_ID (örnek değer: 1:1234567890:ios:321abc456def7890 )
      Bu bir Apple paketi kimliği değildir.
    • mobilesdk_app_id Android uygulamaları: mobilesdk_app_id (örnek değer: 1:1234567890:android:321abc456def7890 )
      Bu bir Android paket adı veya Android uygulaması kimliği değil.
    • 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 (iOS paket kimliği veya Android paket adı) ve API Anahtarı, proje kimliği, Gerçek Zamanlı Veritabanı URL'si gibi Firebase projeye özgü değerler ve Cloud Storage paket adı. Bu göz önüne alındığında, 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 kaynaklı projeler için genellikle uygulamanın Firebase yapılandırma dosyasını veya nesnesini kaynak denetimine 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 projesini yönetme

Bir Firebase projesini yönetme şeklinizi etkileyebilecek hususlar için genel proje düzeyindeki en iyi uygulamaları (bu sayfanın alt kısmında) gözden geçirdiğinizden emin olun.

Bir projeyi yönetmek için araçlar

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. Tıklayarak bir projenin ayarları sol yan panel, erişim üst kısmında . 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 kontrol paneline dönüşür.

Firebase CLI (bir komut satırı aracı)

Firebase ayrıca Firebase Hosting ve Firebase için Cloud Functions gibi belirli Firebase ürünlerini yapılandırmak ve yönetmek için Firebase CLI sunar.

CLI'yi kurduktan 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 Management REST API

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 kaydedilmiş uygulamaları listeleyebilirsiniz ( iOS | Android | web ).

Genel en iyi uygulamalar

Bir projeye uygulama ekleme

Bir projedeki tüm uygulamaların , son kullanıcı açısından aynı uygulamanın platform varyantları olduğundan emin olun . Aynı uygulamanın veya oyunun iOS, Android ve web sürümlerini aynı Firebase projesiyle kaydettirmeniz önerilir. Bir projedeki tüm uygulamalar genellikle aynı Firebase kaynaklarını (veritabanı, depolama paketleri vb.) Paylaşır.

Farklı iOS paket kimliklerine veya tanımlanmış Android paket adlarına sahip birden çok derleme varyantınız varsa her bir varyantı ayrı bir Firebase projesine kaydedebilirsiniz. Ancak, aynı Firebase kaynaklarını paylaşan varyantlarınız varsa bunları aynı Firebase projesine kaydedin.

Firebase projeleri, uygulamaları ve siteleri için bazı genel sınırlar şunlardır:

  • Hesap başına proje sayısı

    • Ücretsiz katmanlı Kıvılcım planı - Proje oluşturma kotası, daha az sayıda projeyle sınırlıdır (genellikle 5-10 civarında).
    • Ücretli planlar - Faturalandırma hesabı başına proje oluşturma kotası, ilişkili Bulut faturalandırma hesabı iyi durumda olduğu sürece önemli ölçüde artar.

    Proje oluşturma kotasına ilişkin 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 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 Uygulamalarının 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 olmalısınız. Örneğin, bir beyaz etiket uygulaması geliştirirseniz, bağımsız olarak etiketlenen her uygulamanın kendi Firebase projesi olmalıdır.

    SSS bölümünden 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.

Çok kiracılık

Mantıksal olarak bağımsız birkaç farklı uygulamayı ve / veya web sitesini tek bir Firebase projesine (genellikle "çoklu kiralama" olarak adlandırılır) bağlamanız önerilmez. Çoklu kiracılık, analitik toplama, paylaşılan kimlik doğrulama, aşırı karmaşık veritabanı yapıları ve güvenlik kurallarıyla ilgili zorluklar dahil olmak üzere ciddi yapılandırma ve veri gizliliği sorunlarına yol açabilir.

Genel olarak, bir dizi uygulama aynı verileri ve yapılandırmaları paylaşmıyorsa, her uygulamayı farklı bir Firebase projesine kaydetmeyi kesinlikle düşünün.

Örneğin, bir beyaz etiket uygulaması geliştirirseniz, bağımsız olarak etiketlenen her uygulamanın kendi Firebase projesi olmalıdır. Her uygulama (gizlilik nedeniyle) verileri başkalarıyla paylaşmaz ve paylaşmamalıdır.

Uygulamanızı başlatma