Teken aan by Amazon Aan die slag-gids vir Android-programme

Teken aan by Amazon Aan die slag-gids vir Android-programme

Meld aan by Amazon: Handleiding vir Android

Kopiereg © 2017 Amazon.com, Inc., of sy affiliasies. Alle regte voorbehou.

Amazon en die Amazon-logo is handelsmerke van Amazon.com, Inc. of sy filiale. Alle ander handelsmerke wat nie deur Amazon besit word nie, is die eiendom van hul onderskeie eienaars.

Installeer die Android-ontwikkelaarnutsgoed

Die Login with Amazon SDK for Android sal jou help om Login with Amazon by jou Android-, Fire TV- en Fire Tablet-toepassings te voeg. Ons beveel aan dat jy die Login with Amazon SDK vir Android met Android Studio gebruik. Vir stappe oor hoe om Android Studio te installeer en hoe om die Android SDK op te stel, sien Kry die Android SDK op developer.android.com.

Om die Aanmelding met Amazon SDK vir Android te gebruik, moet jou Android-toepassing aan een van hierdie minimum vereistes voldoen:

• Minimum SDK-weergawe (minSdkVersion) van Android 0 (API-vlak 11) of hoër.
• Minimum SDK-weergawe (minSdkVersion) van Android 2.2 (API-vlak 8) of hoër met die v4 Android Ondersteuning Biblioteek.

Wanneer die Android SDK geïnstalleer is, soek die SDK Bestuurder toepassing in jou Android-installasie. Om te ontwikkel vir Aanmelding by Amazon, moet jy die SDK-bestuurder gebruik om die minimum SDK-vereistes hierbo te installeer. Sien Voeg SDK-pakkette by op developer.android.com vir meer inligting oor die gebruik van SDK Bestuurder.

Nadat u die SDK geïnstalleer het, moet u 'n Android Virtual Device (AVD) instel om u programme te laat loop. Sien Bestuur Virtuele toestelle op developer.android.com vir instruksies oor die opstel van 'n virtuele toestel.

Wanneer u ontwikkelingsomgewing ingestel is, kan u Installeer die aanmelding met Amazon SDK vir Android or Begin die Sampdie App, soos hieronder beskryf

Installeer die aanmelding met Amazon SDK vir Android

Die aanmelding met Amazon SDK vir Android kom in twee pakkette. Die eerste bevat die Android -biblioteek en ondersteunende dokumentasie. Die tweede bevat asample toepassing wat 'n gebruiker toelaat om aan te meld en hul pro vertoonfile data.

As u nog nie die Android SDK of die Android Development Tools geïnstalleer het nie, sien die Installeer tans die Android Developer Tools afdeling hierbo.

1. Laai af zip en onttrek die files na 'n gids op jou hardeskyf. Jy behoort a te sien dokumente en a lib subgids.
2. Maak oop docs/index.html aan view die Teken in met Amazon Android API-verwysing.
3. Sien Installeer die aanmelding met Amazon Library vir instruksies oor hoe om die biblioteek en dokumentasie by 'n Android te voeg

Wanneer die aanmelding met Amazon SDK vir Android geïnstalleer is, kan u dit doen Skep 'n nuwe aanmelding met Amazon Projek agter jou aan Registreer by Login by Amazon.

Begin die Sampdie App

Om die sampdie aansoek, voer die sampgaan in 'n AndroidStudio-werkspasie.

1. Laai af SampleLoginWithAmazonAppForAndroid-src.zip en onttrek die files na 'n gids op u hard
2. Begin Android Studio en kies Maak 'n bestaande Android Studio-projek oop.
3. Blaai na die SampleLoginWithAmazonApp gids verkry nadat u die afgelaaide zip afgelaai het file in Stap 1.
4. Van die Bou kieslys, klik Maak Projek, en wag vir die projek om klaar te maak.
5. Van die Hardloop kieslys, klik Hardloop en klik dan op SampleLoginWithAmazonApp.
6. Kies die emulator of gekoppelde Android-toestel en klik Hardloop.

Registreer by Login by Amazon

Voordat jy Login with Amazon kan gebruik op 'n webwebwerf of in 'n mobiele toepassing, moet jy 'n toepassing registreer met Login met Amazon. Jou Aanmelding by Amazon-toepassing is die registrasie wat basiese inligting oor jou besigheid en inligting oor elkeen bevat webwebwerf of mobiele toepassing wat jy skep wat Aanmelding met Amazon ondersteun. Hierdie besigheidsinligting word aan gebruikers vertoon elke keer as hulle Login with Amazon op jou gebruik webwebwerf of mobiele app. Gebruikers sien die naam van u aansoek, u logo en 'n skakel na u privaatheidsbeleid. Hierdie stappe demonstreer hoe u u Android -app kan registreer vir gebruik met aanmelding by Amazon.

Registreer u aanmelding by Amazon-aansoek

1. Gaan na https://login.amazon.com.
2. As u al voorheen by Amazon aangemeld het, klik App -konsole. Andersins, klik Teken in. U sal na Seller Central herlei word, wat aansoekregistrasie vir aanmelding hanteer. As dit die eerste keer is dat u Seller Central gebruik, sal u gevra word om 'n Seller Central-rekening op te stel.
3. Klik Registreer nuwe aansoek. Die Registreer jou aansoek vorm sal verskyn:
   a. In die Registreer jou aansoek vorm, voer 'n in Naam en a Beskrywing vir jou aansoek.
   Die Naam is die naam wat op die toestemmingskerm vertoon word wanneer gebruikers instem om inligting met jou aansoek te deel. Hierdie naam is van toepassing op Android, iOS en webwebwerf weergawes van jou aansoek. Die Beskrywing help u om elkeen van u aanmeldings met Amazon-toepassings te onderskei en word nie aan gebruikers vertoon nie.
   b. Voer 'n in Privaatheidskennisgewing URL vir jou aansoek.
   Die Privaatheidskennisgewing URL is die ligging van die privaatheidsbeleid van u onderneming of aansoek (bvample, http://www.example.com/privacy.html). Hierdie skakel word aan gebruikers op die toestemmingskerm vertoon.
   c. As jy 'n byvoeg Logo beeld vir jou aansoek, klik Blaai deur en soek die toepaslike beeld.
4. Klik Stoor. Jou sampDie registrasie moet soos volg lyk:
   
   Nadat u basiese toepassingsinstellings gestoor is, kan u instellings vir spesifieke byvoeg webwebwerwe en mobiele programme wat hierdie aanmelding met Amazon -rekening sal gebruik.

Voeg Android-instellings by jou toepassing

Om 'n Android-app te registreer, kan u 'n app registreer via die Amazon Appstore (Voeg 'n Android-app vir Amazon Appstore by) of direk met Login met Amazon (Voeg 'n Android by Toep sonder Appstore). Wanneer jou program geregistreer is, sal jy toegang hê tot 'n API-sleutel wat jou program toegang sal verleen tot die Login with Amazon-magtigingsdiens.

Let wel: Kontak as u van plan is om Amazon Device Messaging in u Android-app te gebruik lwa-ondersteuning@amazon.com met:

• Die e-posadres van die Amazon-rekening waarmee jy aangesluit het om aan te meld
• Die e-posadres van die Amazon-rekening waarmee u by die Amazon Appstore aangemeld het (indien anders).
• Die naam op jou Seller Central-rekening (klik in Seller Central Instellings> Rekeninginligting> Verkopersinligting, en gebruik die Vertoon Naam).
• Die naam op jou Amazon Appstore-ontwikkelaarrekening (klik op die Mobile App Distribution-webwerf Instellings > Company Profile en gebruik die Ontwikkelaarnaam of Maatskappynaam).

Voeg 'n Android-toepassing by vir Amazon Appstore

Die volgende stappe sal 'n Amazon Appstore-app by u aanmelding met Amazon-rekening voeg:

1. Klik op die toepassingskerm Android-instellings. As u reeds 'n Android-app geregistreer het, soek die Voeg API-sleutel by knoppie in die Android-instellings seleksie
   Die Android-toepassingsbesonderhede vorm sal verskyn:
2. Kies Ja in antwoord op die vraag “Word hierdie aansoek versprei deur die Amazon Appstore?”
3. Voer die in Etiket van jou Android -app. Dit hoef nie die amptelike naam van u app te wees nie. Dit identifiseer eenvoudig hierdie spesifieke Android -app onder die programme en webwebwerwe wat by jou aanmeld by Amazon geregistreer is
4. Voeg jou Amazon Appstore ID.
5. As jy jou program self onderteken het, voeg selfondertekeninginligting by. Dit sal jou toelaat om 'n API-sleutel tydens ontwikkeling te verkry sonder om die Appstore direk te gebruik.
   a. As jou toepassing nie deur die Amazon Appstore onderteken word nie, kies Ja in antwoord op die vraag "Is hierdie aansoek selfonderteken?"
   Die Android-toepassingsbesonderhede vorm sal uitbrei
   
   b. Voer jou in Pakketnaam.
   Dit moet ooreenstem met die pakketnaam van jou Android-projek. Om die pakketnaam van jou Android-projek te bepaal, maak die projek oop in jou keuse van Android-ontwikkelaarnutsding. Maak oop
   AndroidManifest.XML in Package Explorer en kies die Manifesteer oortjie. Die eerste inskrywing is die Pakket naam.
   c. Voer die app in Handtekening.
   Dit is 'n SHA-256-hash-waarde wat gebruik word om u aansoek te verifieer. Die handtekening moet in die vorm van 32 heksadesimale pare geskei wees deur dubbelpunte (bvample: 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). Sien Android App-handtekeninge en API-sleutels vir stappe wat u kan gebruik om die handtekening uit u projek te haal.
   6. Klik Stoor.

Voeg 'n Android-toepassing by sonder Appstore

As jy jou Android-toepassing wil registreer sonder om die Amazon Appstore te gebruik, kan jy die volgende stappe gebruik om jou Pakketnaam en Handtekening met Aanmelding by Amazon te registreer:

1. Klik op die toepassingskerm Android-instellings. As u reeds 'n Android-app geregistreer het, soek die Voeg API-sleutel by knoppie in die Android-instellings Die Android-toepassingsbesonderhede vorm sal verskyn:
   
2. Kies Nee in antwoord op die vraag “Word hierdie aansoek versprei deur die Amazon Appstore?”
3. Voer die in Etiket van jou Android
   Dit hoef nie die amptelike naam van jou program te wees nie. Dit identifiseer eenvoudig hierdie spesifieke Android-toepassing onder die toepassings en webwebwerwe wat jy geregistreer het.
4. Voer jou in Pakketnaam. Dit moet ooreenstem met die pakketnaam van jou Android-projek.
   Om die pakketnaam van jou Android-projek te bepaal, maak die projek oop in jou keuse van Android-ontwikkelaarnutsding. Maak oop AndroidManifest.XML in Package Explorer en kies die Manifesteer oortjie. Die eerste inskrywing is die Pakket naam.
5. Voer die app in Handtekening.
   Dit is 'n SHA-256-hash-waarde wat gebruik word om u aansoek te verifieer. Die handtekening moet in die vorm van 32 heksadesimale pare geskei wees deur dubbelpunte (bvample: 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). Sien die Android App-handtekeninge en API-sleutels afdeling hieronder vir stappe wat jy kan gebruik om die handtekening uit jou projek te onttrek.
6. Klik Stoor.

As verskillende weergawes van u app verskillende handtekeninge of pakketname het, soos vir een of meer toetsweergawes en 'n produksie-weergawe, benodig elke weergawe sy eie API-sleutel. Van die Android-instellings klik op die Voeg API-sleutel by knoppie om bykomende sleutels vir u program te skep (een per weergawe).

Android App-handtekeninge en API-sleutels

Die app-handtekening is 'n SHA-256-hashwaarde wat op elke Android-app toegepas word wanneer dit gebou word. Amazon gebruik die app-handtekening om u API-sleutel te konstrueer. Die API-sleutel stel Amazon-dienste in staat om u program te herken. As u die Amazon Appstore gebruik om u app te onderteken, word die API-sleutel outomaties verstrek. As u nie die Amazon Appstore gebruik nie, moet u u API-sleutel handmatig bestuur.

Toepassingshandtekeninge word in 'n sleutelstoor gestoor. Oor die algemeen is daar vir Android-toepassings 'n ontfoutingsleutelstoor en 'n vrystellingsleutelstoor. Om die ligging van die ontfoutingsleutelstoor in Android Studio te vind, maak die Bou kieslys, kies Wysig Bou tipes, gaan dan na die Ondertekening tabblad, en soek die foutopsporingstoor in die Winkel File veld.

Gewoonlik word 'n vrystelling -sleutelwinkel geskep wanneer u u Android -program uitvoer om 'n ondertekende APK te skep file. Deur die uitvoerproses, as jy 'n nuwe vrystellingsleutelstoor skep, sal jy die ligging daarvan kies. By verstek sal dit op dieselfde plek geplaas word as jou verstek ontfouting KeyStore.

As u u program tydens die ontwikkeling met die ontfouthandtekening geregistreer het, moet u 'n nuwe Android-instelling by u toepassing voeg wanneer u gereed is om die app vry te stel. Die nuwe app-instelling moet die handtekening van die release keystore gebruik.

Sien Onderteken u aansoeke op developer.android.com vir meer inligting.

Bepaal die Android App-handtekening

1. As u 'n ondertekende APK het file:
   a. Pak die APK uit file en onttrek CERT.RSA. (Jy kan die APK-uitbreiding na zip hernoem indien nodig).
   b. Voer vanaf die opdraglyn:

   sleutelbord -afdruk -file SERT.RSA

   Sleutelgereedskap geleë in die bin gids van u Java-installasie.

2. As u 'n sleutelwinkel het file:
   a. Voer vanaf die opdraglyn:

   sleutelbord -lys -v -alias -sleutelwinkelfilenaam>

   Sleutelhulpmiddel is geleë in die bin gids van jou Java-installasie. Die alias is die naam van die sleutel wat gebruik word om die toepassing te onderteken.
   b. Voer die wagwoord vir die sleutel in en druk Voer in.

3. Onder Sertifikaat vingerafdrukke, kopieer die SHA256 waarde.

Kry die Android API-sleutel

As u 'n Android -instelling geregistreer het en 'n app -handtekening verskaf het, kan u die API -sleutel van die registrasiebladsy vir u aanmelding met Amazon -toepassing haal. U moet die API -sleutel in 'n file in u Android -projek. Totdat u dit doen, is die app nie gemagtig om met die aanmelding met Amazon -magtigingsdiens te kommunikeer nie.

1. Gaan na https://login.amazon.com.
2. Klik App -konsole.
3. In die Aansoeke selekteer u
4. Vind u Android-app onder die Android-instellings afdeling (As jy nog nie 'n Android-toepassing geregistreer het nie, sien Voeg 'n Android-app vir Amazon Appstore by).
5. Klik Genereer API-sleutelwaarde. 'n Opspringvenster sal jou API vertoon Om die sleutel te kopieer, klik Kies Alles om die hele sleutel te kies.
   Let wel: Die API-sleutelwaarde is deels gebaseer op die tyd wat dit gegenereer word. Dus kan daaropvolgende API-sleutelwaarde (s) wat u genereer, verskil van die oorspronklike. U kan enige van hierdie API-sleutelwaardes in u app gebruik, aangesien dit almal geldig is.
6. Sien Voeg u API-sleutel by u projek vir instruksies oor die toevoeging van die API-sleutel tot u Android

Skep 'n aanmelding met Amazon Project

In hierdie afdeling leer u hoe u 'n nuwe Android-projek vir aanmelding met Amazon kan skep, die projek kan instel en kode by die projek kan voeg om 'n gebruiker aan te meld met Aanmelding met Amazon. Ons sal die stappe vir Android Studio beskryf, maar u kan analoogstappe toepas op enige IDE- of Android-ontwikkelingsinstrument van u keuse.

Hierdie gids vereis 'n begrip van Aktiwiteite – 'n sleutelkonsep van Android-toepassingsontwikkeling. Leer meer oor Aktiwiteite en Aktiwiteit Fragmente op developer.android.com.

Skep 'n nuwe aanmelding met Amazon Project

Volg die onderstaande instruksies om een ​​te skep as u nog nie 'n app-projek het om Login met Amazon te gebruik nie. Gaan na as u 'n bestaande program het Installeer die aanmelding met Amazon Library.

1. Begin Android
2. Van die File kieslys, kies Nuut en Projek.
3. Tik 'n Aansoek Naam en Maatskappy Naam vir jou
4. Voer die in Toepassing en Maatskappy Naam wat ooreenstem met die pakketnaam wat u gekies het toe u u program by Login by Amazon geregistreer het.
   Kies 'n as u nog nie u app geregistreer het nie Pakketnaam en volg dan die instruksies in die Registreer by Login by Amazon afdeling nadat jy jou projek geskep het. As die pakketnaam van jou toepassing nie ooreenstem met die geregistreerde pakketnaam nie, sal jou Aanmelding met Amazon-oproepe nie slaag nie.
5. Kies 'n Minimum vereiste SDK van API 11: Android 3.0 (Honeycomb) of hoër, en klik Volgende. Jy kan alternatiewelik a Minimum vereiste SDK van API 8: Android 2.2 (Froyo) of hoër wanneer die v4 Android-ondersteuningsbiblioteek.
6. Kies die tipe aktiwiteit wat u wil skep en klik Volgende.
7. Vul die tersaaklike besonderhede in en klik Voltooi.

U het nou 'n nuwe projek in u werkruimte wat u kan gebruik om Login met Amazon te noem.

Installeer die aanmelding met Amazon Library

As u nog nie die aanmelding met Amazon SDK vir Android afgelaai het nie, sien Installeer die aanmelding met Amazon SDK vir Android.

1. Die gebruik van die file stelsel op jou rekenaar, vind die aanmeld-met-amazon-sdk.jar file binne die Teken in met Amazon SDK vir Android. Kopieer dit na die knipbord.
2. Met jou projek oop in Android Studio, maak die Projek View.
3. Regskliek op die ouergids vir jou projek/toepassing in die Projek View en kies Plak.
4. Regskliek aanmeld-met-amazon-sdk.jar in die Projek View en kies Voeg as biblioteek by.

Stel netwerktoestemmings vir u program in

Om u app te kan aanmeld met Amazon, moet dit toegang tot die internet hê en toegang tot die inligting oor die netwerkstatus hê. U app moet hierdie toestemmings in u Android-manifes bevestig, as dit nog nie gebeur nie.

1. Van die Projek View, dubbelklik xml om dit oop te maak.
2. Kopieer die kodereëls wat hieronder vertoon word en plak dit in die xml file, buite die toepassingsblok:
   

   Example:
   

Voeg u API-sleutel by u projek

Wanneer u u Android-toepassing by Login by Amazon registreer, kry u 'n API-sleutel. Dit is 'n identifiseerder wat die Amazon-magtigingsbestuurder sal gebruik om u aansoek te identifiseer vir die Login met Amazon-magtigingsdiens. As u die Amazon Appstore gebruik om u app te onderteken, sal die Appstore outomaties die API-sleutel verskaf. As u nie die Amazon Appstore gebruik nie, laai die Amazon Authorization Manager hierdie waarde tydens die runtime vanaf die api_key.txt file in die bates gids.

1. Volg die instruksies in as u nog nie u API-sleutel het nie Kry die Android API-sleutel.
2. Van die Projek View regskliek in Android Studio op die bates-lêergids en klik dan Nuut en kies File. As jy nie 'n bates-lêergids het nie, klik met die rechtermuisknop op die ouergids vir jou projek en kies dan Nuut, Folder, Bates gids.
3. Noem die file api_key.txt.
4. Jy behoort nou 'n redigeervenster vir 'n teks te hê file genoem txt. Voeg u API-sleutel by die teks file.
5. In die File kieslys, klik Stoor.

Let wel: As 'n teksredigeerder ekstra karakters by jou api_key.txt voeg file (soos 'n Byte Order Mark), kan jy ERROR_ACCESS_DENIED sien wanneer jy probeer om aan die Login with Amazon-magtigingsdiens te koppel. As dit gebeur, probeer om enige voorste of agterste spasies, reëltoevoer of verdagte karakters te verwyder. (Bvample, 'n redigeerder wat Byte Order Mark gebruik, kan 0xEF 0xBB 0xBF of ander heksadesimale rye by die begin van jou api_key.txt voeg file). Jy kan ook probeer om 'n nuwe API-sleutel op te spoor.

Hanteer die konfigurasieveranderings vir u aktiwiteit

As 'n gebruiker die skermoriëntasie verander of die sleutelbordtoestand van die toestel verander terwyl hulle aanmeld, sal die huidige aktiwiteit weer begin. Hierdie herlaai sal die aanmeldskerm onverwags van die hand wys. Om dit te voorkom, moet u die aktiwiteit instel wat die magtigingsmetode gebruik om die konfigurasieveranderings handmatig te hanteer. Dit sal voorkom dat die aktiwiteit weer begin word.

1. In Pakket Verkenner, dubbelklik xml.
2. In die Toepassing afdeling, soek die aktiwiteit wat Aanmelding met Amazon sal hanteer (forexample, Hoofaktiwiteit),
3. Voeg die volgende eienskap by die aktiwiteit wat u in Stap 2 gevind het:
   

   android: configChanges = ”sleutelbord | sleutelbordversteek | oriëntasie”

   Of vir API 13 of hoër:

   android: configChanges = ”sleutelbord | sleutelbord versteek | oriëntasie | skermgrootte”

4. Van die File kieslys, klik Stoor

Nou, wanneer 'n sleutelbord- of toesteloriëntasieverandering plaasvind, sal Android die onConfigurationChanged-metode vir jou aktiwiteit oproep. Jy hoef nie hierdie funksie te implementeer nie, tensy daar 'n aspek van hierdie konfigurasieveranderings is wat jy vir jou program wil hanteer.

Voeg 'n WorkflowActivity by jou projek

As die gebruiker op die Login met Amazon -knoppie klik, sal die API 'n web blaaier om 'n aanmeld- en toestemmingsbladsy aan die gebruiker aan te bied. Om hierdie blaaieraktiwiteit te laat werk, moet jy die WorkflowActivity by jou manifes voeg.

As jy voorheen met die Login with Amazon SDK geïntegreer het of jy het die com.amazon.identity.auth.device.authorization.AuthorizationActivity-aktiwiteit wat in jou AndroidManifest.xml verklaar is, moet dit verwyder word en vervang word met die WorkflowActivity.

1. In Pakket Verkenner, dubbelklik AndroidMailfest.xml..
2. In die Toepassing afdeling, voeg die volgende kode by.
   

   <aktiwiteit android:naam= “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" />

   Let wel: As jy nie die Gradle-boustelsel gebruik nie, vervang ${applicationId} met jou pakketnaam vir hierdie toepassing.

Voeg 'n aanmelding met Amazon-knoppie by u program

Teken in met Amazon bied verskeie standaardknoppies wat jy kan gebruik om gebruikers aan te spoor om vanaf jou toepassing aan te meld. Hierdie afdeling gee stappe om 'n amptelike aanmelding met Amazon-beeld af te laai en dit met 'n Android ImageButton te koppel.

1. Voeg 'n standaard ImageButton by u program.
   Vir meer inligting oor Android-knoppies en die ImageButton-klas, sien Knoppies op developer.android.com.

2. Gee jou knoppie 'n In die knoppie XML-verklaring, stel die android:id-kenmerk na @+id/login_with_amazon. Byvoorbeeldample:
   

   android: id = ”@ + id / login_with_amazon”

3. Kies 'n knoppiebeeld.
   Raadpleeg ons aanmelding by Amazon Stylriglyne vir 'n lys knoppies wat jy in jou toepassing kan gebruik.
   Laai 'n kopie af van die LWA_Android.zip file. Pak 'n afskrif van u knoppie uit vir elke skermdigtheid wat u app ondersteun (xxhdpi, xhdpi, hdpi, mdpi of tvdpi). Vir meer inligting oor die ondersteuning van verskeie skermdigthede in Android, sien Alternatiewe uitlegte in die onderwerp "Ondersteuning vir meerdere skerms" ondeveloper.android.com.
4. Kopieer die toepaslike knoppiebeeld files aan jou projek.
   Kopieer die afgelaaide knoppie vir elke skermdigtheid wat u ondersteun (xhdpi, hdpi, mdpi of ldpi) na die res / tekenbaar gids vir die skermdigtheid.
5. Verklaar die knoppiebeeld.
   In die knoppie XML-verklaring, stel die Android: src toeskryf aan die naam van die knoppie wat jy gekies het. Byvoorbeeldample:

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

6.  Laai jou toepassing en verifieer dat die knoppie nou 'n Aanmelding met Amazon-beeld het.
   U moet seker maak dat die knoppie behoorlik vertoon vir elke skermdigtheid wat u ondersteun

Gebruik die SDK vir Android API's

In hierdie afdeling voeg u kode by u projek om 'n gebruiker aan te meld met Login met Amazon.

Hanteer die aanmeldknoppie en magtig die gebruiker

Hierdie afdeling verduidelik hoe om die magtiging-API te roep om 'n gebruiker aan te meld. Dit sluit in die skep van 'n op klik luisteraar vir jou Teken in met Amazon knoppie in die op Skep metode van jou toepassing.

1. Voeg Login met Amazon by jou Android See Installeer die aanmelding met Amazon Library.
2. Inisialiseer Versoekkonteks.
   Jy sal moet verklaar a Versoekkonteks veranderlike en skep 'n nuwe instansie van die klas. Die beste plek om te inisialiseer Versoekkonteks is in die op Skep metode van jou Android-aktiwiteit of fragment. Byvoorbeeldample:

   private RequestContext requestContext; @Oorskryf beskermde leemte onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); requestContext = RequestContext.create(hierdie); }

3. Skep 'n AuthorizeListener.
   AuthorizeListener sal die resultaat van die verwerk magtigingsoproep. Dit bevat drie metodes: op sukses, op fout, en opKanselleer. Skep die AuthorizeListener koppelvlak in lyn met 'n registreer Luisteraar bel in die op Skep metode van jou Android-aktiwiteit of fragment.

   @Oorskryf beskermde leemte onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); requestContext = RequestContext.create(hierdie);requestContext.registerListener(new AuthorizeListener() { / * Magtiging is suksesvol voltooi. * / @Oorskryf publieke void onSuccess(AuthorizeResult result) { /* Jou toepassing is nou gemagtig vir die gevraagde omvang */ } /* Daar was 'n fout tydens die poging om die aansoek te magtig. */ @Oorskryf openbare leemte onError (AuthError ae) { / * Stel die gebruiker in kennis van die fout * / } /* Magtiging is gekanselleer voordat dit voltooi kon word. */ @Oorskryf publieke void onCancel(AuthCancellation cancellation) { /* Stel die UI terug na 'n gereed-vir-aanmelding-toestand */ } }); }

   Let wel: As jy 'n fragment gebruik en verwysings na View voorwerpe in jou AuthorizeListener implementering, skep AuthorizeListener in die op SkepView metode in plaas van op Skep. Dit verseker die View objekverwysings word gestel wanneer die oproep na magtig afwerkings.

4. Implementeer op sukses, op fout, en onKanselleer vir jou AuthorizeListener.
   Omdat die magtigingsproses 'n aanmeldskerm (en moontlik 'n toestemmingsskerm) aan die gebruiker in 'n web blaaier (of a WebView), sal die gebruiker die geleentheid hê om die aanmelding te kanselleer of weg te navigeer. As hulle die aanmeldproses uitdruklik kanselleer, onKanselleer genoem word, en jy sal jou gebruikerskoppelvlak wil terugstel.
   As die gebruiker wegbeweeg van die aanmeldskerm in die blaaier of WebView, skakel dan terug na jou program, sal die SDK nie bespeur dat die aanmelding nie voltooi is nie. As jy gebruikeraktiwiteit in jou toepassing bespeur voordat aanmelding voltooi is, kan jy aanvaar dat hulle van die blaaier af weggenavigeer het en dienooreenkomstig reageer.
5. Bel RequestContext.onResume.
   Om die Android-toepassinglewensiklus te akkommodeer, implementeer die op Hervat metode in jou aktiwiteit of fragment. Dit sal alle luisteraars wat by geregistreer is aktiveer registreer Luisteraar in die geval dat jou toepassing deur die bedryfstelsel gesluit word voordat die gebruiker 'n magtigingsvloei voltooi het.

   @Oorskryf beskermde leemte onResume () { super.onResume (); requestContext.onResume(); }

6. Bel AuthorizationManager.authorize.
   In die op klik hanteerder vir jou Login with Amazon-knoppie, bel magtiging om die gebruiker te vra om aan te meld en jou aansoek te magtig.
   Met hierdie metode kan die gebruiker op een van die volgende maniere aanmeld en toestem tot die gevraagde inligting:
   1. Skakel oor na die stelselblaaier
   2. Skakel oor na WebView in 'n veilige konteks (as die Amazon Shopping -app op die toestel geïnstalleer is)
   Die veilige konteks vir die tweede opsie is beskikbaar wanneer die Amazon Shopping-toepassing op die toestel geïnstalleer is. Amazon-geskepte toestelle met Fire OS (bvample Kindle Fire, Fire Phone en Fire TV) gebruik altyd hierdie opsie, selfs al is daar geen Amazon Shopping-toepassing op die toestel nie. As gevolg hiervan, as die gebruiker reeds by die Amazon Shopping-toepassing aangemeld is, sal hierdie API die aanmeldbladsy oorslaan, wat lei tot 'n Enkelaanmelding ervaring vir die gebruiker. Sien klante-ervaring in kliënt-ervaring-android programme om meer te wete te kom. Wanneer jou aansoek gemagtig is, is dit gemagtig vir een of meer datastelle bekend as bestekke. 'n Omvang sluit die gebruikerdata in wat u van Login with Amazon versoek. Die eerste keer dat 'n gebruiker by jou toepassing aanmeld, sal 'n lys van die data wat jy versoek en vir goedkeuring gevra word aan hulle gegee word. Aanmelding by Amazon ondersteun tans die volgende omvang:

   Besteknaam	Beskrywing
   profile	Verleen toegang tot die gebruiker se naam, e-posadres en Amazon-rekening-ID.
   profile: user_id	Verleen slegs toegang tot die gebruiker se Amazon-rekening-ID.
   poskode	Gee toegang tot die poskode van die gebruiker file vir hul Amazon -rekening.

   AuthorizationManager.authorize is 'n asynchrone oproep, so jy hoef nie die UI-draad te blokkeer of 'n werkersdraad van jou eie te skep nie. Om te bel magtiging, slaag 'n AuthorizeRequest voorwerp wat gebou kan word deur gebruik te maak AuthorizeRequest.Builder:
   

   @Oorskryf beskermde leemte onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); / * Vorige op Skep verklarings weggelaat * /// Soek die knoppie met die login_with_amazon ID // en stel 'n klikhanteerder op View loginButton = vindViewById(R.id.login_with_amazon); loginButton.setOnClickListener(nuut View.OnClickListener() { @Oorskryf openbare leemte onClick (View v) { AuthorizationManager.authorize(nuwe AuthorizeRequest Builder(requestContext).addScopes(ProfileScope.profile(), ProfileScope.postalCode()) .bou()); }); }

Haal User Profile Data

Hierdie afdeling verduidelik hoe om die gebruikers-API te gebruik om 'n gebruiker se pro te herwinfile data nadat hulle gemagtig is. Die profile data wat u kan ophaal, is gebaseer op die omvang wat in die magtig:withHandler: bel.

1. Bel Gebruiker.haal.
   Gebruiker.haal gee die gebruiker se pro terugfile data aan jou deur die Luisteraar OuteurFout> terugbel. Luisteraar OuteurFout> bevat twee metodes: onSukses en opFout (dit ondersteun nie onKanselleer omdat daar geen manier is om a te kanselleer nie Gebruiker.haal bel). onSukses ontvang 'n Gebruikersobjek met profile data, terwyl opFout ontvang 'n AuthFout beswaar met inligting oor die fout. updateProfileData is 'n eksample van 'n funksie wat jou toepassing kan implementeer om pro te vertoonfile data in die gebruikerskoppelvlak
   Let wel: User.getUserPostalCode word slegs teruggestuur as jy die Pro versoekfileScope.postalCode() omvang.

Kyk of die gebruiker by Startup aanmeld

As 'n gebruiker by u app aanmeld, die app sluit en die app later weer begin, is die app steeds gemagtig om data op te haal. Die gebruiker word nie outomaties uitgeteken nie. By die opstart kan u die gebruiker as aangemeld wys as u app steeds gemagtig is. Hierdie afdeling verduidelik hoe om dit te gebruik getToken om te sien of die app nog steeds gemagtig is.

1. Bel getToken.
   In die aanvang metode van jou aktiwiteit of fragment, bel getToken om te sien of die aansoek steeds goedgekeur is. getToken haal die rou toegangsteken op wat die Magtigingsbestuurder gebruik om toegang tot 'n gebruiker profile. As die tekenwaarde nie nul is nie, is die toepassing steeds gemagtig en kan u voortgaan om gebruikerpro te gaan haalfile data. getToken vereis dieselfde omvang wat u gevra het in u oproep om te magtig.
   getToken ondersteun asynchrone oproepe op dieselfde manier as User.fetch, dus hoef jy nie die UI-draad te blokkeer of 'n werkdraad van jou eie te skep nie. Om te bel getToken asynchronies, slaag 'n voorwerp wat die ondersteun Luisteraar koppelvlak as die laaste parameter.
2. Verklaar a Luisteraar OuteurFout>. Jou implementering van die Luisteraar AuthError>-koppelvlak verwerk die resultaat van die getToken bel. Luisteraar bevat twee metodes: onSukses en opFout (dit ondersteun nie onKanselleer omdat daar geen manier is om a te kanselleer nie getToken bel).
3. Implementeer onSukses en opFout vir jou Luisteraar . op sukses ontvang 'n Magtigresultaat voorwerp met 'n toegangsteken, terwyl opFout ontvang 'n AuthFout beswaar met inligting oor die fout.
   

   @Oorskryf beskermde leemte onStart(){ super.onStart(); Omvang[] omvang = { ProfileScope.profile(), ProfileScope.postalCode() }; AuthorizationManager.getToken(hierdie, omvang, nuut Luisteraar () {@Oorskryf publieke leemte opSukses(AuthorizeResult result) { if (result.getAccessToken() != null) { /* Die gebruiker is aangemeld */ } anders { /* Die gebruiker is nie aangemeld nie */ } } @Oorskryf openbare leemte onError (AuthError ae) { /* Die gebruiker is nie aangemeld nie */ } }); }

Wis magtigingsdata uit en meld 'n gebruiker uit

Hierdie afdeling verduidelik hoe om die afmeldmetode te gebruik om die gebruiker by jou program af te meld. Die gebruiker sal weer moet aanmeld sodat die toepassing pro kan herwinfile data. Gebruik hierdie metode om by 'n gebruiker af te meld of om aanmeldprobleme in die app op te los.

1. Implementeer 'n afmeldmeganisme.
   As 'n gebruiker suksesvol aangemeld het, moet u 'n afmeldmeganisme verskaf sodat hulle hul pro kan verwyderfile data en voorheen gemagtigde bestekke. Jou meganisme kan 'n hiperskakel, knoppie of 'n menu-item wees. Vir hierdie example, ons sal 'n skep op klikmetode vir 'n knoppie.
2. Bel teken uit.
   Bel teken uit in jou afmeldhanteerder om 'n gebruiker se magtigingsdata (toegangtokens, profile) van die plaaslike winkel. teken uit neem 'n Android-konteks en 'n Luisteraar AuthError>aan sukses of mislukking hanteer.
3. Verklaar 'n anonieme Luisteraar OuteurFout>.
   Jou implementering van Listener OuteurFout> verwerk die resultaat van die teken uit bel. Anonieme klasse is nuttig om veranderlikes van die omsluitende omvang vas te vang.
   Sien Hanteer die aanmeldknoppie en magtig die gebruiker vir 'n examplaat dit verklaar luisteraarsklasse.
4. Implementeer onSukses en opFout vir jou Luisteraar OuteurFout>.
   Wanneer tekenOutsukses jy moet jou UI opdateer om verwysings na die gebruiker te verwyder, en 'n aanmeldmeganisme verskaf wat gebruikers kan gebruik om weer aan te meld. As teken Uitkomste 'n fout, kan u die gebruiker weer probeer afmeld.

   @Oorskryf beskermde leemte onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); / * Vorige op Skep verklarings weggelaat * /// Soek die knoppie met die afmeld-ID en stel 'n klikhanteerder op View logoutButton = vindViewById(R.id.logout); logoutButton.setOnClickListener(nuut View.OnClickListener() {@Oorskryf openbare leemte onClick (View v) { AuthorizationManager.signOut(getApplicationContext(), nuut Luisteraar () { @Oorskryf publieke leemte op sukses (ongeldige reaksie) { // Stel die afgemelde toestand in UI } @Oorskryf openbare leemte onError (AuthError authError) { // Teken die fout aan } }); } }); }

Meld aan met Amazon Aan die gang-gids vir Android-toepassings – Aflaai [geoptimaliseer]
Meld aan met Amazon Aan die gang-gids vir Android-toepassings – Laai af