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

इस पेज पर बताया गया है कि आप अपने ऐप्लिकेशन में एक से ज़्यादा 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 प्रोजेक्ट में जोड़ें
• Target का इस्तेमाल करके, अलग-अलग फ़ाइलों को अलग-अलग टारगेट से जोड़ें सदस्यता पैनल:

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

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

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

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

इसके बाद, इन संसाधनों को Google News की FirebaseInitProvider, जो आपके ऐप्लिकेशन कोड से पहले चलता है और इसका इस्तेमाल करके Firebase API को शुरू करता है नहीं दी गई हैं.

यह कंपनी जाने-पहचाने नाम से जुड़े संसाधनों को पढ़ रही है, इसलिए दूसरा इसका विकल्प यह है कि Google सेवाओं का Gradle प्लग इन. ऐसा करने के लिए:

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

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

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

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

• स्विफ़्ट: FirebaseOptions(googleAppID:gcmSenderID:)
• Android: FirebaseOptions.Builder
• वेब: initializeApp()
• सी++: 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 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 { 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);

Analytics के लिए भरोसेमंद रिपोर्टिंग की सुविधा चालू करें

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

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

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