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ö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 (ör. işlevler)
- 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.
Bu ayrıntılı bilgileri
README
bölümünde uzantının uzantı dizininde görebilirsiniz.
2. adım: Bir uzantı yükleyin
Yükleme işlemi sırasında, uzantının temel özelliklerini (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 adresindeki resmi Firebase uzantılarına göz atın.
Bir uzantının kartını tıklayın, ardından uzantıyla ilgili ayrıntılı bilgileri inceleyin. Burada uzantı, belirli kullanım talimatlarını ve yükleme öncesi görevleri sunabilir.
Yükle'yi tıklayın ve ardından uzantıyı yüklemek için ekrandaki talimatları uygulayın.
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 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
Uzantıyı, mevcut olmayan Firebase kaynaklarını (Cloud Firestore koleksiyon, Realtime Database yol, Cloud Storage paket) kullanacak şekilde yapılandırdıysanız uzantıyı kullanmadan önce bu kaynakları 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üreli görevler tamamlandığında kullanıcıları bilgilendirmek veya bir uzantı işlevinin çıkışını sonradan işleme almak için yararlı olabilir.
Uzantının yayınladığı etkinliklerin listesi (varsa) 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ı projede aynı uzantıyı birden çok 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.
Firebase konsolunu kullanarak, yüklediğiniz uzantıyı 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ı ayarladığınızdan ve Firebase konsolunda Kullanım ve faturalandırma kontrol panelinizi izlediğinizden emin olun.