إعداد مشاريع متعددة

توضِّح هذه الصفحة كيفية استخدام أكثر من مشروع Firebase واحد في تطبيقك.

لا تحتاج العديد من التطبيقات سوى مشروع واحد في Firebase والإعداد التلقائي. الموضحة في أدلة البدء. أمثلة على الحالات التي يمكن أن تكون فيها مفيدة لاستخدام مشاريع متعددة في Firebase، تشمل ما يلي:

  • جارٍ إعداد بيئة التطوير لاستخدام مشاريع مختلفة في Firebase بناءً على نوع الإصدار أو الهدف.
  • الوصول إلى المحتوى من مشاريع متعددة في Firebase داخل تطبيقك.

دعم بيئات مختلفة

تتمثّل إحدى حالات الاستخدام الشائعة في دعم مشاريع Firebase المنفصلة لتطوير مؤسستك وبيئات الإنتاج.

يتم ضبط حزم تطوير البرامج (SDK) للويب والمشرف من خلال تمرير القيم إلى دوال التهيئة. بالنسبة إلى حزمة SDK هذه، يمكنك استخدام فحص وقت التشغيل لاختيار متغيرات إعدادات التطوير أو الإنتاج.

يتم تحميل نظامي التشغيل Android وApple الأساسيين (وبرامج تضمين 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)
  • تخزين الملفين في أدلة مختلفة
  • إضافة كليهما إلى مشروع Xcode
  • ربط الملفات المختلفة بالأهداف المختلفة باستخدام الاستهداف لوحة العضوية:

لوحة العضوية المستهدفة

إذا كانت التصميمات جزءًا من هدف واحد، يكون الخيار الأفضل هو تقديم كلا أسماء فريدة لملفات الإعداد (مثل GoogleService-Info-Free.plist GoogleService-Info-Paid.plist). بعد ذلك، اختَر ملف plist الذي سيتم تحميله في بيئة التشغيل. يظهر ذلك في المثال التالي:

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

دعم بيئات متعددة في تطبيق Android

في Android، تتم معالجة ملف google-services.json في سلسلة Android. الموارد بواسطة المكوّن الإضافي لـ Gradle لخدمات Google. يمكنك الاطّلاع على الموارد التي يتم إنشاؤها في وثائق مكوّن Google Services الإضافي على معالجة ملف JSON:

يمكنك إنشاء عدة ملفات google-services.json لملفات إنشاء الصيغ من خلال وضع google-services.json ملف في أدلة مخصصة تحمل اسم كل ملف ضمن جذر وحدة التطبيق. على سبيل المثال، إذا كان لديك "تطوير" أو "إصدار" وإنشاء النكهات، يمكن تنظيم التكوين على النحو التالي:

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

للحصول على مزيد من المعلومات، يمكنك الاطّلاع على وثائق مكوّن Google Services الإضافي على إضافة ملف JSON

يتم بعد ذلك تحميل هذه الموارد بواسطة FirebaseInitProvider، التي يتم تشغيلها قبل رمز التطبيق وتهيئ واجهات برمجة تطبيقات Firebase باستخدام تلك القيم.

ولأن هذا المزود يقرأ فقط الموارد التي تحمل أسماء معروفة، وهو إضافة موارد السلسلة مباشرةً إلى تطبيقك بدلاً من استخدام المكون الإضافي لـ Gradle في خدمات Google. يمكنك إجراء ذلك من خلال:

  • إزالة المكوّن الإضافي google-services من الجذر build.gradle
  • جارٍ حذف google-services.json من مشروعك
  • إضافة موارد السلسلة مباشرةً
  • جارٍ حذف "apply plugin: 'com.google.gms.google-services'" من تطبيقك "build.gradle"

استخدام مشاريع متعددة في طلبك

تحتاج أحيانًا إلى الوصول إلى مشروعات مختلفة باستخدام نفس واجهات برمجة التطبيقات - مثل، الوصول إلى مثيلات قاعدة بيانات متعددة. في معظم الحالات، هناك حساب مركزي عنصر تطبيق Firebase الذي يدير الإعداد لجميع Firebase واجهات برمجة التطبيقات. تم إعداد هذا الكائن كجزء من عملية الإعداد العادية. ومع ذلك، عندما وتريد الوصول إلى مشروعات متعددة من تطبيق واحد، فستحتاج إلى كائن تطبيق Firebase المميز للإشارة إلى كل عنصر على حدة. من المهم لك لإعداد هذه المثيلات الأخرى.

في كلتا الحالتين، تحتاج أولاً إلى إنشاء كائن خيارات Firebase للاحتفاظ بيانات التهيئة لتطبيق Firebase. الوثائق الكاملة للخيارات المتاحة في الوثائق المرجعية لواجهة برمجة التطبيقات الفئات التالية:

يظهر استخدام هذه الفئات لدعم مشروعات متعددة في أحد التطبيقات في الأمثلة التالية:

Swift

// 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.trackingID = "UA-12345678-1"
secondaryOptions.clientID = "27992087142-ola6qe637ulk8780vl8mo5vogegkm23n.apps.googleusercontent.com"
secondaryOptions.databaseURL = "https://myproject.firebaseio.com"
secondaryOptions.storageBucket = "myproject.appspot.com"
secondaryOptions.androidClientID = "12345.apps.googleusercontent.com"
secondaryOptions.deepLinkURLScheme = "myapp://"
secondaryOptions.storageBucket = "projectid-12345.appspot.com"
secondaryOptions.appGroupID = nil
AppDelegate.swift

Kotlin+KTX 

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

Java 

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

C++‎

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

Unity

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

Node.js

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 بديل. (تتّبِع واجهات برمجة التطبيقات لميزات Firebase الأخرى النمط نفسه).

Swift

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

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


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

Kotlin+KTX 

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

Java 

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

C++‎

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

Unity

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

Node.js

// 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 وتطلب إعلانات عند بدء التشغيل على النحو الموصى به، يمكنك بعض بيانات "إحصاءات Google" المتعلقة بإعلانات الأجهزة الجوّالة عند عدم استخدام المورد على أساس التصميم.
  2. احرص على تقديم رقم تعريف واحد فقط لتطبيق Google في كل صيغة موزّعة من تطبيقك. على سبيل المثال، إذا كنت تشحن الإصدار 1 من تطبيقك بقيمة GOOGLE_APP_ID محدّدة بالتهيئة ثم تحميل الإصدار 2 بمعرّف مختلف، فقد يتسبب ذلك البيانات التحليلية التي سيتم إسقاطها.
  3. على أنظمة Apple الأساسية، لا تضف GoogleService-Info.plist إلى مشروعك إذا توفر تهيئة مختلفة في وقت التشغيل، إذ قد ينتج عن ذلك تغيير واضح في GOOGLE_APP_ID ويؤدي إلى فقدان "إحصاءات Google".