Firebase इंस्टॉलेशन मैनेज करें

Firebase इंस्टॉलेशन सेवा (FIS), Firebase ऐप्लिकेशन के इंस्टॉल किए गए हर इंस्टेंस के लिए एक Firebase इंस्टॉलेशन आईडी (एफ़आईडी) देती है. Firebase इंस्टॉलेशन आईडी का इस्तेमाल इन Firebase सेवाओं में अंदरूनी तौर पर किया जाता है:

Firebase सेवा Firebase इंस्टॉल करने की सुविधा
Firebase क्लाउड से मैसेज

'Firebase क्लाउड से मैसेज', मैसेज डिलीवरी के लिए डिवाइस को टारगेट करने के लिए Firebase इंस्टॉलेशन आईडी का इस्तेमाल करता है.

Firebase Crashlytics

ऐप्लिकेशन इंस्टेंस के Firebase इंस्टॉलेशन आईडी में हुए बदलावों के आधार पर, Firebase Crashlytics का इस्तेमाल करके Crashlytics इंस्टॉल करने वाले उपयोगकर्ता के यूयूआईडी को बदला जाता है. आने वाले समय में, इंस्टॉलेशन आईडी का इस्तेमाल, क्रैश रिपोर्टिंग और क्रैश मैनेजमेंट की सेवाओं को बेहतर बनाने वाली सुविधाओं को चालू करने के लिए किया जा सकता है.

Firebase इन-ऐप्लिकेशन मैसेज

Firebase इन-ऐप्लिकेशन मैसेज, मैसेज डिलीवरी के लिए डिवाइस को टारगेट करने के लिए Firebase इंस्टॉलेशन आईडी का इस्तेमाल करता है.

Firebase प्रदर्शन मॉनिटर करना

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

Firebase रिमोट कॉन्फ़िगरेशन

रिमोट कॉन्फ़िगरेशन, असली उपयोगकर्ता के डिवाइसों पर वापस जाने के लिए, Firebase इंस्टॉलेशन आईडी का इस्तेमाल करके कॉन्फ़िगरेशन वैल्यू चुनता है.
Firebase ML

ऐप्लिकेशन इंस्टेंस से इंटरैक्ट करते समय डिवाइस की पुष्टि करने के लिए, Firebase एमएल इंस्टॉलेशन की पुष्टि करने वाले टोकन नाम के क्रेडेंशियल का इस्तेमाल करता है. उदाहरण के लिए, डेवलपर मॉडल को ऐप्लिकेशन इंस्टेंस में बांटने के लिए.

Firebase उपयोगकर्ता को ग्रुप में बांटने के लिए स्टोरेज

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

आम तौर पर, Firebase सेवाएं डेवलपर को एफ़आईएस एपीआई से सीधे इंटरैक्ट करने की ज़रूरत के बिना ही Firebase इंस्टॉलेशन सेवा का इस्तेमाल करती हैं. हालांकि, कुछ मामलों में ऐसा हो सकता है कि ऐप्लिकेशन डेवलपर सीधे FIS API को कॉल करना चाहें, जैसे कि:

  • Firebase इंस्टॉलेशन और इंस्टॉलेशन से जुड़े डेटा को मिटाने के लिए.
  • किसी खास ऐप्लिकेशन इंस्टॉलेशन को टारगेट करने के लिए, आइडेंटिफ़ायर (Firebase इंस्टॉलेशन आईडी) को फिर से पाने के लिए.
  • Firebase इंस्टॉलेशन की पुष्टि करने के लिए, इंस्टॉलेशन की पुष्टि करने वाले टोकन फिर से पाएं.

सीधे FIS API को कॉल करने के लिए, अपने ऐप्लिकेशन में SDK टूल जोड़ें.

अपने ऐप्लिकेशन में Firebase इंस्टॉलेशन SDK टूल जोड़ना

iOS और उसके बाद के वर्शन

  1. अपनी Podfile में, Firebase इंस्टॉल करने के लिए डिपेंडेंसी जोड़ें: 
    pod 'FirebaseInstallations'
  2. pod install चलाएं और बनाई गई .xcworkspace फ़ाइल खोलें.
  3. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल को इंपोर्ट करें. साथ ही, ऐसे सभी Firebase मॉड्यूल को इंपोर्ट करें जिनका इस्तेमाल आपके ऐप्लिकेशन का ऐक्सेस मैनेज करता है. उदाहरण के लिए, Cloud Firestore और पुष्टि करने की सुविधा का इस्तेमाल करने के लिए:

    स्विफ़्टयूआई

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  4. अपने ऐप्लिकेशन का ऐक्सेस देने वाले व्यक्ति के application(_:didFinishLaunchingWithOptions:) तरीके में, FirebaseApp शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:

    स्विफ़्टयूआई

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  5. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो आपको ऐप्लिकेशन का ऐक्सेस देना होगा और उसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor की मदद से अपने App स्ट्रक्चर में अटैच करना होगा. आपको ऐप्लिकेशन सौंपने की सुविधा को स्वाइप करने की सुविधा भी बंद करनी होगी. ज़्यादा जानकारी के लिए, SwiftUI के निर्देश देखें.

    स्विफ़्टयूआई

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Android

अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर app/build.gradle) में, Firebase इंस्टॉलेशन Android SDK के लिए डिपेंडेंसी जोड़ें:

implementation 'com.google.firebase:firebase-installations:18.0.0'

JavaScript

आपका कॉन्फ़िगरेशन अपने-आप मैनेज हो सकता है या आपको Firebase कॉन्फ़िगरेशन ऑब्जेक्ट अपडेट करना पड़ सकता है. यह इस बात पर निर्भर करता है कि आपका वेब ऐप्लिकेशन कैसे होस्ट किया जाता है.

उदाहरण के लिए, अगर index.html में आपकी डिपेंडेंसी जोड़ी जाती हैं, तो <head> एलिमेंट में डिपेंडेंसी जोड़ें:

<script src="/__/firebase/10.12.2/firebase-installations.js"></script>

Flutter

  1. अपने Flutter प्रोजेक्ट की रूट डायरेक्ट्री से, Firebase इंस्टॉलेशन प्लगिन इंस्टॉल करने के लिए यह कमांड चलाएं:

    flutter pub add firebase_app_installations

  2. अपना प्रोजेक्ट फिर से बनाएं:

    flutter run

  3. Firebase इंस्टॉलेशन प्लगिन इंपोर्ट करें:

    import 'package:firebase_app_installations/firebase_app_installations.dart';

Firebase इंस्टॉलेशन को मिटाएं

Firebase इंस्टॉलेशन से जुड़ा डेटा, आम तौर पर व्यक्तिगत पहचान नहीं करता. फिर भी, उपयोगकर्ताओं को इस डेटा को मैनेज करने और मिटाने का विकल्प देना मददगार हो सकता है.

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

जब किसी इंस्टॉलेशन आईडी को मिटाया जाता है, तो उस इंस्टॉलेशन आईडी से जुड़ा डेटा, सभी Firebase सेवाओं के लाइव और बैकअप सिस्टम से हटा दिया जाता है. ये सेवाएं Firebase इंस्टॉलेशन आईडी का इस्तेमाल करके, इंस्टॉलेशन की पहचान करने के लिए 180 दिन लेती हैं. इस प्रोसेस के बारे में Google के डेटा मिटाने और उसे अपने साथ जोड़े रखने से जुड़े स्टेटमेंट में बड़े लेवल पर बताया गया है.

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

क्लाइंट एपीआई कॉल से एफ़आईडी मिटाना

Firebase सेवाओं से जनरेट किए गए एफ़आईडी मिटाने के लिए, Firebase इंस्टॉलेशन SDK टूल से सही तरीके को कॉल करें:

Swift

do {
  try await Installations.installations().delete()
  print("Installation deleted");
} catch {
  print("Error deleting installation: \(error)")
}
AppDelegate.swift

Objective-C

[[FIRInstallations installations] deleteWithCompletion:^(NSError *error) {
   if (error != nil) {
     NSLog(@"Error deleting Installation %@", error);
     return;
   }
   NSLog(@"Installation deleted");
}];
ObjCSnippets.m

Java 

FirebaseInstallations.getInstance().delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(@NonNull Task<Void> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation deleted");
        } else {
            Log.e("Installations", "Unable to delete Installation");
        }
    }
});
MainActivity.java

Kotlin+KTX 

FirebaseInstallations.getInstance().delete().addOnCompleteListener { task ->
    if (task.isComplete) {
        Log.d("Installations", "Installation deleted")
    } else {
        Log.e("Installations", "Unable to delete Installation")
    }
}
MainActivity.kt

JavaScript

await firebase.installations().delete();
index.js

Dart 

await FirebaseInstallations.instance.delete();

सर्वर एपीआई कॉल से एफ़आईडी मिटाना

सर्वर एपीआई कॉल वाले एफ़आईडी को मिटाने के लिए, अपने सर्वर में Firebase एडमिन SDK टूल जोड़ें. अगर आपने पहले से ऐसा नहीं किया है, तो ऐसा करें.

SDK टूल जोड़ने के बाद, अपनी पसंद की भाषा में मिटाने वाले फ़ंक्शन को कॉल करके एफ़आईडी मिटाएं (ध्यान दें: Node.js को छोड़कर, इन तरीकों में इंस्टेंस आईडी का नाम दिखता है. हालांकि, किसी भी मौजूदा Firebase SDK टूल के साथ कॉल करने पर, वे सभी एफ़आईडी को मिटा देते हैं.

Node.js के लिए

// An FIDsent from a client service SDK
const idToDelete = 'eyJhbGciOiJFUzI1N_iIs5';

admin.installations().deleteInstallation(idToDelete);

Java 

// An FID sent from a client service SDK
String idToDelete = "eyJhbGciOiJFUzI1N_iIs5";

FirebaseInstanceId.getInstance().deleteInstanceIdAsync(idToDelete).get();

Python

  from firebase_admin import instance_id

  # An FID sent from a client service SDK
  id_to_delete = 'eyJhbGciOiJFUzI1N_iIs5'

  instance_id.delete_instance_id(id_to_delete)

शुरू करें

client, err := app.InstanceId(ctx)
if err != nil {
  log.Fatalln("error initializing client", err)
}

iidToDelete := "eyJhbGciOiJFUzI1N_iIs5"
if err := client.DeleteInstanceId(ctx, iidToDelete); err != nil {
  log.Fatalln("error deleting FID", err)
}

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

अगर आपको मौजूदा Firebase इंस्टॉलेशन आईडी मिटाना है और Firebase की सेवाओं का इस्तेमाल नए आईडी के साथ तुरंत करना है, तो क्लाइंट एपीआई का इस्तेमाल करें.

क्लाइंट आइडेंटिफ़ायर की जानकारी वापस पाना

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

Firebase इंस्टॉलेशन आईडी वापस पाने के लिए:

Swift

do {
  let id = try await Installations.installations().installationID()
  print("Installation ID: \(id)")
} catch {
  print("Error fetching id: \(error)")
}
AppDelegate.swift

Objective-C

[[FIRInstallations installations] installationIDWithCompletion:^(NSString *identifier, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation ID %@", error);
    return;
  }
  NSLog(@"Installation ID: %@", identifier);
}];
ObjCSnippets.m

Java 

FirebaseInstallations.getInstance().getId()
        .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation ID: " + task.getResult());
        } else {
            Log.e("Installations", "Unable to get Installation ID");
        }
    }
});
MainActivity.java

Kotlin+KTX 

FirebaseInstallations.getInstance().id.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        Log.d("Installations", "Installation ID: " + task.result)
    } else {
        Log.e("Installations", "Unable to get Installation ID")
    }
}
MainActivity.kt

JavaScript

const installationId = await firebase.installations().getId();
console.log(installationId);
index.js

Dart 

String id = await FirebaseInstallations.instance.getId();

इंस्टॉल करने की पुष्टि करने वाले टोकन वापस पाएं

Firebase सेवाएं, एफ़आईएस से मिले पुष्टि वाले टोकन की मदद से, Firebase इंस्टॉल करने की पुष्टि कर सकती हैं. उदाहरण के लिए, रिमोट कॉन्फ़िगरेशन के लिए A/B टेस्ट डिज़ाइन करते समय, इंस्टॉलेशन की पुष्टि करने वाले टोकन का इस्तेमाल करके टारगेट किए गए टेस्ट डिवाइस की पुष्टि की जा सकती है.

इंस्टॉलेशन की पुष्टि करने वाला टोकन, JSON वेब टोकन (JWT) फ़ॉर्मैट में कम समय तक चलने वाला बेयरर टोकन होता है. इसमें इंस्टॉलेशन के बारे में यह जानकारी होती है:

  • Firebase इंस्टॉलेशन आईडी
  • इससे जुड़ा प्रोजेक्ट (projectNumber)
  • इससे जुड़ा Firebase ऐप्लिकेशन आईडी (appId)
  • टोकन के खत्म होने की तारीख

इंस्टॉलेशन की पुष्टि करने वाले टोकन को रद्द नहीं किया जा सकता. साथ ही, यह समयसीमा खत्म होने की तारीख तक मान्य रहता है. डिफ़ॉल्ट टोकन की लाइफ़टाइम वैल्यू एक हफ़्ता है.

इंस्टॉलेशन की पुष्टि करने वाला टोकन वापस पाने के लिए:

Swift

do {
  let result = try await Installations.installations()
    .authTokenForcingRefresh(true)
  print("Installation auth token: \(result.authToken)")
} catch {
  print("Error fetching token: \(error)")
}
AppDelegate.swift

Objective-C

[[FIRInstallations installations] authTokenForcingRefresh:true
                                               completion:^(FIRInstallationsAuthTokenResult *result, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation token %@", error);
    return;
  }
  NSLog(@"Installation auth token: %@", [result authToken]);
}];
ObjCSnippets.m

Java 

FirebaseInstallations.getInstance().getToken(/* forceRefresh */true)
        .addOnCompleteListener(new OnCompleteListener<InstallationTokenResult>() {
    @Override
    public void onComplete(@NonNull Task<InstallationTokenResult> task) {
        if (task.isSuccessful() && task.getResult() != null) {
            Log.d("Installations", "Installation auth token: " + task.getResult().getToken());
        } else {
            Log.e("Installations", "Unable to get Installation auth token");
        }
    }
});
MainActivity.java

Kotlin+KTX 

val forceRefresh = true
FirebaseInstallations.getInstance().getToken(forceRefresh)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d("Installations", "Installation auth token: " + task.result?.token)
        } else {
            Log.e("Installations", "Unable to get Installation auth token")
        }
    }
MainActivity.kt

JavaScript

const installationToken = await firebase.installations()
    .getToken(/* forceRefresh */ true);
console.log(installationToken);
index.js

Dart 

String token = await FirebaseInstallations.instance.getToken();

Firebase इंस्टॉलेशन आईडी की लाइफ़साइकल पर नज़र रखें

ऐप्लिकेशन के सामान्य इस्तेमाल के दौरान, Firebase इंस्टॉलेशन आईडी (एफ़आईडी) को खास मॉनिटर करने की ज़रूरत नहीं होती. हालांकि, जो ऐप्लिकेशन साफ़ तौर पर एफ़आईडी वापस लाते हैं और उनका इस्तेमाल करते हैं उन्हें एफ़आईडी के डेटा को मिटाए जाने या रोटेशन की संभावना पर नज़र रखने के लिए एक लॉजिक जोड़ना चाहिए. यहां कुछ ऐसे मामले दिए गए हैं जिनमें एफ़आईडी को मिटाया या घुमाया जा सकता है:

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

जब इस तरह के मामलों में ऐप्लिकेशन के एफ़आईडी रोटेशन या मिटाने की समस्या होती है, तो उन्हें एक नया एफ़आईडी असाइन किया जाता है. साथ ही, मिटाए गए एफ़आईडी से जुड़ा इंस्टॉलेशन की पुष्टि करने वाला टोकन भी मिट जाता है, भले ही उसकी उम्र कुछ भी हो. साथ ही, इसकी जगह नए इंस्टॉलेशन की पुष्टि करने वाले टोकन का इस्तेमाल किया जाता है.

ऐप्लिकेशन इन बदलावों की निगरानी कर सकते हैं और उसी हिसाब से कार्रवाई कर सकते हैं.

एफ़आईडी रोटेशन की निगरानी करने के लिए:

Swift

installationIDObserver = NotificationCenter.default.addObserver(
        forName: .InstallationIDDidChange,
        object: nil,
        queue: nil
) { (notification) in
  // Fetch new Installation ID
  Task {
    await self.fetchInstallationToken()
  }
}
AppDelegate.swift

Objective-C

__weak __auto_type weakSelf = self;
self.installationIDObserver = [[NSNotificationCenter defaultCenter]
        addObserverForName: FIRInstallationIDDidChangeNotification
                    object:nil
                     queue:nil
                usingBlock:^(NSNotification * _Nonnull notification) {
    // Fetch new Installation ID
    [weakSelf fetchInstallationsID];
}];
ObjCSnippets.m

जब भी कोई नया एफ़आईडी असाइन किया जाता है, तो NSNotificationName.InstallationIDDidChange नाम का NSNotificationCenter, डिफ़ॉल्ट NSNotificationCenter पर पोस्ट किया जाता है.

Android

नए एफ़आईडी को वापस पाने के लिए, फ़ेल हो चुके कॉल का जवाब देने के लिए, Kotlin और Java क्लाइंट को फिर से कोशिश करने वाला लॉजिक जोड़ना चाहिए.

JavaScript

वेब ऐप्लिकेशन, onIdChange हुक की सदस्यता ले सकते हैं.

जब भी कोई नया एफ़आईडी बनाया जाता है, तो जिस कॉलबैक की सदस्यता ली गई है वह ट्रिगर होता है:

await firebase.installations().onIdChange((newId) => {
  console.log(newId);
  // TODO: Handle new installation ID.
});

Dart 

FirebaseInstallations.instance.onIdChange.listen((token) {
  print('FID token: $token');
});

इंस्टेंस आईडी से Firebase इंस्टॉलेशन पर माइग्रेट करना

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

माइग्रेशन की प्रोसेस, आपके ऐप्लिकेशन के हिसाब से अलग-अलग होती है:

  • जो ऐप्लिकेशन सीधे तौर पर इंस्टेंस आईडी एपीआई को कॉल नहीं करते वे अपने SDK टूल के वर्शन अपडेट करके माइग्रेट कर सकते हैं. ज़्यादातर Firebase ऐप्लिकेशन इस कैटगरी में आते हैं.

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

फ़िलहाल, एफ़आईएस लेगसी आइडेंटिफ़ायर Firebase इंस्टेंस आईडी के साथ काम करता है. आईआईडी मिटाना, इन Firebase SDK टूल की मदद से डेटा मिटाने का अनुरोध करने का एक दूसरा तरीका है:

  • iOS 6.14.0 और इससे पहले के वर्शन
  • 27 फ़रवरी, 2020 से पहले के Android SDK

इसका मतलब है कि ऐप्लिकेशन को Firebase इंस्टॉलेशन पर माइग्रेट करने की ज़रूरी नहीं है; हालांकि, हमारा सुझाव है कि ऐसा करें.

Firebase इंस्टॉलेशन के लिए, SDK टूल के कम से कम वर्शन पर अपग्रेड करना

इंस्टेंस आईडी से Firebase इंस्टॉलेशन पर माइग्रेट करने के लिए, पक्का करें कि आपके ऐप्लिकेशन में नीचे दिए गए कम से कम Firebase SDK टूल की सूची में शामिल कम से कम वर्शन का इस्तेमाल किया गया हो:

Firebase SDK टूल Android का कम से कम वर्शन iOS का कम से कम वर्शन
Firebase क्लाउड से मैसेज 20.3.0 वर्शन 6.34.0 वर्शन
Remote Config वर्शन 19.2.0 6.24.0 वर्शन
Firebase के लिए Google Analytics \ (मेज़रमेंट SDK टूल) 17.4.4 वर्शन 6.18.0 वर्शन
इन-ऐप्लिकेशन मैसेज वर्शन 19.0.7 6.24.0 वर्शन
Performance Monitoring वर्शन 19.0.8 6.21.0 वर्शन
Crashlytics वर्शन 17.2.1 6.23.0 वर्शन
ML Kit 22.1.2 वर्शन 6.28.0 वर्शन

इंस्टेंस आईडी एपीआई को साफ़ तौर पर कॉल करने वाला कोड अपडेट करना

अगर आपका Android या Apple ऐप्लिकेशन सीधे तौर पर इंस्टेंस आईडी SDK टूल का इस्तेमाल करता है, तो आप उस इस्तेमाल को Firebase इंस्टॉलेशन SDK या FCM SDK टूल में एक जैसे विकल्पों से बदल सकते हैं.

किसी आइडेंटिफ़ायर को वापस पाना

इंस्टेंस आईडी पाने के तरीकों को इंस्टॉलेशन आईडी पाने के तरीकों से बदल दिया जाता है. उदाहरण के लिए:

पहले

Swift

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching remote FCM registration token: \(error)")
  } else if let token = token {
    print("Remote instance ID token: \(token)")
    self.remoteFCMTokenMessage.text = "Remote FCM registration token: \(token)"
  }
}

Objective-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString * _Nullable token, NSError * _Nullable error) {
   if (error != nil) {
     NSLog(@"Error fetching the remote FCM registration token: %@", error);
   } else {
     NSLog(@"Remote FCM registration token: %@", token);
     NSString* message =
       [NSString stringWithFormat:@"FCM registration token: %@", token];
     self.remoteFCMTokenMessage.text = message;
   }
 }];

Java

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                Log.d("IID_TOKEN", task.getResult().getToken());
            }
        });

Kotlin+KTX

FirebaseInstanceId.getInstance().instanceId
        .addOnSuccessListener { result ->
            Log.d("IID_TOKEN", result.token)
        }

बाद में

Swift

do {
  let id = try await Installations.installations().installationID()
  print("Installation ID: \(id)")
} catch {
  print("Error fetching id: \(error)")
}
AppDelegate.swift

Objective-C

[[FIRInstallations installations] installationIDWithCompletion:^(NSString *identifier, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation ID %@", error);
    return;
  }
  NSLog(@"Installation ID: %@", identifier);
}];
ObjCSnippets.m

Java 

FirebaseInstallations.getInstance().getId()
        .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation ID: " + task.getResult());
        } else {
            Log.e("Installations", "Unable to get Installation ID");
        }
    }
});
MainActivity.java

Kotlin+KTX 

FirebaseInstallations.getInstance().id.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        Log.d("Installations", "Installation ID: " + task.result)
    } else {
        Log.e("Installations", "Unable to get Installation ID")
    }
}
MainActivity.kt

आइडेंटिफ़ायर को मिटाना

इंस्टेंस आईडी मिटाने के तरीकों को, Firebase इंस्टॉलेशन आईडी मिटाने के तरीकों से बदल दिया गया है. उदाहरण के लिए:

पहले

Swift

InstanceID.instanceID().deleteID { error in
  if let error = error {
    print("Error deleting instance ID: \(error)")
  }
}

Objective-C

[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
  if error != nil {
    NSLog(@"Error deleting instance ID: %@", error);
  }
}];

Android

FirebaseInstanceId.deleteInstanceId();

बाद में

Swift

func delete(completion: @escaping (Error?) -> Void)

Objective-C

- (void)deleteWithCompletion:(nonnull void (^)(NSError *_Nullable))completion;

Java 

FirebaseInstallations.getInstance().delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(@NonNull Task<Void> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation deleted");
        } else {
            Log.e("Installations", "Unable to delete Installation");
        }
    }
});
MainActivity.java

Kotlin+KTX 

FirebaseInstallations.getInstance().delete().addOnCompleteListener { task ->
    if (task.isComplete) {
        Log.d("Installations", "Installation deleted")
    } else {
        Log.e("Installations", "Unable to delete Installation")
    }
}
MainActivity.kt

FCM रजिस्ट्रेशन टोकन फिर से पाना

Firebase इंस्टॉलेशन की सुविधा शुरू होने से पहले, FCM क्लाइंट ने इंस्टेंस आईडी से रजिस्ट्रेशन टोकन वापस लिए थे. अब, FCM SDK टूल, रजिस्ट्रेशन टोकन को वापस पाने के तरीके उपलब्ध कराता है.

पहले

Java

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                if (!task.isSuccessful()) {
                    Log.w(TAG, "getInstanceId failed", task.getException());
                    return;
                }

                // Get new Instance ID token
                String token = task.getResult().getToken();

                // Log and toast
                String msg = getString(R.string.msg_token_fmt, token);
                Log.d(TAG, msg);
                Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
            }
        });

Kotlin+KTX

FirebaseInstanceId.getInstance().instanceId
        .addOnCompleteListener(OnCompleteListener { task ->
            if (!task.isSuccessful) {
                Log.w(TAG, "getInstanceId failed", task.exception)
                return@OnCompleteListener
            }

            // Get new Instance ID token
            val token = task.result?.token

            // Log and toast
            val msg = getString(R.string.msg_token_fmt, token)
            Log.d(TAG, msg)
            Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
        })

Swift

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching remote FCM registration token: \(error)")
  } else if let token = token {
    print("Remote instance ID token: \(token)")
    self.remoteFCMTokenMessage.text = "Remote FCM registration token: \(token)"
  }
}

Objective-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString * _Nullable token, NSError * _Nullable error) {
   if (error != nil) {
     NSLog(@"Error fetching the remote FCM registration token: %@", error);
   } else {
     NSLog(@"Remote FCM registration token: %@", token);
     NSString* message =
       [NSString stringWithFormat:@"FCM registration token: %@", token];
     self.remoteFCMTokenMessage.text = message;
   }
 }];

बाद में

Java

FirebaseMessaging.getInstance().getToken()
    .addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
          if (!task.isSuccessful()) {
            Log.w(TAG, "Fetching FCM registration token failed", task.getException());
            return;
          }

          // Get new FCM registration token
          String token = task.getResult();

          // Log and toast
          String msg = getString(R.string.msg_token_fmt, token);
          Log.d(TAG, msg);
          Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
        }
    });

Kotlin+KTX

FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task ->
    if (!task.isSuccessful) {
        Log.w(TAG, "Fetching FCM registration token failed", task.exception)
        return@OnCompleteListener
    }

    // Get new FCM registration token
    val token = task.result

    // Log and toast
    val msg = getString(R.string.msg_token_fmt, token)
    Log.d(TAG, msg)
    Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
})

Swift

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM registration token: \(error)")
  } else if let token = token {
    print("FCM registration token: \(token)")
    self.fcmRegTokenMessage.text  = "Remote FCM registration token: \(token)"
  }
}

Objective-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString *token, NSError *error) {
  if (error != nil) {
    NSLog(@"Error getting FCM registration token: %@", error);
  } else {
    NSLog(@"FCM registration token: %@", token);
    self.fcmRegTokenMessage.text = token;
  }
}];