Firebase Uzantısı Yükleme

Resmi Firebase uzantılarının herhangi birini Firebase konsolunu, Firebase CLI'yi (komut satırı arayüzü) veya otomatik olarak oluşturulmuş bir SDK'yı kullanarak yükleyebilir (ve yönetebilirsiniz).

Her kurulum yöntemi için desteklenen işlemlerdeki farklılıkları inceleyin.



Uzantı yüklemek veya yönetmek için şu rollerden birine atanmış olmanız gerekir: Sahip veya Düzenleyici ya da Firebase Yöneticisi.

Uzantıyı yüklemek için projenizin Blaze (kullandıkça öde) planında olması gerekir. Uzantıları yüklemek ücretsizdir ancak Firebase hizmetlerini veya Cloud Secret Manager gibi Cloud hizmetlerini ücretsiz katmanlarının ötesinde kullanırsanız sizden ücret alınabilir.

Başlamadan önce

Henüz yapmadıysanız Firebase'i projenize ekleyin ve Firebase projenizi Blaze (kullandıkça öde) planına yükseltin.

1. adım: Bir uzantı hakkında ayrıntılı bilgileri görüntüleme

Bu adım isteğe bağlıdır ancak kesinlikle önerilir.

Firebase Extension yüklemeden önce aşağıdakiler de dahil olmak üzere uzantı hakkındaki ayrıntılı bilgileri incelemenizi öneririz:

  • Uzantının işleyiş şekli, yükleme öncesi görevler ve uzantıyla ilgili ayrıntılar
  • Genel tanımlayıcı bilgiler ve açıklama
  • Uzantının görevleri için faturalandırma hesabı gerekip gerekmediği
  • İşlem için gereken Google hizmetleri (API'ler) ve erişim rolleri
  • Uzantı için oluşturulan kaynaklar (işlevler gibi)
  • Kullanıcı tarafından yapılandırılabilir parametrelerin açıklamaları

Bir uzantının ayrıntılı bilgilerini görüntülemek için:

  1. Extensions Hub adresinde resmi Firebase uzantılarına göz atın.

  2. Bir uzantının kartını tıklayarak şunları yapabilirsiniz:

2. adım: Bir uzantı yükleyin

Yükleme işlemi sırasında, uzantının temel özelliklerini (ör. etkinleştirilen API'ler, oluşturulan kaynaklar, verilen erişim vb.) incelemeniz istenir. Faturalandırma şartları hakkında bilgilendirilirsiniz ve uzantının yapılandırılabilir parametreleri için değerler belirtmeniz istenir.

  1. Extensions Hub adresinde resmi Firebase uzantılarına göz atın.

  2. Bir uzantının kartını tıklayın ve ardından uzantıyla ilgili ayrıntılı bilgileri inceleyin. Bu bilgilerde belirli kullanım talimatları ve yükleme öncesi görevler bulunabilir.

  3. Yükle'yi tıklayın ve uzantıyı yüklemek için ekrandaki talimatları uygulayın.

3. Adım: Yükleme sonrası kurulumu tamamlayın

Bazı uzantıların, kullanmadan önce tamamlamanız gereken zorunlu veya isteğe bağlı adımları vardır. Bu talimatları, Firebase konsolunun Extensions kontrol panelindeki uzantınızın yükleme sonrası ayrıntılar sayfasında bulabilirsiniz (kontrol paneline özel bağlantı, yükleme işleminden sonra terminalde gösterilir).

Bu talimatları uzantının kaynak dizininde bulunan POSTINSTALL.md dosyasında da bulabilirsiniz.

Firebase kaynakları oluşturma

Eklentiyi, mevcut olmayan Firebase kaynaklarını (Cloud Firestorekoleksiyonlar, Realtime Database yollar, Cloud Storage paketler) kullanacak şekilde yapılandırdıysanız eklentiyi kullanmadan önce bunları oluşturun.

Eventarc etkinlik işleyicileri oluşturma

Bazı uzantılar, yürütme sırasında önemli olaylar olduğunda Eventarc'ta yayınlanır. Bir uzantı etkinlik yayınlıyorsa ve yükleme sırasında etkinlikleri etkinleştirdiyseniz bu etkinliklere kendi özel mantığınızla tepki veren işlevler yazabilirsiniz. Bu, örneğin uzun süren görevler tamamlandığında kullanıcıları bilgilendirmek veya bir uzantı işlevinin çıktısını son işleme tabi tutmak için yararlı olabilir.

Yayınladığı etkinliklerin (varsa) listesi için uzantının dokümanlarına bakın. Örneğin, Stripe ile Ödeme Yapma uzantısı için etkinlik türlerine bakın.

Ardından, Eventarc etkinlik işleyicileri yazma hakkında bilgi edinmek için Özel etkinlik tetikleyicileri başlıklı makaleyi inceleyin.

Birden fazla uzantı örneği yükleme

Aynı uzantıyı aynı projeye birden fazla kez yükleyebilirsiniz. Yüklenen her örnekte özelleştirilmiş yapılandırma ve uzantı kaynakları bulunabilir. Yüklü her örneği, projenizde benzersiz olan örnek kimliğini kullanarak tanımlar ve referans olarak kullanırsınız.

Yüklediğiniz uzantının her ek örneğinin örnek kimliğini onaylamanız veya düzenlemeniz istenir.

Sonraki adımlar