In questa pagina viene descritta la migrazione di un'app Android Cloud Endpoints versione 1.0 esistente a Endpoints Frameworks per App Engine. Tieni presente che questa pagina fa riferimento a Endpoints versione 1.0 come Endpoints Framework versione 1.0 e ai nuovi Endpoint Frameworks per App Engine come Endpoint Frameworks versione 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.
- Supporto ufficiale per le configurazioni di Guice
- Facoltativamente, nuove funzionalità di gestione delle API
Endpoints Frameworks versione 2.0 non influisce sulle interfacce dell'API. I clienti esistenti continuano a funzionare dopo la migrazione senza alcuna modifica al codice lato client.
Migrazione di progetti multi-modulo Android a Endpoints Frameworks versione 2.0
I passaggi seguenti ti guideranno nel trasferimento dei progetti di Android Studio Endpoint Frameworks versione 1.0 alla versione 2.0 di Endpoints Frameworks. 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 lavori nella guida alla migrazione. Questa guida alla migrazione presuppone che tu abbia un progetto Android esistente che utilizza un modulo Google Cloud.
- Prima di iniziare.
- Configura Google Cloud CLI.
- (Facoltativo) Scarica il codice campione.
- Esegui la migrazione a Endpoints Frameworks versione 2.0.
- Esegui il deployment del modulo di backend.
- Generare librerie client.
Prima di iniziare
- Installa Android Studio.
- Installa l'SDK per Android 26 o versioni successive.
- Installa gcloud CLI.
configura gcloud CLI
Per configurare gcloud CLI:
Inizializza gcloud CLI:
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 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 a Endpoints Frameworks versione 2.0
Aggiorna il file build.gradle
Le dipendenze di Endpoints Frameworks versione 2.0 utilizzano Guava 19 e il plug-in di build Android Gradle com.android.tools.build:gradle:2.3.3
utilizza Guava 18. Aggiungi
Guava 19 alla chiusura delle dipendenze dello script di build di build.gradle
per
eseguire l'override di questa dipendenza transitiva.
Legacy
v2
Aggiorna il file app/build.gradle
In Endpoints versione 1.0, hai utilizzato il plug-in Gradle, gradle-appengine-plugin
, per generare un documento di rilevamento dell'API. In
Endpoints Frameworks versione 2.0, si utilizza
endpoints-framework-gradle-plugin
per generare un documento predittivo.
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 dell'ambiente standard di App Engine sono stati aggiornati.
I progetti di Endpoints Frameworks versione 1.0 utilizzano l'gradle-appengine-plugin
in com.google.appengine
, mentre i progetti di Endpoint Frameworks versione 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 è cambiata da SystemServiceServlet
a EndpointsServlet
.
Il pattern URL è stato aggiornato da /_ah/spi/*
a /_ah/api/*
.
Legacy
v2
Ricrea il progetto
Infine, usa 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 durante il modulo backend
:
gradle endpointsClientLibs
Scopri di più sulle attività disponibili per il plug-in Gradle per framework endpoint.
Aggiunta della gestione dell'API Endpoints
Endpoints Frameworks versione 2.0 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, visita la pagina Java relativa a Endpoint Frameworks per App Engine.