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

توضِّح هذه الصفحة كيفية استخدام أكثر من مشروع واحد على 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
• ربط الملفات المختلفة بالأهداف المختلفة باستخدام لوحة Target Membership:

إذا كانت الإصدارات جزءًا من هدف واحد، فإنّ الخيار الأفضل هو منح كلا ملفَي الإعداد اسمَين فريدَين (مثل 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.json وتحويله إلى موارد سلسلة Android من خلال المكوّن الإضافي لـ Gradle من "خدمات Google". يمكنك الاطّلاع على الموارد التي يتم إنشاؤها في مستندات المكوّن الإضافي لـ "خدمات Google" ضمن معالجة ملف JSON.

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات المكوّن الإضافي لـ "خدمات Google" ضمن إضافة ملف JSON.

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

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

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

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

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

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

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