In questa pagina viene descritta la migrazione di un'app Android Cloud Endpoints 1.0 esistente ad Endpoints Frameworks per App Engine. Tieni presente che questa pagina si riferisce alla versione 1.0 degli endpoint come versione 1.0 degli endpoint e alla nuova versione 2.0 degli endpoint per App Engine.
Vantaggi
Il nuovo framework offre numerosi vantaggi, tra cui:
- Latenza di richiesta ridotta
- Migliore integrazione con le funzionalità di App Engine, come i domini personalizzati.
- Supporto ufficiale per le configurazioni Guice
- Facoltativamente, nuove funzionalità di gestione delle API
La versione 2.0 di Endpoints Frameworks non influisce sulle interfacce della tua API. I client esistenti continuano a funzionare dopo la migrazione senza modifiche al codice lato client.
Migrazione dei progetti con più moduli di Android alla versione 2.0 di Endpoints Frameworks
I passaggi seguenti spiegano come spostare i progetti di Android Studio Endpoints Frameworks 1.0 in Endpoints Frameworks versione 2.0. La guida esegue la migrazione di un progetto Android Studio con un modulo Endpoint.
Elenco attività
Utilizza il seguente elenco di attività generiche durante l'esecuzione della guida alla migrazione. Questa guida alla migrazione presume che tu abbia un progetto Android esistente che utilizza un modulo Google Cloud.
- Prima di iniziare:
- Configura l'interfaccia a riga di comando di Google Cloud.
- (Facoltativo) Scarica il codice di esempio.
- Esegui la migrazione alla versione 2.0 dei framework di endpoint.
- Esegui il deployment del modulo di backend.
- Generare le librerie client.
Prima di iniziare
- Installa Android Studio.
- Installa Android SDK 26 o versioni successive.
- Installa l'interfaccia a riga di comando gcloud.
Configurare l'interfaccia a riga di comando gcloud
Per configurare l'interfaccia a riga di comando gcloud:
Inizializza l'interfaccia a riga di comando gcloud:
gcloud init
Usa credenziali predefinite applicazione:
gcloud auth application-default login
Installa il componente
app-engine-java
:gcloud components install app-engine-java
Facoltativo: scarica il codice di esempio
Per clonare i progetti di esempio legacy
e v2
da GitHub:
Clona il repository di esempio sul tuo computer locale:
git clone https://github.com/GoogleCloudPlatform/android-docs-samples
Passa alla directory contenente il codice di esempio per
legacy
ev2
:cd android-docs-samples/endpoints-frameworks/
Eseguire la migrazione alla versione 2.0 di Endpoints Frameworks
Aggiorna il file build.gradle
Le dipendenze di Endpoints Frameworks versione 2.0 utilizzano Guava 19 e il plug-in di build Android Android com.android.tools.build:gradle:2.3.3
utilizza Guava 18. Aggiungi Guava 19 alla chiusura di dipendenze dello script di build di build.gradle
per sostituire questa dipendenza transitiva.
Legacy
v2
Aggiorna il file app/build.gradle
Nella versione 1.0 di Endpoints, è stato utilizzato il plug-in Gradle, gradle-appengine-plugin
, per generare un documento Discovery API. Nella versione 2.0 di Endpoint Frameworks, puoi utilizzare
endpoints-framework-gradle-plugin
per generare un documento di rilevamento.
Questo script di build utilizza il plug-in lato client,
com.google.cloud.tools.endpoints-framework-client
.
Legacy
v2
Aggiorna il file backend/build.gradle
Lo strumento Gradle dell'ambiente standard di App Engine è stato aggiornato.
I progetti della versione 1.0 di Endpoints Frameworks hanno utilizzato
gradle-appengine-plugin
in com.google.appengine
, mentre i progetti della versione 2.0 di Endpoints
utilizzano appengine-gradle-plugin
.
Questo script di build utilizza il plug-in lato server,
com.google.cloud.tools.endpoints-framework-server
.
Legacy
v2
Aggiorna il file web.xml
Nella versione 2.0 di Endpoints Frameworks, la classe servlet è cambiata da
SystemServiceServlet
a EndpointsServlet
.
Il pattern URL è stato aggiornato da /_ah/spi/*
a /_ah/api/*
.
Legacy
v2
Riprogetta progetto
Infine, utilizza l'elenco di build di Android Studio per pulire e ricreare il progetto Android Studio con le nuove dipendenze.
Esegui il deployment del modulo di backend
Il nuovo plug-in Gradle App Engine viene ora utilizzato per eseguire il deployment del modulo backend utilizzando la seguente attività Gradle durante il modulo backend
:
gradle appengineDeploy
Genera librerie client
Per generare le librerie client, durante il modulo backend
utilizza la seguente attività Gradle:
gradle endpointsClientLibs
Scopri di più sulle attività disponibili per il plug-in Endpoint Frameworks Gradle.
Aggiunta della gestione delle API Endpoints
La versione 2.0 di Endpoints Frameworks ti consente anche di attivare le funzionalità di gestione delle API, tra cui:
- Gestione delle chiavi API
- Condivisione API
- Autenticazione degli utenti
- Metriche delle API
- Log delle API
Per iniziare a utilizzare queste e altre funzionalità di Cloud Endpoints Frameworks 2.0, vai alla pagina Java su Endpoints Frameworks per App Engine.