Uygulamanızı bağlayıp prototip oluşturmaya başlayın


Firebase Local Emulator Suite ile çalışmaya başlamadan önce bir Firebase projesi oluşturduğunuzdan, geliştirme ortamınızı ayarladığınızdan ve platformunuz için Firebase SDK'larını Firebase'i kullanmaya başlama konularına göre seçip yüklediğinizden emin olun: Apple, Android veya Web.

Prototip oluşturma ve test etme

Local Emulator Suite, Firebase Local Emulator Suite'a Giriş bölümünde açıklandığı gibi çeşitli ürün emülatörleri içerir. Üretimde kullandığınız Firebase ürünlerine karşılık gelen şekilde, tek tek emülatörlerle ve emülatör kombinasyonlarıyla prototip oluşturup test edebilirsiniz.

Firebase veritabanı ile işlev emülatörleri arasındaki etkileşim
Veritabanı ve Cloud Functions emülatörleri,'nin bir parçası olarak Local Emulator Suite.

Bu konuda Local Emulator Suite iş akışını tanıtmak için tipik bir ürün kombinasyonu kullanan bir uygulama üzerinde çalıştığınızı varsayalım: Firebase veritabanı ve bu veritabanındaki işlemler tarafından tetiklenen Cloud Functions.

Firebase projenizi yerel olarak başlattıktan sonra, Local Emulator Suite kullanılarak yapılan geliştirme döngüsü genellikle üç adımdan oluşur:

  1. Özelliklerin prototipini emülatörler ve Emulator Suite UI ile etkileşimli olarak oluşturun.

  2. Veritabanı emülatörü veya Cloud Functions emülatörünü kullanıyorsanız uygulamanızı emülatörlere bağlamak için tek seferlik bir adım uygulayın.

  3. Emülatörler ve özel komut dosyalarıyla testlerinizi otomatikleştirin.

Firebase projesini yerel olarak başlatma

CLI'yi yüklediğinizden veya en son sürümüne güncellediğinizden emin olun.

curl -sL firebase.tools | bash

Henüz yapmadıysanız ekrandaki istemleri uygulayarak geçerli çalışma dizinini Firebase projesi olarak başlatın. Cloud Functions ve Cloud Firestore ya da Realtime Database kullandığınızı belirtin:

firebase init

Proje dizininizde artık Firebase yapılandırma dosyaları, veritabanı için bir Firebase Security Rules tanım dosyası, bulut işlevleri kodu içeren bir functions dizini ve diğer destekleyici dosyalar yer alacak.

Etkileşimli prototip oluşturma

Local Emulator Suite, yeni özelliklerin prototipini hızlıca oluşturmanıza olanak tanımak için tasarlanmıştır ve Suite'in yerleşik kullanıcı arayüzü, en kullanışlı prototip oluşturma araçlarından biridir. Bu, Firebase konsolunun yerel olarak çalıştırılmasına benzer.

Emulator Suite UI kullanarak veritabanı tasarımını yineleyebilir, Cloud Functions'ı içeren farklı veri akışlarını deneyebilir, güvenlik kurallarındaki değişiklikleri değerlendirebilir, arka uç hizmetlerinizin nasıl performans gösterdiğini onaylamak için günlükleri kontrol edebilir ve daha fazlasını yapabilirsiniz. Ardından, baştan başlamak isterseniz veritabanınızı temizleyip yeni bir tasarım fikriyle sıfırdan başlayabilirsiniz.

Bu özelliklerin tümü, Local Emulator Suite ile başlatıldığında kullanılabilir:

firebase emulators:start

Varsayımsal uygulamamızın prototipini oluşturmak için Emulator Suite UI içinde bir veritabanındaki metin girişlerini değiştirecek, bu veritabanını oluşturup dolduracak ve tetikleyecek temel bir Cloud Function ayarlayıp test edelim.

  1. Proje dizininizdeki functions/index.js dosyasını düzenleyerek veritabanı yazma işlemleri tarafından tetiklenen bir Cloud Functions işlevi oluşturun. Mevcut dosyanın içeriğini aşağıdaki snippet ile değiştirin. Bu işlev, messages koleksiyonundaki dokümanlarda yapılan değişiklikleri dinler, bir dokümanın original alanının içeriğini büyük harflere dönüştürür ve sonucu bu dokümanın uppercase alanında saklar.
    2.   const functions = require('firebase-functions/v1');

  exports.makeUppercase = functions.firestore.document('/messages/{documentId}')
      .onCreate((snap, context) => {
        const original = snap.data().original;
        console.log('Uppercasing', context.params.documentId, original);
        const uppercase = original.toUpperCase();
        return snap.ref.set({uppercase}, {merge: true});
      });
  2. Local Emulator Suite'ı firebase emulators:start ile başlatın. Cloud Functions ve veritabanı emülatörleri, birlikte çalışacak şekilde otomatik olarak yapılandırılmış olarak başlatılır.
  3. Kullanıcı arayüzünü tarayıcınızda http://localhost:4000 adresinde görüntüleyin. Kullanıcı arayüzü için varsayılan bağlantı noktası 4000'dir ancak Firebase KSA'nın çıkardığı terminal mesajlarını kontrol edin. Kullanılabilir emülatörlerin durumunu not edin. Bu örnekte, Cloud Functions ve Cloud Firestore emülatörleri çalışıyor olacak.
    Resmim
  4. Kullanıcı arayüzünde Firestore > Veri sekmesinde Koleksiyonu başlat'ı tıklayın ve istemleri uygulayarak messages koleksiyonunda, alan adı original ve değeri test olan yeni bir doküman oluşturun. Bu işlem, Cloud Functions işlevimizi tetikler. Kısa süre sonra yeni bir uppercase alanının göründüğünü ve "TEST" dizesiyle doldurulduğunu gözlemleyin.
    Resmim Resmim
  5. Firestore > İstekler sekmesinde, bu isteklerin karşılanması kapsamında gerçekleştirilen tüm Firebase Security Rules değerlendirmeleri de dahil olmak üzere, emüle edilmiş veritabanınıza yapılan istekleri inceleyin.
  6. Veritabanını güncellerken işlevinizin hatayla karşılaşmadığını doğrulamak için Günlükler sekmesini kontrol edin.

Uygulama içi veritabanı erişim koduna dokunmadan, test paketlerini yeniden derleyip yeniden çalıştırmadan, istediğiniz veri akışını elde edene kadar bulut işlevi kodunuz ve etkileşimli veritabanı düzenlemeleriniz arasında kolayca yineleme yapabilirsiniz.

Uygulamanızı emülatörlere bağlama

Etkileşimli prototipleme konusunda iyi bir ilerleme kaydettiğinizde ve bir tasarım üzerinde karar kıldığınızda, uygun SDK'yı kullanarak uygulamanıza veritabanı erişim kodu eklemeye hazır olursunuz. Uygulamanızın davranışının doğru olduğunu onaylamak için veritabanı sekmesini ve işlevler için Emulator Suite UI'daki Günlükler sekmesini kullanmaya devam edersiniz.

Local Emulator Suite aracının yerel bir geliştirme aracı olduğunu unutmayın. Üretim veritabanlarınıza yapılan yazma işlemleri, yerel olarak prototipini oluşturduğunuz işlevleri tetiklemez.

Uygulamanızın veritabanına yazma işlemi yapmasını sağlamak için test sınıflarınızı veya uygulama içi yapılandırmanızı Cloud Firestore emülatörüne yönlendirmeniz gerekir.

Kotlin
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
val firestore = Firebase.firestore
firestore.useEmulator("10.0.2.2", 8080)

firestore.firestoreSettings = firestoreSettings {
    isPersistenceEnabled = false
}
EmulatorSuite.kt
Java
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseFirestore firestore = FirebaseFirestore.getInstance();
firestore.useEmulator("10.0.2.2", 8080);

FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        .setPersistenceEnabled(false)
        .build();
firestore.setFirestoreSettings(settings);
EmulatorSuite.java
Swift
let settings = Firestore.firestore().settings
settings.host = "127.0.0.1:8080"
settings.cacheSettings = MemoryCacheSettings()
settings.isSSLEnabled = false
Firestore.firestore().settings = settings
ViewController.swift

Web

import { getFirestore, connectFirestoreEmulator } from "firebase/firestore";

// firebaseApps previously initialized using initializeApp()
const db = getFirestore();
connectFirestoreEmulator(db, '127.0.0.1', 8080);
fs_emulator_connect.js

Web

// Firebase previously initialized using firebase.initializeApp().
var db = firebase.firestore();
if (location.hostname === "localhost") {
  db.useEmulator("127.0.0.1", 8080);
}
emulator-suite.js

Testlerinizi özel komut dosyalarıyla otomatikleştirme

Şimdi de genel iş akışının son adımına geçelim. Uygulama içi özelliğinizin prototipini oluşturduktan ve tüm platformlarınızda umut verici göründüğünden emin olduktan sonra son uygulama ve test aşamasına geçebilirsiniz. Birim testi ve CI iş akışları için exec komutuyla tek bir çağrıda emülatörleri başlatabilir, komut dosyası içeren testleri çalıştırabilir ve emülatörleri kapatabilirsiniz:

firebase emulators:exec "./testdir/test.sh"

Emülatörleri daha ayrıntılı inceleme

Temel istemci tarafı iş akışının nasıl göründüğünü öğrendiğinize göre, paketteki her bir emülatörle ilgili ayrıntılara geçebilirsiniz. Bu ayrıntılar arasında, emülatörlerin sunucu tarafı uygulama geliştirme için nasıl kullanılacağı da yer alır:

Sonrasında ne olacak?

Yukarıda bağlantısı verilen belirli emülatörlerle ilgili konuları okuduğunuzdan emin olun. Ardından: