Go के लिए Firebase Admin SDK ने वर्शन 4.0.0 से Go मॉड्यूल के लिए ऑप्ट-इन किया है. इसके अलावा, गड़बड़ी ठीक करने और सिमैंटिक्स में भी बड़े बदलाव हुए हैं.
इंस्टॉल करने से जुड़े बदलाव
मॉड्यूल के सबसे सही तरीकों के मुताबिक, एसडीके के मेजर वर्शन को पैकेज के नाम में जोड़ा गया है. इस बदलाव से, पैकेज के नाम में ये अपडेट हुए हैं:
- 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/messaging → firebase.google.com/go/v4/messaging
मॉड्यूल का इस्तेमाल करने वाले डेवलपर
एसडीके का नया वर्शन इंस्टॉल करने के लिए, वर्शन वाले पैकेज के नाम का इस्तेमाल करें.
# 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.18.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
ऐसे डेवलपर जो फ़िलहाल मॉड्यूल का इस्तेमाल नहीं कर रहे हैं
जिन डेवलपर ने अब तक मॉड्यूल में ऑप्ट-इन नहीं किया है वे बिना वर्शन वाले पैकेज के नाम का इस्तेमाल करके, SDK इंस्टॉल करना जारी रख सकते हैं.
go get firebase.google.com/go
हालांकि, ध्यान दें कि इससे एसडीके का नया वर्शन (v4 या इसके बाद का वर्शन) फ़ेच होता है. इसमें एपीआई में हुए अन्य बड़े बदलाव शामिल हैं.
गड़बड़ी ठीक करने से जुड़े सामान्य बदलाव
v4 SDK में एक नया errorutils पैकेज शामिल किया गया है. यह पैकेज, प्लैटफ़ॉर्म लेवल पर गड़बड़ी की स्थितियों को ठीक करने के लिए फ़ंक्शन उपलब्ध कराता है. अगर बैकएंड सेवा में गड़बड़ी की वजह से कोई गड़बड़ी हुई है, तो errorutils.HTTPResponse() फ़ंक्शन को कॉल करके, गड़बड़ी के ओरिजनल जवाब को ऐक्सेस किया जा सकता है. इस पैकेज में मौजूद फ़ंक्शन का इस्तेमाल, एसडीके में मौजूद किसी भी एपीआई से मिली गड़बड़ियों के साथ किया जा सकता है.
Authentication एपीआई में बदलाव
VerifyIDToken()औरVerifySessionCookie()एपीआई के साथ इस्तेमाल किए जाने वाले, गड़बड़ी ठीक करने के नए फ़ंक्शन जोड़े गए हैं:IsIDTokenInvalid()IsIDTokenExpired()IsSessionCookieInvalid()IsSessionCookieExpired()IsCertificateFetchFailed()
- अब इस्तेमाल नहीं किया जाता:
IsProjectNotFound()IsUnknown()IsInsufficientPermission()IsInvalidEmail()
FCM एपीआई में बदलाव
- टाइप
messaging.WebpushFCMOptionsका नाम बदलकरmessaging.WebpushFcmOptionsकर दिया गया है. - जोड़ा गया:
IsThirdPartyAuthError()IsQuotaExceeded()IsSenderIDMismatch()IsUnregistered()IsUnavailable()
- अब इस्तेमाल नहीं किया जाता:
IsInvalidAPNSCredentials()IsMessageRateExceeded()IsMismatchedCredential()IsRegistrationTokenNotRegistered()IsServerUnavailable()IsTooManyTopics()IsUnknown()
IID API में हुए बदलाव
iid पैकेज में उपलब्ध गड़बड़ी ठीक करने वाले सभी फ़ंक्शन अब काम नहीं करेंगे. इसके बजाय, errorutils पैकेज में दिए गए, गड़बड़ी ठीक करने वाले फ़ंक्शन का इस्तेमाल करें.