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ı oluşturduğunuzdan ve platformunuz için Firebase SDK'larını seçip yüklediğinizden emin olun. Platformunuza göre Firebase'i kullanmaya başlama konularına göz atın: Apple, Android veya Web.

Prototip oluşturma ve test etme

Local Emulator Suite, Firebase Local Emulator Suite'e Giriş bölümünde açıklandığı gibi çeşitli ürün emülatörleri içerir. Üretimde kullandığınız Firebase ürünlerine göre, tek tek emülatörlerle veya emülatör kombinasyonlarıyla prototip oluşturabilir ve test yapabilirsiniz.

Firebase veritabanı ile işlev emülatörleri arasındaki etkileşim
Tam Local Emulator Suite kapsamında veritabanı ve Cloud Functions emülatörleri.

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

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

  1. Prototip özellikleri, emülatörlerle ve Emulator Suite UI ile etkileşimli olarak kullanılabilir.

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

  3. Emülatörleri ve özel komut dosyalarını kullanarak 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 mevcut çalışma dizinini Firebase projesi olarak başlatın. Ekrandaki talimatları uygulayarak Cloud Functions ve Cloud Firestore veya 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 kodunu içeren bir functions dizini ve diğer destekleyici dosyalar yer alır.

Etkileşimli prototip oluşturma

Local Emulator Suite, yeni özellikleri hızlıca prototip haline getirmenize olanak tanıyacak şekilde tasarlanmıştır. 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ı gibidir.

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

Local Emulator Suite'ü şu şekilde başlattığınızda tüm bu özelliklerden yararlanabilirsiniz:

firebase emulators:start

Hayali uygulamamızın prototipini oluşturmak için bir veritabanındaki metin girişlerini değiştirmek üzere temel bir bulut işlevi oluşturup test edelim ve bu işlevi tetiklemek için Emulator Suite UI içinde veritabanını oluşturup dolduralım.

  1. Proje dizininizdeki functions/index.js dosyasını düzenleyerek veritabanı yazma işlemlerinden 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 hiyerarşisindeki düğümlerde yapılan değişiklikleri dinler, düğümün original mülkünün içeriğini büyük harfe dönüştürür ve sonucu söz konusu düğümün uppercase mülkünde depolar.
    2.   const functions = require('firebase-functions/v1');

  exports.makeUppercase = functions.database.ref('/messages/{pushId}/original')
      .onCreate((snapshot, context) => {
        const original = snapshot.val();
        console.log('Uppercasing', context.params.pushId, original);
        const uppercase = original.toUpperCase();
        return snapshot.ref.parent.child('uppercase').set(uppercase);
      });
  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ü http://localhost:4000 adresinde tarayıcınızda görüntüleyin. Kullanıcı arayüzü için varsayılan bağlantı noktası 4000'dir ancak Firebase KSA tarafından oluşturulan terminal mesajlarını kontrol edin. Mevcut emülatörlerin durumunu not edin. Bizim durumumuzda, Cloud Functions ve Realtime Database emülatörleri çalışacaktır.
    Resmim
  4. Kullanıcı arayüzündeki Gerçek Zamanlı Veritabanı sekmesinde, veritabanı içerik düzenleyici denetimlerini kullanarak message1 düğümü içeren bir messages düğümü ve bu düğümün içinde anahtarı original ve değeri test olarak ayarlanmış bir düğüm içeren bir düğüm grubu oluşturun. Bu, bulut işlevimizi tetikler. Kısa süre içinde TEST değerine sahip yeni bir uppercase özelliğinin göründüğünü gözlemleyin.
    Resmim Resmim
  5. İşlevinizin, veritabanı güncellenirken hatalarla karşılaşmadığını doğrulamak için Günlük sekmesini kontrol edin.

Uygulama içi veritabanı erişim koduna dokunmadan, test paketlerini yeniden derlemeden ve yeniden çalıştırmadan, aradığınız veri akışını elde edene kadar bulut işlevi kodunuz ve etkileşimli veritabanı düzenlemeleri arasında kolayca geçiş yapabilirsiniz.

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

Etkileşimli prototipleme konusunda iyi bir ilerleme kaydettiğinizde ve bir tasarıma karar verdiğinizde, 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'deki Günlükler sekmesini kullanmaya devam edersiniz.

Local Emulator Suite'ü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ına geçmek için test sınıflarınızı veya uygulama içi yapılandırmanızı Realtime Database 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 database = Firebase.database
database.useEmulator("10.0.2.2", 9000)
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.
FirebaseDatabase database = FirebaseDatabase.getInstance();
database.useEmulator("10.0.2.2", 9000);
EmulatorSuite.java
Swift
    // In almost all cases the ns (namespace) is your project ID.
let db = Database.database(url:"http://127.0.0.1:9000?ns=YOUR_DATABASE_NAMESPACE")
ViewController.swift

Web

import { getDatabase, connectDatabaseEmulator } from "firebase/database";

const db = getDatabase();
if (location.hostname === "localhost") {
  // Point to the RTDB emulator running on localhost.
  connectDatabaseEmulator(db, "127.0.0.1", 9000);
} 
rtdb_emulator_connect.js

Web

var db = firebase.database();
if (location.hostname === "localhost") {
  // Point to the RTDB emulator running on localhost.
  db.useEmulator("127.0.0.1", 9000);
} 
emulator-suite.js

Özel komut dosyalarıyla testlerinizi otomatikleştirme

Şimdi 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 sonuçlar elde ettikten sonra nihai uygulama ve test aşamasına geçebilirsiniz. Birim testi ve CI iş akışları için exec komutunu kullanarak tek bir çağrıda emülatörleri başlatabilir, komut dosyası testleri çalıştırabilir ve emülatörleri kapatabilirsiniz:

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

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

Temel istemci tarafı iş akışının nasıl göründüğünü gördükten sonra, Suite'teki her bir emülatörle ilgili ayrıntılara (ör. sunucu tarafı uygulama geliştirme için nasıl kullanılacağı) geçebilirsiniz:

Sonrasında ne olacak?

Yukarıda bağlantısı verilen belirli emülatörlerle ilgili konuları okumayı unutmayın. Ardından: