In questa pagina viene descritta la migrazione di un'app esistente di Android Cloud Endpoints dalla versione 1.0 a Endpoints Frameworks per App Engine. Tieni presente che questa pagina si riferisce agli endpoint versione 1.0 come endpoints version 1.0 e ai nuovi endpoints Frameworks per App Engine come endpoints Frameworks versione 2.0.
Vantaggi
Il nuovo framework offre una serie di vantaggi, tra cui:
- Latenza di richiesta ridotta
- Integrazione migliore 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 alcuna modifica al codice lato client.
Migrazione di progetti multimodulo Android a Endpoints Frameworks 2.0
I seguenti passaggi ti aiuteranno a spostare i progetti Android Studio Endpoints versione 1.0 in Endpoints 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à di alto livello mentre lavori nella guida alla migrazione. Questa guida alla migrazione presume che tu abbia un progetto Android esistente utilizzando un modulo Google Cloud.
- Prima di iniziare
- Configura Google Cloud CLI.
- (Facoltativo) Scarica il codice campione.
- Eseguire la migrazione a Endpoints Frameworks 2.0.
- Esegui il deployment del modulo di backend.
- Genera 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 dell'applicazione:
gcloud auth application-default login
Installa il componente
app-engine-java
:gcloud components install app-engine-java
(Facoltativo) Scarica il codice campione
Per clonare i progetti di esempio legacy
e v2
da GitHub:
Clona il repository di esempio nella macchina 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/
Esegui la migrazione a Endpoints Frameworks 2.0
Aggiorna il file build.gradle
Le dipendenze della versione 2.0 di Endpoints Frameworks utilizzano Guava 19 e il plug-in di build Gradle com.android.tools.build:gradle:2.3.3
di Android utilizza Guava 18. Aggiungi
Guava 19 alla chiusura delle 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, hai utilizzato il plug-in Gradle, gradle-appengine-plugin
, per generare un documento di rilevamento API. In
Endpoints versione 2.0, utilizzi la
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
È stato aggiornato lo strumento Gradle dell'ambiente standard di App Engine.
I progetti di endpoint di versione 1.0 utilizzavano gradle-appengine-plugin
in com.google.appengine
, mentre i progetti di Framework di endpoint 2.0 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
In Endpoints Frameworks, versione 2.0, la classe servlet è stata modificata da SystemServiceServlet
a EndpointsServlet
.
Il pattern URL è stato aggiornato da /_ah/spi/*
a /_ah/api/*
.
Legacy
v2
Ricrea 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 di backend utilizzando la seguente attività Gradle nel modulo backend
:
gradle appengineDeploy
Genera librerie client
Per generare librerie client, utilizza la seguente attività Gradle mentre sei nel modulo backend
:
gradle endpointsClientLibs
Scopri di più sulle attività disponibili per il plug-in endpoints Frameworks Gradle.
Aggiunta della gestione dell'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 API
Per iniziare a utilizzare queste e altre funzionalità di Cloud Endpoints Frameworks 2.0, vai alla pagina Java relativa ai Framework di endpoint per App Engine.