Auf dieser Seite wird beschrieben, wie Sie eine vorhandene App für Android Cloud Endpoints Version 1.0 zu Endpoints Frameworks for App Engine migrieren. Beachten Sie, dass diese Seite auf Endpoints Version 1.0 als Endpoints Frameworks Version 1.0 und neue Endpoints Frameworks für App Engine als Endpoints Frameworks Version 2.0 verweist.
Vorteile
Das neue Framework bietet diverse Vorteile, unter anderem:
- Geringere Anfragelatenz
- Bessere Einbindung von App Engine-Funktionen wie benutzerdefinierten Domains
- Offizieller Support für Guice-Konfigurationen
- Optional neue Features für die API-Verwaltung
Endpoints Frameworks Version 2.0 hat keine Auswirkungen auf die Schnittstellen zu Ihrer API. Bereits bestehende Clients arbeiten nach der Migration ohne clientseitige Änderungen des Codes regulär weiter.
Android-Projekte mit mehreren Modulen zu Endpoints Frameworks 2.0 migrieren
Nachstehend wird Schritt für Schritt beschrieben, wie Sie mit Android Studio Endpoints Frameworks 1.0 erstellte Projekte zu Endpoints Frameworks 2.0 migrieren. In dieser Anleitung wird ein Android Studio-Projekt mit einem Endpoints-Modul migriert.
Aufgabenliste
Verwenden Sie beim Durcharbeiten der Migrationsanleitung die folgende Aufgabenliste. In dieser Migrationsanleitung wird davon ausgegangen, dass Sie ein bestehendes Android-Projekt mit einem Google Cloud-Modul haben.
- Vorbereitung
- Richten Sie die Google Cloud CLI ein.
- Optional: Beispielcode herunterladen
- Migration zu Endpoints Frameworks Version 2.0
- Back-End-Modul bereitstellen
- Clientbibliotheken generieren
Vorbereitung
- Installieren Sie Android Studio.
- Installieren Sie Android SDK 26+.
- Installieren Sie die gcloud CLI.
Die gcloud CLI einrichten
So richten Sie die gcloud CLI ein:
Initialisieren Sie die gcloud CLI:
gcloud init
Verwenden Sie die Standardanmeldedaten für Anwendungen:
gcloud auth application-default login
Installieren Sie die Komponente
app-engine-java
:gcloud components install app-engine-java
Optional: Beispielcode herunterladen
Klonen Sie die Beispielprojekte legacy
und v2
von GitHub:
Klonen Sie das Beispiel-Repository auf Ihren lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/android-docs-samples
Wechseln Sie in das Verzeichnis, das den Beispielcode für
legacy
undv2
enthält:cd android-docs-samples/endpoints-frameworks/
Migration zu Endpoints Frameworks Version 2.0
Aktualisieren Sie die Datei build.gradle
:
Die Abhängigkeiten von Endpoints Frameworks 2.0 verwenden Guava 19 und das Android Gradle Build-Plug-in com.android.tools.build:gradle:2.3.3
verwendet Guava 18. Fügen Sie Guava 19 zum Abschluss der Build-Skript-Abhängigkeiten von build.gradle
hinzu, um diese transitive Abhängigkeit zu überschreiben.
Alt
v2
Aktualisieren Sie die Datei app/build.gradle
:
In Endpoints Version 1.0 haben Sie das Gradle-Plug-in gradle-appengine-plugin
verwendet, um ein API Discovery-Dokument zu generieren. In Endpoints Frameworks Version 2.0 verwenden Sie das endpoints-framework-gradle-plugin
, um ein Discovery-Dokument zu erstellen.
Dieses Build-Skript verwendet das clientseitige Plug-in com.google.cloud.tools.endpoints-framework-client
.
Alt
v2
Aktualisieren Sie die Datei backend/build.gradle
:
Die Standardumgebung von App Engine Gradle-Tooling wurde aktualisiert.
Endpoints Frameworks-Projekte der Version 1.0 verwendeten gradle-appengine-plugin
in com.google.appengine
und Endpoints Frameworks-Projekte der Version 2.0 verwenden appengine-gradle-plugin
.
Dieses Build-Skript verwendet das serverseitige Plug-in com.google.cloud.tools.endpoints-framework-server
.
Alt
v2
Aktualisieren Sie die Datei web.xml
:
In Endpoints Frameworks Version 2.0 wurde die Servlet-Klasse von SystemServiceServlet
zu EndpointsServlet
geändert.
Das URL-Muster wurde von /_ah/spi/*
auf /_ah/api/*
aktualisiert.
Alt
v2
Projekt neu erstellen
Verwenden Sie schließlich die Android Studio-Buildliste, um das Android Studio-Projekt mit den neuen Abhängigkeiten zu bereinigen und neu zu erstellen.
Back-End-Modul bereitstellen
Das Back-End wird jetzt mit dem neuen Gradle App Engine-Plug-in bereitgestellt.
mithilfe der folgenden Gradle-Task im Modul backend
:
gradle appengineDeploy
Clientbibliotheken erstellen
Erstellen Sie die Clientbibliotheken mit der folgenden Gradle-Aufgabe im backend
-Modul:
gradle endpointsClientLibs
Weitere Informationen zu verfügbaren Aufgaben im Gradle-Plug-in von Endpoints Frameworks.
Endpoints-API-Verwaltung hinzufügen
Mit Endpoints Frameworks 2.0 können Sie auch Funktionen für die API-Verwaltung aktivieren:
- Verwalten von API-Schlüsseln
- Teilen von APIs
- Nutzerauthentifizierung
- API-Messwerte
- API-Logs
Um diese und andere Features von Cloud Endpoints Frameworks 2.0 zu verwenden, besuchen Sie die Java-Seite zu Endpoints Frameworks for App Engine.