Inicieu la sessió amb la Guia d'inici d'Amazon per a aplicacions d'Android
Inicieu sessió amb Amazon: Guia d'iniciació per a Android
Copyright © 2017 Amazon.com, Inc., o els seus afiliats. Tots els drets reservats.
Amazon i el logotip d’Amazon són marques comercials d’Amazon.com, Inc. o dels seus afiliats. La resta de marques comercials que no són propietat d’Amazon són propietat dels seus respectius propietaris.
Instal·leu les eines per a desenvolupadors d'Android
Inicieu sessió amb Amazon SDK per a Android us ajudarà a afegir Inici de sessió amb Amazon a les vostres aplicacions d'Android, Fire TV i Fire Tablet. Us recomanem que utilitzeu Inici de sessió amb Amazon SDK per a Android amb Android Studio. Per obtenir els passos sobre com instal·lar Android Studio i per configurar l'SDK d'Android, consulteu Obteniu l'SDK d'Android a developer.android.com.
Per utilitzar l'inici de sessió amb Amazon SDK per a Android, la vostra aplicació d'Android ha de complir un d'aquests requisits mínims:
- Versió mínima de l'SDK (minSdkVersion) d'Android 0 (API de nivell 11) o superior.
- Versió mínima de l'SDK (minSdkVersion) d'Android 2.2 (API Nivell 8) o superior amb la v4 Suport d'Android Biblioteca.
Quan l'SDK d'Android estigui instal·lat, cerqueu el Gestor d'SDK aplicació a la vostra instal·lació d'Android. Per desenvolupar l'inici de sessió amb Amazon, heu d'utilitzar el Gestor d'SDK per instal·lar els requisits mínims de l'SDK anteriors. Vegeu Afegint paquets SDK a developer.android.com per obtenir més informació sobre com utilitzar SDK Manager.
Després d'instal·lar l'SDK, configureu un dispositiu virtual d'Android (AVD) per executar les vostres aplicacions. Vegeu Gestionant Dispositius virtuals a developer.android.com per obtenir instruccions sobre com configurar un dispositiu virtual.
Quan el vostre entorn de desenvolupament estigui configurat, podeu fer-ho Instal·leu l'inici de sessió amb Amazon SDK per a Android or Executar el Sampl'aplicació, tal com es descriu a continuació
Instal·leu l'inici de sessió amb Amazon SDK per a Android
L'inici de sessió amb Amazon SDK per a Android es presenta en dos paquets. El primer conté la biblioteca d'Android i la documentació de suport. El segon conté comampl'aplicació que permet a un usuari iniciar sessió i mostrar el seu profile dades.
Si encara no heu instal·lat l'SDK d'Android o les eines de desenvolupament d'Android, consulteu el Instal·lació les eines per a desenvolupadors d'Android secció anterior.
- Descarregar cremallera i extreu el files a un directori del vostre disc dur. Hauries de veure a docs i a lib subdirectori.
- Obert docs/index.html a view la referència d'inici de sessió amb l'API d'Amazon Android.
- Mireu Instal·leu l'inici de sessió amb la biblioteca d'Amazon per obtenir instruccions sobre com afegir la biblioteca i la documentació a un Android
Quan s'ha instal·lat l'inici de sessió amb Amazon SDK per a Android, podeu fer-ho Creeu un nou inici de sessió amb Amazon Projecte després de tu Registreu-vos a Inicieu la sessió amb Amazon.
Executar el Sampl'aplicació
Per executar el sampl'aplicació, importeu el sampli a un espai de treball d'AndroidStudio.
- Descarregar SampleLoginWithAmazonAppForAndroid-src.zip i extreu el files a un directori del vostre disc dur
- Inicieu Android Studio i seleccioneu Obriu un projecte Android Studio existent.
- Navegueu fins al SampleLoginWithAmazonApp directori obtingut després d'extreure el zip descarregat file al pas 1.
- Des del Construir menú, feu clic Fes Projecte, i espereu que el projecte acabi la construcció.
- Des del Corre menú, feu clic Corre i després feu clic a SampleLoginWithAmazonApp.
- Seleccioneu l'emulador o el dispositiu Android connectat i feu clic Corre.
Registreu-vos a Inicieu la sessió amb Amazon
Abans de poder utilitzar Inici de sessió amb Amazon a weblloc o en una aplicació mòbil, heu de registrar una aplicació amb Inici de sessió amb Amazon. La vostra aplicació d'inici de sessió amb Amazon és el registre que conté informació bàsica sobre la vostra empresa i informació sobre cadascuna weblloc o aplicació mòbil que creeu que admet la sessió amb Amazon. Aquesta informació empresarial es mostra als usuaris cada vegada que utilitzen Inici de sessió amb Amazon al vostre weblloc o aplicació mòbil. Els usuaris veuran el nom de la vostra sol·licitud, el vostre logotip i un enllaç a la vostra política de privadesa. Aquests passos mostren com registrar l'aplicació Android per utilitzar-la amb Iniciar sessió amb Amazon.
Registreu el vostre inici de sessió amb l'aplicació Amazon
- Vés a https://login.amazon.com.
- Si ja us heu registrat per iniciar sessió amb Amazon, feu clic a Consola d'aplicacions. En cas contrari, feu clic Registra't. Se us redirigirà a Seller Central, que gestiona el registre de l'aplicació per iniciar sessió amb Si és la primera vegada que feu servir Seller Central, se us demanarà que configureu un compte de Seller Central.
- Feu clic Registre una nova aplicació. El Registreu la vostra sol·licitud apareixerà el formulari:
a. En el Registreu la vostra sol·licitud formulari, introduïu a Nom i a Descripció per a la seva aplicació.
El Nom és el nom que es mostra a la pantalla de consentiment quan els usuaris accepten compartir informació amb la vostra aplicació. Aquest nom s'aplica a Android, iOS i webversions del lloc de la vostra aplicació. El Descripció us ajuda a diferenciar cadascun dels vostres inicis de sessió amb les aplicacions d’Amazon i no es mostra als usuaris.
b. Introduïu a Avís de privadesa URL per a la seva aplicació.
El Avís de privadesa URL és la ubicació de la política de privadesa de la vostra empresa o aplicació (per exemple,ampel, http://www.example.com/privacy.html). Aquest enllaç es mostra als usuaris a la pantalla de consentiment.
c. Si voleu afegir un Imatge del logotip per a la vostra aplicació, feu clic Navega i localitza la imatge corresponent. - Feu clic Desa. El teu sampel registre hauria de ser semblant a això:
Després de desar la configuració bàsica de l'aplicació, podeu afegir paràmetres específics webllocs i aplicacions mòbils que faran servir aquest inici de sessió amb el compte d’Amazon.
Afegiu la configuració d'Android a la vostra aplicació
Per registrar una aplicació d'Android, podeu triar registrar una aplicació a través de l'Amazon Appstore (Afegiu una aplicació d'Android per a Amazon Appstore) o directament amb Inici de sessió amb Amazon (Afegeix un Android App sense Appstore). Quan la vostra aplicació estigui registrada, tindreu accés a una clau API que us permetrà accedir al servei d'autorització Inici de sessió amb Amazon.
Nota: Si teniu previst utilitzar Amazon Device Messaging a la vostra aplicació per a Android, poseu-vos en contacte lwa-support@amazon.com amb:
- L'adreça de correu electrònic del compte d'Amazon amb què vas registrar-te per iniciar sessió
- L'adreça de correu electrònic del compte d'Amazon que heu utilitzat per registrar-vos a Amazon Appstore (si és diferent).
- El nom del vostre compte de Seller Central (a Seller Central, feu clic a Configuració > Informació del compte > Informació del venedor, i utilitzeu el Nom de visualització).
- El nom del vostre compte de desenvolupador d'Amazon Appstore (al lloc de distribució d'aplicacions mòbils, feu clic a Configuració > Company Profile i utilitza el Nom del desenvolupador o nom de l'empresa).
Afegeix una aplicació d'Android per a Amazon Appstore
Els passos següents afegiran una aplicació Amazon Appstore al vostre compte d'inici de sessió amb Amazon:
- A la pantalla de l'aplicació, feu clic Configuració d'Android. Si ja teniu una aplicació d'Android registrada, cerqueu Afegeix una clau API botó a Configuració d'Android selecció
El Detalls de l'aplicació d'Android apareixerà el formulari: - Seleccioneu Sí en resposta a la pregunta "Aquesta aplicació es distribueix a través de l'Amazon Appstore?"
- Introduïu el Etiqueta de la teva aplicació per a Android. Aquest no ha de ser el nom oficial de la vostra aplicació. Simplement identifica aquesta aplicació d'Android en particular entre les aplicacions i webllocs registrats al vostre inici de sessió amb Amazon
- Afegeix el teu Identificador d'Amazon Appstore.
- Si heu signat l'aplicació, afegiu-hi informació d'autofirma. Això us permetrà obtenir una clau API durant el desenvolupament sense utilitzar directament l'Appstore.
a. Si la vostra aplicació no s'està signant a través de l'Amazon Appstore, seleccioneu Sí en resposta a la pregunta "Aquesta aplicació està signada per si mateix?"
El Detalls de l'aplicació d'Android forma s'ampliarà
b. Introduïu el vostre Nom del paquet.
Ha de coincidir amb el nom del paquet del vostre projecte Android. Per determinar el nom del paquet del vostre projecte d'Android, obriu el projecte a l'eina de desenvolupament d'Android que trieu. Obert
AndroidManifest.XML a l'Explorador de paquets i seleccioneu Manifest pestanya. La primera entrada és la paquet nom.
c. Entra a l'aplicació Signatura.
Aquest és un valor hash SHA-256 utilitzat per verificar la vostra aplicació. La signatura ha de tenir la forma de 32 parells hexadecimals separats per dos punts (per exampLI: 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). Mireu Signatures d'aplicacions d'Android i claus API per als passos que podeu utilitzar per extreure la signatura del vostre projecte.
6. Feu clic Desa.
Afegeix una aplicació per a Android sense Appstore
Si voleu registrar la vostra aplicació per a Android sense utilitzar l'Amazon Appstore, podeu seguir els passos següents per registrar el vostre nom i signatura de paquet amb Inici de sessió amb Amazon:
- A la pantalla de l'aplicació, feu clic Configuració d'Android. Si ja teniu una aplicació d'Android registrada, cerqueu Afegeix una clau API botó a Configuració d'Android El Detalls de l'aplicació d'Android apareixerà el formulari:
- Seleccioneu No en resposta a la pregunta "Aquesta aplicació es distribueix a través de l'Amazon Appstore?"
- Introduïu el Etiqueta del teu Android
Aquest no ha de ser el nom oficial de la vostra aplicació. Simplement identifica aquesta aplicació d'Android en particular entre les aplicacions i webllocs que heu registrat. - Introduïu el vostre Nom del paquet. Ha de coincidir amb el nom del paquet del vostre projecte Android.
Per determinar el nom del paquet del vostre projecte d'Android, obriu el projecte a l'eina de desenvolupament d'Android que trieu. Obert AndroidManifest.XML a l'Explorador de paquets i seleccioneu Manifest pestanya. La primera entrada és la paquet nom. - Entra a l'aplicació Signatura.
Aquest és un valor hash SHA-256 utilitzat per verificar la vostra aplicació. La signatura ha de tenir la forma de 32 parells hexadecimals separats per dos punts (per exampLI: 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). Veure el Signatures d'aplicacions d'Android i claus API secció següent per als passos que podeu utilitzar per extreure la signatura del vostre projecte. - Feu clic Desa.
Si diferents versions de la vostra aplicació tenen signatures o noms de paquet diferents, com ara una o més versions de prova i una versió de producció, cada versió requereix la seva pròpia clau d'API. Des del Configuració d'Android de la vostra aplicació, feu clic a Afegeix una clau API per crear claus addicionals per a la vostra aplicació (una per versió).
Signatures d'aplicacions d'Android i claus API
La signatura de l'aplicació és un valor hash SHA-256 que s'aplica a totes les aplicacions d'Android quan es crea. Amazon utilitza la signatura de l'aplicació per construir la vostra clau API. La clau API permet als serveis d'Amazon reconèixer la vostra aplicació. Si utilitzeu Amazon Appstore per signar la vostra aplicació, la clau de l'API es proporciona automàticament. Si no feu servir l'Amazon Appstore, haureu de gestionar la vostra clau API manualment.
Les signatures de les aplicacions s'emmagatzemen en un magatzem de claus. En general, per a les aplicacions d'Android hi ha un magatzem de claus de depuració i un magatzem de claus de llançament. Per trobar la ubicació del magatzem de claus de depuració a Android Studio, obriu Construir menú, seleccioneu Edita Tipus de construcció, després aneu a Signatura pestanya i localitzeu el magatzem de claus de depuració al fitxer Botiga File camp.
Normalment es crea un magatzem de claus de llançament quan exporteu la vostra aplicació per a Android per crear un APK signat file. Mitjançant el procés d'exportació, si esteu creant un magatzem de claus de versió nova, seleccionareu la seva ubicació. De manera predeterminada, es col·locarà a la mateixa ubicació que el vostre KeyStore de depuració predeterminat.
Si heu registrat la vostra aplicació mitjançant la signatura de depuració durant el desenvolupament, haureu d'afegir una nova configuració d'Android a la vostra aplicació quan estigueu preparat per llançar l'aplicació. La nova configuració de l'aplicació ha d'utilitzar la signatura del magatzem de claus de llançament.
Mireu Signant les vostres sol·licituds a developer.android.com per obtenir més informació.
Determineu la signatura de l'aplicació d'Android
- Si teniu un APK signat file:
a. Descomprimiu l'APK file i extreu CERT.RSA. (Podeu canviar el nom de l'extensió APK a ZIP si cal).
b. Des de la línia d'ordres, executeu:keytool -printcert -file CERT.RSA Eines clau situat a la paperera directori de la vostra instal·lació de Java.
- Si teniu un magatzem de claus file:
a. Des de la línia d'ordres, executeu:keytool -list -v -alias - magatzem de clausfilenom> Keytool es troba a la paperera directori de la vostra instal·lació de Java. L'àlies és el nom de la clau utilitzada per signar l'aplicació.
b. Introduïu la contrasenya de la clau i premeu Entra. - Sota Empremtes dactilars del certificat, copiar el SHA256 valor.
Recupera la clau de l'API d'Android
Quan hàgiu registrat una configuració d'Android i heu proporcionat una signatura d'aplicació, podeu recuperar la clau API des de la pàgina de registre de l'aplicació Inici de sessió amb Amazon. Haureu de col·locar aquesta clau de l'API a un file al vostre projecte Android. Fins que no ho feu, l'aplicació no estarà autoritzada per comunicar-se amb el servei d'autorització Login with Amazon.
- Vés a https://login.amazon.com.
- Feu clic Consola d'aplicacions.
- En el Aplicacions quadre de l'esquerra, seleccioneu el vostre
- Trobeu la vostra aplicació per a Android a sota de Configuració d'Android secció (si encara no heu registrat una aplicació per a Android, consulteu Afegiu una aplicació d'Android per a Amazon Appstore).
- Feu clic Genera el valor de la clau de l'API. Una finestra emergent mostrarà la vostra API. Per copiar la clau, feu clic Seleccioneu Tot per seleccionar tota la tecla.
Nota: El valor de la clau API es basa, en part, en el temps que es genera. Per tant, els següents valors de claus de l'API que genereu poden diferir de l'original. Podeu utilitzar qualsevol d’aquests valors clau de l’API a la vostra aplicació, ja que tots són vàlids. - Mireu Afegiu la vostra clau API al vostre projecte per obtenir instruccions sobre com afegir la clau API al vostre Android
Creeu un inici de sessió amb Amazon Project
En aquesta secció, aprendràs a crear un nou projecte d'Android per iniciar sessió amb Amazon, configurar el projecte i afegir codi al projecte per iniciar la sessió d'un usuari amb Inici de sessió amb Amazon. Descrivim els passos per a Android Studio, però podeu aplicar passos anàlegs a qualsevol IDE o eina de desenvolupament d'Android que trieu.
Aquesta guia requereix una comprensió Activitats – un concepte clau del desenvolupament d'aplicacions d'Android. Aprendre mes sobre Activitats i Fragments d'activitat a developer.android.com.
Creeu un nou inici de sessió amb Amazon Project
Si encara no teniu cap projecte d'aplicació per utilitzar Inici de sessió amb Amazon, seguiu les instruccions següents per crear-ne un. Si teniu una aplicació existent, aneu a Instal·leu l'inici de sessió amb la biblioteca d'Amazon.
- Llançament Android
- Des del File menú, seleccioneu Nou i Projecte.
- Introduïu un Nom de l'aplicació i Nom de l'empresa pel teu
- Introduïu el Aplicació i Nom de l'empresa corresponent al nom del paquet que vau triar quan vau registrar la vostra aplicació amb Inici de sessió amb Amazon.
Si encara no heu registrat la vostra aplicació, trieu a Nom del paquet i després seguiu les instruccions del fitxer Registrar-se a Iniciar sessió amb Amazon secció després de crear el projecte. Si el nom del paquet de la vostra aplicació no coincideix amb el nom del paquet registrat, les trucades d'inici de sessió amb Amazon no tindran èxit. - Seleccioneu a SDK mínim requerit de l'API 11: Android 3.0 (Honeycomb) o superior i feu clic A continuació. Alternativament, podeu utilitzar a SDK mínim requerit de l'API 8: Android 2.2 (Froyo) o superior quan s'utilitza la v4 Biblioteca de suport d'Android.
- Seleccioneu el tipus d'activitat que voleu crear i feu clic A continuació.
- Ompliu les dades rellevants i feu clic Acabar.
Ara tindreu un nou projecte al vostre espai de treball que podeu utilitzar per trucar a Inici de sessió amb Amazon.
Instal·leu l'inici de sessió amb la biblioteca d'Amazon
Si encara no us heu descarregat el Login with Amazon SDK per a Android, consulteu Instal·leu l'inici de sessió amb Amazon SDK per a Android.
- Utilitzant el file sistema al vostre ordinador, cerqueu el login-with-amazon-sdk.jar file dins de Inici de sessió amb Amazon SDK per a Android. Copieu-lo al porta-retalls.
- Amb el vostre projecte obert a Android Studio, obriu el fitxer Projecte View.
- Feu clic amb el botó dret al directori principal del vostre projecte/aplicació a Projecte View i seleccioneu Enganxa.
- Feu clic amb el botó dret login-with-amazon-sdk.jar en el Projecte View i seleccioneu Afegeix com a biblioteca.
Establiu els permisos de xarxa per a la vostra aplicació
Perquè la vostra aplicació utilitzi Login with Amazon, ha d'accedir a Internet i accedir a la informació de l'estat de la xarxa. La vostra aplicació ha d'afirmar aquests permisos al vostre manifest d'Android, si encara no ho fa.
- Des del Projecte View, feu doble clic a xml per obrir-lo.
- Copieu les línies de codi que es mostren a continuació i enganxeu-les al fitxer xml file, fora del bloc d'aplicació:
ExampLI:
Afegiu la vostra clau API al vostre projecte
Quan registreu la vostra aplicació d'Android amb Inici de sessió amb Amazon, se us assigna una clau API. Aquest és un identificador que el Gestor d'autoritzacions d'Amazon utilitzarà per identificar la vostra aplicació al servei d'autorització Inici de sessió amb Amazon. Si utilitzeu Amazon Appstore per signar la vostra aplicació, l'Appstore us proporcionarà la clau de l'API automàticament. Si no feu servir l'Amazon Appstore, el Gestor d'autoritzacions d'Amazon carrega aquest valor en temps d'execució des del api_key.txt file en el actius directori.
- Si encara no teniu la vostra clau API, seguiu les instruccions a Recupera la clau de l'API d'Android.
- Des del Projecte View a Android Studio, feu clic amb el botó dret a la carpeta de recursos i, a continuació, feu clic Nou i seleccioneu File. Si no teniu una carpeta d'actius, feu clic amb el botó dret al directori principal del vostre projecte i, a continuació, seleccioneu Nou, Carpeta, Carpeta d'actius.
- Anomena el file api_key.txt.
- Ara hauríeu de tenir una finestra d'editor per a un text file nomenat txt. Afegiu la vostra clau API al text file.
- En el File menú, feu clic Desa.
Nota: si un editor de text afegeix caràcters addicionals al vostre api_key.txt file (com ara una marca d'ordre de bytes), és possible que vegeu ERROR_ACCESS_DENIED quan intenteu connectar-vos al servei d'autorització Inici de sessió amb Amazon. Si això passa, proveu d'eliminar els espais inicials o finals, els passos de línia o els caràcters sospitosos. (Per exampli, un editor que utilitza Byte Order Mark pot afegir 0xEF 0xBB 0xBF o altres seqüències hexadecimals a l'inici del vostre api_key.txt file). També podeu provar de recuperar una clau d'API nova.
Gestioneu els canvis de configuració de la vostra activitat
Si un usuari canvia l'orientació de la pantalla o canvia l'estat del teclat del dispositiu mentre inicia sessió, es demanarà que es reiniciï l'activitat actual. Aquest reinici descartarà la pantalla d'inici de sessió de manera inesperada. Per evitar-ho, hauríeu de configurar l'activitat que utilitza el mètode d'autorització per gestionar aquests canvis de configuració manualment. Això evitarà la reinici de l'activitat.
- In paquet Explorador, feu doble clic xml.
- En el Aplicació secció, localitzeu l'activitat que gestionarà l'inici de sessió amb Amazon (forexampel, Activitat principal),
- Afegiu l'atribut següent a l'activitat que heu localitzat al pas 2:
android:configChanges="keyboard|keyboardHidden|orientació" O per a l'API 13 o superior:
android:configChanges="keyboard|keyboardHidden|orientation|screenSize" - Des del File menú, feu clic Desa
Ara, quan es produeix un canvi d'orientació del teclat o del dispositiu, Android trucarà al mètode onConfigurationChanged per a la vostra activitat. No cal que implementeu aquesta funció tret que hi hagi algun aspecte d'aquests canvis de configuració que vulgueu gestionar per a la vostra aplicació.
Afegiu una activitat de flux de treball al vostre projecte
Quan l'usuari faci clic al botó Inicia sessió amb Amazon, l'API s'iniciarà a web navegador per presentar una pàgina d'inici de sessió i consentiment a l'usuari. Perquè aquesta activitat del navegador funcioni, heu d'afegir la WorkflowActivity al vostre manifest.
Si prèviament us heu integrat amb l'SDK d'inici de sessió amb Amazon o teniu l'activitat com.amazon.identity.auth.device.authorization.AuthorizationActivity declarada al vostre AndroidManifest.xml, s'ha d'eliminar i substituir per WorkflowActivity.
- In paquet Explorador, feu doble clic AndroidMailfest.xml...
- En el Aplicació secció, afegiu el codi següent.
<activity android:name=
“com.amazon.identity.auth.device.workflow.WorkflowActivity” android:theme=”@android:style/Theme.NoDisplay” android:allowTaskReparenting=”true” android:launchMode=”singleTask”>
<action android:name=”android.intent.action.VIEW” />
<data
android:host=”${applicationId}” android:scheme=”amzn” />
Nota: Si no feu servir el sistema de compilació Gradle, substituïu ${applicationId} pel nom del vostre paquet per a aquesta aplicació.
Inicieu sessió amb Amazon ofereix diversos botons estàndard que podeu utilitzar per demanar als usuaris que iniciïn sessió des de la vostra aplicació. Aquesta secció ofereix els passos per descarregar una imatge oficial d'inici de sessió amb Amazon i vincular-la amb un ImageButton d'Android.
- Afegiu un ImageButton estàndard a la vostra aplicació.
Per obtenir més informació sobre els botons d'Android i la classe ImageButton, vegeu Botons a developer.android.com.
- Doneu al vostre botó un A la declaració XML del botó, establiu l'atribut android:id a @+id/login_with_amazon. Per exampLI:
android:id="@+id/login_with_amazon" - Trieu una imatge de botó.
Consulteu el nostre inici de sessió amb Amazon Pautes d’estil per obtenir una llista de botons que podeu utilitzar a la vostra aplicació.
Descarrega't una còpia del LWA_Android.zip file. Extraieu una còpia del vostre botó preferit per a cada densitat de pantalla que admet la vostra aplicació (xxhdpi, xhdpi, hdpi, mdpi o tvdpi). Per obtenir més informació sobre la compatibilitat amb múltiples densitats de pantalla a Android, vegeu Dissenys alternatius al tema "Suport de diverses pantalles" ondeveloper.android.com. - Copieu la imatge del botó corresponent files al teu projecte.
Per a cada densitat de pantalla que admeti (xhdpi, hdpi, mdpi o ldpi), copieu el botó descarregat al res/dibuixable directori per a aquesta densitat de pantalla. - Declara la imatge del botó.
Al botó Declaració XML, configureu el android:src atribueix al nom del botó que has triat. Per exampLI:android:src="@drawable/btnlwa_gold_loginwithamazon.png" - Carregueu la vostra aplicació i comproveu que el botó ara tingui una imatge d'inici de sessió amb Amazon.
Heu de verificar que el botó es mostra correctament per a cada densitat de pantalla que admeti
Utilitzeu l'SDK per a les API d'Android
En aquesta secció, afegirà codi al projecte per iniciar la sessió a un usuari amb Iniciar sessió amb Amazon.
En aquesta secció s'explica com trucar a l'API d'autorització per iniciar sessió a un usuari. Això inclou la creació d'un onClick oient per al vostre botó Inici de sessió amb Amazon al onCreate mètode de la vostra aplicació.
- Afegiu Inici de sessió amb Amazon al vostre Android See Instal·leu l'inici de sessió amb la biblioteca d'Amazon.
- Inicialitzar RequestContext.
Haureu de declarar a RequestContext variable i creeu una nova instància de la classe. El millor lloc per inicialitzar RequestContext està a la onCreate mètode de la vostra activitat o fragment d'Android. Per exampLI:Private RequestContext requestContext;
@Anul·lació
protegit void onCreate(Bundle savedInstanceState) { super.onCreate (savedInstanceState); requestContext = RequestContext.create(this);
} - Crea un AuthorizeListener.
AuthorizeListener processarà el resultat de la autoritzar la trucada. Conté tres mètodes: onSuccess, onError, i onCancel. Crea el AuthorizeListener interfície en línia amb a registreListener truca al onCreate mètode de la vostra activitat o fragment d'Android.@Anul·lació
protegit void onCreate(Bundle savedInstanceState) { super.onCreate (savedInstanceState); requestContext = RequestContext.create(this);requestContext.registerListener (nou AuthorizeListener () {
/* L'autorització s'ha completat correctament. */
@Anul·lació
public void onSuccess (resultat d'autorització del resultat) {
/* La teva aplicació ara està autoritzada per als àmbits sol·licitats */
}
/* S'ha produït un error durant l'intent d'autoritzar l'aplicació. */
@Anul·lació
public void onError(AuthError ae) {
/* Informar a l'usuari de l'error */
}
/* L'autorització s'ha cancel·lat abans que es pogués completar. */ @Anul·lació
public void onCancel (cancel·lació d'AuthCancellation) {
/* Restableix la interfície d'usuari a un estat llest per iniciar sessió */
}
});
}Nota: Si utilitzeu un fragment i captureu referències a View objectes al teu AuthorizeListener implementació, crear AuthorizeListener en el onCreateView mètode en lloc de onCreate. Això garanteix el View les referències d'objectes s'estableixen quan la trucada a autoritzar acaba.
- Implementar onSuccess, onError, i onCancel pel teu AuthorizeListener.
Perquè el procés d'autorització presenta una pantalla d'inici de sessió (i possiblement una pantalla de consentiment) a l'usuari en a web navegador (o a WebView), l'usuari tindrà l'oportunitat de cancel·lar la sessió o navegar fora. Si cancel·len explícitament el procés d'inici de sessió, onCancel es crida i voldreu restablir la vostra interfície d'usuari.
Si l'usuari s'allunya de la pantalla d'inici de sessió al navegador o WebView, després torna a la vostra aplicació, l'SDK no detectarà que l'inici de sessió no s'ha completat. Si detecteu activitat de l'usuari a la vostra aplicació abans que s'hagi completat l'inici de sessió, podeu suposar que han sortit del navegador i reaccionar en conseqüència. - Truca RequestContext.onResume.
Per tal d'acomodar el cicle de vida de l'aplicació Android, implementeu el al currículum mètode en la vostra activitat o fragment. Això activarà tots els oients registrats registreListener en el cas que el sistema operatiu tanqui la vostra aplicació abans que l'usuari completi un flux d'autorització.@Anul·lació
buit protegit a Resume () {
super.onResume ();
requestContext.onResume();
} - Truca AuthorizationManager.authorize.
En el onClick gestor del vostre botó Inici de sessió amb Amazon, truqueu a autorització per demanar a l'usuari que iniciï sessió i autoritzi la vostra aplicació.
Aquest mètode permetrà a l'usuari iniciar la sessió i consentir la informació sol·licitada d'una de les maneres següents:
1. Canvia al navegador del sistema
2. Canvia a WebView en un context segur (si l'aplicació Amazon Shopping està instal·lada al dispositiu)
El context segur per a la segona opció està disponible quan l'aplicació Amazon Shopping s'instal·la al dispositiu. Dispositius creats per Amazon amb Fire OS (per exemple,ampKindle Fire, Fire Phone i Fire TV) sempre utilitza aquesta opció encara que no hi hagi cap aplicació Amazon Shopping al dispositiu. Per això, si l'usuari ja ha iniciat la sessió a l'aplicació Amazon Shopping, aquesta API ometrà la pàgina d'inici de sessió, generant un Inici de sessió únic experiència per a l'usuari. Consulteu l'experiència del client a experiència-client-android aplicacions per aprendre més. Quan la vostra aplicació està autoritzada, s'autoritza per a un o més conjunts de dades coneguts com a àmbits. Un abast inclou les dades d'usuari que demaneu a Inici de sessió amb Amazon. La primera vegada que un usuari iniciï sessió a la vostra aplicació, se li presentarà una llista de les dades que esteu sol·licitant i se li demanarà l'aprovació. Actualment, l'inici de sessió amb Amazon admet els àmbits següents:Nom de l’abast Descripció profile Dóna accés al nom de l’usuari, a l’adreça de correu electrònic i a l’identificador del compte d’Amazon. profile:ID d'usuari Ofereix accés només a l’identificador del compte d’Amazon de l’usuari. codi_postal Permet l'accés al codi postal / postal de l'usuari activat file pel seu compte d'Amazon. AuthorizationManager.authorize és una trucada asíncrona, de manera que no heu de bloquejar el fil de la interfície d'usuari ni crear un fil de treball propi. Per trucar a autoritzar, passa un AuthorizeRequest objecte que es pot construir utilitzant AuthorizeRequest.Builder:
@Anul·lació
protegit void onCreate(Bundle savedInstanceState) { super.onCreate (savedInstanceState);
/* S'han omès les declaracions anteriors de Crear */// Trobeu el botó amb l'identificador login_with_amazon
// i configureu un gestor de clics
View loginButton = trobarViewById(R.id.login_with_amazon); loginButton.setOnClickListener (nou View.OnClickListener() {
@Anul·lació
public void onClick(View v) { AuthorizationManager.authorize(new AuthorizeRequest
Builder(requestContext).addScopes(ProfileScope.profile(), ProfileScope.postalCode())
.build());
});
}
Obteniu User Profile Dades
Aquesta secció explica com utilitzar l'API d'usuari per recuperar el professional d'un usuarifile dades després d'haver estat autoritzats. El profile les dades que podeu recuperar es basen en l'abast indicat a la carpeta autoritzar:withHandler: truca.
- Truca Obtenció.usuari.
Obtenció.usuari retorna el pro de l'usuarifile dades a vostè a través de l'Oient AuthError> devolució de trucada. Oient AuthError> conté dos mètodes: a l'èxit i onError (no admet onCancel perquè no hi ha manera de cancel·lar a Obtenció.usuari anomenada). a l'èxit rep un objecte d'usuari amb profile dades, mentre onError rep un AuthError objecte amb informació sobre l’error. updateProfileDades és un exampfitxer d'una funció que la vostra aplicació podria implementar per mostrar profile dades a la interfície d'usuari
Nota: User.getUserPostalCode només es retorna si sol·liciteu el ProfileScope.postalCode() abast.
Cerqueu l’inici de sessió d’usuari a l’inici
Si un usuari inicia la sessió a la vostra aplicació, la tanca i la reinicia més tard, l'aplicació encara està autoritzada a recuperar dades. L'usuari no ha tancat la sessió automàticament. En iniciar, podeu mostrar a l’usuari com ha iniciat la sessió si la vostra aplicació encara està autoritzada. En aquesta secció s'explica com s'utilitza getToken per veure si l'aplicació encara està autoritzada.
- Truca getToken.
En el onStart mètode de la vostra activitat o fragment, truqueu getToken per veure si l'aplicació encara està autoritzada. getToken recupera el testimoni d'accés en brut que el Gestor d'autoritzacions utilitza per accedir a un usuari professionalfile. Si el valor del testimoni no és nul, l'aplicació encara està autoritzada i podeu procedir a buscar l'usuari profile dades. getToken requereix els mateixos àmbits que vau demanar a la vostra convocatòria per autoritzar.
suport de getToken trucades asíncrones de la mateixa manera que User.fetch, de manera que no heu de bloquejar el fil de la interfície d'usuari ni crear un fil de treball propi. Trucar getToken de manera asíncrona, passa un objecte que admeti el Oient interfície com a darrer paràmetre. - Declarar a Oient AuthError>. La vostra implementació del Oient La interfície AuthError> processa el resultat del fitxer getToken anomenada. Listener conté dos mètodes: a l'èxit i onError (no admet onCancel perquè no hi ha manera de cancel·lar a getToken anomenada).
- Implementar a l'èxit i onError per al vostre Oient . a l'èxit rep un AuthorizeResult objecte amb un testimoni d'accés, while onError rep un AuthError objecte amb informació sobre l’error.
@Anul·lació
protegit void onStart(){ super.onStart();
Àmbit[] àmbits = { ProfileScope.profile(), ProfileScope.postalCode() }; AuthorizationManager.getToken(això, àmbits, nou
Oient () {@Anul·lació
public void onSuccess(AuthorizeResult resultat) { if (result.getAccessToken() != null) {
/* L'usuari ha iniciat sessió */
} altrament {
/* L'usuari no ha iniciat sessió */
}
}
@Anul·lació
public void onError(AuthError ae) {
/* L'usuari no ha iniciat sessió */
}
});
}
En aquesta secció s'explica com utilitzar el mètode de tancament de sessió per tancar la sessió de l'usuari de la vostra aplicació. L'usuari haurà d'iniciar sessió de nou per tal que l'aplicació recuperi profile dades. Utilitzeu aquest mètode per tancar la sessió d’un usuari o per solucionar problemes d’inici de sessió a l’aplicació.
- Implementar un mecanisme de tancament de sessió.
Quan un usuari hagi iniciat la sessió amb èxit, haureu de proporcionar un mecanisme de tancament de sessió per poder esborrar el seu professionalfile dades i àmbits autoritzats prèviament. El vostre mecanisme pot ser un hiperenllaç, un botó o un element de menú. Per aquest example, crearem un onClickmethod per un botó. - Truca tanca sessió.
Truca tanca sessió al vostre controlador de tancament de sessió per eliminar les dades d'autorització d'un usuari (fitxers d'accés, profile) de la botiga local. tanca sessió pren un context Android i un listener AuthError> a manejar l'èxit o el fracàs. - Declarar un oient anònim AuthError>.
La vostra implementació de Listener AuthError> processa el resultat de la tanca sessió anomenada. Les classes anònimes són útils per capturar variables de l'àmbit adjunt.
Mireu Gestioneu el botó d'inici de sessió i autoritzeu l'usuari per un exampdeixa que declara classes d'oient. - Implementar a l'èxit i onError per al teu oient AuthError>.
Quan signar té èxit hauríeu d'actualitzar la vostra interfície d'usuari per eliminar les referències a l'usuari i proporcionar un mecanisme d'inici de sessió que els usuaris puguin utilitzar per tornar a iniciar sessió. Si signar Sortides un error, podeu deixar que l'usuari torni a provar de tancar la sessió.@Anul·lació
protegit void onCreate(Bundle savedInstanceState) { super.onCreate (savedInstanceState);
/* S'han omès les declaracions anteriors de Crear */// Trobeu el botó amb l'ID de tancament de sessió i configureu un gestor de clics View logoutButton = trobarViewById(R.id.logout); logoutButton.setOnClickListener (nou View.OnClickListener() {@Anul·lació
public void onClick(View v) { AuthorizationManager.signOut(getApplicationContext(), nou
Oient () { @Override
public void onSuccess (resposta nul·la) {
// Estableix l'estat de tancament de la sessió a la IU
}
@Anul·lació
public void onError(AuthError authError) {
// Registra l'error
}});
}
});
}
Inicieu sessió amb la Guia d'iniciació d'Amazon per a aplicacions d'Android: Baixa [optimitzat]
Inicieu sessió amb la Guia d'iniciació d'Amazon per a aplicacions d'Android: Descarregar
