تكوين مشاريع متعددة

توضح هذه الصفحة كيفية استخدام أكثر من مشروع 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 ). ثم اختر في وقت التشغيل القائمة التي سيتم تحميلها. هذا هو مبين في المثال التالي:

// 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 بواسطة البرنامج الإضافي Google Services gradle. يمكنك معرفة الموارد التي تم إنشاؤها في وثائق Google Services Plugin في معالجة ملف JSON .

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

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

لمعرفة المزيد، راجع وثائق البرنامج الإضافي لخدمات Google حول إضافة ملف JSON .

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

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

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

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

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

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

• سويفت: FirebaseOptions(googleAppID:gcmSenderID:)
• أندرويد: FirebaseOptions.Builder
• الويب: initializeApp()
• C++: firebase::App::Create
• الوحدة: FirebaseApp.Create
• Node.js: initializeApp
• جافا: 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.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

// 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 إضافي. لاحظ أنه في جميع الأمثلة الموضحة أدناه نستخدم السلسلة الثانوية . يتم استخدام هذا الاسم لاسترداد مثيل التطبيق، وتمييزه عن المثيلات الأخرى، بما في ذلك المثيل الافتراضي (المسمى [DEFAULT] ). يجب عليك اختيار سلسلة مناسبة للاستخدام المقصود لمشروع Firebase الآخر.

توضح المقتطفات التالية الاتصال بقاعدة بيانات Realtime بديلة (تتبع واجهات برمجة التطبيقات لميزات 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 { 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

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

ضمان إعداد تقارير موثوقة للتحليلات

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

إذا كان تكوين وقت التشغيل مطلوبًا، فيرجى ملاحظة التحذيرات التالية:

1. إذا كنت تستخدم AdMob وتطلب الإعلانات عند بدء التشغيل على النحو الموصى به، فقد تفوتك بعض بيانات Analytics المتعلقة بإعلانات الجوال عند عدم استخدام نهج التكوين المستند إلى الموارد.
2. قم بتوفير معرف تطبيق Google واحد فقط في كل نسخة موزعة من تطبيقك. على سبيل المثال، إذا قمت بشحن الإصدار 1 من تطبيقك بمعرف GOOGLE_APP_ID معين في التكوين ثم قمت بتحميل الإصدار 2 بمعرف مختلف، فقد يتسبب ذلك في إسقاط البيانات التحليلية.
3. على أنظمة Apple الأساسية، لا تقم بإضافة GoogleService-Info.plist إلى مشروعك إذا كنت تقدم تكوينًا مختلفًا في وقت التشغيل، حيث يمكن أن يؤدي ذلك إلى تغيير واضح في GOOGLE_APP_ID ويؤدي إلى فقدان Analytics.