Conectați-vă cu Ghidul introductiv Amazon pentru aplicațiile Android

Conectați-vă cu Amazon: Ghid introductiv pentru Android

Copyright © 2017 Amazon.com, Inc. sau afiliații săi. Toate drepturile rezervate.

Amazon și sigla Amazon sunt mărci comerciale ale Amazon.com, Inc. sau ale afiliaților săi. Toate celelalte mărci comerciale care nu sunt deținute de Amazon sunt proprietatea proprietarilor respectivi.

Instalați Instrumentele pentru dezvoltatori Android

Login with Amazon SDK pentru Android vă va ajuta să adăugați Login with Amazon la aplicațiile dvs. Android, Fire TV și Fire Tablet. Vă recomandăm să utilizați Login with Amazon SDK pentru Android cu Android Studio. Pentru pașii despre cum să instalați Android Studio și despre configurarea SDK-ului Android, consultați Obțineți setul SDK pentru Android pe developer.android.com.

Pentru a utiliza Login with Amazon SDK pentru Android, aplicația dvs. Android trebuie să îndeplinească una dintre aceste cerințe minime:

• Versiunea SDK minimă (minSdkVersion) Android 0 (API Nivel 11) sau o versiune ulterioară.
• Versiunea SDK minimă (minSdkVersion) de Android 2.2 (API Level 8) sau o versiune ulterioară cu v4 Suport Android Bibliotecă.

Când este instalat SDK-ul Android, găsiți fișierul Manager SDK aplicația din instalația dvs. Android. Pentru a dezvolta pentru Login with Amazon, trebuie să utilizați SDK Manager pentru a instala cerințele minime SDK de mai sus. Vedea Adăugarea pachetelor SDK pe developer.android.com pentru mai multe informații despre utilizarea Managerului SDK.

După instalarea SDK-ului, configurați un dispozitiv virtual Android (AVD) pentru a vă rula aplicațiile. Vedea Gestionarea Dispozitive virtuale pe developer.android.com pentru instrucțiuni despre configurarea unui dispozitiv virtual.

Când mediul dvs. de dezvoltare este configurat, puteți Instalați autentificarea cu Amazon SDK pentru Android or Rulați Sample App, așa cum este descris mai jos

Instalați autentificarea cu Amazon SDK pentru Android

Conectarea cu Amazon SDK pentru Android vine în două pachete. Primul conține biblioteca Android și documentația de susținere. Al doilea conține caampaplicație care permite unui utilizator să se autentifice și își afișează profile date.

Dacă nu ați instalat deja SDK-ul Android sau Instrumentele de dezvoltare Android, consultați Instalare Instrumentele pentru dezvoltatori Android secțiunea de mai sus.

1. Descărcați fermoar și extrageți files într-un director de pe hard disk. Ar trebui să vezi a docs si a lib subdirectorul.
2. Deschide docs/index.html la view Referința Conectare cu Amazon Android API.
3. Vedea Instalați autentificarea cu biblioteca Amazon pentru instrucțiuni despre cum să adăugați biblioteca și documentația la un Android

Când este instalat Conectarea cu Amazon SDK pentru Android, puteți Creați o nouă autentificare cu Amazon Proiect După dumneavoastră Înregistrați-vă cu Autentificare cu Amazon.

Rulați Sample App

Pentru a rula sampaplicația, importați sampîntr-un spațiu de lucru AndroidStudio.

1. Descărcați SampleLoginWithAmazonAppForAndroid-src.zip și extrageți files la un director de pe hard
2. Porniți Android Studio și selectați Deschideți un proiect Android Studio existent.
3. Navigați la SampleLoginWithAmazonApp director obținut după extragerea zip-ului descărcat file în pasul 1.
4. De la Construi meniu, faceți clic Faceți proiectși așteptați ca proiectul să se termine construcția.
5. De la Fugi meniu, faceți clic Fugi și apoi faceți clic pe SampleLoginWithAmazonApp.
6. Selectați emulatorul sau dispozitivul Android conectat și faceți clic pe Fugi.

Înregistrați-vă cu Conectare cu Amazon

Înainte de a putea utiliza Conectarea cu Amazon pe un webpe site sau într-o aplicație mobilă, trebuie să înregistrați o aplicație cu Login with Amazon. Aplicația dvs. Conectare cu Amazon este înregistrarea care conține informații de bază despre afacerea dvs. și informații despre fiecare website-ul sau aplicația mobilă pe care o creați și care acceptă Conectarea cu Amazon. Aceste informații comerciale sunt afișate utilizatorilor de fiecare dată când folosesc Login with Amazon pe dvs website sau aplicație mobilă. Utilizatorii vor vedea numele aplicației dvs., sigla dvs. și un link către politica dvs. de confidențialitate. Acești pași demonstrează cum să vă înregistrați aplicația Android pentru utilizare cu Conectare cu Amazon.

Înregistrați-vă autentificarea cu aplicația Amazon

1. Du-te la https://login.amazon.com.
2. Dacă v-ați înscris la Login cu Amazon înainte, faceți clic pe Consola de aplicații. În caz contrar, dați clic Înscrieți-vă. Veți fi redirecționat către Seller Central, care gestionează înregistrarea aplicației pentru Conectare. Dacă este prima dată când utilizați Seller Central, vi se va solicita să configurați un cont Seller Central.
3. Clic Înregistrați aplicația nouă. The Înregistrați-vă aplicația formularul va apărea:
   a. În Înregistrați-vă aplicația formular, introduceți un Nume si a Descriere pentru aplicația dvs.
   The Nume este numele afișat pe ecranul de consimțământ atunci când utilizatorii sunt de acord să partajeze informații cu aplicația dvs. Acest nume se aplică pentru Android, iOS și webversiuni de site ale aplicației dvs. The Descriere vă ajută să diferențiați fiecare dintre aplicațiile dvs. de conectare cu Amazon și nu este afișat utilizatorilor.
   b. Introduceți a Notificare de confidențialitate URL pentru aplicația dvs.
   The Notificare de confidențialitate URL este locația politicii de confidențialitate a companiei sau a aplicației dvs. (de example, http://www.example.com/privacy.html). Acest link este afișat utilizatorilor pe ecranul de consimțământ.
   c. Dacă doriți să adăugați un Imagine de siglă pentru aplicația dvs., faceți clic Răsfoiește și localizați imaginea aplicabilă.
4. Clic Salva. s. dvsampÎnregistrarea fișierului ar trebui să arate similar cu acesta:
   
   După ce setările de bază ale aplicației sunt salvate, puteți adăuga setări pentru anumite website-urile și aplicațiile mobile care vor utiliza această autentificare cu contul Amazon.

Adăugați Setări Android la aplicația dvs

Pentru a înregistra o aplicație Android, aveți posibilitatea de a înregistra o aplicație prin Amazon Appstore (Adăugați o aplicație Android pentru Amazon Appstore) sau direct cu Autentificare cu Amazon (Adăugați un Android App fără Appstore). Când aplicația dvs. este înregistrată, veți avea acces la o cheie API care va acorda aplicației dvs. acces la serviciul de autorizare Conectare cu Amazon.

Nota: Dacă intenționați să utilizați mesageria dispozitivului Amazon în aplicația dvs. Android, vă rugăm să contactați lwa-support@amazon.com cu:

• Adresa de e-mail a contului Amazon cu care ați folosit pentru a vă înscrie pentru autentificare
• Adresa de e-mail a contului Amazon pe care l-ați utilizat pentru a vă înscrie la Amazon Appstore (dacă este diferit).
• Numele din contul dvs. Seller Central (în Seller Central, faceți clic pe Setări> Informații despre cont> Informații despre vânzător, și folosiți Numele de afișare).
• Numele de pe contul dvs. de dezvoltator Amazon Appstore (în site-ul Mobile App Distribution, faceți clic pe Setări > Company Profile și folosiți Numele dezvoltatorului sau numele companiei).

Adăugați o aplicație Android pentru Amazon Appstore

Următorii pași vor adăuga o aplicație Amazon Appstore la contul dvs. de autentificare cu Amazon:

1. Din ecranul Aplicație, faceți clic Setări Android. Dacă aveți deja o aplicație Android înregistrată, căutați Adăugați o cheie API butonul din Setări Android selecţie
   The Detalii despre aplicația Android formularul va apărea:
2. Selecta Da ca răspuns la întrebarea „Această aplicație este distribuită prin Amazon Appstore?”
3. Introduceți Eticheta din aplicația dvs. Android. Acesta nu trebuie să fie numele oficial al aplicației dvs. Pur și simplu identifică această aplicație specială Android printre aplicații și website-uri înregistrate la Login-ul dvs. cu Amazon
4. Adăugați-vă ID-ul Amazon Appstore.
5. Dacă v-ați autosemnat aplicația, adăugați informații despre autosemnare. Acest lucru vă va permite să obțineți o cheie API în timpul dezvoltării fără a utiliza direct Appstore.
   a. Dacă aplicația dvs. nu este semnată prin Amazon Appstore, selectați Da ca răspuns la întrebarea „Este această aplicație autosemnată?”
   The Detalii despre aplicația Android forma se va extinde
   
   b. Introduceți dvs Numele pachetului.
   Acesta trebuie să se potrivească cu numele pachetului proiectului dvs. Android. Pentru a determina numele pachetului proiectului dvs. Android, deschideți proiectul în instrumentul pentru dezvoltatori Android ales de dvs. Deschis
   AndroidManifest.XML în Package Explorer și selectați Manifesta fila. Prima intrare este Pachet nume.
   c. Accesați aplicația Semnătura.
   Aceasta este o valoare hash SHA-256 utilizată pentru a vă verifica aplicația. Semnătura trebuie să aibă forma a 32 de perechi hexazecimale separate prin două puncte (de examppe: 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). Vedea Semnături de aplicații Android și chei API pentru pașii pe care îi puteți folosi pentru a extrage semnătura din proiect.
   6. Faceți clic Salva.

Adăugați o aplicație Android fără Appstore

Dacă doriți să vă înregistrați aplicația Android fără a utiliza Amazon Appstore, puteți utiliza următorii pași pentru a vă înregistra Numele și semnătura pachetului cu Conectarea la Amazon:

1. Din ecranul Aplicație, faceți clic Setări Android. Dacă aveți deja o aplicație Android înregistrată, căutați Adăugați o cheie API butonul din Setări Android The Detalii despre aplicația Android formularul va apărea:
   
2. Selecta Nu ca răspuns la întrebarea „Această aplicație este distribuită prin Amazon Appstore?”
3. Introduceți Eticheta de Android-ul tău
   Acesta nu trebuie să fie numele oficial al aplicației dvs. Pur și simplu identifică această aplicație Android anume printre aplicații și website-urile pe care le-ați înregistrat.
4. Introduceți dvs Numele pachetului. Acesta trebuie să se potrivească cu numele pachetului proiectului dvs. Android.
   Pentru a determina numele pachetului proiectului dvs. Android, deschideți proiectul în instrumentul pentru dezvoltatori Android ales de dvs. Deschis AndroidManifest.XML în Package Explorer și selectați Manifesta fila. Prima intrare este Pachet nume.
5. Accesați aplicația Semnătura.
   Aceasta este o valoare hash SHA-256 utilizată pentru a vă verifica aplicația. Semnătura trebuie să aibă forma a 32 de perechi hexazecimale separate prin două puncte (de examppe: 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). Vezi Semnături de aplicații Android și chei API secțiunea de mai jos pentru pașii pe care îi puteți utiliza pentru a extrage semnătura din proiectul dvs.
6. Clic Salva.

Dacă diferite versiuni ale aplicației dvs. au semnături sau nume de pachete diferite, cum ar fi pentru una sau mai multe versiuni de testare și o versiune de producție, fiecare versiune necesită propria sa cheie API. De la Setări Android din aplicația dvs., faceți clic pe Adăugați o cheie API butonul pentru a crea chei suplimentare pentru aplicația dvs. (una pentru fiecare versiune).

Semnături de aplicații Android și chei API

Semnătura aplicației este o valoare hash SHA-256 care se aplică fiecărei aplicații Android atunci când este construită. Amazon folosește semnătura aplicației pentru a vă construi cheia API. Cheia API permite serviciilor Amazon să vă recunoască aplicația. Dacă utilizați Amazon Appstore pentru a vă semna aplicația, cheia API este furnizată automat. Dacă nu utilizați Amazon Appstore, va trebui să vă gestionați manual cheia API.

Semnăturile aplicațiilor sunt stocate într-un depozit de chei. În general, pentru aplicațiile Android există un depozit de chei de depanare și un depozit de chei de lansare. Pentru a găsi locația depozitului de chei de depanare în Android Studio, deschideți Construi meniu, selectați Edita Tipuri de construcție, apoi mergeți la Semnare și localizați depozitul de chei de depanare în Magazin File domeniu.

Un magazin de chei de lansare este creat în mod normal atunci când exportați aplicația Android pentru a crea un APK semnat file. Prin procesul de export, dacă creați un nou depozit de chei, veți selecta locația acestuia. În mod implicit, acesta va fi plasat în aceeași locație cu KeyStore-ul implicit de depanare.

Dacă ați înregistrat aplicația utilizând semnătura de depanare în timpul dezvoltării, va trebui să adăugați o nouă setare Android la aplicația dvs. atunci când sunteți gata să lansați aplicația. Noua setare a aplicației trebuie să utilizeze semnătura din magazia de chei de lansare.

Vedea Semnarea cererilor dvs. pe developer.android.com pentru mai multe informații.

Determinați semnătura aplicației Android

1. Dacă aveți un APK semnat file:
   a. Dezarhivați fișierul APK file si extrage CERT.RSA. (Dacă este necesar, puteți redenumi extensia APK în ZIP).
   b. Din linia de comandă, executați:

   keytool -printcert -file CERT.RSA

   Instrumente cheie situat în coșul de gunoi directorul instalării dvs. Java.

2. Dacă aveți un magazin de chei file:
   a. Din linia de comandă, executați:

   keytool -list -v -alias -keystorefilenume>

   Instrument cheie este situat în coșul de gunoi directorul instalării dvs. Java. Aliasul este numele cheii folosite pentru a semna aplicația.
   b. Introduceți parola pentru tastă și apăsați Intră.
3. Sub Amprente digitale, copiați SHA256 valoare.

Obțineți cheia API Android

După ce ați înregistrat o setare Android și ați furnizat o semnătură a aplicației, puteți prelua cheia API din pagina de înregistrare pentru aplicația Conectare cu Amazon. Va trebui să plasați acea cheie API într-un fișier file în proiectul dvs. Android. Până nu faceți acest lucru, aplicația nu va fi autorizată să comunice cu serviciul de autorizare Conectare cu Amazon.

1. Du-te la https://login.amazon.com.
2. Clic Consola de aplicații.
3. În Aplicații selectați caseta din stânga
4. Găsiți aplicația dvs. Android sub Setări Android secțiunea (Dacă nu ați înregistrat încă o aplicație Android, consultați Adăugați o aplicație Android pentru Amazon Appstore).
5. Clic Generați valoarea cheii API. O fereastră pop-up va afișa API-ul dvs. Pentru a copia cheia, faceți clic Selectați Toate pentru a selecta întreaga tastă.
   Nota: Valoarea cheii API se bazează, parțial, pe timpul în care este generată. Astfel, valorile ulterioare ale cheii API pe care le generați pot diferi de cele originale. Puteți utiliza oricare dintre aceste valori cheie API în aplicația dvs., deoarece toate sunt valabile.
6. Vedea Adăugați cheia API la proiect pentru instrucțiuni despre adăugarea cheii API la Android

Creați o autentificare cu Amazon Project

În această secțiune, veți afla cum să creați un nou proiect Android pentru Conectare cu Amazon, configurați proiectul și adăugați cod la proiect pentru a vă conecta la un utilizator cu Conectare cu Amazon. Vom descrie pașii pentru Android Studio, dar puteți aplica pași analogi oricărui instrument de dezvoltare IDE sau Android la alegere.

Acest ghid necesită o înțelegere a Activități – un concept cheie al dezvoltării de aplicații Android. Află mai multe despre Activități şi Fragmente de activitate pe developer.android.com.

Creați o nouă autentificare cu Amazon Project

Dacă nu aveți încă un proiect de aplicație pentru utilizarea Conectării cu Amazon, urmați instrucțiunile de mai jos pentru a crea unul. Dacă aveți o aplicație existentă, treceți la Instalați autentificarea cu biblioteca Amazon.

1. Lansa Android
2. De la File meniu, selectați Nou şi Proiect.
3. Introduceți un Numele aplicației şi Numele companiei pentru dvs
4. Introduceți Aplicație şi Numele companiei corespunzător numelui pachetului pe care l-ați ales atunci când v-ați înregistrat aplicația cu Conectare la Amazon.
   Dacă nu v-ați înregistrat încă aplicația, alegeți o Numele pachetului și apoi urmați instrucțiunile din Înregistrare cu Conectare la Amazon secțiune după ce ați creat proiectul. Dacă numele pachetului aplicației dvs. nu se potrivește cu numele pachetului înregistrat, apelurile dvs. de conectare cu Amazon nu vor reuși.
5. Selectați a SDK minim necesar din API 11: Android 3.0 (Honeycomb) sau o versiune ulterioară și dați clic Următorul. Puteți utiliza alternativ a SDK minim necesar din API 8: Android 2.2 (Froyo) sau o versiune ulterioară când utilizați v4 Biblioteca de suport Android.
6. Selectați tipul de activitate pe care doriți să îl creați și faceți clic Următorul.
7. Completați detaliile relevante și faceți clic Termina.

Veți avea acum un nou proiect în spațiul dvs. de lucru pe care îl puteți utiliza pentru a apela Conectare cu Amazon.

Instalați autentificarea cu biblioteca Amazon

Dacă nu ați descărcat încă Conectarea cu Amazon SDK pentru Android, consultați Instalați autentificarea cu Amazon SDK pentru Android.

1. Folosind file sistem de pe computer, găsiți autentificare-cu-amazon-sdk.jar file în Login with Amazon SDK pentru Android. Copiați-l în clipboard.
2. Cu proiectul deschis în Android Studio, deschideți Proiect View.
3. Faceți clic dreapta pe directorul părinte pentru proiectul/aplicația dvs. din Proiect View și selectați Pastă.
4. Faceți clic dreapta autentificare-cu-amazon-sdk.jar în Proiect View și selectați Adăugați ca bibliotecă.

Setați permisiunile de rețea pentru aplicația dvs.

Pentru ca aplicația dvs. să poată utiliza Conectarea cu Amazon, aceasta trebuie să acceseze Internetul și să acceseze informațiile despre starea rețelei. Aplicația dvs. trebuie să afirme aceste permisiuni în manifestul dvs. Android, dacă nu este deja.

1. De la Proiect View, faceți dublu clic pe xml pentru a-l deschide.
2. Copiați liniile de cod afișate mai jos și lipiți-le în fișierul xml file, în afara blocului de aplicație:
   

   Examppe:
   

Adăugați cheia API la proiect

Când vă înregistrați aplicația Android cu Conectare cu Amazon, vi se atribuie o cheie API. Acesta este un identificator pe care Managerul de autorizare Amazon îl va utiliza pentru a identifica cererea dvs. la serviciul de autentificare Amazon cu Amazon. Dacă utilizați Amazon Appstore pentru a vă semna aplicația, Appstore va furniza automat cheia API. Dacă nu utilizați Amazon Appstore, Amazon Authorization Manager încarcă această valoare în timp de execuție din api_key.txt file în active director.

1. Dacă nu aveți încă cheia API, urmați instrucțiunile din Obțineți cheia API Android.
2. De la Proiect View în Android Studio, faceți clic dreapta pe dosarul cu materiale, apoi faceți clic Nou și selectați File. Dacă nu aveți un folder de active, faceți clic dreapta pe directorul părinte al proiectului dvs., apoi selectați Nou, Pliant, Dosarul cu active.
3. Numiți file api_key.txt.
4. Acum ar trebui să aveți o fereastră de editor pentru un text file numit TXT. Adăugați cheia API la text file.
5. În File meniu, faceți clic Salva.

Nota: Dacă un editor de text adaugă caractere suplimentare la api_key.txt file (cum ar fi un marcaj de comandă de octet), este posibil să vedeți ERROR_ACCESS_DENIED când încercați să vă conectați la serviciul de autorizare Conectare cu Amazon. Dacă se întâmplă acest lucru, încercați să eliminați orice spații de început sau de final, fluxuri de rând sau caractere suspecte. (De exampun editor care folosește Byte Order Mark ar putea adăuga 0xEF 0xBB 0xBF sau alte secvențe hexazecimale la începutul api_key.txt file). De asemenea, puteți încerca să preluați o nouă cheie API.

Gestionați modificările de configurare pentru activitatea dvs.

Dacă un utilizator modifică orientarea ecranului sau modifică starea tastaturii dispozitivului în timp ce se conectează, va solicita o repornire a activității curente. Această repornire va închide ecranul de conectare în mod neașteptat. Pentru a preveni acest lucru, ar trebui să setați activitatea care utilizează metoda de autorizare pentru a gestiona manual aceste modificări de configurare. Acest lucru va împiedica repornirea activității.

1. In Pachet Explorator, faceți dublu clic xml.
2. În Aplicație secțiunea, localizați activitatea care va gestiona Conectarea cu Amazon (forexample, Activitate principala),
3. Adăugați următorul atribut la activitatea pe care ați localizat-o la pasul 2:
   

   android: configChanges = ”keyboard | keyboardHidden | orientation”

   Sau pentru API 13 sau mai mare:

   android: configChanges = ”keyboard | keyboardHidden | orientation | screenSize”

4. De la File meniu, faceți clic Salva

Acum, când are loc o schimbare a orientării tastaturii sau a dispozitivului, Android va apela metoda onConfigurationChanged pentru activitatea dvs. Nu trebuie să implementați această funcție decât dacă există un aspect al acestor modificări de configurare pe care doriți să îl gestionați pentru aplicația dvs.

Adăugați o activitate de flux de lucru la proiectul dvs

Când utilizatorul face clic pe butonul Conectare cu Amazon, API-ul va lansa un web browser pentru a prezenta utilizatorului o pagină de conectare și consimțământ. Pentru ca această activitate din browser să funcționeze, trebuie să adăugați WorkflowActivity în manifest.

Dacă v-ați integrat anterior cu Login with Amazon SDK sau aveți activitatea com.amazon.identity.auth.device.authorization.AuthorizationActivity declarată în AndroidManifest.xml, aceasta trebuie eliminată și înlocuită cu WorkflowActivity.

1. In Pachet Explorator, faceți dublu clic AndroidMailfest.xml..
2. În Aplicație secțiunea, adăugați următorul cod.
   

   <activitate android:nume= „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” /> <date android:host=”${applicationId}” android:scheme=”amzn” />

   Nota: Dacă nu utilizați sistemul de compilare Gradle, înlocuiți ${applicationId} cu numele pachetului pentru această aplicație.

Adăugați o autentificare cu butonul Amazon în aplicația dvs.

Conectarea cu Amazon oferă mai multe butoane standard pe care le puteți folosi pentru a solicita utilizatorilor să se autentifice din aplicația dvs. Această secțiune oferă pași pentru descărcarea unei imagini oficiale de conectare cu Amazon și asocierea acesteia cu un Android ImageButton.

1. Adăugați un ImageButton standard aplicației dvs.
   Pentru mai multe informații despre butoanele Android și clasa ImageButton, consultați Butoane pe developer.android.com.

2. Oferiți butonului dvs. În declarația XML butonului, setați atributul android:id la @+id/login_with_amazon. De examppe:
   

   android: id = ”@ + id / login_with_amazon”

3. Alegeți o imagine de buton.
   Consultați Conectarea noastră cu Amazon Îndrumări de stil pentru o listă de butoane pe care le puteți folosi în aplicația dvs.
   Descărcați o copie a fișierului LWA_Android.zip file. Extrageți o copie a butonului preferat pentru fiecare densitate de ecran pe care o acceptă aplicația dvs. (xxhdpi, xhdpi, hdpi, mdpi sau tvdpi). Pentru mai multe informații despre acceptarea mai multor densități de ecran în Android, consultați Aspecte alternative în subiectul „Suport pentru mai multe ecrane” ondeveloper.android.com.
4. Copiați imaginea corespunzătoare butonului files la proiectul tău.
   Pentru fiecare densitate de ecran pe care o acceptați (xhdpi, hdpi, mdpi sau ldpi), copiați butonul descărcat în res / desenabil director pentru densitatea ecranului respectiv.
5. Declarați imaginea butonului.
   În butonul Declarație XML, setați android:src atribuiți numelui butonului pe care l-ați ales. De examppe:

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

6.  Încărcați aplicația și verificați dacă butonul are acum o imagine Conectare cu Amazon.
   Ar trebui să verificați dacă butonul se afișează corect pentru fiecare densitate de ecran pe care o acceptați

Utilizați SDK-ul pentru API-urile Android

În această secțiune, veți adăuga cod la proiectul dvs. pentru a vă conecta la un utilizator cu Conectare cu Amazon.

Gestionați butonul de autentificare și autorizați utilizatorul

Această secțiune explică cum să apelați API-ul de autorizare pentru a vă conecta un utilizator. Aceasta include crearea unui onClick ascultător pentru butonul Conectare cu Amazon din onCreate metoda aplicației dvs.

1. Adăugați Conectare cu Amazon pe Android See Instalați autentificarea cu biblioteca Amazon.
2. Inițializați RequestContext.
   Va trebui să declarați a RequestContext variabilă și creați o nouă instanță a clasei. Cel mai bun loc pentru inițializare RequestContext este în onCreate metoda activității sau fragmentului dvs. Android. De examppe:

   private RequestContext requestContext; @Trece peste protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); requestContext = RequestContext.create(this); }

3. Creați un AuthorizeListener.
   AuthorizeListener va procesa rezultatul autorizecall. Conține trei metode: onSuccess, onError, şi onCancel. Creați AuthorizeListener interfață în linie cu a registerListener apel în onCreate metoda activității sau fragmentului dvs. Android.

   @Trece peste protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); requestContext = RequestContext.create(this);requestContext.registerListener(nou AuthorizeListener() { / * Autorizarea a fost finalizată cu succes. * / @Trece peste public void onSuccess(AuthorizeResult result) { /* Aplicația dvs. este acum autorizată pentru domeniile solicitate */ } /* A apărut o eroare în timpul încercării de a autoriza aplicația. */ @Trece peste public void onError (AuthError ae) { / * Informați utilizatorul despre eroare * / } /* Autorizarea a fost anulată înainte de a putea fi finalizată. */ @Trece peste public void onCancel(Anulare Anulare Auth) { /* Resetați interfața de utilizare la o stare gata de conectare */ } }); }

   Nota: Dacă utilizați un fragment și capturați referințe la View obiecte din dvs AuthorizeListener implementare, creare AuthorizeListener în onCreateView metoda in loc de onCreate. Aceasta asigură că View referințele la obiect sunt setate atunci când apelul la autorizetermină.

4. Implementează onSuccess, onError, şi onCancel pentru dvs AuthorizeListener.
   Deoarece procesul de autorizare prezintă utilizatorului un ecran de autentificare (și, eventual, un ecran de consimțământ) web browser (sau un WebView), utilizatorul va avea posibilitatea de a anula autentificarea sau de a naviga. Dacă anulează în mod explicit procesul de conectare, onCancel este apelat și veți dori să vă resetați interfața de utilizator.
   Dacă utilizatorul navighează departe de ecranul de conectare din browser sau WebView, apoi trece înapoi la aplicația dvs., SDK-ul nu va detecta că autentificarea nu a fost finalizată. Dacă detectați activitatea utilizatorului în aplicația dvs. înainte de finalizarea conectării, puteți presupune că au navigat în afara browserului și reacționează în consecință.
5. Apel RequestContext.onResume.
   Pentru a adapta ciclul de viață al aplicației Android, implementați onResume metoda în activitatea sau fragmentul dvs. Acest lucru va declanșa toți ascultătorii înregistrați registerListener în cazul în care aplicația dvs. este închisă de sistemul de operare înainte ca utilizatorul să finalizeze un flux de autorizare.

   @Trece peste void protejat onResume () { super.onResume (); requestContext.onResume(); }

6. Apel AuthorizationManager.authorize.
   În onClick handler pentru butonul Conectare cu Amazon, apelați la autorizare pentru a solicita utilizatorului să se autentifice și să vă autorizeze aplicația.
   Această metodă va permite utilizatorului să se conecteze și să consimtă la informațiile solicitate într-unul din următoarele moduri:
   1. Comută la browserul de sistem
   2. Comută la WebView într-un context sigur (dacă aplicația Amazon Shopping este instalată pe dispozitiv)
   Contextul securizat pentru a doua opțiune este disponibil atunci când aplicația Amazon Shopping este instalată pe dispozitiv. Dispozitivele create de Amazon care rulează Fire OS (de exampKindle Fire, Fire Phone și Fire TV) folosesc întotdeauna această opțiune chiar dacă nu există nicio aplicație Amazon Shopping pe dispozitiv. Din acest motiv, dacă utilizatorul este deja conectat la aplicația Amazon Shopping, acest API va omite pagina de conectare, ceea ce va duce la o Conectare unică experiență pentru utilizator. Vedeți Experiența clienților în experiența-client-android aplicații pentru a afla mai multe. Când aplicația dvs. este autorizată, aceasta este autorizată pentru unul sau mai multe seturi de date cunoscute ca ambalaje. Un domeniu cuprinde datele utilizatorului pe care le solicitați de la Login with Amazon. Prima dată când un utilizator se conectează la aplicația dvs., i se va prezenta o listă cu datele pe care le solicitați și i se va cere aprobarea. Conectarea cu Amazon acceptă în prezent următoarele domenii:

   Numele domeniului	Descriere
   profile	Oferă acces la numele utilizatorului, adresa de e-mail și ID-ul contului Amazon.
   profile:numele de utilizator	Oferă acces numai la ID-ul contului Amazon al utilizatorului.
   Cod poștal	Oferă acces la codul poștal/poștal al utilizatorului file pentru contul lor Amazon.

   AuthorizationManager.authorize este un apel asincron, deci nu trebuie să blocați firul UI sau să creați un fir de lucru al dvs. Pentru a apela autorizați, treceți un AuthorizeRequest obiect care poate fi construit folosind AuthorizeRequest.Builder:
   

   @Trece peste protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); / * Anterior pe Creare declarații omise * /// Găsiți butonul cu ID-ul login_with_amazon // și configurați un handler pentru clicuri View loginButton = găsițiViewById(R.id.login_with_amazon); loginButton.setOnClickListener (nou View.OnClickListener() { @Trece peste public void onClick (View v) { AuthorizationManager.authorize(nouă AuthorizeRequest Builder(requestContext).addScopes(ProfileScope.profile(), ProfileScope.postalCode()) .construi()); }); }

Preluare utilizator Profile Date

Această secțiune explică cum să utilizați API-ul utilizator pentru a recupera un profesionist al utilizatoruluifile date după ce au fost autorizate. Profile datele pe care le puteți prelua se bazează pe domeniul de aplicare indicat în autorizare:cuHandler: apel.

1. Apel Utilizator.preluare.
   Utilizator.preluare returnează pro-ul utilizatoruluifile date către dvs. prin Ascultător AuthError> sună din nou. Ascultător AuthError> conține două metode: onSucces şi onError (nu acceptă onCancel deoarece nu există nicio modalitate de a anula un Utilizator.preluare apel). onSucces primește un obiect User cu profile date, în timp ce onError primește un AuthError obiect cu informații despre eroare. updateProfileDate este un exampfișierul unei funcții pe care aplicația dvs. ar putea implementa pentru a afișa profile date în interfața cu utilizatorul
   Nota: User.getUserPostalCode este returnat numai dacă solicitați ProfileScope.postalCode() domeniul de aplicare.

Căutați autentificarea utilizatorului la pornire

Dacă un utilizator se conectează la aplicația dvs., închide aplicația și repornește aplicația ulterior, aplicația este în continuare autorizată să preia date. Utilizatorul nu este deconectat automat. La pornire, puteți afișa utilizatorul ca fiind conectat dacă aplicația dvs. este încă autorizată. Această secțiune explică modul de utilizare getToken pentru a vedea dacă aplicația este încă autorizată.

1. Apel getToken.
   În onStart metoda activității dvs. sau fragment, sunați getToken pentru a vedea dacă aplicația este încă autorizată. getToken preia jetonul de acces brut pe care AuthorizationManager folosește pentru a accesa un utilizator profile. Dacă valoarea simbolului nu este nulă, atunci aplicația este încă autorizată și puteți continua să preluați utilizatorul profile date. getToken necesită aceleași domenii pe care le-ați solicitat în apelul dvs. de autorizare.
   getTokensupports apeluri asincrone în același mod ca User.fetch, astfel încât nu trebuie să blocați firul UI sau să creați un fir de lucru propriu. A apela getToken asincron, treceți un obiect care acceptă Ascultător interfață ca ultim parametru.
2. Declara a Ascultător AuthError>. Implementarea dvs. a Ascultător Interfața AuthError> procesează rezultatul getToken apel. Ascultătorul conține două metode: onSucces şi onError (nu acceptă onCancel deoarece nu există nicio modalitate de a anula un getToken apel).
3. Implementează onSucces și onError pentru dvs Ascultător . onSuccess primește un AuthorizeResult obiect cu un jeton de acces, while onError primește un AuthError obiect cu informații despre eroare.
   

   @Trece peste void protejat onStart(){ super.onStart(); Scope[] scopes = { ProfileScope.profile(), ProfileScope.postalCode() }; AuthorizationManager.getToken(aceasta, domenii, nou Ascultător () {@Trece peste public void onSuccess(AuthorizeResult result) { if (result.getAccessToken() != null) { /* Utilizatorul este conectat */ } altfel { /* Utilizatorul nu este conectat */ } } @Trece peste public void onError (AuthError ae) { /* Utilizatorul nu este conectat */ } }); }

Ștergeți datele de autorizare și deconectați un utilizator

Această secțiune explică cum să utilizați metoda de deconectare pentru a deconecta utilizatorul din aplicația dvs. Utilizatorul va trebui să se autentifice din nou pentru ca aplicația să recupereze profile date. Utilizați această metodă pentru a deconecta un utilizator sau pentru a depana problemele de conectare în aplicație.

1. Implementați un mecanism de deconectare.
   Când un utilizator s-a conectat cu succes, ar trebui să furnizați un mecanism de deconectare pentru a-și putea șterge profesioniștiifile date și domenii autorizate anterior. Mecanismul dvs. poate fi un hyperlink, un buton sau un element de meniu. Pentru acest example, vom crea o onClickmethod pentru un buton.
2. Apel sign out.
   Apel sign out în gestionarea de deconectare pentru a elimina datele de autorizare ale unui utilizator (jetoane de acces, profile) din magazinul local. sign out ia un context Android și un ascultător AuthError>la gestionați succesul sau eșecul.
3. Declarați un ascultător anonim AuthError>.
   Implementarea dvs. de Listener AuthError> prelucrează rezultatul sign out apel. Clasele anonime sunt utile pentru captarea variabilelor din domeniul de aplicare.
   Vedea Gestionați butonul de autentificare și autorizați utilizatorul pentru o examplasa asta declară clasele ascultătorului.
4. Implementează onSucces şi onError pentru ascultătorul tău AuthError>.
   Când semnReușește ar trebui să vă actualizați interfața de utilizare pentru a elimina referințele la utilizator și să furnizați un mecanism de conectare pe care utilizatorii îl pot utiliza pentru a se autentifica din nou. Dacă semnul Ieșiri o eroare, puteți permite utilizatorului să încerce să se deconecteze din nou.

   @Trece peste protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); / * Anterior pe Creare declarații omise * /// Găsiți butonul cu ID-ul de deconectare și configurați un handler pentru clicuri View logoutButton = găsițiViewById(R.id.logout); logoutButton.setOnClickListener (nou View.OnClickListener() {@Trece peste public void onClick (View v) { AuthorizationManager.signOut(getApplicationContext(), nou Ascultător () { @Trece peste public void onSuccess(Răspuns nul) { // Setați starea deconectată în interfața de utilizare } @Trece peste public void onError (AuthError authError) { // Înregistrați eroarea } }); } }); }

Conectați-vă cu Ghidul de început Amazon pentru aplicațiile Android – Descărcați [optimizat]
Conectați-vă cu Ghidul de început Amazon pentru aplicațiile Android – Descărcați

Referințe

• Manual de utilizare