กำหนดค่าหลายโปรเจ็กต์

หน้านี้อธิบายวิธีใช้โปรเจ็กต์ Firebase มากกว่า 1 รายการในแอป

แอปจำนวนมากต้องการเพียงโปรเจ็กต์ Firebase รายการเดียวและการตั้งค่าเริ่มต้นที่อธิบายไว้ในคู่มือ เริ่มต้นใช้งาน ตัวอย่างกรณีที่การใช้โปรเจ็กต์ Firebase หลายรายการมีประโยชน์ ได้แก่

• การตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ให้ใช้โปรเจ็กต์ Firebase ที่แตกต่างกันตามประเภทบิลด์หรือเป้าหมาย
• การเข้าถึงเนื้อหาจากโปรเจ็กต์ Firebase หลายรายการในแอป

รองรับสภาพแวดล้อมที่แตกต่างกัน

กรณีการใช้งานทั่วไปอย่างหนึ่งคือการรองรับโปรเจ็กต์ Firebase ที่แยกกันสำหรับสภาพแวดล้อมการพัฒนาและการใช้งานจริง

คุณกำหนดค่า Web และ Admin SDK ได้โดยการส่งค่าไปยังฟังก์ชันการเริ่มต้นโดยตรง สำหรับ SDK เหล่านี้ คุณสามารถใช้การตรวจสอบรันไทม์เพื่อเลือกตัวแปรการกำหนดค่าการพัฒนาหรือการใช้งานจริง

แพลตฟอร์ม Android และ Apple (รวมถึง Wrapper ของ Unity และ C++) จะโหลดการกำหนดค่าจากไฟล์การกำหนดค่า GoogleService-Info.plist ในแพลตฟอร์ม Apple และ google-services.json ใน Android โดยปกติ ระบบจะอ่านไฟล์เหล่านี้ลงในออบเจ็กต์ตัวเลือก (FIROption หรือ FirebaseOptions) ที่ออบเจ็กต์แอปพลิเคชัน Firebase (FIRApp หรือ FirebaseApp) อ้างอิง

สำหรับแพลตฟอร์มเหล่านี้ การสลับระหว่างสภาพแวดล้อมมักจะใช้การตัดสินใจในเวลาบิลด์ผ่านการใช้ไฟล์การกำหนดค่าที่แตกต่างกันสำหรับแต่ละสภาพแวดล้อม

รองรับสภาพแวดล้อมหลายรายการในแอปพลิเคชัน Apple

FirebaseApp.configure() จะโหลดไฟล์ GoogleService-Info.plist ที่รวมอยู่ในแอปพลิเคชันโดยค่าเริ่มต้น หากสภาพแวดล้อมการพัฒนาและการใช้งานจริงได้รับการกำหนดค่าเป็นเป้าหมายที่แยกกันใน Xcode คุณจะทำสิ่งต่อไปนี้ได้

• ดาวน์โหลดไฟล์ GoogleService-Info.plist ทั้ง 2 ไฟล์
• จัดเก็บไฟล์ทั้ง 2 ไว้ในไดเรกทอรีที่ต่างกัน
• เพิ่มไฟล์ทั้ง 2 ลงในโปรเจ็กต์ Xcode
• เชื่อมโยงไฟล์ต่างๆ กับเป้าหมายต่างๆ โดยใช้แผงการเป็นสมาชิกเป้าหมาย

หากบิลด์เป็นส่วนหนึ่งของเป้าหมายเดียว ตัวเลือกที่ดีที่สุดคือการตั้งชื่อไฟล์การกำหนดค่าทั้ง 2 ไฟล์ให้ไม่ซ้ำกัน (เช่น GoogleService-Info-Free.plist และ GoogleService-Info-Paid.plist) จากนั้นเลือกว่าจะโหลด plist ใดในรันไทม์ ซึ่งแสดงไว้ในตัวอย่างต่อไปนี้

// Load a named file.
guard 
  let filePath = Bundle.main.path(forResource: "MyGoogleService", ofType: "plist"),
  let fileOptions = FirebaseOptions(contentsOfFile: filePath)
else { fatalError("Couldn't load config file.") }
FirebaseApp.configure(options: fileOptions)

รองรับสภาพแวดล้อมหลายรายการในแอปพลิเคชัน Android

ใน Android ปลั๊กอิน Google Services Gradle จะประมวลผลไฟล์ google-services.json เป็นทรัพยากรสตริงของ Android คุณดู ทรัพยากรที่สร้างขึ้นได้ในเอกสารประกอบของปลั๊กอิน Google Services ในหัวข้อ การประมวลผลไฟล์ JSON

คุณสามารถมีไฟล์ google-services.json หลายไฟล์สำหรับ บิลด์รูปแบบต่างๆ ได้โดยวางไฟล์ google-services.json ไว้ในไดเรกทอรีเฉพาะที่ตั้งชื่อตามแต่ละ รูปแบบไว้ใต้รูทของโมดูลแอป ตัวอย่างเช่น หากคุณมีบิลด์ Flavor "development" และ "release" คุณอาจจัดระเบียบการกำหนดค่าได้ดังนี้

app/
    google-services.json
    src/development/google-services.json
    src/release/google-services.json
    ...

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของปลั๊กอิน Google Services ในหัวข้อ การเพิ่มไฟล์ JSON

จากนั้น FirebaseInitProvider จะโหลดทรัพยากรเหล่านี้ ซึ่งจะทำงานก่อนโค้ดของแอปพลิเคชันและเริ่มต้น Firebase API โดยใช้ ค่าเหล่านั้น

เนื่องจากผู้ให้บริการนี้อ่านทรัพยากรที่มีชื่อที่รู้จักเท่านั้น อีกตัวเลือกหนึ่งคือการเพิ่มทรัพยากรสตริงลงในแอปโดยตรงแทนการใช้ปลั๊กอิน Google Services Gradle คุณทำได้โดยทำดังนี้

• นำปลั๊กอิน google-services ออกจาก build.gradle รูท
• ลบ google-services.json ออกจากโปรเจ็กต์
• เพิ่มทรัพยากรสตริงโดยตรง
• ลบ apply plugin: 'com.google.gms.google-services' ออกจาก build.gradle ของแอป

ใช้โปรเจ็กต์หลายรายการในแอปพลิเคชัน

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

ในทั้ง 2 กรณี คุณต้องสร้างออบเจ็กต์ตัวเลือก Firebase ก่อนเพื่อเก็บข้อมูลการกำหนดค่าสำหรับแอปพลิเคชัน Firebase คุณดูเอกสารประกอบฉบับเต็มสำหรับตัวเลือกได้ในเอกสารอ้างอิง API สำหรับคลาสต่อไปนี้

• Swift: FirebaseOptions(googleAppID:gcmSenderID:)
• Android: FirebaseOptions.Builder
• เว็บ: initializeApp()
• C++: firebase::App::Create
• Unity: FirebaseApp.Create
• Node.js: initializeApp
• Java: FirebaseOptions.Builder

การใช้คลาสเหล่านี้เพื่อรองรับโปรเจ็กต์หลายรายการในแอปพลิเคชันแสดงไว้ในตัวอย่างต่อไปนี้

// Configure with manual options. Note that projectID and apiKey, though not
// required by the initializer, are mandatory.
let secondaryOptions = FirebaseOptions(googleAppID: "1:27992087142:ios:2a4732a34787067a",
                                       gcmSenderID: "27992087142")
secondaryOptions.apiKey = "AIzaSyBicqfAZPvMgC7NZkjayUEsrepxuXzZDsk"
secondaryOptions.projectID = "projectid-12345"

// The other options are not mandatory, but may be required
// for specific Firebase products.
secondaryOptions.bundleID = "com.google.firebase.devrel.FiroptionConfiguration"
secondaryOptions.clientID = "27992087142-ola6qe637ulk8780vl8mo5vogegkm23n.apps.googleusercontent.com"
secondaryOptions.databaseURL = "https://myproject.firebaseio.com"
secondaryOptions.storageBucket = "myproject.appspot.com"
secondaryOptions.deepLinkURLScheme = "myapp://"
secondaryOptions.storageBucket = "projectid-12345.appspot.com"
secondaryOptions.appGroupID = nil
AppDelegate.swift

// Manually configure Firebase Options. The following fields are REQUIRED:
//   - Project ID
//   - App ID
//   - API Key
val options = FirebaseOptions.Builder()
    .setProjectId("my-firebase-project")
    .setApplicationId("1:27992087142:android:ce3b6448250083d1")
    .setApiKey("AIzaSyADUe90ULnQDuGShD9W23RDP0xmeDc6Mvw")
    // .setDatabaseUrl(...)
    // .setStorageBucket(...)
    .build()
MainActivity.kt

// Manually configure Firebase Options. The following fields are REQUIRED:
//   - Project ID
//   - App ID
//   - API Key
FirebaseOptions options = new FirebaseOptions.Builder()
        .setProjectId("my-firebase-project")
        .setApplicationId("1:27992087142:android:ce3b6448250083d1")
        .setApiKey("AIzaSyADUe90ULnQDuGShD9W23RDP0xmeDc6Mvw")
        // setDatabaseURL(...)
        // setStorageBucket(...)
        .build();
MainActivity.java

// The following fields are REQUIRED:
//  - Project ID
//  - App ID
//  - API Key
const secondaryAppConfig = {
    projectId: "<PROJECT_ID>",
    appId: "<APP_ID>",
    apiKey: "<API_KEY>",
    // databaseURL: "...",
    // storageBucket: "...",
};
firebaseapp.js

firebase::AppOptions secondary_app_options;

// API key, app ID, and project ID are always required.
secondary_app_options.set_api_key("<API_KEY>");
secondary_app_options.set_app_id("<GOOGLE_APP_ID>");
secondary_app_options.set_project_id("<PROJECT_ID>");

// The following options are specific to individual Firebase products
// and may not always be required.
secondary_app_options.set_database_url("<DATABASE_URL>");
secondary_app_options.set_messaging_sender_id("<SENDER_ID>");
secondary_app_options.set_storage_bucket("<STORAGE_BUCKET>");

Firebase.AppOptions secondaryAppOptions = new Firebase.AppOptions {
  ApiKey = "<API_KEY>",
  AppId = "<GOOGLE_APP_ID>",
  ProjectId = "<PROJECT_ID>"
};

const secondaryServiceAccount = require('./path/to/serviceAccountKey.json');

// All required options are specified by the service account,
// add service-specific configuration like databaseURL as needed.
const secondaryAppConfig = {
    credential: cert(secondaryServiceAccount),
    // databaseURL: 'https://<DATABASE_NAME>.firebaseio.com'
};
index.js

FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");

FirebaseOptions secondaryAppConfig = new FirebaseOptions.Builder()
  .setCredential(FirebaseCredentials.fromCertificate(serviceAccount))
  .setDatabaseUrl("https://<DATABASE_NAME>.firebaseio.com/")
  .build();

หลังจากเริ่มต้นออบเจ็กต์ตัวเลือกนี้แล้ว คุณจะใช้เพื่อกำหนดค่าอินสแตนซ์แอปพลิเคชัน Firebase เพิ่มเติมได้ โปรดทราบว่าในตัวอย่างทั้งหมดที่แสดงด้านล่าง เราใช้สตริง secondary ชื่อนี้ใช้เพื่อดึงข้อมูลอินสแตนซ์แอปพลิเคชันและแยกความแตกต่างจากอินสแตนซ์อื่นๆ รวมถึงอินสแตนซ์เริ่มต้น (ชื่อ [DEFAULT]) คุณควรเลือกสตริงที่เหมาะสมกับการใช้งานโปรเจ็กต์ Firebase อื่นๆ ที่ต้องการ

ข้อมูลโค้ดต่อไปนี้แสดงการเชื่อมต่อกับ Realtime Database (API สำหรับฟีเจอร์ Firebase อื่นๆ จะเป็นไปตามรูปแบบเดียวกัน)

// Configure an alternative FIRApp.
FirebaseApp.configure(name: "secondary", options: secondaryOptions)

// Retrieve a previous created named app.
guard let secondary = FirebaseApp.app(name: "secondary")
  else { fatalError("Could not retrieve secondary app") }


// Retrieve a Real Time Database client configured against a specific app.
let secondaryDb = Database.database(app: secondary)
AppDelegate.swift

// Initialize secondary FirebaseApp.
Firebase.initialize(context = this, options, "secondary")

// Retrieve secondary FirebaseApp.
val secondary = Firebase.app("secondary")
// Get the database for the other app.
val secondaryDatabase = Firebase.database(secondary)
MainActivity.kt

// Initialize with secondary app
FirebaseApp.initializeApp(this /* Context */, options, "secondary");

// Retrieve secondary FirebaseApp
FirebaseApp secondary = FirebaseApp.getInstance("secondary");
MainActivity.java

// Initialize another app with a different config
const secondaryApp = firebase.initializeApp(secondaryAppConfig, "secondary");
// Access services, such as the Realtime Database
// secondaryApp.database();
firebaseapp.js

firebase::App* secondary_app = firebase::App::Create(secondary_app_options, "Secondary");
firebase::database::Database* secondary_database = firebase::database::Database::GetInstance(secondary_app);

var secondaryApp = Firebase.FirebaseApp.Create(secondaryAppOptions, "Secondary"));
var secondaryDatabase = Firebase.Database.FirebaseDatabase.getInstance(secondaryApp);

// Initialize another app with a different config
const secondary = initializeApp(secondaryAppConfig, 'secondary');
// Access services, such as the Realtime Database
// const secondaryDatabase = secondary.database();
index.js

// Initialize another app with a different config
FirebaseApp secondaryApp = FirebaseApp.initializeApp(secondaryAppConfig, "secondary");

// Retrieve the database.
FirebaseDatabase secondaryDatabase = FirebaseDatabase.getInstance(secondaryApp);

ตรวจสอบว่าการรายงาน Analytics เชื่อถือได้

Google Analytics จะเก็บรวบรวมเหตุการณ์ในช่วงเริ่มต้นของขั้นตอนการเริ่มต้นแอป ใน บางครั้งก่อนที่จะมีการกำหนดค่าอินสแตนซ์แอป Firebase หลัก ในกรณีเหล่านี้ Firebase จะอ้างอิงทรัพยากร Android หรือ GoogleService-Info.plist ในแพลตฟอร์ม Apple เพื่อค้นหารหัสแอป Google ที่ถูกต้องเพื่อจัดเก็บเหตุการณ์ ด้วยเหตุนี้ เราจึงขอแนะนำให้ใช้วิธีการกำหนดค่าเริ่มต้นทุกครั้งที่เป็นไปได้

หากจำเป็นต้องมีการกำหนดค่ารันไทม์ โปรดทราบข้อควรระวังต่อไปนี้

1. หากคุณใช้ AdMob และขอโฆษณาเมื่อเริ่มต้นตามที่แนะนำ คุณอาจ พลาดข้อมูล Analytics บางส่วนที่เกี่ยวข้องกับโฆษณาบนอุปกรณ์เคลื่อนที่เมื่อไม่ได้ใช้วิธีการกำหนดค่าตามทรัพยากร
2. ให้ระบุรหัสแอป Google เพียงรหัสเดียวในแต่ละรูปแบบที่เผยแพร่ของแอป ตัวอย่างเช่น หากคุณเผยแพร่แอปเวอร์ชัน 1 ที่มีการกำหนดค่า GOOGLE_APP_ID หนึ่งๆ แล้วอัปโหลดเวอร์ชัน 2 ที่มีรหัสอื่น การดำเนินการดังกล่าวอาจทำให้ระบบทิ้งข้อมูล Analytics
3. ในแพลตฟอร์ม Apple ห้ามเพิ่ม GoogleService-Info.plist ลงในโปรเจ็กต์หากคุณกำหนดค่าที่แตกต่างกันในรันไทม์ เนื่องจากอาจทำให้ GOOGLE_APP_ID เปลี่ยนไปและส่งผลให้ข้อมูล Analytics สูญหาย