สำหรับ Go เลือกใช้ Go modules ตั้งแต่เวอร์ชัน 4.0.0 เป็นต้นไปFirebase Admin SDK นอกจากนี้ยังมีการเปลี่ยนแปลงที่ทำให้เกิดข้อผิดพลาดในการจัดการข้อผิดพลาดและความหมาย
การเปลี่ยนแปลงในการติดตั้ง
SDK ได้เพิ่มเวอร์ชันหลักต่อท้ายชื่อแพ็กเกจเพื่อให้เป็นไปตามแนวทางปฏิบัติแนะนำของโมดูล การเปลี่ยนแปลงนี้ส่งผลให้มีการอัปเดตชื่อแพ็กเกจดังนี้
- 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
นักพัฒนาแอปที่ใช้โมดูลอยู่แล้ว
ใช้ชื่อแพ็กเกจเวอร์ชันเพื่อติดตั้ง SDK เวอร์ชันล่าสุด
# 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.21.0
คุณต้องใช้ชื่อแพ็กเกจเวอร์ชันเดียวกันในซอร์สโค้ดเมื่อนำเข้า SDK
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
อย่างไรก็ตาม การดำเนินการนี้จะดึงข้อมูล SDK เวอร์ชันล่าสุด (v4 ขึ้นไป) ซึ่งมีการเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาดอื่นๆ
การเปลี่ยนแปลงการจัดการข้อผิดพลาดทั่วไป
SDK v4 มีแพ็กเกจ errorutils ใหม่ซึ่งมีฟังก์ชันสำหรับการจัดการเงื่อนไขข้อผิดพลาดระดับแพลตฟอร์ม ในกรณีที่เกิดข้อผิดพลาดเนื่องจากข้อผิดพลาดของบริการแบ็กเอนด์ คุณสามารถเข้าถึงการตอบกลับข้อผิดพลาดเดิมได้โดยเรียกใช้ฟังก์ชันใหม่ errorutils.HTTPResponse() คุณสามารถใช้ฟังก์ชันในแพ็กเกจนี้กับข้อผิดพลาดที่ API ใดก็ได้ใน SDK แสดงผล
การเปลี่ยนแปลง APIAuthentication
- เพิ่มฟังก์ชันการจัดการข้อผิดพลาดใหม่เพื่อใช้ร่วมกับ API
VerifyIDToken()และVerifySessionCookie()ดังนี้IsIDTokenInvalid()IsIDTokenExpired()IsSessionCookieInvalid()IsSessionCookieExpired()IsCertificateFetchFailed()
- เลิกใช้งานแล้ว
IsProjectNotFound()IsUnknown()IsInsufficientPermission()IsInvalidEmail()
การเปลี่ยนแปลง APIFCM
- เปลี่ยนชื่อประเภท
messaging.WebpushFCMOptionsเป็นmessaging.WebpushFcmOptions - เพิ่มฟังก์ชันต่อไปนี้
IsThirdPartyAuthError()IsQuotaExceeded()IsSenderIDMismatch()IsUnregistered()IsUnavailable()
- เลิกใช้งานแล้ว
IsInvalidAPNSCredentials()IsMessageRateExceeded()IsMismatchedCredential()IsRegistrationTokenNotRegistered()IsServerUnavailable()IsTooManyTopics()IsUnknown()
การเปลี่ยนแปลง IID API
ฟังก์ชันการจัดการข้อผิดพลาดทั้งหมดที่พร้อมใช้งานในแพ็กเกจ iid ในปัจจุบันถูกเลิกใช้งานแล้ว ให้ใช้ฟังก์ชันการจัดการข้อผิดพลาดที่เกี่ยวข้องซึ่งมีให้ในแพ็กเกจ errorutils แทน