एक से ज़्यादा प्रोजेक्ट कॉन्फ़िगर करना

इस पेज पर, आपके ऐप्लिकेशन में एक से ज़्यादा Firebase प्रोजेक्ट इस्तेमाल करने का तरीका बताया गया है.

कई ऐप्लिकेशन के लिए सिर्फ़ एक Firebase प्रोजेक्ट की ज़रूरत होती है. साथ ही, डिफ़ॉल्ट सेट अप के बारे में शुरू करें गाइड में बताया गया है. एक से ज़्यादा Firebase प्रोजेक्ट का इस्तेमाल करना कब फ़ायदेमंद हो सकता है, इसके उदाहरण:

• बिल्ड टाइप या टारगेट के आधार पर अलग-अलग Firebase प्रोजेक्ट का इस्तेमाल करने के लिए, अपना डेवलपमेंट एनवायरमेंट सेट अप करना.
• अपने ऐप्लिकेशन में एक से ज़्यादा Firebase प्रोजेक्ट से कॉन्टेंट ऐक्सेस करना.

अलग-अलग एनवायरमेंट के साथ काम करता है

इसका एक सामान्य उदाहरण यह है कि आप अपने डेवलपमेंट और प्रोडक्शन एनवायरमेंट के लिए, अलग-अलग Firebase प्रोजेक्ट की मदद करें.

वेब और एडमिन SDK टूल कॉन्फ़िगर करने के लिए, सीधे उनके शुरू करने वाले फ़ंक्शन में वैल्यू पास की जाती है. इन SDK टूल के लिए, रनटाइम की जांच का इस्तेमाल करके, डेवलपमेंट या प्रोडक्शन के कॉन्फ़िगरेशन वैरिएबल चुने जा सकते हैं.

Android और Apple प्लैटफ़ॉर्म (और उनके Unity और C++ रैपर), आम तौर पर कॉन्फ़िगरेशन फ़ाइल से कॉन्फ़िगरेशन लोड करते हैं: Apple प्लैटफ़ॉर्म पर GoogleService-Info.plist और Android पर google-services.json. इन फ़ाइलों को एक विकल्प ऑब्जेक्ट (FIROption या FirebaseOptions) में पढ़ा जाता है, जिसे Firebase ऐप्लिकेशन ऑब्जेक्ट (FIRApp या FirebaseApp) से रेफ़र किया जाता है.

इन प्लैटफ़ॉर्म के लिए, एनवायरमेंट के बीच स्विच करना, आम तौर पर बिल्ड के समय के फ़ैसले के तौर पर लागू होता है. ऐसा हर एनवायरमेंट के लिए अलग-अलग कॉन्फ़िगरेशन फ़ाइलों का इस्तेमाल करके किया जाता है.

आपके Apple ऐप्लिकेशन में एक से ज़्यादा एनवायरमेंट के साथ काम करता हो

डिफ़ॉल्ट रूप से, FirebaseApp.configure() ऐप्लिकेशन के साथ बंडल की गई GoogleService-Info.plist फ़ाइल लोड करेगा. अगर आपके डेवलपमेंट और प्रोडक्शन एनवायरमेंट को Xcode में अलग-अलग टारगेट के तौर पर कॉन्फ़िगर किया गया है, तो ये काम किए जा सकते हैं:

• दोनों GoogleService-Info.plist फ़ाइलें डाउनलोड करें
• दोनों फ़ाइलों को अलग-अलग डायरेक्ट्री में स्टोर करें
• अपने Xcode प्रोजेक्ट में दोनों को जोड़ें
• टारगेट सदस्यता पैनल का इस्तेमाल करके, अलग-अलग फ़ाइलों को अलग-अलग टारगेट से जोड़ें:

अगर बिल्ड किसी एक टारगेट का हिस्सा हैं, तो सबसे अच्छा विकल्प यह है कि दोनों कॉन्फ़िगरेशन फ़ाइलों को यूनीक नाम दिया जाए (जैसे, 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)

चेतावनी: यह तरीका कुछ मामलों में Analytics के डेटा को इकट्ठा करने पर असर डाल सकता है. भरोसेमंद आंकड़े सेक्शन देखें.

आपके Android ऐप्लिकेशन में एक से ज़्यादा एनवायरमेंट काम करते हैं

Android में, google-services.json फ़ाइल को Google Services gradle प्लगिन की मदद से Android स्ट्रिंग संसाधनों में प्रोसेस किया जाता है. JSON फ़ाइल प्रोसेस करने पर, Google Services प्लगिन दस्तावेज़ में यह देखा जा सकता है कि कौनसे संसाधन बनाए गए हैं.

आपके पास ऐप्लिकेशन मॉड्यूल रूट के तहत, हर वैरिएंट के नाम वाली खास डायरेक्ट्री में google-services.json फ़ाइलों को रखने का विकल्प होता है. ऐसा करके, अलग-अलग वैरिएंट बनाने के लिए कई google-services.json फ़ाइलें बनाई जा सकती हैं. उदाहरण के लिए, अगर आपके पास "डेवलपमेंट" और "रिलीज़" बिल्ड फ़्लेवर हैं, तो आपका कॉन्फ़िगरेशन इस तरह से व्यवस्थित किया जा सकता है:

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

ज़्यादा जानने के लिए, JSON फ़ाइल जोड़ना पर Google Services प्लग इन दस्तावेज़ देखें.

इसके बाद, इन रिसॉर्स को FirebaseInitProvider से लोड किया जाता है. यह आपके ऐप्लिकेशन कोड से पहले चलता है और उन वैल्यू का इस्तेमाल करके, Firebase API को शुरू करता है.

यह सेवा देने वाली कंपनी सिर्फ़ जाने-पहचाने नामों वाले रिसॉर्स पढ़ रही है. इसलिए, दूसरा विकल्प यह है कि Google Services gradle प्लगिन का इस्तेमाल करने के बजाय, स्ट्रिंग रिसॉर्स को सीधे अपने ऐप्लिकेशन में जोड़ा जाए. ऐसा करने के लिए:

• आपके रूट build.gradle से google-services प्लगिन हटाया जा रहा है
• आपके प्रोजेक्ट से google-services.json को मिटाया जा रहा है
• स्ट्रिंग रिसॉर्स सीधे जोड़ना
• आपके ऐप्लिकेशन build.gradle से apply plugin: 'com.google.gms.google-services' को मिटाया जा रहा है

अपने आवेदन में एक से ज़्यादा प्रोजेक्ट इस्तेमाल करना

कभी-कभी आपको एक ही एपीआई का इस्तेमाल करके, अलग-अलग प्रोजेक्ट ऐक्सेस करने पड़ते हैं. जैसे, एक से ज़्यादा डेटाबेस इंस्टेंस ऐक्सेस करना. ज़्यादातर मामलों में, एक मुख्य Firebase ऐप्लिकेशन ऑब्जेक्ट होता है, जो सभी Firebase API का कॉन्फ़िगरेशन मैनेज करता है. इस ऑब्जेक्ट को आपके सामान्य सेटअप के हिस्से के तौर पर शुरू किया जाता है. हालांकि, अगर आपको एक ही ऐप्लिकेशन से कई प्रोजेक्ट ऐक्सेस करने हैं, तो आपको हर प्रोजेक्ट के लिए अलग-अलग Firebase ऐप्लिकेशन ऑब्जेक्ट की ज़रूरत होगी. इन दूसरे इंस्टेंस को शुरू करने की ज़िम्मेदारी आपकी है.

दोनों मामलों में, आपको Firebase ऐप्लिकेशन का कॉन्फ़िगरेशन डेटा होल्ड करने के लिए, सबसे पहले Firebase विकल्प ऑब्जेक्ट बनाना होगा. नीचे दी गई क्लास के लिए, विकल्पों से जुड़े सभी दस्तावेज़, एपीआई रेफ़रंस दस्तावेज़ में देखे जा सकते हैं:

• स्विफ़्ट: FirebaseOptions(googleAppID:gcmSenderID:)
• Android: FirebaseOptions.Builder
• वेब: initializeApp()
• C++: firebase::App::Create
• Unity: FirebaseApp.Create
• Node.js: initializeApp
• Java: FirebaseOptions.Builder

एक ही ऐप्लिकेशन में एक से ज़्यादा प्रोजेक्ट को चलाने के लिए इन क्लास का इस्तेमाल करने का तरीका नीचे दिए गए उदाहरणों में दिखाया गया है:

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

Java

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 प्रोजेक्ट के इस्तेमाल के हिसाब से सही स्ट्रिंग चुननी चाहिए.

नीचे दिए गए स्निपेट, किसी अन्य रीयल टाइम डेटाबेस से कनेक्ट करने के बारे में बताते हैं. 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

Java

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

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

ध्यान दें: Android और Apple प्लैटफ़ॉर्म पर, Analytics को सिर्फ़ डिफ़ॉल्ट ऐप्लिकेशन के लिए लॉग किया जाता है.

Analytics के लिए भरोसेमंद रिपोर्टिंग पक्का करना

Google Analytics, ऐप्लिकेशन के स्टार्ट अप फ़्लो के शुरू में ही इवेंट इकट्ठा कर लेता है. ऐसा, कुछ मामलों में मुख्य Firebase ऐप्लिकेशन इंस्टेंस को कॉन्फ़िगर करने से पहले भी हो जाता है. इन मामलों में, ऐप्लिकेशन इवेंट को स्टोर करने के लिए सही Google app आईडी खोजने के लिए Firebase, Android के संसाधन या Apple प्लैटफ़ॉर्म पर GoogleService-Info.plist का इस्तेमाल करता है. इसी वजह से, हमारी सलाह है कि जहां भी मुमकिन हो, डिफ़ॉल्ट कॉन्फ़िगरेशन के तरीकों का इस्तेमाल करें.

अगर रनटाइम कॉन्फ़िगरेशन की ज़रूरत है, तो कृपया इन चेतावनियों पर ध्यान दें:

1. अगर आपने AdMob का इस्तेमाल करते समय, विज्ञापनों के शुरू होने का अनुरोध किया है, तो हो सकता है कि रिसॉर्स पर आधारित कॉन्फ़िगरेशन का इस्तेमाल न करने पर, मोबाइल विज्ञापनों से जुड़ा Analytics का कुछ डेटा छूट जाए.
2. अपने ऐप्लिकेशन के हर वैरिएंट में, Google app का सिर्फ़ एक आईडी डालें. उदाहरण के लिए, अगर कॉन्फ़िगरेशन में किसी खास GOOGLE_APP_ID के साथ ऐप्लिकेशन का वर्शन 1 भेजा जाता है, तो अलग-अलग आईडी के साथ वर्शन 2 अपलोड करें. ऐसा करने पर, Analytics का डेटा मिट सकता है.
3. अगर रन टाइम के समय अलग-अलग कॉन्फ़िगरेशन की सप्लाई की जा रही है, तो Apple प्लैटफ़ॉर्म पर अपने प्रोजेक्ट में GoogleService-Info.plist न जोड़ें. ऐसा करने पर, GOOGLE_APP_ID साफ़ तौर पर बदल सकता है और Analytics में गड़बड़ी हो सकती है.