Accedi con la Guida introduttiva di Amazon per le app Android

Accedi con Amazon: Guida introduttiva per Android

Copyright © 2017 Amazon.com, Inc. o sue affiliate. Tutti i diritti riservati.

Amazon e il logo Amazon sono marchi di Amazon.com, Inc. o delle sue affiliate. Tutti gli altri marchi non di proprietà di Amazon appartengono ai rispettivi proprietari.

Installa gli strumenti per sviluppatori Android

Il login con Amazon SDK per Android ti aiuterà ad aggiungere il login con Amazon alle tue applicazioni Android, Fire TV e Fire Tablet. Ti consigliamo di utilizzare l'accesso con Amazon SDK per Android con Android Studio. Per i passaggi su come installare Android Studio e su come configurare Android SDK, vedere Ottieni l'Android SDK su developer.android.com.

Per utilizzare l'accesso con Amazon SDK per Android, la tua applicazione Android deve soddisfare uno di questi requisiti minimi:

• Versione SDK minima (minSdkVersion) di Android 0 (livello API 11) o superiore.
• Versione SDK minima (minSdkVersion) di Android 2.2 (livello API 8) o superiore con v4 Supporto Android Biblioteca.

Quando è installato Android SDK, trova il file Responsabile SDK applicazione nella tua installazione Android. Per sviluppare per l'accesso con Amazon, è necessario utilizzare SDK Manager per installare i requisiti minimi SDK di cui sopra. Vedere Aggiunta di pacchetti SDK su developer.android.com per ulteriori informazioni sull'utilizzo di SDK Manager.

Dopo aver installato l'SDK, configura un dispositivo virtuale Android (AVD) per eseguire le tue app. Vedere Gestione Dispositivi virtuali su developer.android.com per istruzioni sulla configurazione di un dispositivo virtuale.

Quando il tuo ambiente di sviluppo è configurato, puoi farlo Installa il login con Amazon SDK per Android or Esegui la Sampl'App, come descritto sotto

Installa il login con Amazon SDK per Android

Il Login con Amazon SDK per Android è disponibile in due pacchetti. Il primo contiene la libreria Android e la documentazione di supporto. Il secondo contiene comeampl'applicazione che consente a un utente di accedere e visualizza il proprio profile dati.

Se non hai già installato Android SDK o Strumenti di sviluppo Android, consulta il file Installazione gli Strumenti per sviluppatori Android sezione sopra.

1. Scaricamento cerniera lampo ed estrai il files in una directory sul disco rigido. Dovresti vedere un documenti e un liberare sottodirectory.
2. Aprire docs / index.html A view il Login con Amazon Android API Reference.
3. Vedere Installa il login con Amazon Library per istruzioni su come aggiungere la libreria e la documentazione a un Android

Quando è installato l'accesso con Amazon SDK per Android, puoi farlo Crea un nuovo accesso con Amazon Progetto Dopo di te Registrati con Accedi con Amazon.

Esegui la SampleApp

Per eseguire il sampl'applicazione, importare la sample in un'area di lavoro di AndroidStudio.

1. Scaricamento SampleLoginWithAmazonAppForAndroid-src.zip ed estrai il files in una directory sul tuo disco
2. Avvia Android Studio e seleziona Apri un progetto Android Studio esistente.
3. Passare al SampleLoginConAmazonApp directory ottenuta dopo aver estratto lo zip scaricato file nel passaggio 1.
4. Dal Costruire menu, clicca Crea progettoe attendi che il progetto termini la costruzione.
5. Dal Correre menu, clicca Correre e poi clicca su SampleLoginConAmazonApp.
6. Seleziona l'emulatore o il dispositivo Android connesso e fai clic su Correre.

Registrati con Accedi con Amazon

Prima di poter utilizzare Accedi con Amazon su un websito o in un'app mobile, devi registrare un'applicazione con Login with Amazon. La tua applicazione Login with Amazon è la registrazione che contiene informazioni di base sulla tua attività e informazioni su ogni websito o app mobile che crei che supporta Login with Amazon. Queste informazioni aziendali vengono visualizzate agli utenti ogni volta che utilizzano Login with Amazon sul tuo websito o app per dispositivi mobili. Gli utenti vedranno il nome della tua applicazione, il tuo logo e un link alla tua informativa sulla privacy. Questi passaggi mostrano come registrare la tua app Android per l'utilizzo con Login con Amazon.

Registra il tuo accesso con l'applicazione Amazon

1. Vai a https://login.amazon.com.
2. Se ti sei registrato per Accedi con Amazon in precedenza, fai clic su Console dell'appAltrimenti, fare clic Iscrizione. Verrai reindirizzato a Seller Central, che gestisce la registrazione dell'applicazione per Accedi con Se è la prima volta che utilizzi Seller Central, ti verrà chiesto di creare un account Seller Central.
3. Clic Registra una nuova applicazione. IL Registra la tua applicazione apparirà il modulo:
   a. Nel Registra la tua applicazione modulo, inserisci un Nome e un Descrizione per la tua candidatura.
   IL Nome è il nome visualizzato nella schermata di consenso quando gli utenti accettano di condividere informazioni con la tua applicazione. Questo nome si applica ad Android, iOS e webversioni del sito della tua applicazione. Il Descrizione ti aiuta a differenziare ogni tuo login con le applicazioni Amazon e non viene mostrato agli utenti.
   b. Inserisci un Informativa sulla privacy URL per la tua candidatura.
   IL Informativa sulla privacy URL è la posizione dell'informativa sulla privacy della tua azienda o dell'applicazione (ad esampLui, http://www.example.com/privacy.html). Questo collegamento viene mostrato agli utenti nella schermata di consenso.
   c. Se vuoi aggiungere un Immagine del logo per la tua applicazione, clicca Sfogliare e individuare l'immagine applicabile.
4. Clic Salva. Il tuoampla registrazione dovrebbe essere simile a questa:
   
   Dopo aver salvato le impostazioni di base dell'applicazione, è possibile aggiungere impostazioni specifiche websiti e app mobili che utilizzeranno questo account di accesso con Amazon.

Aggiungi le impostazioni Android alla tua applicazione

Per registrare un'app Android, puoi scegliere di registrare un'app tramite Amazon Appstore (Aggiungi un'app Android per Amazon Appstore) o direttamente con Accedi con Amazon (Aggiungi un Android Applicazione senza Appstore). Quando la tua app è registrata, avrai accesso a una chiave API che concederà alla tua app l'accesso al servizio di autorizzazione Accedi con Amazon.

Nota: Se prevedi di utilizzare Amazon Device Messaging nella tua app Android, contatta lwa-support@amazon.com con:

• L'indirizzo e-mail dell'account Amazon con cui ti sei registrato per il login
• L'indirizzo e-mail dell'account Amazon che hai utilizzato per registrarti ad Amazon Appstore (se diverso).
• Il nome sul tuo account Seller Central (in Seller Central, fai clic su Impostazioni> Informazioni sull'account> Informazioni sul venditore, e utilizzare il Nome da visualizzare).
• Il nome sul tuo account sviluppatore Amazon Appstore (nel sito di distribuzione di app mobili, fai clic su Impostazioni > Azienda Profile e utilizzare il Nome dello sviluppatore o nome della società).

Aggiungi un'app Android per Amazon Appstore

I seguenti passaggi aggiungeranno un'app Amazon Appstore al tuo account di accesso con Amazon:

1. Dalla schermata Applicazione, fare clic su Impostazioni Android. Se hai già un'app Android registrata, cerca il file Aggiungi chiave API pulsante nel Impostazioni Android selezione
   IL Dettagli dell'applicazione Android apparirà il modulo:
2. Selezionare SÌ in risposta alla domanda "Questa applicazione è distribuita tramite Amazon Appstore?"
3. Entra nel Etichetta della tua App Android. Questo non deve essere il nome ufficiale della tua app. Identifica semplicemente questa particolare app Android tra le app e websiti registrati al tuo Login con Amazon
4. Aggiungi il tuo ID Amazon Appstore.
5. Se hai autofirmato la tua app, aggiungi le informazioni di autofirma. Ciò ti consentirà di ottenere una chiave API durante lo sviluppo senza utilizzare direttamente l'Appstore.
   a. Se la tua app non viene firmata tramite Amazon Appstore, seleziona SÌ in risposta alla domanda "Questa applicazione è autofirmata?"
   IL Dettagli dell'applicazione Android il modulo si espanderà
   
   b. Inserisci il tuo Nome del pacchetto.
   Deve corrispondere al nome del pacchetto del tuo progetto Android. Per determinare il nome del pacchetto del tuo progetto Android, apri il progetto nello strumento di sviluppo Android di tua scelta. Aperto
   AndroidManifest.XML in Package Explorer e seleziona il file Manifesto tab. La prima voce è il file Pacchetto nome.
   c. Accedi all'app Firma.
   Questo è un valore hash SHA-256 utilizzato per verificare la tua applicazione. La firma deve essere sotto forma di 32 coppie esadecimali separate da due punti (ad esampon: 01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef). Vedere Firme delle app Android e chiavi API per i passaggi che puoi utilizzare per estrarre la firma dal tuo progetto.
   6. Fare clic Salva.

Aggiungi un'app Android senza Appstore

Se desideri registrare la tua app Android senza utilizzare Amazon Appstore, puoi utilizzare i seguenti passaggi per registrare il nome del pacchetto e la firma con Accedi con Amazon:

1. Dalla schermata Applicazione, fare clic su Impostazioni Android. Se hai già un'app Android registrata, cerca il file Aggiungi chiave API pulsante nel Impostazioni Android IL Dettagli dell'applicazione Android apparirà il modulo:
   
2. Selezionare NO in risposta alla domanda "Questa applicazione è distribuita tramite Amazon Appstore?"
3. Entra nel Etichetta del tuo Android
   Questo non deve essere il nome ufficiale della tua app. Identifica semplicemente questa particolare app Android tra le app e websiti che hai registrato.
4. Inserisci il tuo Nome del pacchetto. Deve corrispondere al nome del pacchetto del tuo progetto Android.
   Per determinare il nome del pacchetto del tuo progetto Android, apri il progetto nello strumento di sviluppo Android di tua scelta. Aperto AndroidManifest.XML in Package Explorer e seleziona il file Manifesto tab. La prima voce è il file Pacchetto nome.
5. Accedi all'app Firma.
   Questo è un valore hash SHA-256 utilizzato per verificare la tua applicazione. La firma deve essere sotto forma di 32 coppie esadecimali separate da due punti (ad esampon: 01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd: ef). Vedi il Firme delle app Android e chiavi API sezione sottostante per i passaggi che è possibile utilizzare per estrarre la firma dal progetto.
6. Clic Salva.

Se versioni diverse della tua app hanno firme o nomi di pacchetti diversi, ad esempio per una o più versioni di test e una versione di produzione, ogni versione richiede la propria chiave API. Dal Impostazioni Android della tua app, fai clic su Aggiungi chiave API pulsante per creare chiavi aggiuntive per la tua app (una per versione).

Firme delle app Android e chiavi API

La firma dell'app è un valore hash SHA-256 che viene applicato a ogni app Android quando viene creata. Amazon utilizza la firma dell'app per costruire la tua chiave API. La chiave API consente ai servizi Amazon di riconoscere la tua app. Se utilizzi Amazon Appstore per firmare la tua app, la chiave API viene fornita automaticamente. Se non utilizzi Amazon Appstore, dovrai gestire manualmente la tua chiave API.

Le firme delle app vengono archiviate in un keystore. In genere, per le app Android sono disponibili un keystore di debug e un keystore di rilascio. Per trovare la posizione del keystore di debug in Android Studio, apri il file Costruire menu, seleziona Modificare Tipi di build, quindi vai al Firma scheda e individuare il keystore di debug nel file Negozio File campo.

Normalmente viene creato un keystore di rilascio quando esporti la tua app Android per creare un APK firmato file. Attraverso il processo di esportazione, se stai creando un nuovo keystore di rilascio, selezionerai la sua posizione. Per impostazione predefinita, verrà posizionato nella stessa posizione del KeyStore di debug predefinito.

Se hai registrato la tua app utilizzando la firma di debug durante lo sviluppo, dovrai aggiungere una nuova impostazione Android alla tua applicazione quando sarai pronto per rilasciare l'app. La nuova impostazione dell'app deve utilizzare la firma del keystore di rilascio.

Vedere Firma delle applicazioni su developer.android.com per ulteriori informazioni.

Determina la firma dell'app Android

1. Se hai un APK firmato file:
   a. Decomprimi l'APK file ed estrarre CERT.RSA. (Se necessario, puoi rinominare l'estensione APK in ZIP).
   b. Dalla riga di comando, esegui:

   strumento chiave -printcert -file CERT.RSA

   Strumenti chiave situato nel bidone directory della tua installazione di Java.

2. Se hai un negozio di chiavi file:
   a. Dalla riga di comando, esegui:

   keytool -list -v -alias -archivio chiavifilenome>

   Strumento chiave si trova nel bidone directory della tua installazione di Java. L'alias è il nome della chiave utilizzata per firmare l'app.
   b. Immettere la password per la chiave e premere Entra.
3. Sotto Impronte digitali del certificato, copiare il SHA256 valore.

Recupera la chiave API Android

Dopo aver registrato un'impostazione Android e fornito una firma per l'app, puoi recuperare la chiave API dalla pagina di registrazione per l'applicazione Accedi con Amazon. Dovrai inserire quella chiave API in a file nel tuo progetto Android. Fino a quando non lo fai, l'app non sarà autorizzata a comunicare con il servizio di autorizzazione Accedi con Amazon.

1. Vai a https://login.amazon.com.
2. Clic Console dell'app.
3. Nel Applicazioni casella a sinistra, seleziona il tuo
4. Trova la tua app Android sotto il file Impostazioni Android sezione (Se non hai ancora registrato un'app Android, vedi Aggiungi un'app Android per Amazon Appstore).
5. Clic Genera valore chiave API. Una finestra popup visualizzerà la tua API. Per copiare la chiave, fai clic su Seleziona tutto per selezionare l'intera chiave.
   Nota: Il valore della chiave API si basa, in parte, sull'ora in cui viene generato. Pertanto, i successivi valori chiave API generati potrebbero differire dall'originale. Puoi utilizzare uno qualsiasi di questi valori chiave API nella tua app poiché sono tutti validi.
6. Vedere Aggiungi la tua chiave API al tuo progetto per istruzioni su come aggiungere la chiave API al tuo Android

Crea un accesso con Amazon Project

In questa sezione imparerai come creare un nuovo progetto Android per Accedi con Amazon, configurare il progetto e aggiungere codice al progetto per accedere a un utente con Accedi con Amazon. Descriveremo i passaggi per Android Studio, ma puoi applicare passaggi analoghi a qualsiasi IDE o strumento di sviluppo Android di tua scelta.

Questa guida richiede una comprensione di Attività - un concetto chiave dello sviluppo di applicazioni Android. Impara di più riguardo Attività E Frammenti di attività su developer.android.com.

Crea un nuovo accesso con Amazon Project

Se non disponi ancora di un progetto di app per l'utilizzo di Accedi con Amazon, segui le istruzioni di seguito per crearne uno. Se hai un'app esistente, vai a Installa il login con Amazon Library.

1. Lancio Android
2. Dal File menu, seleziona Nuovo E Progetto.
3. Inserire un Nome dell'applicazione E Nome dell'azienda per il tuo
4. Entra nel Applicazione E Nome dell'azienda corrispondente al nome del pacchetto che hai scelto quando hai registrato la tua app con Accedi con Amazon.
   Se non hai ancora registrato la tua app, scegli un file Nome del pacchetto e quindi seguire le istruzioni in Registrazione con Login con Amazon sezione dopo aver creato il progetto. Se il nome del pacchetto della tua app non corrisponde al nome del pacchetto registrato, le tue chiamate di accesso con Amazon non avranno esito positivo.
5. Seleziona un SDK minimo richiesto di API 11: Android 3.0 (Honeycomb) o versioni successive e fare clic su Prossimo. In alternativa puoi usare un file SDK minimo richiesto di API 8: Android 2.2 (Froyo) o versioni successive quando si utilizza la v4 Libreria di supporto Android.
6. Seleziona il tipo di attività che desideri creare e fai clic Prossimo.
7. Compila i dettagli pertinenti e fai clic Fine.

Ora avrai un nuovo progetto nella tua area di lavoro che puoi utilizzare per chiamare Accedi con Amazon.

Installa il login con Amazon Library

Se non hai ancora scaricato il login con Amazon SDK per Android, vedi Installa il login con Amazon SDK per Android.

1. Utilizzando il file sistema sul tuo computer, trova il login-con-amazon-sdk.jar file all'interno del Login con Amazon SDK per Android. Copialo negli appunti.
2. Con il progetto aperto in Android Studio, apri il file Progetto View.
3. Fai clic con il pulsante destro del mouse sulla directory principale per il tuo progetto / app nel file Progetto View e seleziona Impasto.
4. Fare clic con il tasto destro del mouse login-con-amazon-sdk.jar nel Progetto View e seleziona Aggiungi come libreria.

Imposta le autorizzazioni di rete per la tua app

Affinché la tua app possa utilizzare Accedi con Amazon, deve accedere a Internet e accedere alle informazioni sullo stato della rete. La tua app deve affermare queste autorizzazioni nel tuo manifest Android, se non lo è già.

1. Dal Progetto View, fai doppio clic su xml per aprirlo.
2. Copia le righe di codice visualizzate di seguito e incollale nel file xml file, al di fuori del blocco dell'applicazione:
   

   Exampon:
   

Aggiungi la tua chiave API al tuo progetto

Quando registri la tua applicazione Android con Accedi con Amazon, ti viene assegnata una chiave API. Questo è un identificatore che Amazon Authorization Manager utilizzerà per identificare la tua applicazione per il servizio di autorizzazione Accedi con Amazon. Se utilizzi Amazon Appstore per firmare la tua app, l'Appstore fornirà automaticamente la chiave API. Se non stai utilizzando Amazon Appstore, Amazon Authorization Manager carica questo valore in fase di esecuzione dal file chiave_api.txt file nel attività elenco.

1. Se non hai ancora la tua chiave API, segui le istruzioni in Recupera la chiave API Android.
2. Dal Progetto View in Android Studio, fai clic con il pulsante destro del mouse sulla cartella delle risorse, quindi fai clic su Nuovo e seleziona File. Se non disponi di una cartella delle risorse, fai clic con il pulsante destro del mouse sulla directory principale del progetto, quindi seleziona Nuovo, Cartella, Cartella risorse.
3. Nomina il file chiave_api.txt.
4. Ora dovresti avere una finestra dell'editor per un testo file nominato TXT. Aggiungi la tua chiave API al testo file.
5. Nel File menu, clicca Salva.

Nota: Se un editor di testo aggiunge caratteri extra al tuo api_key.txt file (come un Byte Order Mark), potresti visualizzare ERROR_ACCESS_DENIED quando tenti di connetterti al servizio di autorizzazione Accedi con Amazon. Se ciò si verifica, prova a rimuovere eventuali spazi iniziali o finali, feed di riga o caratteri sospetti. (Ad esample, un editor che utilizza Byte Order Mark potrebbe aggiungere 0xEF 0xBB 0xBF o altre sequenze esadecimali all'inizio del tuo api_key.txt file). Puoi anche provare a recuperare una nuova chiave API.

Gestisci le modifiche alla configurazione per la tua attività

Se un utente cambia l'orientamento dello schermo o cambia lo stato della tastiera del dispositivo durante l'accesso, verrà richiesto un riavvio dell'attività corrente. Questo riavvio chiuderà inaspettatamente la schermata di accesso. Per evitare ciò, è necessario impostare l'attività che utilizza il metodo di autorizzazione per gestire manualmente le modifiche alla configurazione. Ciò impedirà il riavvio dell'attività.

1. In Pacchetto Esploratore, fare doppio clic xml.
2. Nel Applicazione sezione, individuare l'attività che gestirà Login con Amazon (forexampLui, Attività principale),
3. Aggiungi il seguente attributo all'attività che hai individuato nel passaggio 2:
   

   android: configChanges = "keyboard | keyboardHidden | orientamento"

   O per API 13 o superiore:

   android: configChanges = "keyboard | keyboardHidden | Orientamento | ScreenSize"

4. Dal File menu, clicca Salva

Ora, quando si verifica una modifica dell'orientamento della tastiera o del dispositivo, Android chiamerà il metodo onConfigurationChanged per la tua attività. Non è necessario implementare questa funzione a meno che non vi sia un aspetto di queste modifiche alla configurazione che si desidera gestire per la propria app.

Aggiungi un'attività del flusso di lavoro al tuo progetto

Quando l'utente fa clic sul pulsante Accedi con Amazon, l'API verrà avviata a web browser per presentare all'utente una pagina di accesso e consenso. Affinché questa attività del browser funzioni, è necessario aggiungere WorkflowActivity al manifest.

Se hai già eseguito l'integrazione con Login con Amazon SDK o hai l'attività com.amazon.identity.auth.device.authorization.AuthorizationActivity dichiarata in AndroidManifest.xml, deve essere rimossa e sostituita con WorkflowActivity.

1. In Pacchetto Esploratore, fare doppio clic AndroidMailfest.xml ..
2. Nel Applicazione sezione, aggiungi il codice seguente.
   

   <attività android:nome= "Com.amazon.identity.auth.device.workflow.WorkflowActivity" android: theme = "@ android: style / Theme.NoDisplay" android: allowTaskReparenting = "true" android: launchMode = "singleTask"> <azione android:name="android.intent.action.VIEW” /> <dati android: host = "$ {applicationId}" android: scheme = "amzn" />

   Nota: Se non stai utilizzando il sistema di compilazione Gradle, sostituisci $ {applicationId} con il nome del pacchetto per questa app.

Aggiungi un accesso con il pulsante Amazon alla tua app

Accedi con Amazon fornisce diversi pulsanti standard che puoi utilizzare per richiedere agli utenti di accedere dalla tua app. Questa sezione fornisce i passaggi per scaricare un login ufficiale con un'immagine Amazon e accoppiarlo con un ImageButton Android.

1. Aggiungi un ImageButton standard alla tua app.
   Per ulteriori informazioni sui pulsanti Android e sulla classe ImageButton, vedere Pulsanti su developer.android.com.

2. Assegna al tuo pulsante un Nella dichiarazione XML del pulsante, imposta l'attributo android:id su @+id/login_with_amazon. Ad esempioampon:
   

   android: id = "@ + id / login_with_amazon"

3. Scegli un'immagine del pulsante.
   Consulta il nostro Login con Amazon Linee guida di stile per un elenco di pulsanti che puoi utilizzare nella tua app.
   Scarica una copia del file LWA_Android.zip file. Estrai una copia del tuo pulsante preferito per ogni densità di schermo supportata dalla tua app (xxhdpi, xhdpi, hdpi, mdpi o tvdpi). Per ulteriori informazioni sul supporto di più densità dello schermo in Android, vedere Layout alternativi nell'argomento "Supporto di più schermi" ondeveloper.android.com.
4. Copia l'immagine del pulsante appropriata fileal tuo progetto.
   Per ogni densità dello schermo supportata (xhdpi, hdpi, mdpi o ldpi), copia il pulsante scaricato nel res / drawable directory per quella densità dello schermo.
5. Dichiara l'immagine del pulsante.
   Nella dichiarazione XML del pulsante, impostare il file android: src attribuisci al nome del pulsante che hai scelto. Ad esempioampon:

   android: src = "@ drawable / btnlwa_gold_loginwithamazon.png"

6.  Carica la tua app e verifica che il pulsante ora abbia un'immagine Accedi con Amazon.
   È necessario verificare che il pulsante venga visualizzato correttamente per ciascuna densità dello schermo supportata

Usa l'SDK per le API Android

In questa sezione, aggiungerai il codice al tuo progetto per accedere a un utente con Accedi con Amazon.

Gestisci il pulsante di accesso e autorizza l'utente

Questa sezione spiega come chiamare l'API di autorizzazione per accedere a un utente. Ciò include la creazione di un file al clic listener per il tuo pulsante Accedi con Amazon nel file suCrea metodo della tua app.

1. Aggiungi Accedi con Amazon al tuo Android Vedi Installa il login con Amazon Library.
2. Inizializzare Contesto della richiesta.
   Dovrai dichiarare un file Contesto della richiesta variabile e creare una nuova istanza della classe. Il posto migliore per inizializzare Contesto della richiesta è nel suCrea metodo della tua attività o frammento Android. Ad esempioampon:

   privato RequestContext requestContext; @Oltrepassare protected void onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); requestContext = RequestContext.create (questo); }

3. Crea un Autorizza ascoltatore.
   Autorizza ascoltatore elaborerà il risultato del file autorizecall. Contiene tre metodi: in caso di successo, in caso di errore, E suAnnulla. Crea il Autorizza ascoltatore interfaccia in linea con un registratiAscoltatore chiamare in suCrea metodo della tua attività o frammento Android.

   @Oltrepassare protected void onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); requestContext = RequestContext.create (questo);requestContext.registerListener (new AuthorizeListener () { / * L'autorizzazione è stata completata con successo. * / @Oltrepassare public void onSuccess (AuthorizeResult result) { / * La tua app è ora autorizzata per gli ambiti richiesti * / } / * Si è verificato un errore durante il tentativo di autorizzazione dell'applicazione. * / @Oltrepassare public void onError (AuthError ae) { / * Informa l'utente dell'errore * / } / * L'autorizzazione è stata annullata prima che potesse essere completata. */ @Oltrepassare public void onCancel (AuthCancellation cancel) { / * Ripristina l'interfaccia utente in uno stato pronto per il login * / } }); }

   Nota: Se stai usando un frammento e catturando riferimenti a View oggetti nel tuo Autorizza ascoltatore implementazione, creare Autorizza ascoltatore nel suCreaView metodo invece di suCrea. Ciò garantisce la View i riferimenti agli oggetti sono impostati quando la chiamata a autorizzafinisce.

4. Attrezzo in caso di successo, in caso di errore, E suAnnulla per il tuo Autorizza ascoltatore.
   Poiché il processo di autorizzazione presenta una schermata di accesso (ed eventualmente una schermata di consenso) all'utente in a web browser (o a WebView), l'utente avrà la possibilità di annullare il login o uscire. Se annullano esplicitamente il processo di accesso, suAnnulla viene chiamato e vorrai reimpostare la tua interfaccia utente.
   Se l'utente esce dalla schermata di accesso nel browser o WebView, quindi torna alla tua app, l'SDK non rileverà che l'accesso non è stato completato. Se rilevi l'attività dell'utente nella tua app prima che l'accesso sia completato, puoi presumere che siano usciti dal browser e reagiscano di conseguenza.
5. Chiamata RequestContext.onResume.
   Per adattare il ciclo di vita dell'applicazione Android, implementare il sulRiprendi metodo nella tua attività o frammento. Questo attiverà tutti i listener registrati con registratiAscoltatore nel caso in cui la tua app venga chiusa dal sistema operativo prima che l'utente completi un flusso di autorizzazione.

   @Oltrepassare protected void onResume () { super.onResume (); requestContext.onResume (); }

6. Chiamata AuthorizationManager.autorizza.
   Nel al clic gestore del pulsante Accedi con Amazon, chiama l'autorizzazione per richiedere all'utente di accedere e autorizzare la tua applicazione.
   Questo metodo consentirà all'utente di accedere e acconsentire alle informazioni richieste in uno dei seguenti modi:
   1. Passa al browser di sistema
   2. Passa a WebView in un contesto sicuro (se l'app Amazon Shopping è installata sul dispositivo)
   Il contesto protetto per la seconda opzione è disponibile quando l'app Amazon Shopping è installata sul dispositivo. Dispositivi creati da Amazon che eseguono Fire OS (ad esample Kindle Fire, Fire Phone e Fire TV) utilizzano sempre questa opzione anche se sul dispositivo non è presente l'app Amazon Shopping. Per questo motivo, se l'utente ha già effettuato l'accesso all'app Amazon Shopping, questa API salterà la pagina di accesso, portando a un Accesso singolo esperienza per l'utente. Guarda l'esperienza del cliente in esperienza-cliente-android app per saperne di più. Quando la tua applicazione è autorizzata, è autorizzata per uno o più set di dati noti come ambiti. Un ambito comprende i dati utente che stai richiedendo da Login with Amazon. La prima volta che un utente accede alla tua app, gli verrà presentato un elenco dei dati che stai richiedendo e verrà richiesta l'approvazione. L'accesso con Amazon attualmente supporta i seguenti ambiti:

   Nome dell'ambito	Descrizione
   professionistafile	Fornisce accesso al nome dell'utente, all'indirizzo e-mail e all'ID dell'account Amazon.
   professionistafile:ID utente	Dà accesso solo all'ID dell'account Amazon dell'utente.
   Codice Postale	Dà accesso al codice postale dell'utente su file per il loro account Amazon.

   AuthorizationManager.autorizza è una chiamata asincrona, quindi non è necessario bloccare il thread dell'interfaccia utente o creare un thread di lavoro personalizzato. Per chiamare l'autorizzazione, passare un Richiesta di autorizzazione oggetto che può essere costruito utilizzando AuthorizeRequest.Builder:
   

   @Oltrepassare protected void onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); / * Precedenti su Crea dichiarazioni omesse * /// Trova il pulsante con l'ID login_with_amazon // e imposta un gestore di clic View loginButton = trovaViewById(R.id.login_with_amazon); loginButton.setOnClickListener(nuovo View.OnClickListener() { @Oltrepassare vuoto pubblico al clic (View v) { AuthorizationManager.authorize(nuova AuthorizeRequest Builder(requestContext).addScope(ProfileScope.profile(), ProfileScope.codicepostale()) .costruire()); }); }

Recupera utente professionalefile Dati

Questa sezione spiega come utilizzare l'API utente per recuperare il pro . di un utentefile dati dopo che sono stati autorizzati. Il profile i dati che puoi recuperare si basano sull'ambito indicato nel autorizza: withHandler: chiamata.

1. Chiamata Recupero.utente.
   Recupero.utente restituisce il pro . dell'utentefile dati a te attraverso l'ascoltatore AuthError> richiama. Ascoltatore AuthError> contiene due metodi: suSuccess E suErrore (non supporta suAnnulla perché non è possibile annullare un file Recupero.utente chiamata). suSuccess riceve un oggetto Utente con profile dati, mentre suErrore riceve un Errore di autenticazione oggetto con informazioni sull'errore. aggiornamentoProfileDati è un exampfile di una funzione che la tua app potrebbe implementare per visualizzare profile dati nell'interfaccia utente
   Nota: User.getUserPostalCode viene restituito solo se richiedi il ProfileScope.postalCode() ambito.

Verificare l'accesso utente all'avvio

Se un utente accede alla tua app, la chiude e la riavvia in un secondo momento, l'app è comunque autorizzata a recuperare i dati. L'utente non viene disconnesso automaticamente. All'avvio, puoi mostrare l'utente come connesso se la tua app è ancora autorizzata. Questa sezione spiega come utilizzare getToken per vedere se l'app è ancora autorizzata.

1. Chiamata getToken.
   Nel suStart metodo della tua attività o frammento, chiama getToken per vedere se l'applicazione è ancora autorizzata. getToken recupera il token di accesso non elaborato che il Responsabile delle autorizzazioni utilizza per accedere a un profilo utentefile. Se il valore del token non è nullo, l'app è ancora autorizzata e puoi procedere al recupero dell'utente profile dati. getToken richiede gli stessi ambiti di cui hai chiesto l'autorizzazione nella chiamata.
   getToken supporta chiamate asincrone nello stesso modo di Utente.fetch, quindi non devi bloccare il thread dell'interfaccia utente o creare un tuo thread di lavoro. Chiamare getToken in modo asincrono, passa un oggetto che supporta l'estensione Ascoltatore interfaccia come ultimo parametro.
2. Dichiara un file Ascoltatore AuthError>. La tua implementazione di Ascoltatore AuthError> elabora il risultato di getToken chiamata. Listener contiene due metodi: suSuccess E suErrore (non supporta suAnnulla perché non è possibile annullare un file getToken chiamata).
3. Attrezzo suSuccess e onError per il tuo Ascoltatore . onSuccess riceve un Autorizzarisultato oggetto con un token di accesso, mentre suErrore riceve un Errore di autenticazione oggetto con informazioni sull'errore.
   

   @Oltrepassare protetto void onStart () {super.onStart (); Scope[] scope = { ProfileScope.profile(), ProfileScope.codicepostale() }; AuthorizationManager.getToken(questo, ambiti, nuovo Ascoltatore () {@Oltrepassare public void onSuccess (AuthorizeResult result) {if (result.getAccessToken ()! = null) { / * L'utente ha effettuato l'accesso * / } altro { / * L'utente non ha effettuato l'accesso * / } } @Oltrepassare public void onError (AuthError ae) { / * L'utente non ha effettuato l'accesso * / } }); }

Cancella i dati di autorizzazione e disconnetti un utente

Questa sezione spiega come usare il metodo di disconnessione per disconnettere l'utente dall'app. L'utente dovrà effettuare nuovamente il login affinché l'app possa recuperare profile dati. Utilizzare questo metodo per disconnettere un utente o per risolvere i problemi di accesso nell'app.

1. Implementa un meccanismo di logout.
   Quando un utente ha effettuato l'accesso con successo, dovresti fornire un meccanismo di logout in modo che possa cancellare il suo profilofile dati e ambiti preventivamente autorizzati. Il tuo meccanismo potrebbe essere un collegamento ipertestuale, un pulsante o una voce di menu. Per questo example, creeremo un onClickMethod per un pulsante.
2. Chiamata disconnessione.
   Chiamata disconnessione nel tuo gestore di logout per rimuovere i dati di autorizzazione di un utente (token di accesso, profile) dal negozio locale. disconnessione accetta un contesto Android e un Listener AuthError> a gestire il successo o il fallimento.
3. Dichiara un ascoltatore anonimo AuthError>.
   La tua implementazione di Listener AuthError> elabora il risultato di disconnessione chiamata. Le classi anonime sono utili per acquisire variabili dall'ambito di inclusione.
   Vedere Gestisci il pulsante di accesso e autorizza l'utente per un examplecio dichiara le classi dell'ascoltatore.
4. Attrezzo suSuccess E suErrore per il tuo ascoltatore AuthError>.
   Quando segnoriuscito è necessario aggiornare l'interfaccia utente per rimuovere i riferimenti all'utente e fornire un meccanismo di accesso che gli utenti possono utilizzare per accedere nuovamente. Se segnoRisultati un errore, puoi consentire all'utente di provare a disconnettersi di nuovo.

   @Oltrepassare protected void onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); / * Precedenti su Crea dichiarazioni omesse * /// Trova il pulsante con l'ID di disconnessione e imposta un gestore dei clic View logoutButton = trovaViewById(R.id.logout); logoutButton.setOnClickListener(nuovo View.OnClickListener() {@Oltrepassare vuoto pubblico al clic (View v) { AuthorizationManager.signOut(getApplicationContext(), nuovo Ascoltatore () { @Oltrepassare public void onSuccess (Void response) { // Imposta lo stato di disconnessione nell'interfaccia utente } @Oltrepassare public void onError (AuthError authError) { // Registra l'errore } }); } }); }

Accedi con Amazon Guida introduttiva per app Android - Scarica [ottimizzato]
Accedi con Amazon Guida introduttiva per app Android - Scaricamento

Riferimenti

• Manuale d'uso