Skráðu þig inn með Amazon Byrjunarleiðbeiningar fyrir Android

Skráðu þig inn með Amazon: Handbók fyrir Android
Höfundarréttur © 2016 Amazon.com, Inc., eða hlutdeildarfélag þess. Allur réttur áskilinn. Amazon og Amazon merkið eru vörumerki Amazon.com, Inc. eða hlutdeildarfélaga þess. Öll önnur vörumerki sem ekki eru í eigu Amazon eru eign viðkomandi eigenda.

Að byrja fyrir Android

Í þessari handbók munum við sýna þér hvernig á að bæta við Login með Amazon í Android appið þitt. Að lokinni þessari handbók ættirðu að hafa virkan Innskráningu með Amazon hnappinn í appinu þínu til að leyfa notendum að skrá sig inn með Amazon persónuskilríki.

Setja upp Android Developer Tools

Innskráningin með Amazon SDK fyrir Android mun hjálpa þér að bæta Innskráningu með Amazon við Android forritið þitt. Við mælum með að þú notar Innskráning með Amazon SDK fyrir Android frá developer.amazon.com með Android Studio. Þú getur þó einnig notað myrkvann með ADT viðbótinni. Fyrir skref um hvernig á að setja upp Android Studio og um hvernig á að setja upp Android SDK, sjá Sæktu Android SDK á developer.android.com.

Þegar Android SDK er sett upp skaltu finna SDK framkvæmdastjóri forritið í Android uppsetningunni þinni. Til að þróa til innskráningar með Amazon verður þú að nota SDK Manager til að setja upp SDK Platform fyrir Android 2.2 eða nýrri (API útgáfa 8). Sjá Bætir við SDK pakka á developer.android.com til að fá frekari upplýsingar um notkun SDK

Eftir að SDK hefur verið sett upp skaltu setja upp Android Virtual Device (AVD) til að keyra forritin þín. Sjá Stjórna Sýndartæki á developer.android.com til að fá leiðbeiningar um að setja upp sýndartæki.

Þegar þróunarumhverfi þitt er komið upp geturðu það Settu inn innskráningu með Amazon SDK fyrir Android or Keyra Sample App, eins og lýst er hér að neðan.

Settu inn innskráningu með Amazon SDK fyrir Android

Innskráningin með Amazon SDK fyrir Android kemur í tveimur pakka. Sú fyrsta inniheldur Android bókasafnið og fylgiskjöl. Annað inniheldur semample forritið sem gerir notanda kleift að skrá sig inn og sýna atvinnumann sinnfile gögn.

Ef þú hefur ekki þegar sett upp Android SDK eða Android Development Tools, sjáðu Er að setja upp Android Developer Tools kafla hér að ofan.

1. Sækja zip og draga úr files í möppu á harða disknum þínum.
   Þú ættir að sjá a doc og a lib undirskrá.
2. Opið doc / index.html til view innskráninguna með Amazon Android API
3. Sjá Settu inn innskráninguna með Amazon bókasafninu, fyrir leiðbeiningar um hvernig bæta á bókasafninu og skjölum við Android

Þegar innskráningin með Amazon SDK fyrir Android er sett upp geturðu gert það Búðu til nýja innskráningu með Amazon Verkefni, eftir Skráning með innskráningu hjá Amazon .

Keyra Sample App

Til að keyra sample umsókn, flytja inn sample inn í AndroidStudio vinnusvæði (ef þú ert að nota Eclipse verður þú einnig að bæta sérsniðinni kembiforritaskrá við vinnusvæðið. Sjáðu Bættu við sérsniðnu kembiforritinu Keystore í myrkva kafla hér að neðan). API lykillinn sem sampLe forritsnotkun krefst þess að vinnusvæðið noti lyklabúðina sem er með sample. Ef sérsniðna lyklageymslan er ekki sett upp munu notendur ekki geta skráð sig inn með sample. Lykilverslunin verður sjálfkrafa sótt ef þú notar AndroidStudio.

1. Sækja SampleLoginWithAmazonAppForAndroid-src.zip og draga úr files í möppu á harða þinni
2. Byrjaðu Android Studio og veldu Opnaðu núverandi Android Studio verkefni
   
3. Flettu að SampleLoginWithAmazonApp skrá fengin eftir að hafa hlaðið niður zip file í Skref
4. Frá Byggja valmynd, smelltu Gerðu verkefni, og bíddu eftir að verkefnið klárist
5. Frá Hlaupa valmynd, smelltu Hlaupa og smelltu svo á SampleLoginWithAmazonApp.
6. Veldu keppinautinn eða tengt Android tæki og smelltu á Hlaupa.

Bættu við Custom Debug Key versluninni í myrkva

Ef þú notar Eclipse skaltu fylgja leiðbeiningunum hér að neðan til að bæta við sérsniðnu villuleitarforritinu:

1. Í Óskir valmynd, veldu Android og Byggja.
2. Við hliðina á Sérsniðin Aflúsaðu Keystore, smelltu Skoðaðu.
3. Sigla til sample app möppuna og veldu 3p.lyklageymslu, og smelltu svo á OK.

Skráning með innskráningu hjá Amazon

Áður en þú getur notað Innskráning með Amazon á a websíðu eða í farsímaforriti, þú verður að skrá forrit með Innskráning með Amazon. Innskráning þín með Amazon forritinu er skráningin sem inniheldur grunnupplýsingar um fyrirtækið þitt og upplýsingar um hvert websíða eða farsímaforrit sem þú býrð til sem styður innskráningu með Amazon. Þessar viðskiptaupplýsingar eru birtar notendum í hvert sinn sem þeir nota Innskráning með Amazon á þínu webvef eða farsímaforrit. Notendur munu sjá nafn forritsins þíns, lógóið þitt og krækju á persónuverndarstefnu þína. Þessi skref sýna hvernig á að skrá innskráningu með Amazon forriti og bæta Android forriti við þann reikning.

Sjáðu eftirfarandi efni:

• Skráðu þig inn með Amazon forritinu
• Skráðu Android forritið þitt
  • Bættu við Android forriti fyrir Amazon Appstore
  • Bættu við Android forriti án Appstore
• Undirskrift Android forrita og API lyklar
  • Að ákvarða undirskrift Android forrits
  • Sækir Android API lykil

Skráðu þig inn með Amazon forritinu

1. Farðu til https://login.amazon.com.
2. Ef þú hefur skráð þig inn á Amazon áður, smelltu á Forrit hugbúnaðar. Annars smelltu Skráðu þig. Þú verður vísað til Seller Central, sem sér um skráningu umsókna um innskráningu með Ef þetta er í fyrsta skipti sem þú notar Seller Central, verður þú beðinn um að stofna Seller Central reikning.
3. Smelltu Skráðu nýja umsókn. The Skráðu umsókn þína eyðublað mun birtast:
   a. Í Skráðu umsókn þína form, sláðu inn a Nafn og a Lýsing fyrir umsókn þína.
   The Nafn er nafnið sem birtist á samþykkisskjánum þegar notendur samþykkja að deila upplýsingum með forritinu þínu. Þetta nafn á við um Android, iOS og webvefútgáfur af forritinu þínu.
   b. Sláðu inn a Persónuverndartilkynning URL fyrir umsókn þína
   The Persónuverndartilkynning URL er staðsetning persónuverndarstefnu fyrirtækis þíns eða forrits (tdample, http://www.example.com/privacy.html). Þessi hlekkur birtist notendum á samþykkisskjánum.
   c. Ef þú vilt bæta við a Logo mynd fyrir umsókn þína, smelltu Skoðaðu og finndu viðeigandi mynd.
   Þetta merki birtist á innskráningar- og samþykkisskjánum til að tákna fyrirtæki þitt eða websíðu. Merkið verður skreppt í 50 pixla á hæð ef það er hærra en 50 pixlar; það er engin takmörkun á breidd merkisins
4. Smelltu Vista. Þitt sampskráningin ætti að líta svipað út:
   
   Eftir að grunnstillingar forrita eru vistaðar geturðu bætt við stillingum fyrir sérstakar webvefsíður og farsímaforrit sem munu nota þessa innskráningu með Amazon reikningi.

Skráðu Android forritið þitt

Til að skrá Android forrit hefurðu val um að skrá forrit í gegnum Amazon Appstore (Bættu við Android forriti fyrir Amazon Appstore, bls. 8) eða beint með innskráningu með Amazon (Bættu við Android App Án Appstore, bls. 9). Þegar forritið þitt er skráð hefurðu aðgang að API lykli sem veitir forriti þínu aðgang að Innskráningu með Amazon heimildarþjónustu.

Athugið: Ef þú ætlar að nota Amazon tækjaskilaboð í Android forritinu þínu, vinsamlegast hafðu samband lwa- support@amazon.com með:

• Netfang Amazon reikningsins sem þú notaðir til að skrá þig til innskráningar hjá Amazon.
• Netfang Amazon reikningsins sem þú notaðir til að skrá þig í Amazon Appstore (ef öðruvísi).
• Nafnið á aðalreikning seljanda þíns. (Smelltu á Seller Central Stillingar> Reikningsupplýsingar> Upplýsingar um seljanda, og notaðu Sýna nafn).
• Nafnið á Amazon Appstore verktaki reikningnum þínum. (Smelltu á dreifingarsíðu farsímaforrita Stillingar > Fyrirtæki Profile og nota Nafn hönnuðar eða nafn fyrirtækis).

Bættu við Android forriti fyrir Amazon Appstore

Eftirfarandi skref munu bæta Amazon Appstore app við innskráninguna þína með Amazon reikningi:

1. Smelltu á forritaskjáinn Stillingar Android. Ef þú ert þegar með Android app skráð skaltu leita að Bæta við API lykli hnappinn í Stillingar Android
   The Upplýsingar um Android forrit eyðublað mun birtast:
2. Veldu Já sem svar við spurningunni „Er þessu forriti dreift í gegnum Amazon Appstore?“
3. Sláðu inn Merki af Android forritinu þínu. Þetta þarf ekki að vera opinbert nafn forritsins þíns. Það auðkennir einfaldlega þetta tiltekna Android app meðal forrita og webvefsvæði skráð í Innskráningu þína með Amazon forriti.
4. Bættu við þínum Auðkenni Amazon Appstore.
5. Ef þú undirritaðir forritið þitt sjálf / n skaltu bæta við sjálfum undirskriftarupplýsingum. Þetta gerir þér kleift að fá API lykil meðan á þróun stendur án þess að nota Appstore beint:
   a. Ef forritið þitt er ekki undirritað í gegnum Amazon Appstore skaltu velja Já sem svar við spurningunni „Er þetta forrit sjálf undirritað?“
   The Upplýsingar um Android forrit form mun stækka:
   
   b. Sláðu inn þinn Heiti pakka.
   Þetta verður að samsvara pakkaheiti Android verkefnisins þíns. Til að ákvarða pakkaheiti Android Project þíns skaltu opna verkefnið að eigin vali á Android verktaki.
   Opið AndroidManifest.XML í Package Explorer og veldu Auglýst flipa. Fyrsta færslan er heiti pakkans.
   c. Sláðu inn forritið Undirskrift.
   Þetta er SHA-256 kjötkássa gildi notað til að staðfesta umsókn þína. Undirskriftin verður að vera í formi 32 sextándapara aðskilin með ristlum (tdample: 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: 3:45:67:89:a b:cd:ef). Sjá Undirskrift Android forrita og API lyklar fyrir skref sem þú getur notað til að draga undirskriftina úr verkefninu þínu.
6. Smelltu Vista.

Ef mismunandi útgáfur af forritinu þínu eru með mismunandi undirskrift eða pakkaheiti, svo sem fyrir eina eða fleiri prófunarútgáfur og framleiðsluútgáfu, þarf hver útgáfa sinn eigin API lykil. Frá Stillingar Android smellt á forritið þitt Bæta við API lykli hnappinn til að búa til viðbótarlykla fyrir forritið þitt (einn í hverri útgáfu).

Undirskrift Android forrita og API lyklar

Forrit undirskrift er SHA-256 kjötkássugildi sem er beitt á hvert Android forrit þegar það er smíðað. Amazon notar undirskrift forritsins til að smíða API lykilinn þinn. API lykillinn gerir Amazon þjónustu kleift að þekkja forritið þitt. Ef þú notar Amazon Appstore til að undirrita forritið þitt er API lykillinn gefinn sjálfkrafa. Ef þú ert ekki að nota Amazon Appstore þarftu að stjórna API lyklinum þínum handvirkt.

Undirskrift forrita er geymd í lyklageymslu. Almennt, fyrir Android forrit er kembiforrit verslunar og útgáfu lyklageymsla. Villuleitarlykillinn er búinn til með viðbótarþróunartækinu fyrir Android fyrir Eclipse og er sjálfgefið. Þú getur fundið staðsetningu kembiforritanna í Eclipse með því að smella Gluggi, og velur síðan Óskir> Android> Byggja. Frá þeim skjá er einnig hægt að bæta við eigin villuleitarforrit. Fyrir Android Studio, frá Byggja valmynd, veldu Breyttu gerð bygginga, farðu síðan í Undirritun flipann og finndu villuleitarforritið í Verslun File sviði.

Útgáfulaus geymsla er venjulega búin til þegar þú flytur út Android forritið þitt til að búa til undirritaðan APK file.

Með útflutningsferlinu, ef þú ert að búa til nýja útgáfu lykilverslun, munt þú velja staðsetningu þess. Eftir

sjálfgefið það verður sett á sama stað og sjálfgefið villuleitar KeyStore.

Ef þú hefur skráð forritið þitt með kembiforritinu meðan á þróun stendur, verður þú að bæta við nýrri Android stillingu við forritið þitt þegar þú ert tilbúinn að gefa út forritið. Nýja forritastillingin verður að nota undirskriftina frá útgáfulyklageymslunni.

Sjá Undirritun umsókna þinna á developer.android.com til að fá frekari upplýsingar.

Ákveðið undirskrift Android forritsins

1. Ef þú ert með undirritaðan APK file:
   a. Pakkaðu upp APK file og þykkni CERT.RSA. (Þú getur endurnefnt APK viðbótina í ZIP ef nauðsyn krefur).
   b. Haltu frá stjórnlínunni:

   lyklaborð -prentprent -file CERT.RSA

   Keytoolis staðsett í bin skrá yfir Java uppsetningu þína.

2. Ef þú ert með lyklabúð file:
   a. Haltu frá stjórnlínunni:

   keytool -list -v -alias -keyraverslunfilenafn >

   Lyklatól er staðsett í ruslakörfu Java uppsetningar þinnar. Samnefnið er heiti lykilsins sem notaður er til að undirrita forritið.
   b. Sláðu inn lykilorð fyrir lykilinn og ýttu á Sláðu inn.
3. Undir Fingraför skírteina, afritaðu SHA256 gildi.

Sækja Android API lykilinn

Þegar þú hefur skráð Android stillingu og gefið upp undirskrift forrits geturðu sótt API lykilinn af skráningarsíðunni fyrir innskráningu þína með Amazon forriti. Þú verður að setja API lykilinn í a file í Android verkefninu þínu. Fyrr en þú gerir það hefur forritið ekki heimild til að eiga samskipti við innskráningu með Amazon leyfisþjónustu.

1. Farðu til https://login.amazon.com.
2. Smelltu Forrit hugbúnaðar.
3. Í Umsóknir kassi til vinstri, veldu þinn
4. Finndu Android forritið þitt undir Stillingar Android (Ef þú hefur ekki enn skráð Android app, sjáðu Bættu við Android forriti fyrir Amazon Appstore).
5. Smelltu Búðu til API lykilgildi. Sprettigluggi birtir API lykilinn þinn. Smelltu til að afrita lykilinn Veldu Allt að velja allt
   Athugið: API lykilgildið byggir að hluta á þeim tíma sem það er búið til. Þannig geta síðari API lykilgildi sem þú býrð til verið frábrugðin upprunalegu. Þú getur notað öll þessara API lykilgilda í forritinu þínu þar sem þau eru öll gild.
6. Sjá Bættu API lyklinum við verkefnið fyrir leiðbeiningar um að bæta API lyklinum við Android þinn

Að búa til innskráningu með Amazon Project

Í þessum kafla lærirðu hvernig á að búa til nýtt Android verkefni fyrir Innskráningu með Amazon, stilla verkefnið og bæta kóða við verkefnið til að skrá sig inn notanda með Innskráningu með Amazon. Við munum lýsa skrefunum fyrir Android Studio, en þú getur beitt hliðstæðum skrefum á hvaða IDE eða Android þróunartæki sem þú velur.

Sjáðu eftirfarandi efni:

• Búðu til nýja innskráningu með Amazon Project
• Settu upp innskráninguna með Amazon bókasafninu
  • Virkja Content Assist fyrir innskráningu með Amazon bókasafninu
• Stilltu netheimildir fyrir forritið þitt
• Bættu API lyklinum við verkefnið
  • Fjarlægðu Sample App sérsniðin villuleitarlyklaverslun
• Meðhöndla stillingar breytingar fyrir virkni þína
• Bættu við heimildarvirkni við verkefnið þitt
• Bættu við innskráningu með Amazon hnappi í forritið þitt
• Meðhöndlaðu innskráningarhnappinn og fáðu þér Profile Gögn
• Athugaðu hvort notandi sé skráður í gangsetningu
• Hreinsaðu leyfisríki og skráðu þig út notanda
• Hringdu í Amazon Authorization Manager Methods samstillt

Búðu til nýja innskráningu með Amazon Project

Ef þú ert ekki enn með forritverkefni til að nota Innskráning með Amazon skaltu fylgja leiðbeiningunum hér að neðan til að búa til eitt. Ef þú ert með forrit sem er til skaltu hoppa til Settu upp innskráninguna með Amazon bókasafninu .

1. Ræsa Android þróunarverkfæri.
2. Frá File valmynd, veldu Nýtt og Verkefni.
3. Sláðu inn Nafn umsóknar og Nafn fyrirtækis fyrir þína
4. Sláðu inn Umsókn og nafn fyrirtækis samsvarar pakkaheitinu sem þú valdir þegar þú skráðir forritið þitt með Innskráningu hjá Amazon.
   Ef þú hefur ekki skráð forritið þitt ennþá skaltu velja a Nafn pakka og fylgdu síðan leiðbeiningunum í Skráning með innskráningu hjá Amazon kafla eftir að þú hefur búið til verkefnið. Ef pakkaheiti forritsins þíns passar ekki við skráð pakkaheiti tekst innskráning þín með Amazon símtölum ekki.
5. Veldu a Lágmarks krafist SDK af API 8: Android 2 (Froyo) eða hærra og smelltu á Næst.
6. Veldu tegund aðgerðar sem þú vilt búa til og smelltu á Næst.
7. Fylltu út viðeigandi upplýsingar og smelltu Ljúktu.

Þú verður nú með nýtt verkefni á vinnusvæðinu þínu sem þú getur notað til að hringja í Login með Amazon.

Settu upp innskráninguna með Amazon bókasafninu

Ef þú hefur ekki enn hlaðið niður innskráningu með Amazon SDK fyrir Android, sjáðu Settu inn innskráninguna með Amazon SDK fyrir Android (bls. 4).

1. Með verkefnið þitt opið í Android Developer Tools, í Project Explorer, hægrismelltu á þinn Verkefni.
2. Ef mappa heitir libs er ekki þegar til staðar, skapa
3. Afritaðu innskráning-með-amazon-sdk.jar file frá File Kerfi, og límdu það síðan í libs skrá undir verkefninu / appinu þínu.
4. Hægri smelltu innskráning-með-amazon-sdk.jar, og athugaðu Bæta við sem bókasafni

Virkja innihaldshjálp fyrir innskráningu með Amazon bókasafninu í myrkva

Til að gera kleift að styðja við efnið Eclipse í Android verkefni þarf að nota a .eignir file. Nánari upplýsingar um efnisaðstoð, sjá Innihald / kóðaaðstoð onhelp.eclipse.org.

Til að gera kleift að styðja við efnið Eclipse í Android verkefni þarf að nota a .eignir file. Nánari upplýsingar um efnisaðstoð, sjá Innihald / kóðaaðstoð onhelp.eclipse.org.

1. In Windows Explorer, farðu að skjöl möppu fyrir Innskráning með Amazon SDK fyrir Android og afritaðu möppuna í
2. Með opið verkefni, farðu til Pakki Explorer og veldu libs Smelltu Breyta úr aðalvalmyndinni og veldu Líma. Þú ættir nú að hafa a libs \ docs skrá.
3. Veldu libs Smelltu File úr aðalvalmyndinni og veldu Nýtt ogFile.
4. Í Nýtt File glugga, slá inn login-with-amazon-sdk.jar.eignir og smelltu Ljúktu.
5. Myrkvi ætti að opna login-with-amazon-sdk.jar.eignir í textaritlinum. Í textaritlinum skaltu bæta eftirfarandi línu við file:
   

   doc = docs

6. Frá File valmynd, smelltu Vista.
7. Þú gætir þurft að endurræsa Eclipse til að breytingarnar taki gildi

Stilltu netheimildir fyrir forritið þitt

Til þess að forritið þitt geti notað Innskráningu með Amazon verður það að fá aðgang að internetinu og fá aðgang að upplýsingum um stöðu ríkisins. Forritið þitt verður að fullyrða um þessar heimildir í Android manifestinu þínu, ef það er það ekki þegar.

ATH: Aðferðarskrefin hér að neðan eru sértæk til að bæta við heimildunum í myrkva. Ef þú ert að nota Android Studio eða aðra IDE geturðu sleppt öllum númeruðum skrefunum hér að neðan. Afritaðu í staðinn kóðalínurnar sem birtast fyrir neðan skjámyndina og límdu þær í AndroidManifest.xml file, utan umsóknarblokksins.

1. In Pakki Landkönnuður, tvísmelltu xml.
2. Á Heimildir flipa, smelltu Bæta við.
3. Veldu Notar heimild og smelltu OK.
4. Hægra megin við Heimildir, finndu Eiginleikar fyrir notkun leyfis
5. Í Nafn kassi, sláðu inn leyfi. INTERNET eða veldu það úr fellivalmyndinni.
6. Á Heimildir flipa, smelltu Bæta við
7. Veldu Notar heimild og smelltu OK.
8. Í Nafn kassi, sláðu inn leyfi.ACCESS_NETWORK_STATE eða veldu það úr fellivalmyndinni
9. Frá File valmynd, smelltu Vista.
   Núverandi heimildir þínar ættu nú að hafa eftirfarandi gildi:
   
   Í AndroidManifest.xml flipann, ættirðu nú að sjá þessar færslur undir manifest frumefninu:

Bættu API lyklinum við verkefnið

Þegar þú skráir Android forritið þitt með Innskráningu hjá Amazon er þér úthlutað API lykli. Þetta er auðkenni sem Amazon Authorization Manager mun nota til að bera kennsl á umsókn þína við Innskráningu með Amazon heimildarþjónustu. Ef þú ert að nota Amazon Appstore til að undirrita forritið þitt mun Appstore útvega API lykilinn sjálfkrafa. Ef þú ert ekki að nota Amazon Appstore, hleður Amazon heimildarstjóri þessu gildi á keyrslu frá api_key.txt file í eignir skrá.

1. Ef þú ert ekki með API lykilinn ennþá skaltu fylgja leiðbeiningunum í Sækja Android API lykilinn (bls. 11).
2. Með ADT verkefnið þitt opið frá File valmynd, smelltu Nýtt og veldu Titill án texta File. Þú ættir nú að hafa ritstjóra glugga fyrir texta file nefndur Án titils 1. Bættu API lyklinum við textann
3. Frá File valmynd, smelltu Vista sem.
4. Í Vista sem valmynd, veldu eignir skrá yfir verkefnið þitt sem móðurmappa. Fyrir File nafn, slá inn txt.

Fjarlægðu Sample App sérsniðin villuleitarlyklaverslun

 ATH: Þetta skref er aðeins krafist ef þú notar Eclipse; ef þú ert að nota Android Studio skaltu sleppa þessum kafla.

Ef þú settir inn innskráninguna með Amazon fyrir Android sampForritið inn á sama vinnusvæði og þú ert að nota fyrir Android forritið þitt, þú gætir verið með sérsniðna kembiforritaskrá fyrir vinnusvæðið. Þú þarft að hreinsa sérsniðna kembiforritið til að nota þinn eigin API lykil.

1. Í aðalvalmyndinni, smelltu á Gluggi og veldu Óskir.
2. Í Óskir valmynd, veldu Android og Byggja.
3. Hreinsaðu Sérsniðin kemba lykilverslun
4. Smelltu OK.

Meðhöndla stillingar breytingar fyrir virkni þína

Ef notandi breytir skjástefnu eða breytir lyklaborðsástandi tækisins meðan þeir eru að skrá sig inn, mun það hvetja til að endurræsa núverandi virkni. Þessi endurræsing mun óvænt hafna innskráningarskjánum. Til að koma í veg fyrir þetta ættir þú að stilla þá virkni sem notar heimildaraðferðina til að höndla þessar stillingar breytingar handvirkt. Þetta kemur í veg fyrir að starfsemi hefjist á ný.

1. In Pakki Landkönnuður, tvísmelltu xml.
2. Í Umsókn kafla, finndu þá starfsemi sem mun annast innskráningu með Amazon (tdample, MainActivity).
3. Bættu eftirfarandi eiginleika við þá starfsemi sem þú fannst í skrefi 2:
   

   android: configChanges = ”lyklaborð | lyklaborð falið | stefnumörkun”

   Eða fyrir API 13 eða nýrri:

   android: configChanges = ”lyklaborð | lyklaborð falið | stefnumörkun | skjástærð”

4.  Frá File valmynd, smelltu Vista
   Nú, þegar lyklaborð eða tækjabreyting breytist, mun Android hringja í onConfigurationChanged aðferð fyrir virkni þína. Þú þarft ekki að framkvæma þessa aðgerð nema það sé þáttur í þessum stillingum sem þú vilt sjá um forritið þitt

Bættu við heimildarvirkni við verkefnið þitt

Þegar notandinn smellir á Innskráning með Amazon hnappinn mun API setja af stað a web vafra til að kynna notanda og samþykki síðu. Til þess að þessi vafravirkni virki verður þú að bæta við AuthorizationActivity við stefnuskrána þína.

1. In Pakki Landkönnuður, tvísmelltu xml.
2. Í Umsókn kafla, bættu eftirfarandi kóða við og skiptu út „com.example.app ”með pakkanafni þínu fyrir þetta forrit:
   

   <virkni android:name= “Com.amazon.identity.auth.device.authorization.AuthorizationActivity” android: theme = ”@ android: style / Theme.NoDisplay” android: allowTaskReparenting = ”true” android: launchMode = ”singleTask”> <action android:name="android.intent.action.VIEW“ /> <gögn android: host = ”com.example.app ”android: scheme =” amzn ” />

Bættu við innskráningu með Amazon hnappi í forritið þitt

appið þitt. Þessi hluti gefur skref til að hlaða niður opinberri innskráningu með Amazon mynd og para hana við Android ImageButton.

1. Bættu venjulegum ImageButton við forritið þitt.
   Nánari upplýsingar um Android hnappa og ImageButton flokkinn, sjá Hnappar á developer.android.com.
2. Gefðu hnappnum þínum auðkenni.
   Í hnappnum XML -yfirlýsingu, stilltu eiginleikann android: id á @+id/login_with_amazon. Fyrir fyrrvample:

   android: id = ”@ + id / login_with_amazon”

3. Veldu hnappamynd.
   Hafðu samband við innskráningu okkar hjá Amazon Leiðbeiningar um stíl fyrir lista yfir hnappa sem þú getur notað í forritinu þínu. Sæktu afrit af LWA_Android.zip file. Dragðu afrit af valinn hnapp fyrir hverja skjáþéttleika sem forritið þitt styður (xxhdpi, xhdpi, hdpi, mdpi eða tvdpi). Nánari upplýsingar um stuðning við marga skjáþéttleika í Android, sjá Aðrar skipulag í „Stuðningur við marga skjái“ efni ondeveloper.android.com.
4. Afritaðu viðeigandi hnappamynd files við verkefnið þitt.
   Fyrir hvern skjáþéttleika sem þú styður (xhdpi, hdpi, mdpi eða ldpi), afritaðu hnappinn sem þú hefur hlaðið niður á res / drawable skrá yfir þann þéttleika skjásins.
5. Lýstu yfir hnappamyndina.
   Í XML yfirlýsingunni fyrir hnappinn, stilltu eiginleikann android: src á nafn hnappsins sem þú hefur valið. Fyrir fyrrvample:

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

   6. Hladdu forritinu þínu og staðfestu að hnappurinn sé nú með innskráningu með Amazon mynd. Þú ættir að staðfesta að hnappurinn birtist rétt fyrir hvern skjáþéttleika sem þú styður.

Meðhöndlaðu innskráningarhnappinn og fáðu þér Profile Gögn

Þessi hluti útskýrir hvernig á að hringja í authorize og getProfile API til að skrá sig inn á notanda og sækja atvinnumann sinnfile gögn. Þetta felur í sér að búa til onClick hlustanda fyrir innskráningu þína með Amazon hnappi í onCreate aðferð forritsins þíns.

1. Bættu við innskráningu með Amazon í Android verkefnið þitt. Sjá Settu upp innskráninguna með Amazon bókasafninu .
2. Flyttu innskráninguna með Amazon API til uppruna þíns
   Til að flytja innskráninguna með Amazon API skaltu bæta eftirfarandi innflutningsupplýsingum við uppsprettuna þína file:

   flytja inn com.amazon.identity.auth.device.AuthError; flytja inn com.amazon.identity.auth.device.authorization.api. AmazonAuthorizationManager; flytja inn com.amazon.identity.auth.device.authorization.api. AuthorizationListener; flytja inn com.amazon.identity.auth.device.authorization.api.AuthzConstants;

3. Frumstilla AmazonAuthorizationManager.
   Þú verður að lýsa yfir AmazonAuthorizationManager breytu og búið til nýtt dæmi um bekkinn. Til að búa til nýtt dæmi þarf aðeins núverandi samhengi við forritið þitt og tómt búnt. Besti staðurinn til að frumstilla AmazonAuthorizationManager er í áCreate aðferð við virkni þína. Fyrir fyrrvample:
4. Búðu til AuthorizeLiistener.
   AuthorizeHluster útfærir viðmótið AuthorizatioinListener og mun vinna úr niðurstöðunni autorizecall. Það inniheldur þrjár aðferðir: oinSuccess, áVilla, og onCanceil. Hver aðferð fær annað hvort knippi eða AuthError mótmæla.

   einkaflokkur AuthorizeListener útfærir AuthorizationListener { / * Heimild tókst. * / @ Yfirstjórn opinbert ógilt áSuccess (svar við knippi) { } / * Villa kom upp við tilraun til að heimila forritið. */ @ Yfirstjórn opinbert ógilt onError (AuthError ae) { } / * Heimild var hætt áður en hægt var að ljúka henni. * / @ Yfirstjórn ógilt á almannafæri onCancel (orsök knippis) { } }

    

5. Hringdu AmazonAuthorizationManager.authorize.
   Í áSmelltu meðhöndlun fyrir Innskráning með Amazon hnappinn, hringdu í heimild til að hvetja notandann til að skrá sig inn og heimila umsókn þína.
   Þessi aðferð er ábyrg fyrir því að veita viðskiptavini heimild á eftirfarandi hátt:
   1. Skiptir yfir í kerfisvafrann og leyfir viðskiptavininum að skrá sig inn og samþykkja umbeðið
   2. Skiptir yfir í web view í öruggu samhengi, til að láta viðskiptavininn skrá sig inn og samþykkja beiðni

   Þetta örugga samhengi fyrir #2 er nú aðgengilegt sem Amazon Shopping app í Android tækjum. Tæki búin til af Amazon sem keyra Fire OS (tdample Kindle Fire, Fire Phone og Fire TV) nota alltaf þennan möguleika þó að ekkert Amazon Shopping app sé í tækinu. Vegna þessa, ef viðskiptavinurinn er þegar skráður inn á Amazon Shopping appið, sleppir þetta API innskráningarsíðunni, sem leiðir til Single Sign On reynsla fyrir viðskiptavininn.
   Þegar umsókn þín er heimiluð er hún heimiluð fyrir eitt eða fleiri gagnasett sem kallast umfang. Fyrsti færibreytan er úrval af gildissviðum sem innihalda notendagögnin sem þú ert að biðja um frá Login með Amazon. Í fyrsta skipti sem notandi skráir sig inn á forritið þitt mun þeim verða framvísaður listi yfir gögnin sem þú ert að biðja um og beðinn um samþykki. Innskráning hjá Amazon styður nú þrjú svið: atvinnumaðurfile, sem inniheldur nafn notandans, netfang og auðkenni Amazon reiknings; atvinnumaðurfile:notandanafn, sem inniheldur aðeins auðkenni Amazon-reikningsins; og póstnúmer, sem inniheldur póstnúmer / póstnúmer.
   Besta leiðin til að hringja í heimild er ósamstillt, þannig að þú þarft ekki að loka á þráðinn í HÍ eða búa til þinn eigin þráð. Að hringja heimildarstillt, framhjá hlut sem styður Leyfisviðmót hlustenda sem síðasta færibreytan:

   einkarekinn AmazonAuthorizationManager mAuthManager; @ Yfirstjórn protected void onCreate(Bundle savedInstanceState) { super.onCreate (savedInstanceState); mAuthManager = nýr AmazonAuthorizationManager (þetta, Bundle.EMPTY); // Finndu hnappinn með auðkenni login_with_amazon // og setja upp smellameðhöndlun mLoginButton = (hnappur) finnaViewById (R.id.login_with_amazon); mLoginButton.setOnClickListener (nýr OnClickListener () { @ Yfirstjórn almenningsgildi onClick (View v) { mAuthManager.authorize ( nýr strengur [] {“atvinnumaðurfile","póstnúmer"}, Bundle.EMPTY, nýr AuthorizeListener ()); } }); }

6. Búðu til a ProfileHlustandi.
   ProfileHlustandi er nafn okkar fyrir flokk sem útfærir APILister tengi, og mun vinna úr niðurstöðu getProfile hringja. APILister inniheldur tvær aðferðir: á velgengni og onError (það styður ekki á Hætta við vegna þess að það er engin leið að hætta við a getProfile hringja). á velgengni fær búnthlut með atvinnumannifile gögnum, á meðan áEriror fær an AuthError mótmæla með upplýsingum um villuna.

   einkaflokkur ProfileHlustandi útfærir APIListener { /* getProfile lokið með góðum árangri. */ @Ofgreiðsla opinbert ógilt áSuccess (svar við knippi) { } /* Villa kom upp þegar reynt var að fá atvinnumanninnfile. */ @Ofgreiðsla opinbert ógilt onError (AuthError ae) { } }

7. Innleiða á velgengni fyrir þína AuthorizeHluster.
   In á Árangur, hringja AmazonAuthorizationManager.getProfile að sækja viðskiptavininn atvinnumaðurfile. getProfile, eins og heimila, notar ósamstillt hlustendaviðmót. Fyrir getProfile, það viðmót er APIListener, notAuthorizationListener.
   

   / * Heimild tókst. * / @ Yfirstíga opinbert ógilt áSuccess (svar við knippi) { mAuthManager.getProfile(nýr ProfileHlustandi ());}

8. Innleiða áSuccessfor þitt ProfileHlustandi.
   áSuccesshas tvö meginverkefni: að sækja atvinnumanninnfile gögn úr svörunarbúnaðinum og til að senda gögnin til notendaviðmótsins. updateProfileGögn eru tilgátuaðgerð sem forritið þitt gæti innleitt til að sýna atvinnumennfile smáatriði. setLoggedInState, önnur tilgátufall, myndi benda til þess að notandi sé innskráður og gefa þeim leið til útskráning.
   Til að sækja atvinnumaðurfile gögn úr búntnum, notum við nöfn sem eru geymd af AuthzCastastants bekk. The á velgengni búnt inniheldur atvinnumanninnfile gögn í BUNDLE_KEY.PROFILE búnt.
   Innan atvinnumannsfile búnt, gildissviðsgögnin eru flokkuð undir PROFILE_KEY.NAME, PROFILE_KEY.EMAIL, PROFILE_KEY.USER_ID, og PROFILE_KEY.POSTAL_CODE. PROFILE_KEY.POSTAL_CODE er aðeins innifalinn ef þú óskar eftir póstnúmer umfang.

   @ Yfirstjórn opinbert ógilt áSuccess (svar við knippi) { // Sæktu gögnin sem við þurfum frá Bundle Bundle profileKnippi = response.getBundle ( AuthzConstants.BUNDLE_KEY.PROFILE.val); Nafn strengja = atvinnumaðurfileBundle.getString ( AuthzConstants.PROFILE_KEY.NAME.val); Strengjapóstur = atvinnumaðurfileBundle.getString ( AuthzConstants.PROFILE_KEY.EMAIL.val); Strengur reikningur = atvinnumaðurfileBundle.getString ( AuthzConstants.PROFILE_KEY.USER_ID.val); Póstnúmer strengja = atvinnumaðurfileBundle.getString ( AuthzConstants.PROFILE_KEY.POSTAL_CODE.val); runOnUiThread (nýr Runnable () {@Override opinbert ógilt hlaup () { updateProfileGögn (nafn, netfang, reikningur, póstnúmer); } }); }

9. Innleiða áVilla fyrir þína ProfileHlustandi.
   áVilla felur í sér AuthError hlutur sem inniheldur upplýsingar um villuna.

   /* Villa kom upp þegar reynt var að fá atvinnumanninnfile. */ @Ofgreiðsla opinbert ógilt onError (AuthError ae) { / * Reyndu aftur eða upplýstu notandann um villuna * / }

10. Innleiða áVilla fyrir þitt AuthorizeHluster.
    

    / * Villa kom upp við tilraun til að heimila forritið. */ @ Yfirstjórn opinbert ógilt onError (AuthError ae) { / * Láttu notandann vita um villuna * / }

11. Innleiða áCancelfor þitt AuthorizeHluster.
    Vegna þess að heimildarferlið sýnir notandaskjá (og hugsanlega samþykki) fyrir notandann í web vafra (eða a webview), notandinn fær tækifæri til að hætta við innskráningu eða fletta í burtu frá web síðu. Ef þeir hætta beinlínis við innskráningarferlið, á Hætta við er kallað. Ef áCancelis hringt, þú munt vilja endurstilla notendaviðmótið.

    / * Heimild var hætt áður en hægt var að ljúka henni. * / @ Yfirstjórn ógilt á almannafæri onCancel (orsök knippis) { / * endurstilla notendaviðmótið í tilbúið til innskráningarástands * / }

    Athugið: Ef notandinn siglir í burtu frá innskráningarskjánum í vafranum eða web view og skiptir aftur yfir í forritið þitt, SDK mun ekki greina að innskráningunni var ekki lokið. Ef þú uppgötvar virkni notenda í forritinu þínu áður en innskráningu er lokið geturðu gert ráð fyrir að þeir hafi flakkað frá vafranum og brugðist við í samræmi við það.

Athugaðu hvort notandi sé skráður í gangsetningu

Ef notandi skráir sig inn í forritið þitt, lokar forritinu og endurræsir forritið seinna er forritið enn heimilt að sækja gögn. Notandinn er ekki skráður út sjálfkrafa. Við ræsingu geturðu sýnt notandann sem innskráðan ef forritið þitt er enn heimilað. Í þessum kafla er útskýrt hvernig á að nota getToken til að sjá hvort forritið sé enn heimilað.

1. Búðu til a TokenHluster.
   TokenHluster útfærir APILister tengi og mun vinna úr niðurstöðu getToken símtalsins. APILister inniheldur tvær aðferðir: á velgengni og áVilla (það styður ekki á Hætta við vegna þess að það er engin leið að hætta við a getToken hringja). á velgengni fær búnt hlut með tákn gögnum, meðan áVilla fær an AuthError mótmæla með upplýsingum um villuna.

   einkaflokkur TokenListener útfærir APIListener { / * getToken lokið. * / @ Yfirstíga opinbert ógilt áSuccess (svar við knippi) { } / * Villa kom upp við tilraun til að fá táknið. * / @ Yfirstíga opinbert ógilt onError (AuthError ae) { } }

2. Í áStart aðferð við virkni þína, hringdu getToken til að sjá hvort umsóknin sé enn heimiluð.
   getToken sækir hrátt aðgangsmerki sem AmazonAuthorizationManager notar til að fá aðgang að atvinnumanni viðskiptavinafile. Ef auðkennisgildið er ekki núll, þá er forritið ennþá heimilt og hringt í getProfile ætti að ná árangri. getToken krefst sömu gildissvið og þú baðst um í símtali þínu um heimild.
   getTokensupports ósamstillt símtöl á sama hátt og getProfile, þannig að þú þarft ekki að loka fyrir UI þráðinn eða búa til þinn eigin vinnandi þráð. Til að hringja í getToken ósamstillt, sendu hlut sem styður APILister tengi sem loka breytu.

   @ Yfirstjórn verndað tóm á Start () { super.onStart (); mAuthManager.getToken (nýr strengur [] {“atvinnumaðurfile","póstnúmer"}, nýr TokenListener ()); }

3. Innleiða á velgengni fyrir þína TokenHluster.
   áSuccesshas tvö verkefni: að ná tákninu úr Knippinu, og ef táknið er gilt, að hringja getProfile.
   Til að ná táknagögnum úr knippinu notum við nöfn sem eru vistuð af AuthzCastastants bekk. The á velgengni búnt inniheldur auðkennisgögnin í BUNDLE_KEY.TOKEN gildi. Ef það gildi er ekki ógilt, skal þetta frvample kallar getProfile með því að nota sama hlustanda og þú lýstir yfir í fyrri hlutanum (sjá skref 7 og 8).

   / * getToken lokið. * / @ Yfirstjórn opinbert ógilt áSuccess (svar við knippi) { endanlegur strengur authzToken = response.getString (AuthzConstants.BUNDLE_KEY.TOKEN.val); ef (! TextUtils.isEmpty (authzToken)) { // Sæktu atvinnumanninnfile gögn mAuthManager.getProfile(nýr ProfileHlustandi ()); } }

Hreinsaðu leyfisríki og skráðu þig út notanda

Aðferðin clearAuthorizationState mun hreinsa heimildargögn notandans frá AmazonAuthorizationManager staðbundinni gagnageymslu. Notandi verður að skrá sig inn aftur til að appið sæki atvinnumaðurfile gögn. Notaðu þessa aðferð til að skrá þig út af notanda eða til að leysa innskráningarvandamál í forritinu.

1. Framkvæmdu útskráningu
   Þegar notandi hefur skráð sig inn með góðum árangri, þá ættir þú að útvega útskráningarbúnað svo hann geti hreinsað atvinnumenn sínafile gögnum og áður viðurkenndum gildissviðum. Vélbúnaðurinn þinn gæti verið tengill eða valmyndaratriði. Fyrir þessa fyrrverandiample við munum búa til áSmelltu aðferð fyrir hnapp.
2. Hringdu í afgreiðsluaðilanum þínum clearAuthorizationState. clearAuthorizationState mun fjarlægja heimildargögn notanda (aðgangstákn, atvinnumennfile) frá versluninni á staðnum. clearAuthorizationStatetakes engar breytur nema fyrir APILister að skila árangri eða
3. Lýstu nafnlausum APILister.
   Nafnlausir flokkar eru gagnlegur valkostur við að lýsa yfir nýjum flokki til framkvæmda APILister. Sjá Meðhöndlaðu innskráningarhnappinn og fáðu þér Profile Gögn (bls. 17) fyrir exampleti lýsir yfir hlustendaflokkum.
4. Innleiða á velgengni inni í APILister
   Hvenær clearAuthorizationState tekst að þú ættir að uppfæra notendaviðmótið þitt til að fjarlægja tilvísanir til notandans og bjóða upp á innskráningarferli sem notendur geta notað til að skrá þig inn aftur.
5. Innleiða áVilla inni í APILister.
   If clearAuthorizationStateeturns villa, þú getur látið notandann reyna að skrá þig út aftur.

   @ Yfirstjórn protected void onCreate(Bundle savedInstanceState) { super.onCreate (savedInstanceState); / * Fyrri á Skapa yfirlýsingar sleppt * / // Finndu hnappinn með auðkenni útskráningar og settu upp smellameðhöndlun mLogoutButton = (Hnappur) finnaViewById (R.id.logout); mLogoutButton.setOnClickListener (nýr OnClickListener () { @ Yfirstjórn almenningsgildi onClick (View v) { mAuthManager.clearAuthorizationState (nýtt APIListener () { @ Yfirstjórn opinber tóm áSuccess (árangur í knippi) { // Stilla útritað ástand í HÍ } @ Yfirstjórn opinbert ógilt onError (AuthError authError) { // Skráðu villuna } }); } }); }

Hringdu í AmazonAuthorizationManager Methods samstillt

Sumir AmazonAuthorizationManager aðferðir skila framtíðarhlut. Þetta gerir þér kleift að kalla aðferðina samstillt í stað þess að láta hlustanda framhjá sem breytu. Ef þú notar Future hlut, þá ættirðu ekki að nota hann á UI þráð. Ef þú útilokar UI þráð í meira en fimm sekúndur færðu ANR (Umsögn svarar ekki). Í handfanginu er innskráningarhnappurinn og fáðu Profile Gögn fyrrvample, hinn á velgengni aðferð fyrir AuthorizeHluster er kallað með starfsmannþráð búið til af AmazonAuthorizationManager. Þetta þýðir að það er óhætt að nota þann þráð til að hringja í getPirofile samstillt. Til að hringja samstillt símtal skal úthluta skilagildi frá fá Pirófile til framtíðar hlutar, og hringdu í gietaðferð á þeim hlut að bíða þar til aðferðinni lýkur.

Future.get skilar búnt hlut sem inniheldur a FUTURE_TYPE verðmæti á Árangur, VILLA, or HÆTTA við. Ef aðferðin heppnaðist mun sami búntinn innihalda PROFILE_KEY gildi fyrir atvinnumanninnfile gögn. Fyrir fyrrvample:

/ * Heimild tókst. * / @ Yfirstjórn opinbert ógilt áSuccess (svar við knippi) { Future <Bundle> future = mAuthManager.getProfile(núll); Niðurstaða búnt = future.get (); // Finndu út hvort símtalinu tókst og sóttu atvinnumanninnfile Object future_type = result.get (AuthzConstants.BUNDLE_KEY.FUTURE.val); ef (future_type == AuthzConstants.FUTURE_TYPE.SUCCESS) { Nafn strengja = result.getString (AuthzConstants.PROFILE_KEY.NAME.val); String netfang = result.getString (AuthzConstants.PROFILE_KEY.EMAIL.val); Stringreikningur = result.getString (AuthzConstants.PROFILE_KEY.USER_ID.val); Póstnúmer strengja = result.getString (AuthzConstants.PROFILE_KEY.POSTAL_CODE.val); runOnUiThread (nýr Runnable () {@Override opin tóm keyrsla () {updateProfileGögn (nafn, netfang, reikningur, Póstnúmer); } }); } annað ef (future_type == AuthzConstants.FUTURE_TYPE.ERROR) { // Fáðu villuhlut AuthError authError = AuthError.extractError (niðurstaða); / * Notaðu authError til að greina villu * / } annað ef (future_type == AuthzConstants.FUTURE_TYPE.CANCEL) { / * Notanda hætt við leyfi * / } }

Skráðu þig inn með Amazon Byrjun handbók fyrir Android - Sækja [bjartsýni]
Skráðu þig inn með Amazon Byrjun handbók fyrir Android - Sækja

Heimildir

• Notendahandbók