Firebase is back at Google I/O on May 10! Register now

Bir Firebase Uzantısı yükleyin

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Firebase konsolunu veya Firebase CLI'yi (komut satırı arabirimi) kullanarak resmi Firebase uzantılarından herhangi birini yükleyebilir (ve yönetebilirsiniz ).

Firebase CLI ve Firebase konsolu için desteklenen işlemlerdeki farklılıkları incelediğinizden emin olun.


Uzantıları yüklemek veya yönetmek için size şu rollerden biri atanmalıdır: Sahip veya Düzenleyici veya Firebase Yöneticisi .

Bir uzantı yüklemek için projenizin Blaze (kullandığın kadar öde) planında olması gerekir. Bir uzantı yüklemek için herhangi bir ücret alınmamasına rağmen, kullanımınız hizmetlerin ücretsiz katmanını aşarsa, Firebase hizmetlerini veya Cloud Secret Manager gibi Bulut hizmetlerini kullanımınız için ücretlendirilebilirsiniz.

Sen başlamadan önce

  1. Henüz yapmadıysanız, Firebase'i projenize ekleyin .

  2. Henüz yapmadıysanız, projenizi Blaze (kullandıkça öde) planına yükseltin.

  3. Firebase CLI'nin en son sürümünü yükleyin veya güncelleyin.

  4. Firebase proje kimliğinizi veya önceden yapılandırılmış proje takma adını not alın.

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

Bu adım isteğe bağlıdır, ancak şiddetle tavsiye edilir.

Bir Firebase Uzantısı kurmadan önce, aşağıdakiler de dahil olmak üzere uzantıyla ilgili ayrıntılı bilgileri incelemenizi öneririz:

  • Uzantının nasıl çalıştığı, kurulum öncesi görevler ve uzantıyla ilgili ayrıntılar
  • Genel tanımlayıcı bilgiler ve açıklama
  • Uzantının görevlerinin faturalandırma hesabı gerektirip gerektirmediğ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ılabilen parametrelerin açıklamaları

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

  1. Ortamınızı kurduğunuzdan ve bir uzantı seçtiğinizden emin olun.

  2. extension-info komutunu bilgisayarınızın herhangi bir yerinden çalıştırın:

    firebase ext:info publisher-id/extension-id

    publisher-id ve extension-id bağımsız değişkenleri gereklidir ve uzantının ön yükleme ayrıntıları sayfasında bulunabilir.

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

Yükleme işlemi sırasında, uzantının temel özelliklerini (etkin API'ler, oluşturulan kaynaklar , verilen erişim vb.) gözden geçirmeniz istenecektir. Tüm faturalandırma gereksinimleri size bildirilecek ve ayrıca uzantının yapılandırılabilir parametreleri için değerler belirtmeniz istenecektir.

  1. Ortamınızı kurduğunuzdan ve bir uzantı seçtiğinizden emin olun.

  2. Yerel Firebase dizininizden extension-install komutunu çalıştırın. İstenirse, uzantı örneğini özelleştirmek için parametre değerlerini girin.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-id ve extension-id bağımsız değişkenleri gereklidir ve uzantının ön yükleme ayrıntıları sayfasında bulunabilir.

    Bu komutu çalıştırmak, uzantı bildiriminize bir uzantı örneği ekler.

  3. Ardından, bildiriminizdeki uzantıları bir Firebase projesine dağıtmak için şunu çalıştırın:

    firebase deploy --only extensions --project=projectId-or-alias

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

Bazı uzantıları kullanmadan önce tamamlamanız gereken gerekli veya isteğe bağlı adımlar vardır. Bu talimatları, uzantınızın Firebase konsolunun Uzantılar panosundaki yükleme sonrası ayrıntılar sayfasında bulabilirsiniz (panoya özel bağlantı, kurulumdan sonra terminalde görüntülenir).

Bu talimatları , uzantının kaynak dizininde yer alan POSTINSTALL.md dosyasında da bulabilirsiniz.

Firebase kaynakları oluşturun

Uzantıyı halihazırda mevcut olmayan Firebase kaynaklarını (Cloud Firestore koleksiyonları, Gerçek Zamanlı Veritabanı yolları, Cloud Storage paketleri) kullanacak şekilde yapılandırdıysanız uzantıyı kullanmadan önce bunları oluşturun.

Eventarc olay işleyicileri oluşturma

Bazı uzantılar, yürütme sırasında önemli olaylar gerçekleştiğinde Eventarc'ta yayınlar. Bir eklenti olayları yayınlıyorsa ve kurulum sırasında olayları etkinleştirdiyseniz, kendi özel mantığınızla bu olaylara tepki veren işlevler yazabilirsiniz. Bu, örneğin, uzun süreli görevler tamamlandığında kullanıcıları bilgilendirmek veya bir uzantı işlevinin çıktısını sonradan işlemek için yararlı olabilir.

Yayınladığı olayların (varsa) listesi için uzantının belgelerine bakın.

Ardından, Eventarc olay işleyicileri yazma hakkında bilgi için Özel olay tetikleyicileri bölümüne bakın.

Birden çok uzantı örneği kurun

Aynı uzantıyı aynı projede birden fazla kurabilirsiniz. Yüklenen her örneğin kendi özelleştirilmiş yapılandırması ve kendi uzantı kaynakları olabilir. Projenizde benzersiz olan örnek kimliğini kullanarak her kurulu örneği tanımlar ve bunlara başvurursunuz. Yüklediğiniz uzantının her ek örneğinin örnek kimliğini onaylamanız veya düzenlemeniz istenir.

Sonraki adımlar