Deneysel Dart SDK'sını kullanmaya başlama

Cloud Functions for Firebase'daki deneysel Dart desteği, Flutter ve Dart ile tam yığın uygulamalar oluşturmanıza olanak tanır. Yeni Firebase Admin Dart SDK ile diğer Firebase hizmetleriyle iletişim kurun.

Dart işlevlerini kullanmaya başlamak için bu kılavuzdaki kurulum görevlerini tamamlayın ve ardından Dart HTTP ve çağrılabilir işlevleri keşfetmeye devam edin.

Ön koşullar

• Dart SDK 3.9 veya sonraki sürümler
• Firebase CLI (sürüm 15.15.0 veya daha yeni)

Cloud Functions for Firebase içinde Dart'ı destekleyen bir Firebase CLI sürümünüzün olup olmadığını --version işaretiyle kontrol edin:

 `firebase --version`

Denemeyi Firebase CLI'da etkinleştirme

firebase experiments:enable dartfunctions

Projenizi ilk kullanıma hazırlayın

1. Koşu:

   firebase init functions
   

2. Dil olarak Dart'ı seçin.

3. "Bağımlılıkları şimdi yüklemek istiyor musunuz?" sorusuna "Evet" yanıtını verin.

İşlev kodunuzu görüntüleme

functions/bin/server.dart (veya giriş noktanızda) oluşturulan kodu görüntüleyin. Bu kod, basit bir HTTP işlevini gösterir.

Örnek kodun, HttpsOptions oluşturucusuyla helloWorld işlevi için maksimum örnek sayısını 10 olarak ayarladığını unutmayın. Çalışma zamanı seçenekleri hakkında daha fazla bilgiyi Çalışma zamanı seçeneklerini ayarlama bölümünde bulabilirsiniz.

Yerel olarak test etme

firebase emulators:start

Local Emulator Suite başlatıldıktan sonra functions http function initialized (http://127.0.0.1:5001/<url>) gibi bir günlük satırı görürsünüz. Yerel olarak emüle edilen Dart işlevinizi çağırmak için bu URL'yi tarayıcınıza yükleyin.

Dart kodunuzu düzenlerseniz Firebase Local Emulator Suite değişikliği algılar ve işlevinizi otomatik olarak yeniden yükler.

Dağıt

firebase deploy --only functions

Dart'ın dağıtım süreci, Node.js veya Python işlevlerinden farklıdır. Firebase CLI, kaynak kodunuzu Cloud Build içinde derlenmek üzere yüklemek yerine geliştirme makinenizde bir Dart derleme adımı çalıştırır ve oluşturulan ikili dosyayı doğrudan Cloud Run işlevlerine yükler.

Dağıtım tamamlandığında Function URL (hello-world(us-central1)): https://hello-world-<random-hash>.<region>.run.app gibi bir günlük satırı görürsünüz.

Yeni dağıttığınız Dart işlevini çağırmak için bu URL'yi tarayıcınıza yükleyin.

Sonraki adımlar

• Minimum örnek sayısı gibi yapılandırma seçeneklerini ayarlayın.
• HTTP işlevleri ve çağrılabilir işlevler hakkında daha fazla bilgi edinin.
• Dart İşlevleri codelab'ini Dart İşlevleri codelab'ini takip edin.
• İşlevinizden Cloud Firestore gibi diğer Firebase hizmetleriyle etkileşim kurmak için deneysel Dart Admin SDK kullanın.
• onRequest HTTP işlevlerine ek olarak, işlevleri doğrudan uygulamanızdan çağırmak için bir onCall örneği veya akış içeren onCall örneğini deneyebilirsiniz (çağrı yöntemiyle ilgili özel sınırlamaya dikkat edin).

Sınırlamalar

• onCall tetikleyicisi dağıtılabilir ancak işlevleri ada göre tanımlayan httpsCallable gibi yöntemlerle istemci SDK'larından çağrılamaz. Bunun yerine httpsCallableFromURL gibi yöntemleri kullanabilir ve işlevinizin tam Cloud Run URL'sini iletebilirsiniz.
• Firestore tetikleyicileri gibi diğer tetikleyiciler yerel emülatör paketinde çalıştırılabilir ancak dağıtılamaz.
• Deneysel sürüm sırasında Firebase konsolunda Dart işlevleri gösterilmez. Dart işlevlerini Cloud konsolunun Cloud Run işlevleri sayfasında görüntüleyebilirsiniz.

Dart işlevleriyle çalışırken sorunlarla karşılaşırsanız deneysel Dart SDK'yı iyileştirmemize ve genişletmemize yardımcı olmak için ekibe rapor göndermenizi öneririz.