गो एडमिन SDK v4 पर माइग्रेट करें

संस्करण 4.0.0 से शुरू होकर, गो के लिए फायरबेस एडमिन एसडीके ने गो मॉड्यूल में विकल्प चुना है। इसके अलावा, त्रुटि प्रबंधन और शब्दार्थ में भी महत्वपूर्ण परिवर्तन हुए हैं।

स्थापना परिवर्तन

मॉड्यूल की सर्वोत्तम प्रथाओं के अनुरूप, एसडीके के प्रमुख संस्करण को पैकेज नाम में जोड़ा गया है। इस परिवर्तन के परिणामस्वरूप निम्नलिखित पैकेज नाम अद्यतन होते हैं:

  • firebase.google.com/go → firebase.google.com/go/v4
  • firebase.google.com/go/auth → firebase.google.com/go/v4/auth
  • firebase.google.com/go/db → firebase.google.com/go/v4/db
  • firebase.google.com/go/iid → firebase.google.com/go/v4/iid
  • firebase.google.com/go/messageing → firebase.google.com/go/v4/messageing

डेवलपर्स पहले से ही मॉड्यूल का उपयोग कर रहे हैं

एसडीके के नवीनतम संस्करण को स्थापित करने के लिए संस्करणित पैकेज नाम का उपयोग करें।

# Install the latest version:
go install firebase.google.com/go/v4@latest

# Or install a specific version:
go install firebase.google.com/go/v4@4.13.0

एसडीके आयात करते समय स्रोत कोड में समान संस्करण पैकेज नाम का उपयोग किया जाना चाहिए।

package helloworld

import (
        "firebase.google.com/go/v4"
        "firebase.google.com/go/v4/auth"
        "firebase.google.com/go/v4/messaging"
)

पुराने संस्करण को स्थापित करने के लिए, स्पष्ट संस्करण क्वालीफायर के साथ पुराने (बिना संस्करण वाले) पैकेज नाम का उपयोग करें।

# Notice the @v3 suffix.
# This instructs Go tools to fetch the latest v3.x release of the SDK.
go get firebase.google.com/go@v3

डेवलपर्स वर्तमान में मॉड्यूल का उपयोग नहीं कर रहे हैं

जिन डेवलपर्स ने अभी तक मॉड्यूल का विकल्प नहीं चुना है, वे अपरिवर्तित पैकेज नाम का उपयोग करके एसडीके स्थापित करना जारी रख सकते हैं।

go get firebase.google.com/go

हालाँकि, ध्यान दें कि यह SDK का नवीनतम संस्करण (v4 या बाद का) लाता है जिसमें अन्य ब्रेकिंग एपीआई परिवर्तन शामिल हैं।

सामान्य त्रुटि प्रबंधन परिवर्तन

V4 SDK एक नया errorutils पैकेज पेश करता है जो प्लेटफ़ॉर्म-स्तरीय त्रुटि स्थितियों को संभालने के लिए फ़ंक्शन प्रदान करता है। यदि बैकएंड सेवा त्रुटि के कारण कोई त्रुटि हुई, तो आप नए फ़ंक्शन errorutils.HTTPResponse() कॉल करके मूल त्रुटि प्रतिक्रिया तक पहुंच सकते हैं। आप एसडीके में किसी भी एपीआई द्वारा लौटाई गई त्रुटियों के साथ इस पैकेज में फ़ंक्शन का उपयोग कर सकते हैं।

प्रमाणीकरण एपीआई परिवर्तन

  • VerifyIDToken() और VerifySessionCookie() API के संयोजन में उपयोग किए जाने वाले नए त्रुटि प्रबंधन फ़ंक्शन जोड़े गए:
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • बहिष्कृत:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

एफसीएम एपीआई परिवर्तन

  • messaging.WebpushFCMOptions प्रकार का नाम बदलकर messaging.WebpushFcmOptions कर दिया गया।
  • जोड़ा गया:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • बहिष्कृत:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

आईआईडी एपीआई परिवर्तन

iid पैकेज में वर्तमान में उपलब्ध सभी त्रुटि प्रबंधन फ़ंक्शन अब अप्रचलित हैं। इसके बजाय errorutils पैकेज में दिए गए संबंधित त्रुटि प्रबंधन फ़ंक्शन का उपयोग करें।