Auf gebündelte Legacy-Dienste für Go 1.12+ zugreifen

Auf dieser Seite wird beschrieben, wie Sie die gebündelten Dienste mit der Go 1.12+-Laufzeit für die App Engine-Standardumgebung installieren und verwenden. Ihre Anwendung kann über das App Engine Services SDK für Go 1.12+ auf die gebündelten Dienste zugreifen.

Hinweis

App Engine Services SDK installieren

Um die APIs mit gebündelten Legacy-Diensten mit Go 1.12 oder höher aufzurufen, müssen Sie das neueste SDK verwenden. Gehen Sie so vor:

  1. Aktualisieren Sie die Datei app.yaml mit der folgenden Zeile:

    app_engine_apis: true

  2. Fügen Sie einen Verweis auf das neueste SDK in Ihrem go.mod hinzu. Führen Sie dazu go get im Terminal so aus:

    go get google.golang.org/appengine/v2

    Der Hauptunterschied beim Upgrade auf Go 1.12+ ist die Verwendung von Version 2 des App Engine-Dienste-SDK.

  3. Ändern Sie in der Anwendung die Importanweisungen durch Einfügen von /v2/ in die alten Paketnamen. Wenn Sie beispielsweise Memcache verwenden, gehen Sie so vor:

    import (
  "google.golang.org/appengine/v2"
  "google.golang.org/appengine/v2/memcache"
)

    Eine vollständige Liste der verfügbaren Paketnamen finden Sie in der API-Referenzdokumentation für gebündelte Legacy-Dienste.

  4. Führen Sie go mod tidy aus, um Referenzen in der Datei go.mod zu bereinigen.

    go mod tidy

Hinweise zur Migration

Beachten Sie die folgenden Überlegungen, wenn Sie zur Go 1.12+-Laufzeit migrieren und Ihre Anwendung gebündelte Legacy-Dienste verwendet: