Skráðu þig inn hjá Amazon Byrjunarleiðbeiningar fyrir iOS

 

Skráðu þig inn hjá Amazon: Handbók fyrir iOS

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 iOS

Í þessari handbók munum við sýna þér hvernig á að bæta Innskráningu með Amazon við iOS forritið þitt. Að lokinni þessari handbók ættirðu að hafa virkan Innskráningu með Amazon hnappinn í forritinu þínu til að leyfa notendum að skrá sig inn með Amazon skilríkjum sínum.

Setja upp Xcode

Innskráningin með Amazon SDK fyrir iOS er veitt af Amazon til að hjálpa þér að bæta við Login með Amazon í iOS forritið þitt. SDK er ætlað að nota með Xcode þróunarumhverfinu. SDK styður forrit sem keyra á iOS 7.0 og síðar með ARMv7, ARMv7s, ARM64, i386 og x86_64.

Þú getur sett upp Xcode úr Mac App Store. Fyrir frekari upplýsingar, sjá Xcode: Hvað er nýtt á developer.apple.com.

Eftir að Xcode hefur verið sett upp geturðu það Settu upp innskráninguna með Amazon SDK fyrir iOS og Keyra Sample App, eins og lýst er hér að neðan.

Settu upp innskráninguna með Amazon SDK fyrir iOS

Innskráningin með Amazon SDK fyrir iOS kemur í tveimur pakka. Sú fyrsta inniheldur iOS bókasafnið og stuðningsgögn. Annað inniheldur semample forritið sem gerir notanda kleift að skrá sig inn og view atvinnumaður þeirrafile gögn.

Ef þú hefur ekki enn sett upp Xcode, sjáðu leiðbeiningarnar í Settu upp Xcode kafla hér að ofan.

1. Sækja InnskráningWithAmazonSDKForiOS.zip og draga úr files í möppu á harða disknum þínum.
   Þú ættir að sjá a InnskráningWithAmazon.framework Skrá. Þetta inniheldur Login with Amazon bókasafnið.
   Á efsta stigi zip er a InnskráningWithAmazon.doc setja skráasafn. Þetta inniheldur API skjölin.
2. Sjá Settu upp innskráninguna með Amazon bókasafninu fyrir leiðbeiningar um hvernig bæta á bókasafninu við iOS verkefni.

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

Keyra Sample App

Til að keyra sample umsókn, opnaðu sample í Xcode.

1. Sækja SampleLoginWithAmazonAppForiOS.zip og afritaðu
   SampleLoginWithAmazonAppForiOS möppu í skjalamöppuna þína.
2. Byrjaðu Xcode. Ef Welcome to Xcode valmyndin birtist skaltu smella á Open Other. Annars skaltu smella á aðalvalmyndina File og veldu Opna.
3. Veldu skjalamöppuna og veldu
   SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/ LoginWithAmazonSample.xcodeproj. Smelltu Opið.
4. Sample verkefnið ætti nú að hlaða. Þegar því er lokið skaltu velja Vara úr aðalvalmyndinni og veldu Hlaupa

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 iOS forriti við þann reikning.

Sjá eftirfarandi efni

• Skráðu þig inn með Amazon forritinu
• Bættu iOS forriti við Security Profile
• IOS búnt auðkenni og API lyklar
  o Ákveðið búnnaauðkenni fyrir iOS forrit
  o Sækja iOS 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 smellirðu á Skráðu þig.
   Þú verður vísað til Seller Central, sem sér um skráningu umsókna vegna innskráningar hjá Amazon. 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. Sláðu inn nafn og a á skráningarformið þitt 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 persónuverndartilkynningu URL fyrir umsókn þína.
   Persónuverndartilkynningin URL er staðsetning persónuverndarstefnu fyrirtækis þíns eða forrits (tdample, http: //www.example.com/privacy.html). Þessi hlekkur er birtur notendum á samþykki skjá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.
   

Ef mismunandi útgáfur af forritinu þínu eru með mismunandi auðkenni knippa, 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á iOS stillingar smellt á forritið þitt Bæta við API lykli hnappinn til að búa til viðbótarlykla fyrir forritið þitt (einn í hverri útgáfu).

Bættu iOS forriti við Security Profile

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.

Til að skrá iOS forrit þarftu að tilgreina auðkenni knippsins fyrir verkefnið. Innskráning með Amazon notar auðkenni knippsins til að búa til API lykil. API lykillinn veitir forriti þínu aðgang að Login með Amazon heimildarþjónustunni. Fylgdu þessum skrefum til að bæta iOS forriti við reikninginn þinn:

1. Smelltu á forritaskjáinn iOS stillingar. Ef þú ert nú þegar með iOS app skráð skaltu leita að Bæta við API lykli hnappinn í iOS stillingar kafla.
   The iOS forrit Upplýsingar um eyðublað birtast:
   
2. Sláðu inn Merki af iOS forritinu þínu. Þetta þarf ekki að vera opinbert nafn forritsins þíns. Það auðkennir einfaldlega þetta tiltekna iOS app meðal forrita og webvefsvæði skráð í Innskráningu þína með Amazon forriti.
3. Sláðu inn þinn Knippi. Þetta verður að passa við auðkenni knippsins fyrir iOS verkefnið þitt. Til að ákvarða auðkennisbúnt skaltu opna verkefnið í Xcode. Opnaðu eignalistann fyrir verkefnið ( -Info.plist) í Verkefni Navigator. Auðkenni knippsins er ein af eiginleikunum á listanum.
4. Smelltu Vista.

IOS búnt auðkenni og API lyklar

Auðkenni knippsins er einstakt fyrir hvert iOS forrit. Innskráning með Amazon notar auðkenni knippsins til að smíða API lykilinn þinn. API lykillinn gerir Innskráningu með Amazon heimildarþjónustu kleift að þekkja forritið þitt.

Ákveðið búnnaauðkenni fyrir iOS forrit

1. Opnaðu forritið þitt í Xcode.
2. Opnaðu Upplýsingareignalisti fyrir verkefnið ( -Info.plist) í Verkefni Navigator.
3. Finndu Auðkenni knippsins í fasteignalistanum.

Sækja iOS API lykil

Eftir að þú hefur skráð iOS útgáfu og gefið upp auðkenni knippa geturðu sótt API lykilinn af skráningarsíðunni fyrir Innskráninguna þína með Amazon forritinu. Þú verður að setja API lykilinn á eignalista verkefnisins. Þangað til þú gerir það mun forritið ekki hafa heimild til að eiga samskipti við Innskráningu með Amazon heimildarþjónustu.

1. Farðu í https://login.amazon.com.
2. Smelltu Forrit hugbúnaðar.
3. Í Forrit kassi, smelltu á forritið þitt.
4. Finndu iOS forritið þitt undir iOS stillingar kafla. Ef þú hefur ekki þegar skráð iOS forrit, sjáðu Bættu iOS forriti við Security Profile.
5. Smelltu Búðu til API lykilgildi. Sprettigluggi birtir API lykilinn þinn. Smelltu til að afrita lykilinn Veldu Allt til að velja allan lykilinn.
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 þínum við eignarlistann þinn fyrir leiðbeiningar um að bæta API lyklinum við iOS forritið þitt

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

Í þessum kafla lærir þú hvernig á að búa til nýtt Xcode verkefni fyrir innskráningu með Amazon og stilla verkefnið.

Sjáðu eftirfarandi efni:

• Búðu til nýja innskráningu með Amazon Project
• Settu upp innskráninguna með Amazon bókasafninu
• Bættu API lyklinum þínum við eignarlistann þinn
• Bæta við a URL Skipuleggðu lista yfir eignir forrita þinna
• Bættu við öryggisundantekningu forrita fyrir Amazon við forritið þitt Eignalisti
  ATH: Þetta nýja skref er nú krafist þegar þróað er á iOS 9 SDK
• Bættu við innskráningu með Amazon hnappi í forritið þitt

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ð núverandi forrit skaltu fara yfir í hlutann Setja inn innskráningu með Amazon bókasafninu hér að neðan.

1. Ræsa Xcode.
2. Ef þér er kynnt a Verið velkomin í Xcode valmynd, veldu Búðu til nýtt Xcode verkefni.
   Annars frá File valmynd, veldu Nýtt og Verkefni.
3. Veldu tegund verkefnisins sem þú vilt búa til og smelltu á Næst.
4. Sláðu inn a Vöruheiti og a Auðkenni fyrirtækis. Athugaðu þinn Auðkenni búnts, og smelltu Næst.
5. Veldu staðsetningu þar sem þú vilt geyma verkefnið þitt og smelltu á Búa til.
   Þú verður nú með nýtt verkefni 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 iOS, sjáðu Settu upp innskráninguna með Amazon SDK fyrir iOS.

Innskráning með Amazon verkefni verður að tengja InnskráningWithAmazon.framework og Öryggi. Rammaverk bókasöfn. Þú verður einnig að stilla leitarleiðina til að finna innskráningu með Amazon hausum

1. Með verkefnið þitt opið í Xcode skaltu velja Rammar möppu, smelltu File úr aðalvalmyndinni og veldu síðan Bæta við Files til "verkefni".
2. Veldu í glugganum InnskráningWithAmazon.framework og smelltu á Bæta við.
   Ef þú notaðir Login with Amazon 1.0 bókasafnið, eyddu login-with-amazon sdk skránni og login-with-amazon-sdk.a úr Frameworks möppunni. Smellur Breyta úr aðalvalmyndinni og veldu Eyða.
3. Veldu nafn verkefnisins í Verkefni Navigator.
   The Verkefnisstjóri mun birtast á ritstjórasvæði Xcode vinnusvæðisins.
4. Smelltu á heiti verkefnis þíns undir Markmið, og veldu Byggja áfanga. Stækkaðu Link Binary með bókasöfnum og smelltu á plúsmerkið til að bæta við bókasafni.
5. Sláðu inn í leitarreitinn Öryggi. Rammaverk. Veldu Security.framework og smelltu Bæta við.
6. Sláðu inn í leitarreitinn SafariServices.framework. Veldu SafariServices.framework og smelltu Bæta við.
7. Sláðu inn í leitarreitinn CoreGraphics.framework. Veldu CoreGraphics.framework og smelltu Bæta við
8. Veldu Byggingarstillingar. Smelltu á Allt til view allar stillingar.
9. Undir Leitarleiðir, tryggja að InnskráningWithAmazon.framework skrá er í Rammaleitarstígar.
   Til dæmisample:
   
   Ef þú notaðir Login með Amazon 1.0 bókasafnið geturðu fjarlægt allar tilvísanir í 1.0 bókasafnsstíginn í Leitarleiðir fyrir haus or Leitarleiðir bókasafns.
10. Í aðalvalmyndinni, smelltu á Vara og veldu Byggja. Byggingunni ætti að ljúka með góðum árangri.
    Áður en þú byggðir verkefnið þitt, ef þú notaðir Login með Amazon 1.0 bókasafnið, skaltu skipta út #innflutningur „AIMobileLib.h“, #innflutningur „AIAuthenticationDelegate.h“, or #innflutningur „AIError.h“ í heimildinni þinni files með #innflutningur
    .
    InnskráningWithAmazon.h nær til allra innskráningar með Amazon hausum í einu.

Bættu API lyklinum þínum við eignarlistann þinn

Þegar þú skráir iOS forritið þitt með Innskráningu hjá Amazon er þér úthlutað API lykli. Þetta er auðkenni sem Amazon Mobile Library mun nota til að bera kennsl á forritið þitt við Login með Amazon heimildarþjónustunni. Farsafnsbók Amazon hleður þessu gildi á keyrslu frá API-lykil eignargildinu í lista yfir upplýsingar um eignir þínar.

1. Með opnu verkefninu skaltu velja Stuðningur Files mappa og veldu síðan -Info.plist file (hvar er nafn verkefnis þíns). Þetta ætti að opna eignalistann til að breyta:
   
2. Gakktu úr skugga um að engin af færslunum sé valin. Smelltu síðan á aðalvalmyndina Ritstjóri, og Bæta við hlut. Sláðu inn API lykill og ýttu á Sláðu inn.
3. Tvísmelltu undir Gildi dálki til að bæta við gildi. Límdu API lykilinn þinn sem gildi.

Bæta við a URL Skipuleggðu lista yfir eignir forrita þinna

Þegar notandinn skráir sig inn verður þeim kynnt Amazon innskráningarsíða. Til þess að forritið þitt fái staðfestingu á innskráningu sinni verður þú að bæta við a URL áætlun þannig að web síðu getur vísað aftur í forritið þitt. The URL kerfi verður að lýsa sem amzn- (tdample, amzncom.example.app). Fyrir frekari upplýsingar, sjá Notar URL Áætlanir um samskipti við forrit á developer.apple.com.

1. Með opnu verkefninu skaltu velja Stuðningur Files mappa og veldu síðan -Info.plist file (hvar er nafn verkefnis þíns). Þetta ætti að opna eignalistann til að breyta:
   
2. Gakktu úr skugga um að engin af færslunum sé valin. Smelltu síðan á aðalvalmyndina Ritstjóri, og Bæta við hlut. Sláðu inn eða veldu URL tegundir og ýttu á Sláðu inn.
3. Stækkaðu URL tegundir að opinbera Atriði 0. Veldu Atriði 0 og frá aðalvalmyndinni smellirðu á Editor og Add Item. Sláðu inn eða veldu URL Auðkenni og ýttu á Sláðu inn.
4. Veldu Vörunúmer 0 undir URL Auðkenni og tvísmelltu undir dálknum Gildi til að bæta við gildi. Gildið er auðkenni knippsins. Þú getur fundið auðkenni knippsins skráð sem knippi auðkenni í eignalistanum.
5. Veldu Vörunúmer 0 undir URL tegundir og smelltu á aðalvalmyndina Ritstjóri og Bæta við hlut. Sláðu inn eða veldu URL Skipuleggðu og ýttu á Enter.
6. Veldu Vörunúmer 0 undir URL Áætlanir og tvísmelltu undir Gildi dálki til að bæta við gildi. Gildið er auðkenni knippsins þíns með amzn- undirbúið (tdample, amzn com.example.app). Þú getur fundið auðkenni knippsins skráð sem Auðkenni knippsins í fasteignalistanum.

Bættu við öryggisundantekningu forrita fyrir Amazon við forritið þitt
Eignalisti

Frá og með iOS 9 framfylgir Apple App Transport Security (ATS) fyrir örugga tengingu milli forrits og web þjónusta. Endapunkturinn (api.amazon.com) sem innskráningin með Amazon SDK hefur samskipti við til að skiptast á upplýsingum er ekki í samræmi við ATS ennþá. Bættu við undantekningu fyrir api.amazon.com til að gera óaðfinnanleg samskipti milli SDK og Amazon netþjónsins kleift.

1. Með opnu verkefninu skaltu velja Stuðningur Files mappa og veldu síðan -Info.plist file (hvar er nafn verkefnis þíns). Þetta ætti að opna eignalistann til að breyta:
   
2. Gakktu úr skugga um að engin af færslunum sé Smelltu síðan á aðalvalmyndina Ritstjóri, og Bæta við hlut. Sláðu inn eða veldu NSAppTransportSecurity og ýttu á Sláðu inn.
3. Stækkaðu NSAppTransportSecurity og smelltu á aðalvalmyndina Ritstjóri og Bæta við hlut. Sláðu inn eða veldu NSExceptionDomains og ýttu á Sláðu inn.
4. Stækkaðu NSExceptionDomains og smelltu á aðalvalmyndina Ritstjóri og Bæta við hlut. Sláðu inn á amazon.com og ýttu á Sláðu inn.
5. Stækkaðu amazon.com og smelltu á aðalvalmyndina Ritstjóri og Bæta við hlut.Koma inn NSExceptionRequiresForwardSecy og ýttu á Sláðu inn.
6. Veldu NSExceptionRequiresForwardSecy og tvísmelltu undir Gildi dálki til að bæta við Veldu a Tegund of Boolean og a Gildi of NEI.

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

Innskráning með Amazon býður upp á nokkra venjulega hnappa sem þú getur notað til að hvetja notendur til að skrá sig inn úr forritinu þínu. Þessi hluti gefur skref til að hlaða niður opinberri innskráningu með Amazon mynd og para hana við iOS UIButton.

1. Bættu venjulegum UIButton við forritið þitt.
   Fyrir námskeið og upplýsingar um hvernig á að bæta hnapp við app, sjá Búa til og stilla View Hlutir og Byrjaðu að þróa iOS forrit í dag á developer.apple.com.
2. Bætið við Touch Up inni atburður fyrir hnappinn að aðferð sem heitir onLogin ButtonClicked. Láttu framkvæmdina vera tóma í bili. The Að búa til og Stillir View Hlutir og Byrjaðu að þróa iOS forrit í dag skjöl á apple.com innihalda skref til að bæta við hnappatburði.
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_for_iOS.zip file. Finndu valinn hnapp í bæði 1x og 2x möppunum og dragðu þá úr zip. Dragðu út _Pressaða útgáfu hnappsins ef þú vilt sýna hnappinn í völdu ástandi.
4. Bættu myndunum við verkefnið þitt.
   a. Smelltu á Xcode, með verkefnið þitt hlaðið File úr aðalvalmyndinni og veldu Bæta við Files að „verkefna“.
   b. Veldu hnappamyndina í glugganum file(s) sem þú hefur hlaðið niður og smellt á Bæta við.
   c. Hnapparnir ættu nú að vera í verkefninu undir verkefnaskránni þinni. Færðu þá í stuðninginn Filemöppu.
5. Bættu myndinni við hnappinn þinn.
   Til að virkja myndina fyrir hnappinn þinn geturðu breytt hnappaeiginleikanum eða notað setImage: forState aðferð á UI-hnappur mótmæla. Fylgdu þessum skrefum til að breyta myndareiginleikanum fyrir hnappinn þinn:
   a. Opnaðu söguspjaldið fyrir forritið þitt.
   b. Veldu hnappinn á söguspjaldinu með því að smella á hann eða velja hann úr View Stjórnandi Vettvangstré.
   c. Í Veitur glugga, opnaðu Eiginleikar eftirlitsmaður.
   
   d. Efst á eigindaskoðunaraðilanum, stilltu hnappategundina á kerfi.
   e. Í seinni stillingahópnum skaltu velja Sjálfgefið fyrir Ríkisstillingu.
   f. Í öðrum hópi stillinganna skaltu falla niður Image stillingin.
   g. Veldu innskráningu með Amazon hnappagrafík sem þú bættir við verkefnið. Ekki velja 2x útgáfuna: hún verður hlaðin sjálfkrafa á skjátæki með háþéttni (Retina).
   h. Stilltu sömu mynd fyrir bakgrunnsstillingu.
   i. Ef þú vilt tilgreina þrýsta útgáfu hnappsins skaltu velja Valið fyrir ríkisstillingu og setja myndina á _þrýsta útgáfu hnappsins.
   j. Stilltu stærð hnappsins á söguspjaldið til að passa myndina, ef nauðsyn krefur.

Notkun SDK fyrir iOS API

Í þessum kafla bætir þú kóða við verkefnið þitt til að skrá þig inn notanda með Innskráningu hjá Amazon.
Sjáðu eftirfarandi efni:

• 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

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

Þessi hluti útskýrir hvernig á að hringja í authorizeUserForScopes: fulltrúi: og getProfile: API að skrá sig inn á notanda og sækja atvinnumann sinnfile gögn. Þetta felur í sér að búa til onLoginButtonClicked: hlustandi fyrir tenginguna þína með Amazon hnappinn.

1. Bættu við innskráningu með Amazon í iOS verkefnið þitt. Sjá Setja inn innskráningu með Amazon bókasafninu.
2. Flyttu innskráninguna með Amazon API til uppruna þíns file.
   Til að flytja inn innskráningu með Amazon API skaltu bæta við eftirfarandi #innflutningsupplýsingar að heimildarmanni þínum file:

   #flytja inn

3. Búðu til AMZNauthorizeUserDelegateclass að framkvæma
   AIA sannvottun.
   Hvenær authorizeUserForScopes: fulltrúi: lýkur, það mun kalla requestDidSucceed: or requestDidFail: aðferð á hlut sem útfærir AIA sannvottun siðareglur.

   @interface AMZNAuthorizeUserDelegate: NSObject @end

   Fyrir frekari upplýsingar, sjá Vinna með bókanir  á developer.apple.com.
4. Hringdu authorizeUserForScopes: fulltrúi: in onLogin ButtonClicked.
   Ef þú fylgdir skrefunum í Bættu við innskráningu með Amazon hnappi í forritið þitt, þú ættir að hafa onLoginButtonClicked: aðferð tengt við Login með Amazon hnappinn. Í þeirri aðferð, hringdu authorizeUserForScopes: fulltrúi: til hvet notandann til að skrá þig inn og heimila umsókn þína.
   Þessi aðferð gerir notandanum kleift að skrá sig inn og samþykkja umbeðnar upplýsingar á einn af eftirfarandi leiðum:
   1.) Skiptir yfir í web view í öruggu samhengi (ef Amazon Shopping app er sett upp í tækinu)
   2.) Skiptir yfir í Safari View Stjórnandi (á iOS 9 og síðar)
   3.) Skiptir yfir í kerfisvafrann (í iOS 8 og eldri)
   Öruggt samhengi fyrir fyrsta valkostinn er í boði þegar Amazon verslunarforritið er sett upp í tækinu. Ef notandinn er þegar skráður inn í Amazon verslunarforritið er innskráningarsíðunni sleppt sem leiðir til a Einskráning (SSO) reynslu.

   Þegar umsókn þín er heimiluð er hún heimiluð fyrir eitt eða fleiri gagnasett sem kallast gildissvið. Fyrsta breytan er fjöldi gildissviðs sem nær yfir notendagögnin sem þú biður um frá Innskráningu hjá Amazon. Í fyrsta skipti sem notandi skráir sig inn í forritið þitt verður þeim kynntur listi yfir gögnin sem þú ert að biðja um og beðinn um samþykki. Innskráning með Amazon styður sem stendur þrjú gildissvið: atvinnumaðurfile, sem inniheldur nafn notanda, 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.
   Önnur breytan við authorizeUserForScopes: fulltrúi: er hlutur sem útfærir AIA sannvottun Delateprotocol, í þessu tilfelli dæmi um AMZNAuthorizeUserDelegate bekk.

   - (IBAction) onLogInButtonClicked: (id) sendandi { // Hringdu í SDK til að fá öruggt aðgangsmerki // fyrir notandann. // Meðan þú hringir í fyrsta símtalið geturðu tilgreint lágmarks grunn // gildissvið þarf. // Óskar eftir báðum gildissviðum fyrir núverandi notanda. NSArray * requestScopes = [NSArray arrayWithObjects:@”atvinnumaðurfile”, @” Póstnúmer_númer ”, ekkert]; AMZNAuthorizeUserDelegate * fulltrúi = [[AMZNAuthorizeUserDelegate alloc] initWithParentController: sjálf]; [AIMobileLib authorizeUserForScopes: requestScopes fulltrúi: fulltrúi];

   Bættu haus framkvæmdastjóra þíns við bekkinn sem hringir
   heimilaUserForScopes :. Til dæmisample:

   #flytja inn „AMZNAuthorizeUserDelegate.h“

5. Búðu til AMZNGetProfileFulltrúi.
   AMZNGetProfileFulltrúi nafn okkar fyrir bekk sem útfærir
   AIA sannvottun Delateprotocol, og mun vinna úr niðurstöðu getProfile: hringja. Eins og authorizeUserForScopes: fulltrúi :, getProfile: styður requestDidSucceed: og requestDidFail: siðareglur aðferðir. requestDidSucceed: fær an APIResult mótmæla með atvinnumannifile gögn í niðurstöðueigninni. requestDidFail: fær an AIVilla mótmæla með upplýsingum um villuna í villueigninni.
   Til að búa til fulltrúa bekk úr venjulegri bekkjaryfirlýsingu, flytja inn
   AIAuthenticationDelegate.hand bættu bókuninni við yfirlýsinguna í bekkjarhausnum þínum file:

   #flytja inn @viðmót AMZNGetProfileFulltrúi: NSObject @end

    

6. Innleiða requestDidSucceed: fyrir þitt AMZNAuthorizeUserDelegate. In requestDidSucceed :, hringja getProfile: að sækja viðskiptavininn atvinnumaðurfile. getProfile:, eins og authorizeUserForScopes: fulltrúi :, notar AIAuthenticationDelegate samskiptareglur.
   

   - (void) requestDidSucceed: (APIResult *) apiResult { // Kóðinn þinn eftir að notandinn hefur heimilað umsókn fyrir // beðið um gildissvið. // Hlaða nýju view stjórnandi með auðkenni notenda // þar sem notandinn hefur nú skráð sig inn. AMZNGetProfileFulltrúi* fulltrúi = [[[AMZNGetProfileDelegate alloc] initWithParentController: foreldriViewStjórnandi] heimildarútgáfa]; [AIMobileLib getProfile: fulltrúi]; }

   Bættu haus framkvæmdastjóra þíns við bekkinn sem hringir getProfile:. Fremriample:
   

   #flytja inn “AMZNGetProfileFulltrúi.h “

7. Innleiða requestDidSucceed: fyrir þína AMZNGetProfileFulltrúi.
   requestDidSucceed: hefur tvö meginverkefni: að sækja atvinnumanninnfile gögn frá Niðurstaða, og að koma gögnum til HÍ.
   Til að sækja atvinnumaðurfile gögn frá Niðurstaða, fá aðgang að útkomueigninni. Fyrir getProfile: svar, þessi eign mun innihalda orðabók með eignargildum fyrir notandannfile eignir. Atvinnumaðurinnfile eignir eru nafn, netfang, og USER_ID fyrir atvinnumanninnfile umfang og
   póstnúmer fyrir póstnúmer umfang.

   - (void) requestDidSucceed: (APIResult *) apiResult { // Fáðu atvinnumannfile beiðni tókst. Pakkaðu út atvinnumanninumfile upplýsingar // og sendu það til foreldrisins view stjórnandi NSString * nafn = [(NSDictionary *) apiResult.result objectForKey: @ ”nafn”]; NSString * email = [(NSDictionary *) apiResult.result objectForKey: @ ”netfang”]; NSString * user_id = [(NSDictionary *) apiResult.result objectForKey: @ ”user_id”]; NSString * postal_code = [(NSDictionary *) apiResult.result objectForKey: @ ”póstnúmer”]; // Sendu gögn til view stjórnandi }

8. Innleiða requestDidFail: fyrir þína AMZNGetProfileFulltrúi.
   requestDidFail: felur í sér APIEVilla hlutur sem inniheldur upplýsingar um villuna. sýnaLogInPageis tilgátuaðferð sem myndi endurstilla aðalatriðið view stjórnandi til að sýna Login with Amazon hnappinn.

   - (void) requestDidFail: (APIError *) errorResponse { // Fáðu þér Profile beiðni mistókst hjá atvinnumannifile umfang. // Ef villukóði = kAIApplicationNotAuthorized, // leyfa notanda að skrá sig inn aftur. ef (errorResponse.error.code == kAIApplicationNotAuthorized) { // Sýna hnapp fyrir heimild notanda. [foreldriViewStjórnandi showLogInPage]; } annað { // Meðhöndla aðrar villur [[[[UIAlertView alloc] initWithTitle:@”“ skilaboð: [NSString stringWithFormat: @ ”Villa kom upp með skilaboðunum:% @”, errorResponse.error.message] fulltrúi: enginn cancelButtonTitle: @ ”OK” otherButtonTitles: nil] autorelease] show]; } }

9. Innleiða requestDidFail: fyrir þitt AMZNAuthorizeUserDelegate.
   

   - (void) requestDidFail: (APIError *) errorResponse { NSString * skilaboð = errorResponse.error.message; // Kóðinn þinn þegar heimildin mistekst. [[[[UIAlertView alloc] initWithTitle:@”“ skilaboð: [NSString stringWithFormat: @ ”Heimild notanda mistókst með skilaboð:% @”, errorResponse.error.message] fulltrúi: enginn cancelButtonTitle: @ ”OK” otherButtonTitles: nil] autorelease] show]; }

   10. Framkvæmd umsókn: opiðURL: source Umsókn: athugasemd: í bekknum í verkefninu þínu sem sér um UIAapplicationDelegate samskiptareglur (sjálfgefið verður þetta AppDelegate class í verkefninu þínu). Þegar forritið kynnir Amazon innskráningarsíðuna og notandinn lýkur innskráningu, mun það vísa til forritsins með því að nota URL Skipuleggðu forritið sem skráð var áðan. Sú tilvísun er send til umsókn: opiðURL: source Umsókn: athugasemd :, sem skilar sér JÁ ef URL tókst vel. höndla OpnaURL: source Forrit: er SDK bókasafnsaðgerð sem mun sjá um Innskráningu með Amazon tilvísun URLs fyrir þig. Ef höndla OpnaURL: source Forrit: skilar JÁ, þá er URL var afgreitt.

   - (BOOL) umsókn: (UIApplication *) umsókn opiðURL: (NSURL *)url sourceApplication: (NSString *) sourceApplication athugasemd: (id) athugasemd { // Sendu áfram url til SDK til að flokka heimildarkóða // frá url. BOOL erValidRedirectSignInURL = [AIMobileLib handfang OpiðURL:url sourceApplikation: sour ceApplicati on); ef (! isValidRedirect Si gnlnURL) skila NEI; // Forritið gæti viljað meðhöndla það url skila JÁ; }

   ATH: Þessi aðferð er úrelt í iOS 9 en ætti að vera með í verkefninu þínu til að viðhalda stuðningi við notendur á eldri kerfum. Fyrir frekari upplýsingar um umsókn: opiðURL: source Umsókn: athugasemd :, sjáðu UIAapplicationDelegate Protocol Reference á developer.apple.com.

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ð. Þessi hluti útskýrir hvernig á að nota
getAccessTokenForScopes: withOverrideParams: fulltrúi: til að sjá hvort appið sé enn heimilað.

1. Búðu til AMZNGetAccessTokenDelegate bekk. AMZNGetAccessTokenDelegate útfærslur the AIA sannvottun siðareglur, og mun vinna úr niðurstöðu
   getAccessTokenForScopes: withOverrideParams: fulltrúi: hringja. AIA sannvottun inniheldur tvær aðferðir, requestDidSucceed: og requestDidFail :. requestDidSucceed: fær an APIResult mótmæla með táknagögnum, meðan requestDidFail: fær an APIEVilla mótmæla með upplýsingum um villuna.

   #flytja inn @interface AMZNGetAccessTokenDelegate: NSObject @lok

   Bættu haus framkvæmdastjóra þíns við bekkinn sem hringir
   getAccessTokenForScopes: withOverrideParams: fulltrúi :. Fremriample:

   #flytja inn „AMZNGetAccessTokenDelegate.h“

2. Við upphaf forrits skaltu hringja
   getAccessTokenForScopes: withOverrideParams: fulltrúi: til að sjá hvort umsóknin sé enn heimiluð. getAccessTokenForScopes: withOverrideParams: fulltrúi: sækir hráan aðgangslykil sem Innskráning með Amazon notar til að fá aðgang að atvinnumanni viðskiptavinafile. Ef aðferðin heppnast er appið enn heimilt og hringt í getProfile: ætti að ná árangri. getAccessTokenForScopes: withOverrideParams: fulltrúi: notar AIA sannvottun bókun á sama hátt og authorizeUserForScopes: fulltrúi :. Sendu hlutinn sem framkvæmir siðareglur sem breytu breytanda.

   - (ógilt) checkIsUserSignedIn { AMZNGetAccessTokenDelegate * fulltrúi = [[[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorelease]; NSArray * requestScopes = [NSArray arrayWithObjects:@”atvinnumaðurfile”, @” Póstnúmer_númer ”, ekkert]; [AIMobileLib getAccessTokenForScopes: requestScopes withOverrideParams: null fulltrúi: fulltrúi]; }

3. Innleiða requestDidSucceed: á þínum AMZNGetAccessTokenDelegate. requestDidSucceed: hefur eitt verkefni: að hringja getProfile:. Þetta frvample kallar getProfile: með því að nota sama hlustanda og þú lýstir yfir í fyrri hlutanum (sjá skref 6-8).
   

   #flytja inn “AMZNGetProfileFulltrúi.h “ #flytja inn - (void) requestDidSucceed: (APIResult *) apiResult { // Kóðinn þinn til að nota aðgangsmerki fer hér. // Þar sem umsóknin hefur heimild fyrir gildissviði okkar getum við það // fáðu user profile. AMZNGetProfileFulltrúi* fulltrúi = [[[AMZNGetProfileFulltrúi úthlutunar] initWithParentController: foreldriViewStjórnandi] heimildarútgáfa]; [AIMobileLib getProfile: fulltrúi]; }

4. Innleiða requestDidFail: á þínum AMZNGetAccessTokenDelegate.
   requestDidFail: felur í sér APIEVilla hlut sem inniheldur upplýsingar um villuna. Ef þú færð villu geturðu endurstillt aðal view stjórnandi til að sýna Login with Amazon hnappinn.

   - (void) requestDidFail: (APIError *) errorResponse { // Kóðinn þinn til að takast á við endurheimt aðgangsmerkisins. // Ef villukóði = kAIApplicationNotAuthorized, leyfðu notanda // til að skrá þig inn aftur. ef (errorResponse.error.code == kAIApplicationNotAuthorized) { // Sýna innskráningu með Amazon hnappi. } annað { // Meðhöndla aðrar villur [[[[UIAlertView alloc] initWithTitle:@”“ skilaboð: [NSString stringWithFormat: @ ”Villa kom upp með skilaboðum:% @”, errorResponse.error.message] fulltrúi: enginn cancelButtonTitle:@”OK” otherButtonTitles:nil] autorelease] show]; } }

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

The clearAuthorizationState: aðferð mun hreinsa leyfisgögn notanda úr AIMObileLib staðbundin gagnaverslun. Notandi verður að skrá sig inn aftur til að forritið nái atvinnumannifile gögn. Notaðu þessa aðferð til að skrá þig út af notanda eða til að leysa innskráningarvandamál í forritinu.

1. Lýstu yfir AMZNLogoutDelegate. Þetta er flokkur sem útfærir
   AIA sannvottunDelegateprotocol. Í okkar tilgangi getum við erft bekkinn frá NSObject:
   

   #flytja inn @interface AMZNLogoutDelegate NSObject @lok

   Bættu haus framkvæmdastjóra þíns við bekkinn sem hringir clearAuthorizationState :. Til dæmisample:

   #flytja inn “AMZNLogoutDelegate.h”

2. Hringdu clearAuthorizationState :.
   Þegar notandi hefur skráð sig inn getur þú útvegað útskráningaraðferð svo hann geti hreinsað heimildargögn sín. Vélbúnaðurinn þinn gæti verið tengill eða valmyndaratriði, en fyrir þessa atburðarás er fyrrverandiample mun búa til logoutButtonClickedmethod fyrir útskráningshnapp.

   - (IBAction) útskráningButtonClicked: (id) sendandi { AMZNLogoutDelegate* delegate = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorelease]; [AIMobileLib clearAuthorizationState:fulltrúi]; }

   Eina breytan til clearAuthorizationState er an AIA sannvottun sem útfærir requestDidSucceed: og requestDidFail :.

3. Innleiða requestDidSucceed :. Þessi aðferð verður kölluð þegar upplýsingar notandans eru hreinsaðar. Þú ættir þá að sýna þá sem útskráða.
   

   - (void) requestDidSucceed: (APIResult *) apiResult { // viðbótar rökfræði þín eftir heimild notanda // ríki er hreinsað. [[[UIAlertView úthluta] initWithTitle:@”“ skilaboð:@”Notandi útskráður.“ delegate:nil cancelButtonTitle:@”OK” otherButtonTitles:nil] show]; }

4. Innleiða requestDidFail :. Þessi aðferð verður kölluð til ef ekki er hægt að hreinsa upplýsingar notandans úr skyndiminni af einhverjum ástæðum. Í því tilfelli ættirðu ekki að sýna þá sem útskráða.
   

   - (void) requestDidFail: (APIError *) errorResponse { // Ekki tókst að hreinsa viðbótar rökfræði þína eftir SDK // heimildarríkið. [[[[UIAlertView alloc] initWithTitle:@”“ skilaboð: [NSString stringWithFormat: @ ”Útskráning notanda mistókst með skilaboð:% @”, errorResponse.error.message] fulltrúi: enginn cancelButtonTitle:@”OK” otherButtonTitles:nil] autorelease] show]; }

Prófaðu samþættingu þína

Ræstu forritið þitt í iOS tæki eða hermi og staðfestu að þú getir skráð þig inn með Amazon.com skilríkjunum þínum.

Athugið: Þegar prófað er á iOS10 hermum gætirðu séð villuskilaboðin APIKey fyrir forritið er ógild fyrir heimildUserForScopes beiðni, eða Óþekkt villukóði fyrir skýranAuthorizationState beiðni. Þetta er þekktur galla hjá Apple sem á sér stað þegar SDK reynir að fá aðgang að lyklakippunni. Þangað til Apple leysir villuna geturðu unnið í kringum hana með því að gera hlutdeild lykilhjóla fyrir forritið þitt undir flipanum Hæfileikar miða á forritið þitt. Þessi galla hefur aðeins áhrif á hermi. Þú getur prófað á raunverulegum iOS10 tækjum án þess að nota neina lausn.

Skráðu þig inn með Amazon Byrjunarleiðbeiningar fyrir iOS útgáfu 2.1.2 - Sækja [bjartsýni]
Skráðu þig inn með Amazon Byrjunarleiðbeiningar fyrir iOS útgáfu 2.1.2 - Sækja

Heimildir

• Notendahandbók