Firebase Uzantısı yükleyin

Firebase konsolunu veya Firebase CLI'yi (komut satırı arayüzü) 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 şu rollerden birine atanmanız gerekir: Sahip veya Düzenleyici ya da Firebase Yöneticisi .

Bir uzantı yüklemek için projenizin Blaze (kullandıkça öde) planında olması gerekir. Bir uzantı yüklemek için herhangi bir ücret alınmasa da, 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 projenize Firebase'i 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ızı not edin.

    • Proje Kimliğifirebase projects:list bilgisayarınızın herhangi bir yerinden çalıştırın.
    • Proje takma adı - firebase use yerel uygulama dizininizden çalıştırın.

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

Bu adım isteğe bağlıdır ancak önemle tavsiye edilir.

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

  • Uzantının nasıl çalıştığı, yükleme öncesi görevler ve uzantıyla ilgili ayrıntılar
  • Genel tanımlayıcı bilgiler ve açıklama
  • Uzantının görevlerinin bir faturalandırma hesabı gerektirip gerektirmediği
  • Operasyon için gerekli 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 , erişim izni vb. gibi) incelemeniz istenecektir. Faturalandırma gereksinimleri konusunda bilgilendirileceksiniz ve ayrıca uzantının yapılandırılabilir parametreleri için değerler belirtmeniz istenecek.

  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, extensions manifest dosyanıza bir uzantı örneği ekler.

  3. Ardından manifestinizdeki 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 zorunlu veya isteğe bağlı adımlar vardır. Bu talimatları, Firebase konsolunun Uzantılar kontrol panelindeki uzantınızın kurulum sonrası ayrıntılar sayfasında bulabilirsiniz (kontrol paneline özel bağlantı kurulumdan sonra terminalde görüntülenir).

Bu talimatları , uzantının kaynak dizininde bulunan 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 meydana geldiğinde Eventarc'ta yayınlanır. Bir uzantı olaylar yayınlıyorsa ve yükleme sırasında olayları etkinleştirdiyseniz, kendi özel mantığınızla bu olaylara 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ı sonradan işlemek için yararlı olabilir.

Yayınladığı etkinliklerin (varsa) listesi için uzantının belgelerine bakın. Örneğin Ödemeleri Stripe ile Çalıştır uzantısına ilişkin etkinlik türlerine bakın.

Ardından Eventarc olay işleyicilerini yazma hakkında bilgi için Özel olay tetikleyicileri konusuna bakın.

Birden çok uzantı örneği yükleyin

Aynı uzantıyı aynı projeye birden çok kez yükleyebilirsiniz. Yüklenen her örneğin kendi özelleştirilmiş yapılandırması ve kendi uzantı kaynakları olabilir. Yüklü her örneği, projeniz içinde benzersiz olan örnek kimliğini kullanarak tanımlar ve bunlara başvurursunuz. Yüklediğiniz uzantının her ek örneğinin örnek kimliğini onaylamanız veya düzenlemeniz istenecektir.

Sonraki adımlar

  • Firebase konsolunda yüklü uzantınızın ayrıntılarını ve yapılandırmasını görüntüleyin .

  • Yüklü uzantınızın durumunu, kullanımını ve günlüklerini kontrol ederek etkinliğini izleyin .

  • Firebase CLI'yi kullanarak yüklü uzantınızı yönetin . Uzantınızı yeniden yapılandırabilir veya kaldırabilir, ayrıca uzantınızı en son sürüme güncelleyebilirsiniz.

  • Firebase konsolunu kullanarak yüklü uzantınızı yönetin . Resmi Firebase uzantıları için uzantınızı yeniden yapılandırabilir veya kaldırabilir, ayrıca uzantınızı en son sürüme güncelleyebilirsiniz.

  • Tüm projeler için en iyi uygulama olarak, projeniz için bütçe uyarıları ayarladığınızdan ve Firebase konsolunda Kullanım ve faturalandırma kontrol panelinizi izlediğinizden emin olun.