Esegui la migrazione all'SDK Admin Go v4

A partire dalla versione 4.0.0, Firebase Admin SDK per Go ha attivato i moduli Go. Inoltre, sono presenti modifiche che provocano un errore nella gestione degli errori e nella semantica.

Modifiche all'installazione

In conformità alle best practice per i moduli, la versione principale dell'SDK è stata aggiunta al nome del pacchetto. Questa modifica comporta i seguenti aggiornamenti dei nomi dei pacchetti:

  • 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

Sviluppatori che utilizzano già i moduli

Utilizza il nome del pacchetto con versione per installare l'ultima versione dell'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.22.0

Nel codice sorgente deve essere utilizzato lo stesso nome del pacchetto con controllo delle versioni durante l'importazione dell'SDK.

package helloworld

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

Per installare una versione precedente, utilizza il nome del pacchetto precedente (senza versione) con un qualificatore di versione esplicito.

# 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

Sviluppatori che al momento non utilizzano i moduli

Gli sviluppatori che non hanno ancora attivato i moduli possono continuare a installare l'SDK utilizzando il nome del pacchetto senza versione.

go get firebase.google.com/go

Tieni presente, tuttavia, che in questo modo viene recuperata l'ultima versione dell'SDK (v4 o successive), che contiene altre modifiche che provocano errori nell'API.

Modifiche generali alla gestione degli errori

L'SDK v4 introduce un nuovo pacchetto errorutils che fornisce funzioni per la gestione delle condizioni di errore a livello di piattaforma. Nel caso in cui un errore sia stato causato da un errore del servizio di backend, puoi accedere alla risposta di errore originale chiamando la nuova funzione errorutils.HTTPResponse(). Puoi utilizzare le funzioni di questo pacchetto con gli errori restituiti da qualsiasi API nell'SDK.

Modifiche all'API Authentication

  • Sono state aggiunte nuove funzioni di gestione degli errori da utilizzare insieme alle API VerifyIDToken() e VerifySessionCookie():
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • Ritirato:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

Modifiche all'API FCM

  • Il tipo messaging.WebpushFCMOptions è stato rinominato in messaging.WebpushFcmOptions.
  • Aggiunte:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • Ritirato:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

Modifiche all'API IID

Tutte le funzioni di gestione degli errori attualmente disponibili nel pacchetto iid sono ora deprecate. Utilizza invece le funzioni di gestione degli errori corrispondenti fornite nel pacchetto errorutils.