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ıyla ilgili ayrıntılı bilgileri görüntüleyin
Bu adım isteğe bağlıdır ancak kesinlikle önerilir.
Firebase Extension eklentisini yüklemeden önce, aşağıdakiler dahil olmak üzere uzantıyla ilgili ayrıntılı bilgileri incelemenizi öneririz:
- Uzantının çalışma şekli, yükleme öncesi görevleri 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ı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ıdaki uzantı dizininde bu ayrıntılı bilgileri
READMEbölümünde görebilirsiniz.
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 adresindeki 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ı 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ı, henüz mevcut olmayan Firebase kaynaklarını (Cloud Firestorekoleksiyonlar, Realtime Database yollar, Cloud Storage paketler) kullanacak şekilde yapılandırıldıysa 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 kendi özel mantığınızla bu etkinliklere 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.
Yayınladığı etkinliklerin (varsa) listesi 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 çok uzantı örneği yükleme
Aynı uzantıyı aynı projeye birden fazla kez yükleyebilirsiniz. Yüklenen her örneğin kendi özelleştirilmiş yapılandırması ve kendi uzantı kaynakları olabilir. 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
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 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ı oluşturmayı ve Firebase konsolunda Kullanım ve faturalandırma kontrol panelinizi izlemeyi unutmayın.