Firebase Uzantısı Yükleme

İstediğiniz uygulamayı yükleyebilir (ve yönetebilirsiniz) resmi Firebase uzantıları için Firebase konsolunu veya Firebase CLI (komut satırı arayüzü).

Şurayı incelemeyi unutmayın: farklılıklar Firebase CLI ve Firebase konsolu için desteklenen işlemler.


Uzantıları yüklemek veya yönetmek için aşağıdaki rollerden birine sahip olmanız gerekir: Sahip veya Düzenleyici ya da Firebase Yöneticisi.

Uzantı yüklemek için projenizin Blaze'te olması gerekir (kullandığınız kadar ödeyin devam edin) planı. Uzantı yüklemek için herhangi bir ücret alınmasa da, Firebase veya Google Cloud hizmetlerini kullanımınız için ücretlendirilen Cloud Secret Manager (kullanımınız hizmet sınırını aşıyorsa) ücretsiz katman.

Başlamadan önce

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

  2. Henüz yapmadıysanız projenizi Blaze'e yükseltin (kullandığınız kadar ödeyin devam edin) planı.

  3. Firebase CLI.

  4. Firebase proje kimliğinizi veya önceden yapılandırılmış bir bilgiyi not edin proje takma adı.

    • Proje Kimliği — Çalıştır Bilgisayarınızda herhangi bir yerden firebase projects:list.
    • Proje takma adı — Çalıştır Yerel uygulama dizininizden firebase use.
    ziyaret edin.

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 kesinlikle önerilir.

Firebase uzantısını yüklemeden önce Aşağıdakiler dahil olmak üzere uzantıyla ilgili ayrıntılı bilgileri inceleyin:

  • Uzantının çalışma şekli, yükleme öncesi görevleri ve uzantı
  • Genel tanımlayıcı bilgiler ve açıklama
  • Uzantının görevlerinin faturalandırma hesabı gerektirip gerektirmediği
  • Google hizmetleri (API'ler) ve erişim rollerinin işlem
  • Oluşturulan kaynaklar (ör. işlevler)
  • 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. Projeyi tamamlamak için ayarınızı yap ortam ve şunu seçti: uzantısıyla ilgili daha fazla bilgi edinebilirsiniz.

  2. Uzantı bilgisi komutunu bilgisayarınızda herhangi bir yerden çalıştırın:

    firebase ext:info publisher-id/extension-id

    publisher-id ve extension-id bağımsız değişkenler gereklidir ve uzantının önceden yükleme ayrıntıları sayfasını ziyaret edin.

ziyaret edin.

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

Yükleme işlemi sırasında, varsayılan yapılandırma uzantının özellikleri (ör. etkinleştirilen API'ler, kaynakların oluşturulduğu erişim verildi vb.) Faturalandırmayla ilgili tüm şartlar size bildirilir ve şunları da yapmanız istenir: Uzantının yapılandırılabilir parametreleri için değerler belirtin.

  1. Projeyi tamamlamak için ayarınızı yap ortam ve şunu seçti: uzantısıyla ilgili daha fazla bilgi edinebilirsiniz.

  2. Yerel Firebase dizininizde uzantı-yükleme 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şkenler gereklidir ve uzantının önceden yükleme ayrıntıları sayfasını ziyaret edin.

    Bu komutu çalıştırdığınızda uzantılar manifestini inceleyin.

  3. Ardından, manifest dosyanızdaki uzantıları Firebase'e dağıtmak için çalıştır: 

    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 içerir. oluşturabilirsiniz. Bu talimatları, uzantınızın yükleme sonrası ayrıntılar sayfasında bulabilirsiniz: Firebase konsolunun Uzantılar kontrol paneli ( kurulumdan sonra terminalde kontrol paneli görüntülenir).

Bu talimatları,POSTINSTALL.md uzantının kaynak dizininde yer alır.

Firebase kaynakları oluşturma

Uzantıyı Firebase kaynaklarını (Cloud Firestore) kullanacak şekilde yapılandırdıysanız mevcut olmayan koleksiyonları, Realtime Database yolları, Cloud Storage paketleri) bunları veya uzantıları oluşturmanız gerekir.

Eventarc etkinlik işleyicileri oluşturma

Bazı uzantılar Eventarc'ta yayınlanır ne zaman olduğunu daha iyi anlamışsınızdır. Bir uzantı etkinlik yayınlarsa ve yükleme sırasında etkinlikleri etkinleştirdiyseniz, resmî bir kapanışla mantığınıza göre ekleyebilirsiniz. Bu, örneğin veya uzun süreli görevler tamamlandığında kullanıcılara bilgi vermeli veya bir uzantı işlevi görür.

Uzantının yayınladığı etkinliklerin listesi (varsa) için uzantının dokümanlarına bakın. Örneğin, bkz. Stripe ile Ödemeleri Çalıştır uzantısı için etkinlik türleri.

Ardından, etkinlikler için Özel etkinlik tetikleyicileri .

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

Aynı projede aynı uzantıyı birden çok kez yükleyebilirsiniz. Yüklenen her örneğin kendi özelleştirilmiş yapılandırması ve kendi ve uzantı kaynakları. Yüklü her örneği tanımlamak için kullanır ve örnek kimliği bulunmalıdır. Bir sonraki şuna benzer her ek örneğin, örnek kimliğini onaylamanız veya düzenlemeniz istenir: yüklediğiniz uzantı.

Sonraki adımlar