หน้านี้ได้รับการแปลโดย Cloud Translation API

เชื่อมต่อแอพของคุณและเริ่มสร้างต้นแบบ

ก่อนที่คุณจะเริ่มใช้ Firebase Local Emulator Suite ตรวจสอบให้แน่ใจว่าคุณได้สร้างโครงการ Firebase ตั้งค่าสภาพแวดล้อมการพัฒนาของคุณ และเลือกและติดตั้ง Firebase SDK สำหรับแพลตฟอร์มของคุณตามหัวข้อ เริ่มต้นใช้งาน Firebase สำหรับแพลตฟอร์มของคุณ: Apple , Android หรือ เว็บ .

ต้นแบบและการทดสอบ

หมายเหตุ: ก่อนที่คุณจะสำรวจ Firebase Local Emulator Suite เราขอแนะนำให้คุณทำความคุ้นเคยกับผลิตภัณฑ์ Firebase และโมเดลการพัฒนา Firebase หลังจากอ่าน การเริ่มต้นใช้งาน สำหรับแพลตฟอร์มของคุณแล้ว ให้ดาวน์โหลดแอป Quickstart ที่พร้อมใช้งานบนแพลตฟอร์มที่คุณเลือก จากนั้นอ่านข้อมูลและดำเนินการโค้ด แอปเริ่มต้นอย่างรวดเร็วของ FriendlyEats เป็นตัวเลือกที่ดี ( iOS , Android หรือ เว็บ )

Local Emulator Suite ประกอบด้วยโปรแกรมจำลองหลายผลิตภัณฑ์ ดังที่อธิบายไว้ใน บทนำเกี่ยวกับ Firebase Local Emulator Suite คุณสามารถสร้างต้นแบบและทดสอบด้วยอีมูเลเตอร์แต่ละตัว รวมถึงอีมูเลเตอร์หลายตัวรวมกันได้ตามที่เห็นสมควร ซึ่งสอดคล้องกับผลิตภัณฑ์ Firebase ที่คุณใช้ในการผลิต

การโต้ตอบระหว่างฐานข้อมูล Firebase และโปรแกรมจำลองฟังก์ชัน — ตัวจำลองฐานข้อมูลและ Cloud Functions เป็นส่วนหนึ่งของ Local Emulator Suite เต็มรูปแบบ

สำหรับหัวข้อนี้ เพื่อแนะนำเวิร์กโฟลว์ Local Emulator Suite สมมติว่าคุณกำลังทำงานในแอปที่ใช้ผลิตภัณฑ์ร่วมกันโดยทั่วไป ได้แก่ ฐานข้อมูล Firebase และฟังก์ชันคลาวด์ที่ทริกเกอร์โดยการดำเนินการบนฐานข้อมูลนั้น

หลังจากที่คุณเริ่มต้นโปรเจ็กต์ Firebase ในเครื่องแล้ว วงจรการพัฒนาโดยใช้ Local Emulator Suite โดยทั่วไปจะมีสามขั้นตอน:

ฟีเจอร์ต้นแบบโต้ตอบกับอีมูเลเตอร์และ Emulator Suite UI
หากคุณใช้โปรแกรมจำลองฐานข้อมูลหรือโปรแกรมจำลอง Cloud Functions ให้ทำตามขั้นตอนเพียงครั้งเดียวเพื่อเชื่อมต่อแอปของคุณกับโปรแกรมจำลอง
ทำการทดสอบของคุณให้เป็นอัตโนมัติด้วยอีมูเลเตอร์และสคริปต์แบบกำหนดเอง

เริ่มต้นโครงการ Firebase ในเครื่อง

ตรวจสอบให้แน่ใจว่าคุณ ติดตั้ง CLI หรือ อัปเดตเป็นเวอร์ชันล่าสุด

curl -sL firebase.tools | bash

หากคุณยังไม่ได้ดำเนินการ ให้เริ่มต้นไดเร็กทอรีการทำงานปัจจุบันเป็นโครงการ Firebase ทำตามคำแนะนำบนหน้าจอเพื่อระบุว่าคุณกำลังใช้ Cloud Functions และ Cloud Firestore หรือ Realtime Database :

firebase init

ตอนนี้ไดเร็กทอรีโปรเจ็กต์ของคุณจะมีไฟล์การกำหนดค่า Firebase, ไฟล์คำจำกัดความของ Firebase Security Rules สำหรับฐานข้อมูล, ไดเร็กทอรี functions ที่มีโค้ดฟังก์ชันระบบคลาวด์ และไฟล์สนับสนุนอื่นๆ

ต้นแบบโต้ตอบ

Local Emulator Suite ได้รับการออกแบบมาเพื่อให้คุณสามารถสร้างต้นแบบคุณลักษณะใหม่ๆ ได้อย่างรวดเร็ว และอินเทอร์เฟซผู้ใช้ในตัวของ Suite เป็นหนึ่งในเครื่องมือสร้างต้นแบบที่มีประโยชน์มากที่สุด มันเหมือนกับให้คอนโซล Firebase ทำงานในเครื่อง

เมื่อใช้ Emulator Suite UI คุณสามารถทำซ้ำการออกแบบฐานข้อมูล ลองใช้กระแสข้อมูลต่างๆ ที่เกี่ยวข้องกับฟังก์ชันคลาวด์ ประเมินการเปลี่ยนแปลงกฎความปลอดภัย ตรวจสอบบันทึกเพื่อยืนยันว่าบริการแบ็คเอนด์ของคุณทำงานเป็นอย่างไร และอื่นๆ อีกมากมาย จากนั้น หากคุณต้องการเริ่มต้นใหม่ เพียงล้างฐานข้อมูลของคุณแล้วเริ่มต้นใหม่ด้วยแนวคิดการออกแบบใหม่

ทุกอย่างพร้อมใช้งานเมื่อคุณเริ่ม Local Emulator Suite ด้วย:

firebase emulators:start

ในการสร้างต้นแบบแอปสมมุติของเรา ให้ตั้งค่าและทดสอบฟังก์ชันคลาวด์พื้นฐานเพื่อแก้ไขรายการข้อความในฐานข้อมูล และสร้างและเติมข้อมูลฐานข้อมูลนั้นใน Emulator Suite UI เพื่อทริกเกอร์

สร้างฟังก์ชันคลาวด์ที่ทริกเกอร์โดยการเขียนฐานข้อมูลโดยแก้ไขไฟล์ functions/index.js ในไดเร็กทอรีโปรเจ็กต์ของคุณ แทนที่เนื้อหาของไฟล์ที่มีอยู่ด้วยข้อมูลโค้ดต่อไปนี้ ฟังก์ชันนี้รับฟังการเปลี่ยนแปลงโหนดในลำดับชั้นของ messages แปลงเนื้อหาของคุณสมบัติ original ของโหนดเป็นตัวพิมพ์ใหญ่ และเก็บผลลัพธ์ไว้ในคุณสมบัติ uppercase ของโหนดนั้น

  const functions = require('firebase-functions');

  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);
      });

เปิด Local Emulator Suite ด้วย firebase emulators:start Cloud Functions และโปรแกรมจำลองฐานข้อมูลเริ่มต้นขึ้น กำหนดค่าโดยอัตโนมัติเพื่อทำงานร่วมกัน
ดู UI ในเบราว์เซอร์ของคุณที่ http://localhost:4000 พอร์ต 4000 เป็นค่าเริ่มต้นสำหรับ UI แต่ตรวจสอบเอาต์พุตข้อความเทอร์มินัลโดย Firebase CLI สังเกตสถานะของอีมูเลเตอร์ที่มีอยู่ ในกรณีของเรา ตัวจำลอง Cloud Functions และ Realtime Database จะทำงาน
ใน UI บนแท็ บฐานข้อมูลเรียล ไทม์ ให้ใช้ตัวควบคุมตัวแก้ไขเนื้อหาฐานข้อมูลเพื่อสร้างชุดของโหนดที่มีโหนด messages ที่มีโหนด message1 ซึ่งจะมีโหนดที่มีชุดคีย์เป็น original และชุดค่าสำหรับ test สิ่งนี้จะกระตุ้นการทำงานของระบบคลาวด์ของเรา สังเกตว่าคุณสมบัติ uppercase ใหม่จะปรากฏขึ้นในไม่ช้า โดยมีค่า TEST
ตรวจสอบแท็บ บันทึก เพื่อยืนยันว่าฟังก์ชันของคุณไม่ได้รันข้อผิดพลาด inot เนื่องจากอัปเดตฐานข้อมูล

คุณสามารถวนซ้ำระหว่างโค้ดฟังก์ชันระบบคลาวด์กับการแก้ไขฐานข้อมูลแบบโต้ตอบได้จนกว่าจะได้โฟลว์ข้อมูลที่ต้องการ โดยไม่ต้องแตะโค้ดเข้าถึงฐานข้อมูลในแอป คอมไพล์ใหม่และเรียกใช้ชุดทดสอบซ้ำ

เชื่อมต่อแอปของคุณกับอีมูเลเตอร์

เมื่อคุณมีความคืบหน้าที่ดีกับการสร้างต้นแบบเชิงโต้ตอบและได้ตกลงกับการออกแบบแล้ว คุณจะพร้อมที่จะเพิ่มรหัสการเข้าถึงฐานข้อมูลไปยังแอปของคุณโดยใช้ SDK ที่เหมาะสม คุณจะยังคงใช้แท็บฐานข้อมูลและสำหรับฟังก์ชันต่างๆ แท็บ บันทึก ใน Emulator Suite UI เพื่อยืนยันว่าการทำงานของแอปของคุณถูกต้อง

โปรดจำไว้ว่า Local Emulator Suite เป็นเครื่องมือในการพัฒนาท้องถิ่น การเขียนไปยังฐานข้อมูลการผลิตของคุณจะไม่เรียกใช้ฟังก์ชันที่คุณกำลังสร้างต้นแบบในเครื่อง

หากต้องการเปลี่ยนไปให้แอปเขียนลงในฐานข้อมูล คุณจะต้องชี้คลาสทดสอบหรือการกำหนดค่าในแอปไปที่โปรแกรมจำลองฐานข้อมูลเรียลไทม์

Kotlin+KTX

// 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

สวิฟต์

    // In almost all cases the ns (namespace) is your project ID.
let db = Database.database(url:"http://localhost:9000?ns=YOUR_DATABASE_NAMESPACE")ViewController.swift

Web version 9

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

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

Web version 8

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

ทำการทดสอบของคุณโดยอัตโนมัติด้วยสคริปต์ที่กำหนดเอง

ตอนนี้สำหรับขั้นตอนเวิร์กโฟลว์โดยรวมสุดท้าย เมื่อคุณสร้างต้นแบบคุณลักษณะของคุณในแอปแล้ว และดูเหมือนว่ามีแนวโน้มที่ดีในทุกแพลตฟอร์มของคุณ คุณสามารถหันไปใช้งานและทดสอบขั้นสุดท้ายได้ สำหรับการทดสอบหน่วยและเวิร์กโฟลว์ CI คุณสามารถเริ่มต้นโปรแกรมจำลอง เรียกใช้การทดสอบสคริปต์ และปิดโปรแกรมจำลองในการเรียกครั้งเดียวด้วยคำสั่ง exec :

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

สำรวจอีมูเลเตอร์แต่ละตัวในเชิงลึกยิ่งขึ้น

ตอนนี้คุณได้เห็นแล้วว่าเวิร์กโฟลว์ฝั่งไคลเอ็นต์พื้นฐานมีลักษณะอย่างไร คุณสามารถดำเนินการต่อด้วยรายละเอียดเกี่ยวกับอีมูเลเตอร์แต่ละตัวใน Suite รวมถึงวิธีใช้พวกมันสำหรับการพัฒนาแอพฝั่งเซิร์ฟเวอร์:

อะไรต่อไป?

อย่าลืมอ่านหัวข้อที่เกี่ยวข้องกับอีมูเลเตอร์เฉพาะที่ลิงก์ด้านบน แล้ว:

สำหรับชุดวิดีโอที่คัดสรรมาอย่างดีและตัวอย่างวิธีใช้โดยละเอียด โปรดติดตาม เพลย์ลิสต์การฝึกอบรม Firebase Emulators
ตรวจสอบกรณีการใช้งานขั้นสูงที่เกี่ยวข้องกับการทดสอบกฎความปลอดภัยและ Firebase Test SDK: ทดสอบกฎความปลอดภัย (Cloud Firestore) ทดสอบกฎความปลอดภัย (ฐานข้อมูลเรียลไทม์) และ ทดสอบกฎความปลอดภัย (Cloud Storage for Firebase)