Questa pagina descrive la migrazione di un'app Android Cloud Endpoints 1.0 esistente a Endpoints Frameworks per App Engine. Tieni presente che in questa pagina la versione 1.0 di Endpoints è indicata come Endpoints Frameworks 1.0 e la nuova versione di Endpoints Frameworks per App Engine come Endpoints Frameworks 2.0.
Vantaggi
Il nuovo framework offre una serie di vantaggi, tra cui:
- Latenza delle richieste ridotta
- Migliore integrazione con le funzionalità di App Engine, come i domini personalizzati.
- Assistenza ufficiale per le configurazioni Guice
- (Facoltativo) 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 multi-modulo Android alla versione 2.0 di Endpoints Frameworks
I passaggi che seguono descrivono la procedura per spostare i progetti Android Studio Endpoints Frameworks versione 1.0 in Endpoints Frameworks versione 2.0. La guida esegue la migrazione di un progetto Android Studio con un modulo Endpoints.
Elenco attività
Utilizza il seguente elenco di attività di alto livello mentre segui la guida alla migrazione. Questa guida alla migrazione presuppone che tu abbia già un progetto Android che utilizza un modulo Google Cloud.
- Prima di iniziare.
- Configura Google Cloud CLI.
- (Facoltativo) Scarica il codice campione.
- Esegui la migrazione alla versione 2.0 di Endpoints Frameworks.
- Esegui il deployment del modulo di backend.
- Genera librerie client.
Prima di iniziare
- Installa Android Studio.
- Installa Android SDK 26 o versioni successive.
- Installa la gcloud CLI.
Configurare l'interfaccia a riga di comando gcloud
Per configurare gcloud CLI:
Inizializza la gcloud CLI:
gcloud init
Utilizza le 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 sulla tua macchina locale:
git clone https://github.com/GoogleCloudPlatform/android-docs-samples
Passa alla directory contenente il codice campione per
legacy
ev2
:cd android-docs-samples/endpoints-frameworks/
Esegui 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 compilazione Gradle per Android com.android.tools.build:gradle:2.3.3
utilizza Guava 18. Aggiungi
Guava 19 alla chiusura delle dipendenze dello script di compilazione del build.gradle
per
override 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 scoperta API. In Endpoints Frameworks versione 2.0, utilizzi endpoints-framework-gradle-plugin
per generare un documento di rilevamento.
Questo script di compilazione utilizza il plug-in lato client com.google.cloud.tools.endpoints-framework-client
.
Legacy
v2
Aggiorna il file backend/build.gradle
Gli strumenti Gradle per l'ambiente standard di App Engine sono stati aggiornati.
I progetti Endpoints Frameworks 1.0 utilizzavano gradle-appengine-plugin
in com.google.appengine
, mentre i progetti Endpoints Frameworks 2.0 utilizzano appengine-gradle-plugin
.
Questo script di compilazione 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 è passata da
SystemServiceServlet
a EndpointsServlet
.
Il pattern URL è stato aggiornato da /_ah/spi/*
a /_ah/api/*
.
Legacy
v2
Ricostruire il progetto
Infine, utilizza l'elenco di build di Android Studio per eseguire la pulizia e la ricostruzione del 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 il seguente task Gradle nel modulo backend
:
gradle appengineDeploy
Generare librerie client
Per generare le librerie client, utilizza il seguente task Gradle nel
modulo backend
:
gradle endpointsClientLibs
Scopri di più sulle attività disponibili per il plug-in Gradle Endpoints Frameworks.
Aggiunta della gestione dell'API Endpoints
Endpoints Frameworks versione 2.0 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 a Endpoints Frameworks per App Engine.