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 ücretsiz olsa da 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: Uzantılarla ilgili 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 dahil olmak üzere uzantı hakkında 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:
Extensions Hub adresinde resmi Firebase uzantılarına göz atın.
Bir uzantının kartını tıklayarak şunları yapabilirsiniz:
Uzantıyla ilgili ayrıntılı bilgileri görüntüleyin.
Firebase Extensions kaynak deposunda uzantının kaynak kodunun bağlantısını bulun.
Uzantıların uzantı dizininde bu ayrıntılı bilgileri
READMEbölümünde bulabilirsiniz.
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.
Extensions Hub adresinde resmi Firebase uzantılarına göz atın.
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.
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 belgelerine 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
Yüklü uzantınızın Firebase konsolundaki 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 etmek de dahil olmak üzere etkinliğini izleyin.
Yüklenen uzantınızı Firebase konsolunu kullanarak yönetin. Resmi Firebase uzantılarını yeniden yapılandırabilir, kaldırabilir ve en son sürüme güncelleyebilirsiniz.
Tüm projeler için en iyi uygulama olarak, projeniz için bütçe uyarıları oluşturmayı ve Firebase konsolunda Kullanım ve faturalandırma kontrol panelinizi izlemeyi unutmayın.