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

توضّح هذه الصفحة كيفية استخدام أكثر من مشروع واحد على 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 من خلال المكوّن الإضافي لخدمات Google في Gradle. يمكنك الاطّلاع على الموارد التي يتم إنشاؤها في مستندات المكوّن الإضافي لخدمات 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 باستخدام هذه القيم.

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

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

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

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

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

• Swift: FirebaseOptions(googleAppID:gcmSenderID:)
• ‫Android: FirebaseOptions.Builder
• الويب: initializeApp()
• C++‎: firebase::App::Create
• الوحدة: 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 بمعرّف مختلف، قد يؤدي ذلك إلى إسقاط بيانات الإحصاءات.
3. على منصات Apple، لا تُضِف ملف GoogleService-Info.plist إلى مشروعك إذا كنت توفّر إعدادات مختلفة في وقت التشغيل، لأنّ ذلك قد يؤدي إلى تغيير واضح في GOOGLE_APP_ID وإلى فقدان بيانات "إحصاءات Google".