Di chuyển sang Go SDK quản trị v4

Bắt đầu từ phiên bản 4.0.0, SDK quản trị Firebase cho Go đã chọn tham gia các mô-đun Go . Ngoài ra còn có những thay đổi đột phá trong việc xử lý lỗi và ngữ nghĩa.

Thay đổi cài đặt

Để tuân thủ các phương pháp hay nhất về mô-đun , phiên bản chính của SDK đã được thêm vào tên gói. Thay đổi này dẫn đến các cập nhật tên gói sau:

  • 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

Các nhà phát triển đã sử dụng mô-đun

Sử dụng tên gói đã được phiên bản để cài đặt phiên bản SDK mới nhất.

# 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

Tên gói có phiên bản tương tự phải được sử dụng trong mã nguồn khi nhập SDK.

package helloworld

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

Để cài đặt phiên bản cũ hơn, hãy sử dụng tên gói cũ (không có phiên bản) với vòng loại phiên bản rõ ràng.

# 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

Các nhà phát triển hiện không sử dụng mô-đun

Các nhà phát triển chưa chọn tham gia mô-đun có thể tiếp tục cài đặt SDK bằng tên gói không phiên bản.

go get firebase.google.com/go

Tuy nhiên, xin lưu ý rằng thao tác này sẽ tìm nạp phiên bản SDK mới nhất (v4 trở lên) chứa các thay đổi API có thể gây lỗi khác.

Thay đổi xử lý lỗi chung

SDK v4 giới thiệu gói errorutils mới cung cấp các chức năng xử lý các điều kiện lỗi ở cấp độ nền tảng. Trong trường hợp xảy ra lỗi do lỗi dịch vụ phụ trợ, bạn có thể truy cập phản hồi lỗi ban đầu bằng cách gọi hàm mới errorutils.HTTPResponse() . Bạn có thể sử dụng các hàm trong gói này khi có lỗi được bất kỳ API nào trong SDK trả về.

Thay đổi API xác thực

  • Đã thêm các hàm xử lý lỗi mới được sử dụng cùng với API VerifyIDToken() và VerifySessionCookie() :
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • Không dùng nữa:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

Thay đổi API FCM

  • Đã đổi tên loại messaging.WebpushFCMOptions thành messaging.WebpushFcmOptions .
  • Thêm:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • Không dùng nữa:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

Thay đổi API IID

Tất cả các chức năng xử lý lỗi hiện có trong gói iid hiện không còn được dùng nữa. Thay vào đó, hãy sử dụng các hàm xử lý lỗi tương ứng được cung cấp trong gói errorutils .