कई प्रोजेक्ट कॉन्फ़िगर करें

यह पेज बताता है कि अपने ऐप में एक से अधिक फायरबेस प्रोजेक्ट का उपयोग कैसे करें।

कई ऐप्स को केवल एक ही फायरबेस प्रोजेक्ट और गेट स्टार्टेड गाइड में वर्णित डिफ़ॉल्ट सेट अप की आवश्यकता होती है। एकाधिक फायरबेस परियोजनाओं का उपयोग करना कब उपयोगी हो सकता है, इसके उदाहरणों में शामिल हैं:

  • बिल्ड प्रकार या लक्ष्य के आधार पर विभिन्न फायरबेस परियोजनाओं का उपयोग करने के लिए अपना विकास वातावरण स्थापित करना।
  • आपके ऐप में एकाधिक फायरबेस प्रोजेक्ट्स से सामग्री तक पहुँचना।

विभिन्न परिवेशों का समर्थन करें

एक सामान्य उपयोग का मामला आपके विकास और उत्पादन परिवेश के लिए अलग-अलग फायरबेस परियोजनाओं का समर्थन करना है।

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

Android और Apple प्लेटफ़ॉर्म (और उनके यूनिटी और 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)

अपने Android एप्लिकेशन में एकाधिक परिवेशों का समर्थन करें

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

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

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

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

फिर इन संसाधनों को FirebaseInitProvider द्वारा लोड किया जाता है, जो आपके एप्लिकेशन कोड से पहले चलता है और उन मानों का उपयोग करके Firebase API को प्रारंभ करता है।

क्योंकि यह प्रदाता केवल ज्ञात नामों वाले संसाधनों को पढ़ रहा है, दूसरा विकल्प Google सेवा ग्रेडल प्लगइन का उपयोग करने के बजाय स्ट्रिंग संसाधनों को सीधे अपने ऐप में जोड़ना है। आप ऐसा कर सकते हैं:

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

अपने एप्लिकेशन में एकाधिक प्रोजेक्ट का उपयोग करें

कभी-कभी आपको एक ही एपीआई का उपयोग करके विभिन्न परियोजनाओं तक पहुंचने की आवश्यकता होती है - उदाहरण के लिए, कई डेटाबेस उदाहरणों तक पहुंच। ज्यादातर मामलों में एक केंद्रीय फायरबेस एप्लिकेशन ऑब्जेक्ट होता है जो सभी फायरबेस एपीआई के लिए कॉन्फ़िगरेशन का प्रबंधन करता है। यह ऑब्जेक्ट आपके सामान्य सेटअप के भाग के रूप में प्रारंभ किया गया है। हालाँकि, जब आप एक ही एप्लिकेशन से कई प्रोजेक्ट्स तक पहुंचना चाहते हैं, तो आपको प्रत्येक को व्यक्तिगत रूप से संदर्भित करने के लिए एक अलग फायरबेस एप्लिकेशन ऑब्जेक्ट की आवश्यकता होगी। इन अन्य उदाहरणों को प्रारंभ करना आप पर निर्भर है।

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

किसी एप्लिकेशन में एकाधिक परियोजनाओं का समर्थन करने के लिए इन कक्षाओं का उपयोग निम्नलिखित उदाहरणों में दिखाया गया है:

तीव्र

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

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()

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

वेब

// The following fields are REQUIRED:
//  - Project ID
//  - App ID
//  - API Key
const secondaryAppConfig = {
    projectId: "<PROJECT_ID>",
    appId: "<APP_ID>",
    apiKey: "<API_KEY>",
    // databaseURL: "...",
    // storageBucket: "...",
};

सी++

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'
};

जावा

FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");

FirebaseOptions secondaryAppConfig = new FirebaseOptions.Builder()
  .setCredential(FirebaseCredentials.fromCertificate(serviceAccount))
  .setDatabaseUrl("https://<DATABASE_NAME>.firebaseio.com/")
  .build();

आपके द्वारा इस विकल्प ऑब्जेक्ट को प्रारंभ करने के बाद, आप इसका उपयोग अतिरिक्त फ़ायरबेस एप्लिकेशन इंस्टेंस को कॉन्फ़िगर करने के लिए कर सकते हैं। ध्यान दें कि नीचे दिखाए गए सभी उदाहरणों में हम स्ट्रिंग सेकेंडरी का उपयोग करते हैं। इस नाम का उपयोग एप्लिकेशन इंस्टेंस को पुनः प्राप्त करने और इसे डिफ़ॉल्ट इंस्टेंस ( [DEFAULT] नाम) सहित अन्य इंस्टेंस से अलग करने के लिए किया जाता है। आपको अन्य फायरबेस प्रोजेक्ट के इच्छित उपयोग के लिए उपयुक्त स्ट्रिंग चुननी चाहिए।

निम्नलिखित स्निपेट वैकल्पिक रीयलटाइम डेटाबेस से कनेक्ट होने का प्रदर्शन करते हैं (अन्य फायरबेस सुविधाओं के लिए एपीआई समान पैटर्न का पालन करते हैं)।

तीव्र

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

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)

Java

// Initialize with secondary app
FirebaseApp.initializeApp(this /* Context */, options, "secondary");

// Retrieve secondary FirebaseApp
FirebaseApp secondary = FirebaseApp.getInstance("secondary");

वेब

// Initialize another app with a different config
const secondaryApp = firebase.initializeApp(secondaryAppConfig, "secondary");
// Access services, such as the Realtime Database
// secondaryApp.database();

सी++

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

जावा

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

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

एनालिटिक्स के लिए विश्वसनीय रिपोर्टिंग सुनिश्चित करें

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

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

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