Migrate to Go Admin SDK v4

Od wersji 4.0.0 pakiet Firebase Admin SDK dla Go korzysta z modułów Go. Wprowadziliśmy też zmiany powodujące niezgodność wsteczną w obsłudze błędów i semantyce.

Zmiany w instalacji

Zgodnie ze sprawdzonymi metodami dotyczącymi modułów do nazwy pakietu została dodana wersja główna pakietu SDK. Ta zmiana spowoduje aktualizację nazw pakietów w ten sposób:

  • 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

Deweloperzy, którzy już korzystają z modułów

Aby zainstalować najnowszą wersję pakietu SDK, użyj nazwy pakietu z numerem wersji.

# 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.17.0

Podczas importowania pakietu SDK w kodzie źródłowym musi być używana ta sama nazwa pakietu z numerem wersji.

package helloworld

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

Aby zainstalować starszą wersję, użyj starej (bez numeru wersji) nazwy pakietu z wyraźnym kwalifikatorem wersji.

# 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

Deweloperzy, którzy obecnie nie używają modułów

Deweloperzy, którzy nie zdecydowali się jeszcze na moduły, mogą nadal instalować pakiet SDK za pomocą nazwy pakietu bez wersji.

go get firebase.google.com/go

Pamiętaj jednak, że pobierana jest najnowsza wersja pakietu SDK (wersja 4 lub nowsza), która zawiera inne zmiany w interfejsie API powodujące niezgodność wsteczną.

Ogólne zmiany w obsłudze błędów

Pakiet SDK w wersji 4 wprowadza nowy pakiet errorutils, który zawiera funkcje obsługi błędów na poziomie platformy. Jeśli błąd został spowodowany przez błąd usługi backendu, możesz uzyskać dostęp do oryginalnej odpowiedzi o błędzie, wywołując nową funkcję errorutils.HTTPResponse(). Funkcje w tym pakiecie możesz stosować w przypadku błędów zwracanych przez dowolny interfejs API w pakiecie SDK.

Authentication Zmiany w interfejsie API

  • Dodaliśmy nowe funkcje obsługi błędów, które można stosować w połączeniu z interfejsami API VerifyIDToken() i VerifySessionCookie():
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • Wycofane:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

FCM Zmiany w interfejsie API

  • Zmieniono nazwę typu messaging.WebpushFCMOptions na messaging.WebpushFcmOptions.
  • Dodano:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • Wycofane:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

Zmiany w interfejsie IID API

Wszystkie funkcje obsługi błędów dostępne obecnie w pakiecie iid zostały wycofane. Zamiast tego użyj odpowiednich funkcji obsługi błędów dostępnych w pakiecie errorutils.