Prisijunkite naudodami „Amazon“ darbo pradžios vadovą, skirtą „Android“ programoms

Prisijunkite naudodami „Amazon“: „Android“ darbo pradžios vadovas

Autorių teisės © 2017 „Amazon.com, Inc.“ arba jos filialai. Visos teisės saugomos.

„Amazon“ ir „Amazon“ logotipas yra „Amazon.com, Inc.“ ar jos dukterinių bendrovių prekių ženklai. Visi kiti „Amazon“ nepriklausantys prekių ženklai yra jų atitinkamų savininkų nuosavybė.

Įdiekite „Android“ kūrėjo įrankius

„Android“ prisijungimas naudojant „Amazon SDK“ padės pridėti prisijungimo prie „Amazon“ prie „Android“, „Fire TV“ ir „Fire Tablet“ programas. Rekomenduojame naudoti „Android“ prisijungimo prie „Amazon SDK“ su „Android Studio“. Apie tai, kaip įdiegti „Android Studio“ ir kaip nustatyti „Android SDK“, žr Gaukite Android SDK svetainėje developer.android.com.

Norėdami naudoti „Android“ skirtą „Login with Amazon SDK“, „Android“ programa turi atitikti vieną iš šių minimalių reikalavimų:

• Minimali „Android 0“ (11 lygio API lygis) SDK versija (minSdkVersion).
• Mažiausia SDK versija („minSdkVersion“) - „Android 2.2“ (8 lygio API) arba naujesnė, naudojant „v4“ Android palaikymas biblioteka.

Kai įdiegsite „Android SDK“, raskite SDK valdytojas programą „Android“ diegime. Norėdami sukurti „Login with Amazon“, turite naudoti SDK tvarkyklę, kad įdiegtumėte aukščiau nurodytus minimalius SDK reikalavimus. Matyti SDK paketų pridėjimas apsilankykite adresu developer.android.com, kad gautumėte daugiau informacijos apie SDK tvarkyklės naudojimą.

Įdiegę SDK, nustatykite „Android“ virtualųjį įrenginį (AVD), kad galėtumėte paleisti programas. Matyti Valdymas Virtualūs įrenginiai tinklalapyje developer.android.com rasite instrukcijas, kaip nustatyti virtualų įrenginį.

Kai jūsų kūrimo aplinka bus sukurta, galėsite Įdiekite „Android“ skirtą „Login with Amazon SDK“ or Paleiskite Samp„App“, kaip aprašyta toliau

Įdiekite „Android“ skirtą „Login with Amazon SDK“

Prisijungimas naudojant „Amazon SDK“, skirtas „Android“, yra dviejų paketų. Pirmajame yra „Android“ biblioteka ir patvirtinamoji dokumentacija. Antrame yra kaipample programa, kuri leidžia vartotojui prisijungti ir rodo savo profesionalumąfile duomenis.

Jei dar neįdiegėte „Android SDK“ ar „Android“ kūrimo įrankių, žr Diegimas „Android“ kūrėjo įrankiai skyriuje aukščiau.

1. Atsisiųsti užtrauktukas ir ištraukite files į standžiojo disko katalogą. Turėtumėte pamatyti a dok ir a lib pakatalogis.
2. Atidaryti docs / index.html į view Prisijungimas naudojant „Amazon Android“ API nuorodą.
3. Žr Įdiekite „Login with Amazon Library“ instrukcijos, kaip pridėti biblioteką ir dokumentus prie „Android“

Kai įdiegsite „Android“ skirtą „Login with Amazon SDK“, galėsite Sukurkite naują prisijungimą naudodami „Amazon“ Projektas po tavęs Prisiregistruokite prisijungdami prie „Amazon“.

Paleiskite Sample App

Norėdami paleisti sample programą, importuokite sampį AndroidStudio darbo sritį.

1. Atsisiųsti SampleLoginWithAmazonAppForAndroid-src.zip ir ištraukite files į katalogą jūsų kietajame
2. Paleiskite „Android Studio“ ir pasirinkite Atidarykite esamą „Android Studioproject“.
3. Naršykite į SampleLoginWithAmazonApp katalogas, gautas ištraukus atsisiųstą ZIP failą file 1 veiksme.
4. Iš Sukurti meniu, spustelėkite Padaryti projektąir palaukite, kol projektas baigs statyti.
5. Iš Bėk meniu, spustelėkite Bėk ir tada spustelėkite SampleLoginWithAmazonApp.
6. Pasirinkite emuliatorių arba prijungtą „Android“ įrenginį ir spustelėkite Bėk.

Prisiregistruokite prisijungdami prie „Amazon“

Prieš naudodami prisijungimą naudodami „Amazon“ a websvetainėje arba mobiliojoje programėlėje, turite užregistruoti programą naudodami Prisijunkite naudodami „Amazon“. Jūsų prisijungimo naudojant „Amazon“ programa yra registracija, kurioje yra pagrindinė informacija apie jūsų verslą ir informacija apie kiekvieną websukurta svetainė arba programa mobiliesiems, kuri palaiko prisijungimą naudojant „Amazon“. Ši verslo informacija rodoma vartotojams kiekvieną kartą, kai jie naudojasi „Prisijungti naudojant Amazon“. websvetainę ar programą mobiliesiems. Vartotojai matys jūsų programos pavadinimą, jūsų logotipą ir nuorodą į jūsų privatumo politiką. Šie veiksmai parodo, kaip užregistruoti „Android“ programą naudoti prisijungiant prie „Amazon“.

Užregistruokite savo prisijungimą naudodami „Amazon“ programą

1. Eikite į https://login.amazon.com.
2. Jei anksčiau prisiregistravote prisijungti prie „Amazon“, spustelėkite „App Console“. Kitu atveju spustelėkite Registruotis. Jūs būsite nukreiptas į „Seller Central“, kuris tvarko programos registraciją prisijungimui su. Jei pirmą kartą naudojate „Seller Central“, jūsų bus paprašyta nustatyti „Seller Central“ paskyrą.
3. Spustelėkite Užregistruokite naują paraišką. The Užregistruokite savo paraišką forma pasirodys:
   a. Į Užregistruokite savo paraišką formą, įveskite a Vardas ir a Aprašymas už jūsų prašymą.
   The Vardas yra vardas, rodomas sutikimo ekrane, kai naudotojai sutinka bendrinti informaciją su jūsų programa. Šis pavadinimas taikomas „Android“, „iOS“ ir webjūsų programos svetainės versijos. The Aprašymas padeda atskirti kiekvieną prisijungimą naudojant „Amazon“ programas ir nėra rodomas vartotojams.
   b. Įveskite a Privatumo pranešimas URL už jūsų prašymą.
   The Privatumo pranešimas URL yra jūsų įmonės ar programos privatumo politikos vieta (pvzample, http://www.example.com/privacy.html). Ši nuoroda rodoma vartotojams sutikimo ekrane.
   c. Jei norite pridėti a Logotipo vaizdas savo programai spustelėkite Naršyti ir raskite tinkamą vaizdą.
4. Spustelėkite Išsaugoti. Jūsų sampregistracija turėtų atrodyti taip:
   
   Išsaugoję pagrindinius programos nustatymus, galite pridėti konkrečių nustatymų websvetaines ir programas mobiliesiems, kurios naudos šį prisijungimą naudojant „Amazon“ paskyrą.

Pridėkite „Android“ nustatymus prie savo programos

Norėdami užregistruoti „Android“ programą, galite pasirinkti registruoti programą per „Amazon Appstore“ (Pridėkite „Android App“, skirtą „Amazon Appstore“) arba tiesiogiai su „Login with Amazon“ (Pridėkite „Android“ Programėlė be „Appstore“). Kai jūsų programa bus užregistruota, turėsite prieigą prie API rakto, kuris suteiks jūsų programai prieigą prie „Login with Amazon“ autorizacijos paslaugos.

Pastaba: Jei „Android“ programoje planuojate naudoti „Amazon Device Messaging“, susisiekite lwa-support@amazon.com su:

• „Amazon“ paskyros el. Pašto adresas, kurį naudojote prisiregistruodami prisijungti
• „Amazon“ paskyros, kurią naudojote prisiregistruodami prie „Amazon Appstore“, el. Pašto adresas (jei skiriasi).
• Vardas jūsų „Seller Central“ paskyroje („Seller Central“ spustelėkite Nustatymai> Paskyros informacija> Pardavėjo informacija, ir naudokite Rodomas pavadinimas).
• „Amazon Appstore“ kūrėjo paskyros pavadinimas („Mobile App Distribution“ svetainėje spustelėkite Nustatymai > Įmonės profesionalasfile ir naudokite Kūrėjo vardas arba įmonės pavadinimas).

Pridėkite „Android App“, skirtą „Amazon Appstore“

Atlikę šiuos veiksmus prie „Login with Amazon“ paskyros pridėsite „Amazon Appstore“ programą:

1. Programos ekrane spustelėkite „Android“ nustatymai. Jei jau esate užregistravę „Android“ programą, ieškokite Pridėti API raktą mygtuką „Android“ nustatymai pasirinkimas
   The Išsami „Android“ programos informacija forma pasirodys:
2. Pasirinkite Taip atsakant į klausimą „Ar ši programa platinama per„ Amazon Appstore “?“
3. Įveskite Etiketė jūsų „Android“ programoje. Tai neturi būti oficialus programos pavadinimas. Tai tiesiog nustato šią konkrečią „Android“ programą tarp programų ir websvetainės, užregistruotos jūsų prisijungimui naudojant „Amazon“.
4. Pridėkite savo „Amazon Appstore“ ID.
5. Jei patys pasirašėte savo programą, pridėkite informaciją apie save. Tai leis jums gauti API raktą kūrimo metu nenaudojant tiesiogiai „Appstore“.
   a. Jei jūsų programa nėra pasirašyta per „Amazon Appstore“, pasirinkite Taip atsakant į klausimą „Ar ši paraiška yra pasirašyta savarankiškai?“
   The Išsami „Android“ programos informacija forma išsiplės
   
   b. Įveskite savo Pakuotės pavadinimas.
   Tai turi atitikti „Android“ projekto paketo pavadinimą. Norėdami nustatyti „Android“ projekto paketo pavadinimą, atidarykite projektą pasirinkdami „Android“ kūrėjo įrankį. Atviras
   „AndroidManifest.XML“ „Package Explorer“ ir pasirinkite Manifestas skirtuką. Pirmasis įrašas yra Paketas pavadinimas.
   c. Įveskite programą Parašas.
   Tai SHA-256 maišos vertė, naudojama jūsų programai patvirtinti. Parašas turi būti sudarytas iš 32 šešioliktainių porų, atskirtų dvitaškiais (pvzampLe: 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). Žr „Android“ programų parašai ir API raktai veiksmams, kuriuos galite naudoti norėdami išgauti parašą iš savo projekto.
   6. Spustelėkite Išsaugoti.

Pridėkite „Android“ programą be „Appstore“

Jei norite užregistruoti „Android“ programą nenaudodami „Amazon Appstore“, galite atlikti šiuos veiksmus norėdami užregistruoti savo paketo pavadinimą ir parašą prisijungdami prie „Amazon“:

1. Programos ekrane spustelėkite „Android“ nustatymai. Jei jau esate užregistravę „Android“ programą, ieškokite Pridėti API raktą mygtuką „Android“ nustatymai The Išsami „Android“ programos informacija forma pasirodys:
   
2. Pasirinkite Nr atsakant į klausimą „Ar ši programa platinama per„ Amazon Appstore “?“
3. Įveskite Etiketė jūsų Android
   Tai neturi būti oficialus jūsų programos pavadinimas. Tai tiesiog identifikuoja šią konkrečią „Android“ programą tarp programų ir websvetaines, kurias užregistravote.
4. Įveskite savo Paketo pavadinimas. Tai turi atitikti „Android“ projekto paketo pavadinimą.
   Norėdami nustatyti „Android“ projekto paketo pavadinimą, atidarykite projektą pasirinkdami „Android“ kūrėjų įrankį. Atviras „AndroidManifest.XML“ „Package Explorer“ ir pasirinkite Manifestas skirtuką. Pirmasis įrašas yra Paketas pavadinimas.
5. Įveskite programą Parašas.
   Tai SHA-256 maišos vertė, naudojama jūsų programai patvirtinti. Parašas turi būti sudarytas iš 32 šešioliktainių porų, atskirtų dvitaškiais (pvzampLe: 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). Žr „Android“ programų parašai ir API raktai skyriuje žemiau pateikiami veiksmai, kuriuos galite naudoti norėdami išgauti parašą iš savo projekto.
6. Spustelėkite Išsaugoti.

Jei skirtingose ​​jūsų programos versijose yra skirtingi parašai ar paketų pavadinimai, pvz., Vienos ar daugiau bandomųjų versijų ir gamybinės versijos, kiekvienai versijai reikalingas atskiras API raktas. Nuo „Android“ nustatymai programos, spustelėkite Pridėti API raktą mygtuką, kad sukurtumėte papildomus programos raktus (po vieną kiekvienoje versijoje).

„Android“ programų parašai ir API raktai

Programos parašas yra SHA-256 maišos vertė, taikoma kiekvienai „Android“ programai, kai ji yra sukurta. „Amazon“ sukuria API raktą naudodamas programos parašą. API raktas leidžia „Amazon“ tarnyboms atpažinti jūsų programą. Jei programai pasirašyti naudojate „Amazon Appstore“, API raktas pateikiamas automatiškai. Jei nenaudojate „Amazon Appstore“, turėsite rankiniu būdu valdyti savo API raktą.

Programos parašai saugomi raktų saugykloje. Paprastai „Android“ programoms yra derinimo ir išleidimo raktų saugykla. Norėdami rasti derinimo pagrindinio saugyklos vietą „Android Studio“, atidarykite Sukurti meniu, pasirinkite Redaguoti Komponavimo tipai, tada eikite į Pasirašymas skirtuką ir raskite derinimo raktų saugyklą Parduotuvė File lauke.

Išleidimo raktų saugykla paprastai sukuriama, kai eksportuojate „Android“ programą, kad sukurtumėte pasirašytą APK file. Eksportuodami, jei kuriate naują leidimo raktų saugyklą, pasirinksite jos vietą. Pagal numatytuosius nustatymus jis bus patalpintas toje pačioje vietoje kaip numatytasis derinimo raktų saugykla.

Jei kūrimo metu užregistravote programą naudodami derinimo parašą, turėsite prie programos pridėti naują „Android“ nustatymą, kai būsite pasirengę išleisti programą. Naujas programos nustatymas turi naudoti parašą iš leidimo raktų.

Žr Paraiškų pasirašymas daugiau informacijos rasite adresu developer.android.com.

Nustatykite „Android“ programos parašą

1. Jei turite pasirašytą APK file:
   a. Išpakuokite APK file ir ištraukite CERT.RSA. (Jei reikia, APK plėtinį galite pervardyti į ZIP).
   b. Iš komandinės eilutės vykdykite:

   „Keytool“ spaudos koncertas -file CERT.RSA

   Pagrindinės priemonės esančioje šiukšliadėžė jūsų „Java“ diegimo katalogą.

2. Jei turite raktų saugyklą file:
   a. Iš komandinės eilutės vykdykite:

   keytool -list -v -alias -raktų parduotuvėfilevardas>

   Klavišų įrankis yra įsikūrusi šiukšliadėžė jūsų „Java“ diegimo katalogą. Pseudonimas yra raktas, naudojamas pasirašyti programą.
   b. Įveskite rakto slaptažodį ir paspauskite Įeikite.
3. Pagal Pažymėjimo pirštų atspaudai, nukopijuoti SHA256 vertė.

Gaukite „Android“ API raktą

Užregistravę „Android“ nustatymą ir pateikę programos parašą, galite gauti API raktą iš prisijungimo prie „Amazon“ programos registracijos puslapio. Turėsite įdėti tą API raktą į file savo „Android“ projekte. Kol to nepadarysite, programai nebus suteikta teisė bendrauti su „Login with Amazon“ autorizacijos paslauga.

1. Eikite į https://login.amazon.com.
2. Spustelėkite „App Console“.
3. Į Programos kairėje esančiame laukelyje pasirinkite savo
4. Suraskite „Android“ programą skiltyje „Android“ nustatymai skyriuje (Jei dar neregistravote „Android“ programos, žr Pridėkite „Android App“, skirtą „Amazon Appstore“).
5. Spustelėkite Generuoti API rakto vertę. Iššokančiame lange bus rodoma jūsų API Norėdami nukopijuoti raktą spustelėkite Pasirinkite Viskas norėdami pasirinkti visą klavišą.
   Pastaba: API rakto vertė iš dalies priklauso nuo jos sugeneravimo laiko. Taigi paskesnė jūsų sukurta API rakto vertė (-ės) gali skirtis nuo originalo. Galite naudoti bet kurią iš šių API raktinių verčių savo programoje, nes jos visos galioja.
6. Žr Pridėkite savo API raktą prie savo projekto instrukcijos, kaip pridėti API raktą prie „Android“

Sukurkite prisijungimą naudodami „Amazon Project“

Šiame skyriuje sužinosite, kaip sukurti naują „Android“ projektą prisijungiant prie „Amazon“, sukonfigūruoti projektą ir pridėti kodą prie projekto, norint prisijungti prie vartotojo su „Login with Amazon“. Aprašysime „Android Studio“ veiksmus, tačiau analogiškus veiksmus galite pritaikyti bet kuriam pasirinktam IDE ar „Android“ kūrimo įrankiui.

Šis vadovas reikalauja suprasti Veikla - pagrindinė „Android“ programų kūrimo koncepcija. Išmokti daugiau apie Veikla ir Veiklos fragmentai svetainėje developer.android.com.

Sukurkite naują prisijungimą naudodami „Amazon“ projektą

Jei dar neturite programos, skirtos „Login with Amazon“ naudoti, vadovaukitės toliau pateiktomis instrukcijomis, kad sukurtumėte. Jei turite esamą programą, pereikite prie Įdiekite „Login with Amazon Library“.

1. Paleisti Android
2. Iš File meniu, pasirinkite Nauja ir Projektas.
3. Įveskite Programos pavadinimas ir Įmonės pavadinimas už tavo
4. Įveskite Taikymas ir Įmonės pavadinimas atitinkantis paketo pavadinimą, kurį pasirinkote, kai užregistravote programą prisijungdami prie „Amazon“.
   Jei dar neregistravote programos, pasirinkite a Paketo pavadinimas ir tada vykdykite instrukcijas Registracija prisijungiant prie „Amazon“ skyrių sukūrę savo projektą. Jei jūsų programos paketo pavadinimas nesutampa su registruoto paketo pavadinimu, jūsų prisijungimo prie „Amazon“ skambučių nepavyks.
5. Pasirinkite a Minimalus reikalingas SDK API 11: „Android 3.0“ („Honeycomb“) arba naujesnė versija ir spustelėkite Kitas. Arba galite naudoti a Minimalus reikalingas SDK API 8: „Android 2.2“ („Froyo“) arba naujesnė, kai naudojate v4 „Android“ palaikymo biblioteka.
6. Pasirinkite norimos sukurti veiklos tipą ir spustelėkite Kitas.
7. Įveskite reikiamą informaciją ir spustelėkite Baigti.

Dabar savo darbo vietoje turėsite naują projektą, kurį galėsite naudoti norėdami paskambinti „Login with Amazon“.

Įdiekite „Login with Amazon Library“

Jei dar neatsisiuntėte „Android“ prisijungimo prie „Amazon SDK“, žr Įdiekite prisijungimą naudodami „Amazon“ SDK, skirtas „Android“.

1. Naudojant file sistemą savo kompiuteryje, raskite prisijunkite-su-amazon-sdk.jar file Prisijunkite naudodami „Amazon SDK“, skirtą „Android“. Nukopijuokite jį į mainų sritį.
2. Kai jūsų projektas atidarytas „Android Studio“, atidarykite Projektas View.
3. Dešiniuoju pelės mygtuku spustelėkite pagrindinį projekto / programos katalogą Projektas View ir pasirinkite Įklijuoti.
4. Dešiniuoju pelės mygtuku spustelėkite prisijunkite-su-amazon-sdk.jar esančiame Projektas View ir pasirinkite Pridėti kaip biblioteką.

Nustatykite tinklo leidimus savo programai

Kad jūsų programa galėtų naudoti „Login with Amazon“, ji turi pasiekti internetą ir prieigą prie tinklo būsenos informacijos. Programa turi patvirtinti šiuos leidimus „Android“ apraše, jei to dar nepadarė.

1. Iš Projektas View, dukart spustelėkite xml, kad jį atidarytumėte.
2. Nukopijuokite žemiau rodomas kodo eilutes ir įklijuokite jas į xml file, už programų bloko ribų:
   

   ExampLe:
   

Pridėkite savo API raktą prie savo projekto

Kai užregistruojate „Android“ programą prisijungdami prie „Amazon“, jums priskiriamas API raktas. Tai yra identifikatorius, kurį naudodamas „Amazon Authorization Manager“ nustatys jūsų programą prisijungimo prie „Amazon“ autorizacijos tarnybai. Jei prisijungdami prie programos naudojate „Amazon Appstore“, „Appstore“ automatiškai pateiks API raktą. Jei nenaudojate „Amazon Appstore“, „Amazon Authorization Manager“ šią vertę vykdymo metu įkelia iš api_key.txt file esančiame turto katalogas.

1. Jei dar neturite API rakto, vykdykite instrukcijas Gaukite „Android“ API raktą.
2. Iš Projektas View „Android Studio“ dešiniuoju pelės mygtuku spustelėkite aplanką ištekliai, tada spustelėkite Nauja ir pasirinkite File. Jei neturite išteklių aplanko, dešiniuoju pelės mygtuku spustelėkite projekto pirminį katalogą, tada pasirinkite Nauja, Aplankas, Turto aplankas.
3. Pavadinkite file api_key.txt.
4. Dabar turėtumėte turėti teksto redaktoriaus langą file pavadintas txt. Prie teksto pridėkite API raktą file.
5. Į File meniu, spustelėkite Išsaugoti.

Pastaba: jei teksto rengyklė prideda papildomų simbolių į jūsų api_key.txt file (pvz., baitų eilės žyma), galite matyti ERROR_ACCESS_DENIED, kai bandysite prisijungti prie prisijungimo naudojant „Amazon“ autorizacijos tarnybos. Jei taip atsitiks, pabandykite pašalinti visus pirmuosius arba galinius tarpus, eilučių tiekimą arba įtartinus simbolius. (pvzampredagavimo priemonė, naudojanti baitų eilės žymėjimą, api_key.txt pradžioje gali pridėti 0xEF 0xBB 0xBF arba kitas šešioliktaines sekas. file). Taip pat galite pabandyti gauti naują API raktą.

Tvarkykite savo veiklos konfigūracijos pakeitimus

Jei vartotojas, prisijungdamas, pakeičia ekrano orientaciją arba keičia įrenginio klaviatūros būseną, jis paragins iš naujo paleisti dabartinę veiklą. Šis pakartotinis paleidimas netikėtai panaikins prisijungimo ekraną. Norėdami to išvengti, turėtumėte nustatyti veiklą, kuri naudoja autorizavimo metodą, kad rankiniu būdu tvarkytų tuos konfigūracijos pakeitimus. Tai neleis iš naujo pradėti veiklos.

1. In Paketas Tyrinėtojas, dukart spustelėkite xml.
2. Į Taikymas skyrių, suraskite veiklą, kuri tvarkys prisijungimą naudojant „Amazon“ (forexample, Pagrindinis užsiėmimas),
3. Pridėkite šį atributą prie veiklos, kurią atlikote atlikdami 2 veiksmą:
   

   android: configChanges = ”klaviatūra | klaviatūra paslėpta | orientacija”

   Arba API 13 ar naujesnei versijai:

   android: configChanges = ”klaviatūra | klaviatūra paslėpta | orientacija | screenSize“

4. Iš File meniu, spustelėkite Išsaugoti

Dabar, kai pasikeis klaviatūros ar įrenginio orientacija, „Android“ iškvies jūsų veiklos metodą „onConfigurationChanged“. Šios funkcijos įgyvendinti nereikia, nebent yra šių konfigūracijos pakeitimų aspektas, kurį norite tvarkyti savo programoje.

Pridėkite „WorkflowActivity“ prie savo projekto

Kai vartotojas spustelės mygtuką Prisijungti naudojant „Amazon“, API paleis web naršyklę, kad pateiktų vartotojui prisijungimo ir sutikimo puslapį. Kad ši naršyklės veikla veiktų, prie aprašo turite pridėti WorkflowActivity.

Jei anksčiau esate integravęsi „Login with Amazon SDK“ arba turite „com.amazon.identity.auth.device.authorization.AuthorizationActivity“ veiklą, deklaruotą jūsų „AndroidManifest.xml“, ji turi būti pašalinta ir pakeista „WorkflowActivity“.

1. In Paketas Tyrinėtojas, dukart spustelėkite AndroidMailfest.xml ..
2. Į Taikymas skyriuje pridėkite šį kodą.
   

   <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: schema = ”amzn” />

   Pastaba: Jei nenaudojate „Gradle build“ sistemos, pakeiskite $ {applicationId} šios programos paketo pavadinimu.

Pridėkite prisijungimą naudodami „Amazon“ mygtuką prie savo programos

Prisijungimas naudojant „Amazon“ suteikia keletą standartinių mygtukų, kuriais galite paraginti vartotojus prisijungti iš jūsų programos. Šiame skyriuje pateikiami veiksmai, kaip atsisiųsti oficialų prisijungimą naudojant „Amazon“ vaizdą ir susieti jį su „Android ImageButton“.

1. Pridėkite standartinį „ImageButton“ prie savo programos.
   Norėdami gauti daugiau informacijos apie „Android“ mygtukus ir „ImageButton“ klasę, žr Mygtukai svetainėje developer.android.com.

2. Mygtuko XML deklaracijoje nustatykite atributą android:id į @+id/login_with_amazon. Pavyzdžiui,ampLe:
   

   android: id = ”@ + id / login_with_amazon”

3. Pasirinkite mygtuko vaizdą.
   Pasitarkite su „Amazon“ prisijungimu Stiliaus gairės mygtukų, kuriuos galite naudoti savo programoje, sąrašą.
   Atsisiųskite LWA_Android.zip file. Ištraukite pageidaujamo mygtuko kopiją kiekvienam ekrano tankiui, kurį palaiko jūsų programa (xxhdpi, xhdpi, hdpi, mdpi arba tvdpi). Norėdami gauti daugiau informacijos apie kelių ekrano tankių palaikymą „Android“, žr Alternatyvūs maketai temoje „Kelių ekranų palaikymas“ ondeveloper.android.com.
4. Nukopijuokite atitinkamo mygtuko vaizdą files jūsų projektui.
   Kiekvienam palaikomam ekrano tankiui (xhdpi, hdpi, mdpi arba ldpi) nukopijuokite atsisiųstą mygtuką į res / nupiešiamas to ekrano tankio katalogas.
5. Paskelbkite mygtuko vaizdą.
   Mygtuko XML deklaracijoje nustatykite android: src atributą pasirinkto mygtuko pavadinimui. Pavyzdžiui,ampLe:

   „Android“: src = ”@ drawable / btnlwa_gold_loginwithamazon.png”

6.  Įkelkite programą ir patikrinkite, ar dabar mygtuke yra „Login with Amazon“ vaizdas.
   Turėtumėte patikrinti, ar mygtukas tinkamai rodomas kiekvienam jūsų palaikomam ekrano tankiui

Naudokite SDK, skirtą „Android“ API

Šiame skyriuje pridėsite kodą prie savo projekto, kad prisijungtumėte prie vartotojo su „Login with Amazon“.

Tvarkykite prisijungimo mygtuką ir įgaliokite vartotoją

Šiame skyriuje paaiškinta, kaip paskambinti įgaliojimo API prisijungti prie vartotojo. Tai apima onClick klausytojas, skirtas jūsų prisijungimo su „Amazon“ mygtuku onCreate programos metodas.

1. Pridėkite Prisijungti naudodami „Amazon“ prie „Android See“ Įdiekite „Login with Amazon Library“.
2. Inicijuoti „RequestContext“.
   Turėsite deklaruoti a „RequestContext“ kintamąjį ir sukurkite naują klasės egzempliorių. Geriausia vieta inicijuoti „RequestContext“ yra onCreate „Android“ veiklos ar fragmento metodas. Pavyzdžiui,ampLe:

   privatus RequestContext requestContext; @ Nepaisyti apsaugotas void onCreate (paketas savedInstanceState) {super.onCreate (savedInstanceState); requestContext = RequestContext.create (tai); }

3. Sukurti an „AuthorizeListener“.
   „AuthorizeListener“ apdoros autorizacinis skambutis. Jame yra trys metodai: „onSuccess“, „onError“, ir onAtšaukti. Sukurti „AuthorizeListener“ sąsaja, suderinta su a registruotisKlausytojas paskambinkite onCreate „Android“ veiklos ar fragmento metodas.

   @ Nepaisyti apsaugotas void onCreate (paketas savedInstanceState) {super.onCreate (savedInstanceState); requestContext = RequestContext.create (tai);requestContext.registerListener (naujas AuthorizeListener () { / * Įgaliojimas sėkmingai užbaigtas. * / @ Nepaisyti public void onSuccess (AuthorizeResult rezultatas) { / * Dabar jūsų programai suteikta teisė naudotis prašomomis taikymo sritimis * / } / * Bandant autorizuoti programą įvyko klaida. * / @ Nepaisyti public void onError (AuthError ae) { / * Informuokite vartotoją apie klaidą * / } / * Autorizacija buvo atšaukta prieš ją baigiant. * / @ Nepaisyti public void onCancel (AuthCancellation cancellation) { / * Atstatykite vartotojo sąsają į būseną, kurią galima paruošti prisijungti * / } }); }

   Pastaba: Jei naudojate fragmentą ir fiksuojate nuorodas į View objektus tavo „AuthorizeListener“ įgyvendinimą, kurti „AuthorizeListener“ esančiame onCreateView metodas vietoj onCreate. Tai užtikrina View objekto nuorodos nustatomos skambinant į autorizuojasi.

4. Įgyvendinti „onSuccess“, „onError“, ir onAtšaukti už tavo „AuthorizeListener“.
   Kadangi autorizacijos procesas pateikia prisijungimo ekraną (ir galbūt sutikimo ekraną) vartotojui web naršyklė (arba a WebView), vartotojas turės galimybę atšaukti prisijungimą arba išeiti. Jei jie aiškiai atšaukia prisijungimo procesą, onAtšaukti yra vadinamas, ir jūs norite iš naujo nustatyti savo vartotojo sąsają.
   Jei vartotojas naršyklėje nukrypsta nuo prisijungimo ekrano arba WebView, tada vėl persijungs į jūsų programą, SDK neaptiks, kad prisijungimas nebuvo baigtas. Jei aptinkate naudotojo veiklą programoje prieš prisijungiant, galite manyti, kad jie išėjo iš naršyklės ir atitinkamai reaguos.
5. Skambinti RequestContext.onResume.
   Norėdami pritaikyti „Android“ programos gyvavimo ciklą, įdiekite onResume metodas jūsų veikloje ar fragmente. Tai sukels visus klausytojus, užsiregistravusius registruotisKlausytojas tuo atveju, jei operacinė sistema uždaro jūsų programą prieš vartotojui baigiant prieigos teisę.

   @ Nepaisyti apsaugotas negaliojantis onResume () { super.onResume (); requestContext.onResume (); }

6. Skambinti AuthorizationManager.autorize.
   Į onClick „Prisijunkite su„ Amazon “mygtuko tvarkytoju, paskambinkite įgalinti, kad paragintumėte vartotoją prisijungti ir patvirtinti jūsų programą.
   Šis metodas leis vartotojui prisijungti ir sutikti su prašoma informacija vienu iš šių būdų:
   1. Perjungiama į sistemos naršyklę
   2. Persijungia į WebView saugiame kontekste (jei įrenginyje įdiegta „Amazon Shopping“ programa)
   Saugus antrosios parinkties kontekstas pasiekiamas, kai įrenginyje įdiegiama „Amazon Shopping“ programa. „Amazon“ sukurti įrenginiai, kuriuose veikia „Fire OS“ (pvz.,ample Kindle Fire, Fire Phone ir Fire TV) visada naudokite šią parinktį, net jei įrenginyje nėra „Amazon Shopping“ programos. Dėl šios priežasties, jei vartotojas jau yra prisijungęs prie „Amazon Shopping“ programos, ši API praleis prisijungimo puslapį, todėl Vienkartinis prisijungimas patirtį vartotojui. Žr. klientų patirtį klientų patirtis-android programas, kad sužinotumėte daugiau. Kai jūsų programa yra įgaliota, ji yra įgaliota vienam ar daugiau duomenų rinkinių, žinomų kaip apimtis. Taikymo sritis apima vartotojo duomenis, kurių prašote iš Prisijungimo naudojant „Amazon“. Kai vartotojas pirmą kartą prisijungs prie jūsų programos, jam bus pateiktas jūsų prašomų duomenų sąrašas ir bus paprašyta patvirtinti. Prisijungimas naudojant „Amazon“ šiuo metu palaiko šias sritis:

   Taikymo srities pavadinimas	Aprašymas
   profile	Suteikia prieigą prie vartotojo vardo, el. Pašto adreso ir „Amazon“ paskyros ID.
   profile:Vartotojo ID	Suteikia prieigą tik prie vartotojo „Amazon“ paskyros ID.
   pašto_kodas	Suteikia prieigą prie vartotojo pašto/pašto kodo file savo „Amazon“ paskyrai.

   AuthorizationManager.autorize yra asinchroninis skambutis, todėl jums nereikia blokuoti vartotojo sąsajos gijos ar kurti savo darbininko gijos. Norėdami paskambinti įgalinti, perduokite „AuthorizeRequest“ objektas, kurį galima pastatyti naudojant „AuthorizeRequest.Builder“:
   

   @ Nepaisyti apsaugotas void onCreate (paketas savedInstanceState) {super.onCreate (savedInstanceState); / * Ankstesnės onCreate deklaracijos praleistos * /// Raskite mygtuką su login_with_amazon ID // ir nustatykite paspaudimų tvarkytuvą View loginButton = rastiViewById(R.id.login_with_amazon); loginButton.setOnClickListener(new View.OnClickListener() { @ Nepaisyti public void onClick (View v) { AuthorizationManager.authorize(new AuthorizeRequest Builder(requestContext).addScopes(ProfileScope.profile(), ProfileApimtis.pašto kodas()) .pastatyti ()); }); }

„Fetch User Pro“file Duomenys

Šiame skyriuje paaiškinama, kaip naudoti vartotojo API, kad būtų galima atkurti vartotojo profesionalumąfile duomenis po to, kai jie buvo įgalioti. Profesionalasfile duomenys, kuriuos galite gauti, yra pagrįsti apimtimi, nurodyta skiltyje įgalioti: su „Handler“: skambinti.

1. Skambinti User.fetch.
   User.fetch grąžina vartotojo profesionalumąfile duomenis jums per Klausytoją AuthError> perskambink. Klausytojas AuthError> yra du metodai: OnSuccess ir onError (tai nepalaiko onAtšaukti nes nėra galimybės atšaukti a User.fetch skambutis). OnSuccess gauna vartotojo objektą su profile duomenis, tuo tarpu onError gauna AuthError objektas su informacija apie klaidą. updateProfileDuomenys yra buvęsampfunkcija, kurią jūsų programa galėtų įdiegti, kad būtų rodoma profesionalifile duomenis vartotojo sąsajoje
   Pastaba: User.getUserPostalCode grąžinamas tik tuo atveju, jei prašote profesionalofileTaikymo sritis.pašto kodas() taikymo sritis.

Patikrinkite, ar Vartotojo prisijungimas paleidžiamas

Jei vartotojas prisijungia prie jūsų programos, ją uždaro ir paleidžia iš naujo, programa vis tiek turi teisę gauti duomenis. Vartotojas neatsijungia automatiškai. Paleisdami galite parodyti vartotoją kaip prisijungusį, jei jūsų programa vis dar yra įgaliota. Šiame skyriuje paaiškinama, kaip naudoti „getToken“ norėdami sužinoti, ar programa vis dar yra įgaliota.

1. Skambinti „getToken“.
   Į onStart savo veiklos metodą ar fragmentą, paskambinkite „getToken“ norėdami sužinoti, ar programa vis dar yra įgaliota. „getToken“ gauna neapdorotą prieigos raktą, kurį „AuthorizationManager“ naudoja vartotojo profesionalui pasiektifile. Jei prieigos rakto reikšmė nėra nulinė, programa vis tiek įgaliota ir galite tęsti naudotojo profesionalų gavimąfile duomenis. „getTokenrequires“ tomis pačiomis sritimis, kurių prašėte savo kvietime suteikti įgaliojimą.
   „getTokensupports“ asinchroninius skambučius taip pat, kaip ir „User.fetch“, taigi jums nereikia užblokuoti vartotojo sąsajos gijos ar sukurti savo darbininko gijos. Paskambinti „getToken“ asinchroniškai perduokite objektą, palaikantį Klausytojas sąsaja kaip paskutinis parametras.
2. Paskelbkite a Klausytojas AuthError>. Jūsų įgyvendinimas Klausytojas Sąsaja AuthError> apdoroja „getToken“ skambutis. Klausytojui taikomi du metodai: OnSuccess ir onError (tai nepalaiko onAtšaukti nes nėra galimybės atšaukti a „getToken“ skambutis).
3. Įgyvendinti OnSuccess ir „onError“ jūsų Klausytojas . onSuccess gauna „AuthorizeResult“ objektas su prieigos žetonu, o onError gauna AuthError objektas su informacija apie klaidą.
   

   @ Nepaisyti apsaugotas negaliojantis onStart () {super.onStart (); Taikymo sritis[] apimtis = { ProfileScope.profile(), ProfileTaikymo sritis.paštoKodas() }; AuthorizationManager.getToken(tai, apimtis, naujas Klausytojas () {@ Nepaisyti public void onSuccess (AuthorizeResult result) {if (result.getAccessToken ()! = null) { / * Vartotojas yra prisijungęs * / } dar { / * Vartotojas neprisijungęs * / } } @ Nepaisyti public void onError (AuthError ae) { / * Vartotojas neprisijungęs * / } }); }

Išvalykite autorizacijos duomenis ir atsijunkite nuo vartotojo

Šiame skyriuje paaiškinama, kaip naudoti atsijungimo metodą, kad vartotojas atsijungtų nuo programos. Vartotojas turės prisijungti dar kartą, kad programa galėtų nuskaityti profile duomenis. Naudokite šį metodą, norėdami atsijungti nuo vartotojo arba pašalinti prisijungimo prie programos problemas.

1. Įdiegti atsijungimo mechanizmą.
   Kai vartotojas sėkmingai prisijungia, turėtumėte pateikti atsijungimo mechanizmą, kad jis galėtų išvalyti savo profesionaląfile duomenis ir anksčiau patvirtintas apimtis. Jūsų mechanizmas gali būti hipersaitas, mygtukas arba meniu elementas. Šiam buvusiamample, sukursime an onClickmethod mygtukui.
2. Skambinti Atsijungti.
   Skambinti Atsijungti atsijungimo tvarkyklėje, kad pašalintumėte vartotojo įgaliojimo duomenis (prieigos prieigos raktus, profile) iš vietinės parduotuvės. Atsijungti paima „Android“ kontekstą ir klausytoją AuthError> to tvarkyti sėkmę ar nesėkmę.
3. Paskelbkite anoniminį klausytoją AuthError>.
   Jūsų klausytojo įgyvendinimas AuthError> apdoroja Atsijungti skambutis. Anoniminės klasės yra naudingos fiksuojant kintamuosius iš pridedamos srities.
   Žr Tvarkykite prisijungimo mygtuką ir įgaliokite vartotoją už an examptegul deklaruoja klausytojų klases.
4. Įgyvendinti OnSuccess ir onError jūsų klausytojui AuthError>.
   Kada ženklas Nepavyksta turėtumėte atnaujinti savo vartotojo sąsają, kad pašalintumėte nuorodas į vartotoją, ir pateikite prisijungimo mechanizmą, kurį vartotojai gali naudoti prisijungdami dar kartą. Jei ženklasIšvykimai klaida, galite leisti vartotojui bandyti dar kartą atsijungti.

   @ Nepaisyti apsaugotas void onCreate (paketas savedInstanceState) {super.onCreate (savedInstanceState); / * Ankstesnės onCreate deklaracijos praleistos * /// Raskite mygtuką su atsijungimo ID ir nustatykite paspaudimų tvarkytuvą View logoutButton = rastiViewById(R.id.logout); logoutButton.setOnClickListener(new View.OnClickListener() {@ Nepaisyti public void onClick (View v) { AuthorizationManager.signOut(getApplicationContext(), naujas Klausytojas () {@ Nepaisyti public void onSuccess (Tuščias atsakymas) { // Nustatykite atsijungimo būseną vartotojo sąsajoje } @ Nepaisyti public void onError (AuthError authError) { // Užregistruokite klaidą } }); } }); }

Prisijunkite naudodami „Amazon“ darbo pradžios vadovą, skirtą „Android“ programoms - Atsisiųsti [optimizuota]
Prisijunkite naudodami „Amazon“ darbo pradžios vadovą, skirtą „Android“ programoms - Atsisiųsti

Nuorodos

• Vartotojo vadovas