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

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

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

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

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

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

वेब और एडमिन एसडीके को कॉन्फ़िगर करने के लिए, सीधे तौर पर उनकी वैल्यू को इनिशियलाइज़ेशन फ़ंक्शन में पास किया जाता है. इन 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 प्रोजेक्ट में जोड़ें
TargetMembership पैनल का इस्तेमाल करके, अलग-अलग फ़ाइलों को अलग-अलग टारगेट से जोड़ें:

पैसे चुकाकर ली जाने वाली सदस्यता को टारगेट करने वाला पैनल

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

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

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

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

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

Swift: 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.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 = nilAppDelegate.swift

Kotlin

// 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 ऐप्लिकेशन इंस्टेंस को कॉन्फ़िगर करने के लिए किया जा सकता है. ध्यान दें कि यहां दिए गए सभी उदाहरणों में, हमने secondary स्ट्रिंग का इस्तेमाल किया है. इस नाम का इस्तेमाल, ऐप्लिकेशन इंस्टेंस को वापस पाने के लिए किया जाता है. साथ ही, इसका इस्तेमाल इसे अन्य इंस्टेंस से अलग करने के लिए किया जाता है. इनमें डिफ़ॉल्ट इंस्टेंस ([DEFAULT] नाम वाला) भी शामिल है. आपको ऐसी स्ट्रिंग चुननी चाहिए जो दूसरे Firebase प्रोजेक्ट के इस्तेमाल के हिसाब से सही हो.

यहां दिए गए स्निपेट में, किसी अन्य Realtime Database से कनेक्ट करने का तरीका बताया गया है (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 { 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

Kotlin

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

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

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

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

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