Identifikohu me Amazon Guide Starting Started për iOS

 

Identifikohu me Amazon: Udhëzuesi i Fillimit për iOS

Të drejtat e autorit © 2016 Amazon.com, Inc., ose bashkëpunëtorët e saj. Të gjitha të drejtat e rezervuara.
Amazon dhe logo e Amazon janë marka tregtare të Amazon.com, Inc. ose filialeve të saj. Të gjitha markat e tjera tregtare që nuk janë në pronësi të Amazon janë pronë e pronarëve të tyre përkatës.

Fillimi për iOS

Në këtë udhëzues ne do t'ju tregojmë se si të shtoni Login me Amazon në aplikacionin tuaj iOS. Pas përfundimit të këtij udhëzuesi, duhet të keni një buton pune Login with Amazon në aplikacionin tuaj për të lejuar përdoruesit të identifikohen me kredencialet e tyre Amazon

Po instalon Xcode

Identifikimi me Amazon SDK për iOS sigurohet nga Amazon për t'ju ndihmuar të shtoni Login me Amazon në aplikacionin tuaj iOS. SDK synon të përdoret me mjedisin e zhvillimit Xcode. SDK mbështet aplikacione që ekzekutohen në iOS 7.0 dhe më vonë duke përdorur ARMv7, ARMv7s, ARM64, i386, dhex86_64.

Ju mund ta instaloni Xcode nga Mac App Store. Për më shumë informacion, shih Xcode: Çfarë ka të re në developer.apple.com.

Pasi të instalohet Xcode, mundeni Instaloni hyrjen me Amazon SDK për iOS dhe Drejtoni SampLe App, siç përshkruhet më poshtë.

Instaloni hyrjen me Amazon SDK për iOS

Hyrja me Amazon SDK për iOS vjen në dy pako. E para përmban bibliotekën iOS dhe dokumentacionin mbështetës. E dyta përmban siample aplikacion që lejon një përdorues të regjistrohet dhe view pro e tyrefile të dhëna.

Nëse nuk e keni instaluar ende Xcode, shihni udhëzimet në Instaloni Xcode seksioni i mësipërm.

1. Shkarkoni HyrMe AmazonSDKForiOS.zip dhe nxirrni files në një direktori në hard diskun tuaj.
   Ju duhet të shihni një LoginWithAmazon.kornizë direktoria. Kjo përmban hyrjen me bibliotekën Amazon.
   Në nivelin e lartë të zip është një LoginWithAmazon.doc vendos direktorinë. Kjo përmban dokumentacionin e API-së.
2. Shihni Instaloni hyrjen me Bibliotekën Amazon për udhëzime se si të shtoni bibliotekën në një projekt iOS.

Kur të instalohet hyrja me Amazon SDK për iOS, mundeni Krijoni një hyrje të re me Amazon Project pas Regjistrimi me Login me Amazon.

Drejtoni SampLe App

Për të drejtuar sample aplikim, hapni sample në Xcode.

1. Shkarkoni SampleLoginWithAmazonAppForiOS.zip dhe kopjoni
   Sampdrejtori leLoginWithAmazonAppForiOS në dosjen tuaj Dokumente.
2. Filloni Xcode. Nëse shfaqet dialogu Mirë se vini në Xcode, klikoni Hap Tjetër. Përndryshe, klikoni në menunë kryesore File dhe zgjidhni Hap.
3. Zgjidhni dosjen Documents dhe zgjidhni
   SampleLoginWithAmazonAppForiOS/IdentifikohuAmazonSample/ LoginWithAmazonSample.xcodeproj. Klikoni Hapur.
4. Sampprojekti tani duhet të ngarkohet. Kur të përfundojë, zgjidhni Produkti nga menyja kryesore dhe zgjidh Vraponi

Regjistrimi me Login me Amazon

Përpara se të mund të përdorni Login me Amazon në një webfaqe ose në një aplikacion celular, duhet të regjistroni një aplikacion me Identifikohu me Amazon. Aplikacioni juaj Hyrja me Amazon është regjistrimi që përmban informacion bazë për biznesin tuaj dhe informacion për secilin websajti ose aplikacioni celular që krijoni që mbështet identifikimin me Amazon. Ky informacion biznesi u shfaqet përdoruesve sa herë që përdorin Identifikimin me Amazon në telefonin tuaj webfaqe ose aplikacion celular. Përdoruesit do të shohin emrin e aplikacionit tuaj, logon tuaj dhe një lidhje me politikën tuaj të privatësisë. Këto hapa demonstrojnë se si të regjistroheni një Hyrje me aplikacionin Amazon dhe të shtoni një aplikacion iOS në atë llogari.

Shihni temat vijuese

• Regjistroni hyrjen tuaj me aplikacionin Amazon
• Shtoni një aplikacion iOS në një Pro Securityfile
• Çelësat e ID të Pakos iOS dhe API
  o Përcaktoni një Identifikues Paketash për një Aplikacion iOS
  o Merr një çelës iOS API

Regjistroni hyrjen tuaj me aplikacionin Amazon

1. Shko tek https://login.amazon.com.
2. Nëse jeni regjistruar më parë për Login me Amazon, klikoni Konsolë aplikacioni. Përndryshe, kliko Regjistrohu.
   Ju do të ridrejtoheni tek Seller Central, i cili merret me regjistrimin e aplikacionit për hyrje me Amazon. Nëse kjo është hera juaj e parë që përdorni Seller Central, do t'ju kërkohet të krijoni një llogari Seller Central.
3. Klikoni Regjistro një aplikacion të ri. Të Regjistroni aplikacionin tuaj do të shfaqet forma:
   
   a. Në Regjistrohuni në formularin tuaj të aplikimit, futni një emër dhe a Përshkrimi për aplikimin tuaj.
   Të Emri është emri që shfaqet në ekranin e pëlqimit kur përdoruesit pranojnë të ndajnë informacionin me aplikacionin tuaj. Ky emër vlen për Android, iOS dhe webversionet e faqes së aplikacionit tuaj.
   b. Futni një Njoftim të Privatësisë URL për aplikimin tuaj.
   Njoftimi i Privatësisë URL është vendndodhja e politikës së privatësisë së kompanisë ose aplikacionit tuaj (p.shample, http: //www.example.com/privacy.html). Kjo lidhje u shfaqet përdoruesve në ekranin e pëlqimit.
   c. Nëse dëshironi të shtoni një Imazhi i logos për aplikimin tuaj, klikoni Shfletoni dhe gjeni imazhin e aplikueshëm.
   Kjo logo shfaqet në ekranin e identifikimit dhe pëlqimit për të përfaqësuar biznesin tuaj ose webfaqe. Logoja do të zvogëlohet në 50 piksel në lartësi nëse është më e gjatë se 50 piksele; nuk ka kufizime në gjerësinë e logos.
4. Klikoni Ruaj. s juajampRegjistrimi duhet të duket i ngjashëm me këtë:
   Pasi të ruhen cilësimet e aplikacionit tuaj bazë, mund të shtoni cilësime për të veçanta webfaqet dhe aplikacionet celulare që do të përdorin këtë Hyrje me llogarinë Amazon.
   

Nëse versione të ndryshme të aplikacionit tuaj kanë ID të ndryshëm të paketës, të tilla si për një ose më shumë versione testimi dhe një version prodhimi, secili version kërkon çelësin e tij API. Nga Cilësimet e iOS të aplikacionit tuaj, klikoni në Shto çelësin API butonin për të krijuar çelësa shtesë për aplikacionin tuaj (një për version).

Shtoni një aplikacion iOS në një Pro Securityfile

Pasi të ruhen cilësimet e aplikacionit tuaj bazë, mund të shtoni cilësime për të veçanta webfaqet dhe aplikacionet celulare që do të përdorin këtë Hyrje me llogarinë Amazon.

Për të regjistruar një aplikacion iOS, duhet të specifikoni identifikuesin Bundle për projektin e aplikacionit. Identifikimi me Amazon do të përdorë ID-në e paketës për të gjeneruar një çelës API. Çelësi API do t'i japë aplikacionit tuaj hyrje në shërbimin e autorizimit Login with Amazon. Ndiqni këto hapa për të shtuar një aplikacion iOS në llogarinë tuaj:

1. Nga ekrani i aplikacionit, klikoni Cilësimet e iOS. Nëse tashmë keni regjistruar një aplikacion iOS, shikoni për Shto çelësin API butonin në Cilësimet e iOS seksioni.
   Të Aplikacioni iOS Do të shfaqet formulari i detajeve:
   
2. Futni Etiketa të aplikacionit tuaj iOS. Ky nuk duhet të jetë emri zyrtar i aplikacionit tuaj. Ai thjesht identifikon këtë aplikacion të veçantë iOS midis aplikacioneve dhe webfaqet e regjistruara në Hyrjen tuaj me aplikacionin Amazon.
3. Futni tuajën ID e paketës. Kjo duhet të përputhet me identifikuesin e paketës së projektit tuaj iOS. Për të përcaktuar identifikuesin tuaj të paketës, hapni projektin në Xcode. Hapni listën e pronave për projektin ( -Info.plist) në Projekti Navigator. Identifikuesi i Paketës është një nga vetitë në listë.
4. Klikoni Ruaj.

Çelësat e ID të Pakos iOS dhe API

Identifikuesi i Paketës është unik për çdo aplikacion iOS. Identifikimi me Amazon përdor ID të Bundle për të ndërtuar çelësin tuaj API. Çelësi API mundëson hyrjen me shërbimin e autorizimit Amazon për të njohur aplikacionin tuaj.

Përcaktoni një Identifikues Paketash për një Aplikacion iOS

1. Hapni projektin tuaj të aplikacionit në Xcode.
2. Hapni Lista e Pronave të Informacionit për projektin ( -Info.plist) në Projekti Navigator.
3. Gjeni Identifikuesi i paketës në listën e pronave.

Merr një çelës iOS API

Pasi të keni regjistruar një version iOS dhe të keni dhënë një ID të Paketës, mund të merrni tastin API nga faqja e regjistrimit për aplikimin tuaj Login with Amazon. Do të duhet ta vendosni atë çelës API në listën e pronave të projektit tuaj. Derisa ta bëni, aplikacioni nuk do të autorizohet të komunikojë me shërbimin e autorizimit Login with Amazon.

1. Shkoni në https://login.amazon.com.
2. Klikoni Konsolë aplikacioni.
3. Në Aplikacionet kutinë, klikoni në aplikacionin tuaj.
4. Gjeni aplikacionin tuaj iOS nën Cilësimet e iOS seksioni. Nëse nuk keni regjistruar tashmë një aplikacion iOS, shihni Shtoni një aplikacion iOS në një Pro Securityfile.
5. Klikoni Gjeneroni vlerën kryesore të API. Një dritare që shfaqet do të shfaqë çelësin tuaj API. Për të kopjuar çelësin, klikoni Zgjidhni Të gjitha për të zgjedhur të gjithë çelësin.
Shënim: Vlera kryesore e API bazohet, pjesërisht, në kohën kur gjenerohet. Kështu, Vlera (t) Kryesore e API-së që gjeneroni mund të ndryshojnë nga origjinali. Ju mund të përdorni ndonjë nga këto Vlerat kryesore të API-së në aplikacionin tuaj pasi të gjitha janë të vlefshme.
6. Shih Shtoni çelësin tuaj API në listën tuaj të pronave të aplikacionit tuaj për udhëzime për shtimin e çelësit API në aplikacionin tuaj iOS

Krijimi i një hyrje me projektin Amazon

Në këtë seksion, ju do të mësoni se si të krijoni një projekt të ri Xcode për Login me Amazon dhe të konfiguroni projektin.

Shihni temat vijuese:

• Krijoni një hyrje të re me Amazon Project
• Instaloni hyrjen me Bibliotekën Amazon
• Shtoni çelësin tuaj API në listën tuaj të pronave të aplikacionit tuaj
• Shtoni një URL Skema në listën tuaj të pronave të aplikacionit tuaj
• Shtoni një Përjashtim të Sigurisë së Transportit të Aplikacionit për Amazon në Aplikacionin tuaj Lista e Pronave
  SHËNIM: Ky hap i ri kërkohet aktualisht kur zhvillohet në iOS 9 SDK
• Shtoni një hyrje me butonin Amazon në aplikacionin tuaj

Krijoni një hyrje të re me Amazon Project

Nëse nuk keni ende një projekt aplikacioni për përdorimin e Login me Amazon, ndiqni udhëzimet më poshtë për të krijuar një të tillë. Nëse keni një aplikacion ekzistues, kaloni te seksioni Instalo hyrjen me Bibliotekën Amazon më poshtë.

1. Nisja Xcode.
2. Nëse ju paraqitet një Mirësevini në Xcode dialog, zgjidhni Krijoni një Projekt të Ri Xcode.
   Përndryshe, nga File menu, zgjidhni E re dhe Projekti.
3. Zgjidhni llojin e projektit që dëshironi të krijoni dhe klikoni Tjetra.
4. Shkruani a Emri i produktit dhe a Identifikuesi i Kompanisë. Vini re tuajin Identifikuesi i paketës, dhe klikoni Tjetra.
5. Zgjidhni një vendndodhje në të cilin do të ruani projektin tuaj dhe klikoni Krijo.
   Tani do të keni një projekt të ri që mund ta përdorni për të thirrur Login me Amazon.

Instaloni hyrjen me Bibliotekën Amazon

Nëse nuk e keni shkarkuar ende hyrjen me Amazon SDK për iOS, shihni Instaloni hyrjen me Amazon SDK për iOS.

Një hyrje me projektin Amazon duhet të lidhë LoginWithAmazon.kornizë dhe Siguria.korniza bibliotekat. Ju gjithashtu do të duhet të konfiguroni shtegun e kërkimit kornizë për të gjetur Login me headers Amazon

1. Me projektin tuaj të hapur në Xcode, zgjidhni Kornizat dosje, kliko File nga menyja kryesore dhe më pas zgjidhni Shtoni Files te "Projekt".
2. Në dialog, zgjidhni LoginWithAmazon.kornizë dhe kliko Shto.
   Nëse keni përdorur bibliotekën Login with Amazon 1.0, fshini direktorinë login-with-amazon sdk dhe login-with-amazon-sdk.a nga dosja Kornizat. Klikoni Redakto nga menyja kryesore dhe zgjidh Fshije.
3. Zgjidhni emrin e projektit tuaj në Projekti Navigator.
   Të Redaktor i Projektit do të shfaqet në zonën e redaktuesit të hapësirës së punës Xcode.
4. Klikoni emrin e projektit tuaj nën Objektivat, dhe zgjidhni Faza e ndërtimit. Zgjero Lidhjen Binare me Bibliotekat dhe kliko në shenjën plus për të shtuar një bibliotekë.
5. Në kutinë e kërkimit, futni Siguria.korniza. Zgjidhni Siguria.korniza dhe kliko Shtoni.
6. Në kutinë e kërkimit, futni SafariServices.kornizë. Zgjidhni SafariServices.kornizë dhe klikoni Shtoni.
7. Në kutinë e kërkimit, futni Grafika Core.kornizë. Zgjidhni Grafika Core.kornizë dhe klikoni Shtoni
8. Zgjidhni Ndërtimi i cilësimeveMe Klikoni Të gjitha për të view të gjitha cilësimet.
9. Nën Shtigjet e Kërkimit, sigurohuni që LoginWithAmazon.kornizë direktoria është në Shtigjet e kërkimit kornizë.
   Për shembullampe:
   
   Nëse keni përdorur hyrjen me bibliotekën Amazon 1.0, mund të hiqni çdo referencë në rrugën e bibliotekës 1.0 në Shtigjet e kërkimit të kokës or Shtigjet e Kërkimit të Bibliotekës.
10. Nga menyja kryesore, klikoni Produkti dhe zgjidhni Ndërtoni. Ndërtimi duhet të përfundojë me sukses.
    Para se të ndërtoni projektin tuaj, nëse keni përdorur bibliotekën Login with Amazon 1.0, zëvendësoni # import "AIMobileLib.h", # import "AIAuthenticationDelegate.h", or #import "AIError.h" në burimin tuaj files me #import
    .
    IdentifikohuMeAmazon.h përfshin të gjitha hyrjet me kokat Amazon në të njëjtën kohë.

Shtoni çelësin tuaj API në listën tuaj të pronave të aplikacionit tuaj

Kur regjistroni aplikacionin tuaj iOS me Login me Amazon, ju caktohet një çelës API. Ky është një identifikues që Biblioteka Mobile Amazon do të përdorë për të identifikuar aplikacionin tuaj në shërbimin e autorizimit Login with Amazon. Biblioteka Mobile Amazon e ngarkon këtë vlerë gjatë kohës së ekzekutimit nga vlera kryesore e pronës API në Listën e Pronave të Informacionit të aplikacionit tuaj.

1. Me projektin tuaj të hapur, zgjidhni Mbështetëse Files dosje, pastaj zgjidhni -Info.plist file (ku është emri i projektit tuaj). Kjo duhet të hapë listën e pronave për redaktim:
   
2. Sigurohuni që asnjë nga shënimet nuk është zgjedhur. Pastaj, nga menyja kryesore, klikoni Redaktor, dhe Shto artikullin. Hyni APIKçel dhe shtypni Hyni.
3. Klikoni dy herë nën Vlera kolona për të shtuar një vlerë. Ngjitni çelësin tuaj API si vlerë.

Shtoni një URL Skema në listën tuaj të pronave të aplikacionit tuaj

Kur përdoruesi të hyjë, ata do të paraqiten me një faqe hyrjeje në Amazon. Në mënyrë që aplikacioni juaj të marrë konfirmimin e hyrjes së tij, duhet të shtoni një URL skemë në mënyrë që web faqja mund të ridrejtohet përsëri në aplikacionin tuaj. E URL skema duhet të deklarohet si amzn- (për shembullample, amzncom.example.app) Për më shumë informacion, shih Duke përdorur URL Skemat për të komunikuar me aplikacionet në developer.apple.com.

1. Me projektin tuaj të hapur, zgjidhni Mbështetëse Files dosje, pastaj zgjidhni -Info.plist file (ku është emri i projektit tuaj). Kjo duhet të hapë listën e pronave për redaktim:
   
2. Sigurohuni që asnjë nga shënimet nuk është zgjedhur. Pastaj, nga menyja kryesore, klikoni Redaktor, dhe Shto artikullin. Hyni ose zgjidhni URL llojet dhe shtypni Hyni.
3. Zgjerojeni URL llojet për të zbuluar Artikulli 0. Zgjidhni Artikulli 0 dhe, nga menyja kryesore, klikoni Editor dhe Shto artikullin. Hyni ose zgjidhni URL Identifikuesi dhe shtypni Hyni.
4. Zgjidhni Artikulli 0 nën URL Identifikues dhe kliko dy herë nën kolonën Vlera për të shtuar një vlerë. Vlera është ID-ja juaj e paketës. Ju mund ta gjeni ID-në tuaj të paketës të listuar si identifikues të Paketës në listën e pronave.
5. Zgjidhni Artikulli 0 nën URL llojet dhe, nga menyja kryesore, kliko Redaktor dhe Shto artikullin. Hyni ose zgjidhni URL Skemat dhe shtypni Enter.
6. Zgjidhni Artikulli 0 nën URL Skemat dhe kliko dy herë nën Vlera kolona për të shtuar një vlerë. Vlera është ID-ja juaj e paketës amzn- paraprakisht (për shembullample, amzn com.example.app). Ju mund ta gjeni ID-në tuaj të paketës të renditur si Identifikuesi i paketës në listën e pasurisë.

Shtoni një Përjashtim të Sigurisë së Transportit të Aplikacionit për Amazon në Aplikacionin tuaj
Lista e Pronave

Duke filluar me iOS 9, Apple zbaton Sigurinë e Transportit të Aplikacioneve (ATS) për lidhje të sigurta midis një aplikacioni dhe web shërbimet. Pika përfundimtare (api.amazon.com) Hyrja me Amazon SDK ndërvepron për të shkëmbyer informacion nuk përputhet ende me ATS. Shtoni një përjashtim për api.amazon.com për të mundësuar një komunikim pa probleme midis SDK dhe serverit Amazon.

1. Me projektin tuaj të hapur, zgjidhni Mbështetëse Files dosje, pastaj zgjidhni -Info.plist file (ku është emri i projektit tuaj). Kjo duhet të hapë parashikimin e listës së pronave:
   
2. Sigurohuni që asnjë nga shënimet të mos jetë. Pastaj, nga menyja kryesore, klikoni Redaktor, dhe Shto artikull. Hyni ose zgjidhni Siguria e NSAppTransport dhe shtypni Hyni.
3. Zgjerojeni Siguria e NSAppTransport dhe, nga menyja kryesore, kliko Redaktor dhe Shto artikull. Hyni ose zgjidhni NSEPërjashtimiFushat dhe shtypni Hyni.
4. Zgjerojeni NSEPërjashtimiFushat dhe, nga menyja kryesore, kliko Redaktor dhe Shto artikull. Hyni në amazon.com dhe shtypni Hyni.
5. Zgjerojeni amazon.com dhe, nga menyja kryesore, kliko Redaktor dhe Shto artikull.Hyn NSEPërjashtimiKërkonShpresë e fshehtë dhe shtypni Hyni.
6. Zgjidhni NSEPërjashtimiKërkonShpresë e fshehtë dhe kliko dy herë nën Vlera kolona për të shtuar një Zgjidhni një Lloji of Boolean dhe a Vlera of NR.

Shtoni një hyrje me butonin Amazon në aplikacionin tuaj

Identifikimi me Amazon ofron disa butona standardë që mund të përdorni për t'i nxitur përdoruesit të identifikohen nga aplikacioni juaj. Kjo pjesë jep hapa për shkarkimin e një hyrje zyrtare me imazhin Amazon dhe çiftimin e tij me një UIB Button iOS.

1. Shtoni një UIB buton standard në aplikacionin tuaj.
   Për udhëzime dhe informacione se si të shtoni një buton në një aplikacion, shihni Krijimi dhe Konfigurimi View Objektet dhe Filloni të zhvilloni aplikacione për iOS sot në developer.apple.com.
2. Shtoni Prekni Brenda ngjarje për butonin në një metodë të quajtur onLoginButtonKlikuar. Lëreni zbatimin tani për tani bosh. Krijimi dhe Konfigurimi View Objektet dhe Filloni të zhvilloni aplikacione për iOS sot dokumentet në apple.com përfshijnë hapa për shtimin e një ngjarjeje butoni.
3. Zgjidhni një imazh butoni.
   Konsultohuni me hyrjen tonë me Amazon Udhëzimet e stilit për një listë butonash që mund të përdorni në aplikacionin tuaj. Shkarkoni një kopje të LWA_for_iOS.zip fileMe Gjeni butonin tuaj të preferuar si në drejtoritë 1x ashtu edhe në 2x dhe nxirreni ato nga zip. Nxirrni versionin e shtypur të butonit tuaj nëse doni ta shfaqni butonin në një gjendje të zgjedhur.
4. Shtoni imazhet në projektin tuaj.
   a. Në Xcode, me projektin tuaj të ngarkuar, klikoni File nga menyja kryesore dhe zgjidh Shtoni Files për të "projektuar".
   b. Në dialog, zgjidhni imazhin e butonit file(t) që keni shkarkuar dhe klikoni Shtoni.
   c. Butonat tani duhet të jenë në projekt nën direktorinë e projektit tuaj. Lëvizni ata te Mbështetja Filesfolder
5. Shtoni imazhin në butonin tuaj.
   Për të aktivizuar imazhin për butonin tuaj, mund të modifikoni tiparin e butonit ose të përdorni atë setImage: forState metodë në Butoni UIB Objekt. Ndiqni këto hapa për të modifikuar atributin e figurës për butonin tuaj:
   a. Hapni panelin e historive për aplikacionin tuaj.
   b. Zgjidhni butonin në panelin tuaj të historive duke e klikuar atë ose duke e zgjedhur atë nga View Kontrolluesi Pema e skenës.
   c. Në Shërbimet komunale dritare, hapni Atributet Inspektori.
   
   d. Në krye të Inspektorit të Atributeve, vendosni Llojin e butonit te Sistemi.
   e. Në grupin e dytë të cilësimeve, zgjidhni Default for State Config.
   f. Në grupin e dytë të cilësimeve, lëshoni poshtë Cilësimin e Imazhit.
   g. Zgjidhni grafikun e hyrjes me butonin Amazon që keni shtuar në projekt. Mos zgjidhni versionin 2x: ai do të ngarkohet automatikisht në pajisjet me ekran me dendësi të lartë (Retina).
   h. Vendosni të njëjtën imazh për cilësimin Sfondi.
   i. Nëse dëshironi të specifikoni një version të shtypur të butonit, zgjidhni Selected for State Config dhe vendosni Imazhin në versionin _Pression të butonit tuaj.
   j. Në tabelën e historive, rregulloni madhësinë e butonit tuaj për të akomoduar imazhin, nëse është e nevojshme.

Përdorimi i SDK-së për API-të e iOS

Në këtë seksion, ju do të shtoni kodin në projektin tuaj për të hyrë në një përdorues me Login me Amazon.
Shihni temat vijuese:

• Trajtoni butonin e hyrjes dhe bëhuni profesionistfile Të dhënat
• Kontrolloni për hyrjen e përdoruesit në fillimin
• Pastroni shtetin e autorizimit dhe dilni nga përdoruesi

Trajtoni butonin e hyrjes dhe bëhuni profesionistfile Të dhënat

Kjo pjesë shpjegon mënyrën e thirrjes autorizoniUserForScopes: delegoni: dhe getProfile: API -të për të hyrë në një përdorues dhe për të marrë profesionistin e tyrefile të dhënave. Kjo përfshin krijimin e një onLoginButtonKlikuar: dëgjues për butonin Login me Amazon.

1. Shtoni Login me Amazon në projektin tuaj iOS. Shihni Instaloni hyrjen me Bibliotekën Amazon.
2. Importoni hyrjen me Amazon API në burimin tuaj file.
   Për të importuar hyrjen me Amazon API, shtoni sa vijon # importet te burimi juaj file:

   # import

3. Krijo AMZNAutorizoUserDelegateclass për të zbatuar
   Delegate e Vërtetimit të AIA-s.
   Kur autorizoniUserForScopes: delegoni: plotëson, do të thërrasë kërkesa A arriti: or kërkesa DidFail: metodë në një objekt që zbaton Delegate e Vërtetimit të AIA-s protokoll.

   @interface AMZNAuthorizeUserDelegate: NSObject @ fund

   Për më shumë informacion, shihni Duke punuar me Protokollet  në developer.apple.com.
4. Thirrni autorizoniUserForScopes: delegoni: in onLoginButtonKlikuar.
   Nëse keni ndjekur hapat brenda Shtoni një hyrje me butonin Amazon në aplikacionin tuaj, ju duhet të keni një onLoginButtonClicked: metodë e lidhur me një buton Login me Amazon. Në atë metodë, telefononi autorizojUserForScopes: delegoj: te nxisni përdoruesin të identifikohet dhe autorizojë aplikacionin tuaj.
   Kjo metodë do t'i mundësojë përdoruesit të identifikohet dhe të pajtohet me informacionin e kërkuar në një nga mënyrat e mëposhtme:
   1.) Kalon në web view në një kontekst të sigurt (nëse aplikacioni Amazon Shopping është i instaluar në pajisje)
   2.) Kalon në Safari View Kontrolluesi (në iOS 9 dhe më vonë)
   3.) Kalon në shfletuesin e sistemit (në iOS 8 dhe më herët)
   Konteksti i sigurt për opsionin e parë është i disponueshëm kur aplikacioni Amazon Shopping është instaluar në pajisje. Nëse përdoruesi është identifikuar tashmë në aplikacionin Amazon Shopping, faqja e identifikimit anashkalohet, duke çuar në një Hyrja e vetme (SSO) përvojë.

   Kur aplikacioni juaj është i autorizuar, ai është i autorizuar për një ose më shumë grupe të dhënash të njohura si fushëveprime. Parametri i parë është një varg sferash që përfshijnë të dhënat e përdoruesit që po kërkoni nga Login me Amazon. Herën e parë që një përdorues hyn në aplikacionin tuaj, ata do të paraqiten me një listë të të dhënave që ju kërkoni dhe do t'ju kërkohet miratim. Identifikimi me Amazon aktualisht mbështet tre fusha: profile, e cila përmban emrin e përdoruesit, adresën e postës elektronike dhe ID-në e llogarisë Amazon; profile: user_id, e cila përmban vetëm id-in e llogarisë Amazon; dhe Kodi Postar, i cili përmban kodin postar / postar të përdoruesit.
   Parametri i dytë për të autorizoniUserForScopes: delegoni: është një objekt që zbaton Protokolli i Vërtetimit AIADelegate, në këtë rast një shembull i AMZNAutorizoniDelegatin e Përdoruesit klasës.

   - (IBAction) onLogInButtonKlikuar: (id) dërguesi { // Bëni autorizim të thirrjes në SDK për të marrë një shenjë hyrëse të sigurt // për përdoruesin. // Ndërsa bëni thirrjen e parë, mund të specifikoni minimumin bazë // fushat e nevojshme. // Kërkimi i të dy fushave për përdoruesin aktual. NSArray * kërkesaScopes = [NSArray arrayWithObjects:@”profile”, @” Kodi postar ”, zero]; Delegojë AMZNAuthorizeUserDelegate * [[AMZNAuthorizeUserDelegate alokojë] initWithParentController: vetë]; [AIMobileLib autorizojëUserForScopes: delego delegatin e kërkesës: fushatën];

   Shtoni titullin e zbatimit të delegatit në thirrjen e klasës
   autorizojUserForScopes :. Për shembullampe:

   #import "AMZNAuthorizeUserDelegate.h"

5. Krijo një AMZNGetProfileDelegate.
   AMZNGetProfileDelegateis emri ynë për një klasë që zbaton
   Protokolli i Vërtetimit AIADelegate, dhe do të përpunojë rezultatin e getProfile: thirrje Ashtu si autorizoniUserForScopes: delegoni :, getProfile: mbështet kërkesa A arriti: dhe kërkesa DidFail: metodat e protokollit. kërkesa A arriti: merr një I PADI objekt me profile të dhëna në vetinë e rezultatit. kërkesa DidFail: merr një Gabim në AI objekt me informacion mbi gabimin në vetinë e gabimit.
   Për të krijuar një klasë të deleguar nga një deklaratë e klasës normale, importo
   AIAuthenticationDelegate.dorëz shtoni protokollin në deklaratë në kokën tuaj të klasës file:

   #import @ndërfaqe AMZNGetProfileDelegat: NSObject @end

    

6. Zbatoni kërkesëAidSuksesi: për juaj AMZNAutorizoniDelegatin e Përdoruesit. In kërkesa A arriti :, telefononi getProfile: për të rimarrë klientin profile. getProfile:, si autorizoUserForScopes: delegat :, përdor protokollin AIAuthenticationDelegate.
   

   - (e pavlefshme) kërkesa A e arriti: (APIResult *) apiResult { // Kodi juaj pasi përdoruesi të autorizojë aplikacionin për // fushëveprimet e kërkuara. // Ngarko të re view kontrollues me informacion identifikues të përdoruesit // pasi përdoruesi është identifikuar me sukses. AMZNGetProfileDelegat* delegat = [[AMZNGetProfileDelegate alloc] initWithParentController:prindViewKontrollues] lëshim automatik]; [AIMobileLib getProfile: delegoj]; }

   Shtoni titullin e zbatimit të delegatit në thirrjen e klasës getProfile: Forexampe:
   

   #import "AMZNGetProfileDelegat.h ”

7. Zbatoni kërkesa A arriti: për tuajin AMZNGetProfileDelegate.
   kërkesaDidSuksesi: ka dy detyra kryesore: të rimarrë profesionistinfile të dhënat nga PIRRFundimi, dhe për të kaluar të dhënat në UI.
   Për të tërhequr profile të dhënat nga PIRRFundimi, hyni në pronën e rezultatit. Per nje getProfile: përgjigje, ajo pronë do të përmbajë një fjalor të vlerave të pronës për përdoruesin profile Vetitë. Profesionistifile pronat janë emri, emaili, dhe user_id për profesionistinfile shtrirja dhe
   kodi_postar për kodi_postar fushëveprimi.

   - (e pavlefshme) kërkesa A e arriti: (APIResult *) apiResult { // Merrni profesioninfile kërkesa u realizua. Shpaketoni profesionistinfile informacion // dhe ia kaloni prindit view kontrollues Emri i NSString * = [(Fjalori NSD *) apiResult.rezultati objectForKey: @ ”emri”]; NSString * email = [(Fjalori NSD *) apiResult.rezultati objectForKey: @ ”email”]; NSString * user_id = [(Fjalori NSD *) apiResult.rezultati objectForKey: @ ”user_id”]; NSString * Kodi_postal = [(Fjalori NSD *) apiResult.rezultati objectForKey: @ ”kodi postal”]; // Kaloni të dhënat tek view kontrollues }

8. Zbatoni kërkesa DidFail: për tuajin AMZNGetProfileDelegate.
   kërkesa DidFail: përfshin një APIE gabim objekt që përmban detaje në lidhje me gabimin. showLogInPageis një metodë hipotetike që do të rivendoste kryesore view kontrollues për të treguar butonin Hyrja me Amazon.

   - Kërkesa (e pavlefshme) DidFail: (APIError *) errorResponse { // Merr Profile kërkesa dështoi për profile fushëveprimi. // Nëse kodi i gabimit = kAIAApplicationNotAuthorized, // lejoni përdoruesin të identifikohet përsëri. nëse (errorResponse.error.code == kAIAApplicationNotAuthorized) { // Shfaq butonin e autorizimit të përdoruesit. [prindViewKontrollues showLogInPage]; } tjeter { // Trajtoni gabime të tjera [[[[UIAlartView alokoj] initWithTitle:@”” mesazh: [NSString stringWithFormat: @ ”Ndodhi një gabim me mesazhin:% @”, errorResponse.rorror.message] delegat: zero cancelButtonTitle: @ "OK" otherButtonTitles: zero] autorelease] show]; } }

9. Zbatoni kërkesa DidFail: për juaj AMZNAutorizoniDelegatin e Përdoruesit.
   

   - Kërkesa (e pavlefshme) DidFail: (APIError *) errorResponse { NSString * mesazh = errorResponse.error.message; // Kodi juaj kur autorizimi dështon. [[[[UIAlartView alokoj] initWithTitle:@”” mesazh: [NSString stringWithFormat: @ ”Autorizimi i përdoruesit dështoi me mesazhin:% @”, errorResponse.error.message] delegat: nil cancelButtonTitle: @ "OK" otherButtonTitles: zero] autorelease] show]; }

   10. Zbatoni aplikimi: i hapurURL: SourceApplication: Annotation: në klasën në projektin tuaj që merret me Aplikimi UIADelegat protokoll (si parazgjedhje kjo do të jetë Klasa e aplikacionit në projektin tuaj). Kur aplikacioni paraqet faqen e hyrjes në Amazon dhe përdoruesi përfundon hyrjen, ai do të ridrejtohet në aplikacion duke përdorur URL Skemoni aplikacionin e regjistruar më herët. Ky ridrejtim i kalohet aplikimi: i hapurURL: SourceApplication: Annotation :, e cila kthehet PO nëse URL u trajtua me sukses. dorezaHapURL: SourceApplication: është një funksion i bibliotekës SDK që do të trajtojë hyrjen me ridrejtimin e Amazon URLs per ju Nëse dorezaHapURL: sourceApplication: kthen PO, pastaj URL u trajtua.

   - Aplikimi (BOOL): (UIApplication *) aplikimi hapurURL: (NSURL *)url sourceApplication: (NSString *) sourceApplication shënim: (id) shënim { // Kalo në url te SDK për të analizuar kodin e autorizimit // nga url. BOOL është i pavlefshëmRedirectSignInURL = [AIMobileLib doreza HapurURL:url burimiKation i aplikimit: ce e thartëApplicati në); nëse (! ështëValidRedirect Si gnlnURL) kthimi JO; // Aplikacioni mund të dëshirojë të trajtojë url ktheje PO; }

   SHËNIM: Kjo metodë është zhvlerësuar në iOS 9 por duhet të përfshihet në projektin tuaj për të ruajtur mbështetjen për përdoruesit në platformat e vjetra. Për më shumë informacion në aplikimi: i hapurURL: SourceApplication: Annotation :, shih Referenca e Protokollit të Delegatit të UIApplication në developer.apple.com.

Kontrolloni për hyrjen e përdoruesit në fillimin

Nëse një përdorues hyn në aplikacionin tuaj, e mbyll aplikacionin dhe rifillon aplikacionin më vonë, aplikacioni është ende i autorizuar të marrë të dhënat. Përdoruesi nuk del automatikisht. Gjatë fillimit, mund t'i tregoni përdoruesit si të regjistruar nëse aplikacioni juaj është ende i autorizuar. Kjo pjesë shpjegon mënyrën e përdorimit
getAccessTokenForScopes: withOverrideParams: delegat: për të parë nëse aplikacioni është ende i autorizuar.

1. Krijo një Delegat AMZNGetAccessToken klasës. Zbatimet e AMZNGetAccessTokenDelegate të Delegate e Vërtetimit të AIA-s protokoll, dhe do të përpunojë rezultatin e
   getAccessTokenForScopes: withOverrideParams: delegat: telefononi. Delegate e Vërtetimit të AIA-s përmban dy metoda, kërkesa A arriti: dhe kërkesa DidFail :. kërkesa a arriti: merr një I PADI objekt me të dhëna token, ndërsa kërkesa DidFail: merr një APIE gabim objekt me informacion mbi gabimin.

   # import @interface AMZNGetAccessTokenDelegate: NSObject @fund

   Shtoni titullin e zbatimit të delegatit në thirrjen e klasës
   getAccessTokenForScopes: withOverrideParams: delegat :. Forexampe:

   #import "AMZNGetAccessTokenDelegate.h"

2. Në fillimin e aplikacionit, telefono
   getAccessTokenForScopes: withOverrideParams: delegat: për të parë nëse aplikacioni është ende i autorizuar. getAccessTokenForScopes: withOverrideParams: delegat: rifiton shenjën e papërpunuar të hyrjes që përdor Login me Amazon për të hyrë në një profesionist të klientitfileMe Nëse metoda ka sukses, aplikacioni është ende i autorizuar dhe një thirrje për getProfile: duhet të ketë sukses. getAccessTokenForScopes: withOverrideParams: delegat: përdor Delegate e Vërtetimit të AIA-s protokolli në të njëjtën mënyrë si autorizojUserForScopes: delegat :. Kaloni objektin që zbaton protokollin si parametër të deleguar.

   - (i pavlefshëm) checkIsUserSignedIn { Delegat AMZNGetAccessTokenDelegate * [[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorlease]; NSArray * kërkesaScopes = [NSArray arrayWithObjects:@”profile”, @” Kodi postar ”, zero]; [AIMobileLib getAccessTokenForScopes: requestScopes withOverrideParams: zero delegat: delegat]; }

3. Zbatoni kërkesa A arriti: në tuajën Delegat AMZNGetAccessToken. kërkesa A arriti: ka një detyrë: të telefonojë getProfile:. Ky ishample thirrjet getProfile: duke përdorur të njëjtin dëgjues që keni deklaruar në seksionin e mëparshëm (shih hapat 6-8).
   

   #import "AMZNGetProfileDelegat.h ” # import - (e pavlefshme) kërkesa A e arriti: (APIResult *) apiResult { // Kodi juaj për të përdorur shenjën e hyrjes shkon këtu. // Meqenëse aplikacioni ka autorizim për qëllimet tona, ne mundemi // merrni përdoruesin profile. AMZNGetProfileDelegat* delegat = [[[AMZNGetProfileDelegate alokoj] initWithParentController: prindViewKontrollues] lëshim automatik]; [AIMobileLib getProfile: delegoj]; }

4. Zbatoni kërkesa DidFail: në tuajën Delegat AMZNGetAccessToken.
   kërkesa DidFail: përfshin një APIE gabim objekt që përmban detaje rreth gabimit. Nëse merrni një gabim, mund të rivendosni kryesore view kontrollues për të treguar butonin Hyrja me Amazon.

   - Kërkesa (e pavlefshme) DidFail: (APIError *) errorResponse { // Kodi juaj për të trajtuar rikuperimin e dështuar të shenjës së hyrjes. // Nëse kodi i gabimit = kAIAApplicationNotAuthorized, lejo përdoruesin // për tu identifikuar përsëri. nëse (errorResponse.error.code == kAIAApplicationNotAuthorized) { // Shfaq hyrjen me butonin Amazon. } tjeter { // Trajtoni gabime të tjera [[[[UIAlartView alokoj] initWithTitle:@”” mesazh: [NSString stringWithFormat: @ ”Gabim ndodhi me mesazhin:% @”, errorResponse.error.message] delegat: nil cancelButtonTitle:@”OK” otherButtonTitles:nil] autorlease] shfaq]; } }

Pastroni shtetin e autorizimit dhe dilni nga përdoruesi

Të qartëAuthorizationState: metoda do të pastrojë të dhënat e autorizimit të përdoruesit nga AIMobileLib dyqan lokal i të dhënave. Një përdorues do të duhet të regjistrohet përsëri në mënyrë që aplikacioni të marrë profile të dhënave. Përdoreni këtë metodë për të dalë nga përdoruesi ose për të zgjidhur problemet e hyrjes në aplikacion.

1. Deklaroni një AMZNLogoutDelegat. Kjo është një klasë që zbaton
   Protokolli i vërtetimit të AIA-sDelegate Për qëllimet tona, ne mund ta trashëgojmë klasën nga NSObjekti:
   

   # import @interface AMZNLogoutDelegate NSObject @fund

   Shtoni titullin e zbatimit të delegatit në thirrjen e klasës qartëShtati i Autorizimit :. Për shembullampe:

   #import "AMZNLogoutDelegate.h"

2. Thirrni qartëShtati i Autorizimit :.
   Kur një përdorues të jetë regjistruar me sukses, ju mund të siguroni një mekanizëm daljeje në mënyrë që ai të mund të pastrojë të dhënat e autorizimit të tij. Mekanizmi juaj mund të jetë një hiperlidhje, ose një artikull menuje, por për këtë skenar ishample do të krijojë një logoutButtonClickedmetoda për një buton të daljes.

   - Dalja nga (IBAction) ButoniKlikoi: dërguesi (id) { AMZNLogoutDelegate* delegat = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorlease]; [AIMobileLib clearAuthorizationState:delegate]; }

   I vetmi parametër për të pastroni shtetin e autorizimit është një Delegate e Vërtetimit të AIA-s që zbaton kërkesa A arriti: dhe kërkesa DidFail :.

3. Zbatoni kërkesaA arriti:. Kjo metodë do të thirret kur informacioni i përdoruesit pastrohet. Pastaj duhet t'i tregoni si të dala nga llogaria.
   

   - (e pavlefshme) kërkesa A e arriti: (APIResult *) apiResult { // Logjika juaj shtesë pas autorizimit të përdoruesit // shteti pastrohet. [[[UIAlartView alokoj] initWithTitle:@”” mesazh:@”Përdoruesi është i kyçur.” delegat:nil cancelButtonTitulli:@”OK” otherButtonTitles:nil] shfaq]; }

4. Zbatoni kërkesa DidFail :. Kjo metodë do të thirret nëse për ndonjë arsye informacioni i përdoruesit nuk mund të pastrohet nga memoria e fshehtë. Në atë rast, ju nuk duhet t'i tregoni ato si të regjistruar.
   

   - Kërkesa (e pavlefshme) DidFail: (APIError *) errorResponse { // Logjika juaj shtesë pasi SDK nuk arriti të pastrohet // gjendja e autorizimit. [[[[UIAlartView alokoj] initWithTitle:@”” mesazh: [NSString stringWithFormat: @ ”Dalja e përdoruesit dështoi me mesazhin:% @”, errorResponse.rorror.message] delegat: zero cancelButtonTitle:@”OK” otherButtonTitles:nil] autorlease] shfaq]; }

Testoni integrimin tuaj

Nisni aplikacionin tuaj në një pajisje iOS ose imitues dhe konfirmoni që mund të identifikoheni me kredencialet tuaja të Amazon.com.

Shënim: Kur testoni në imituesit iOS10, mund të shihni se mesazhi i gabimit APIKey për Aplikacionin është i pavlefshëm për një kërkesë të autorizuarUserForScopes, ose Kodi i Panjohur i Gabimit për një kërkesë të qartëAuthorizationState. Kjo eshte nje një defekt i njohur me Apple gjë që ndodh kur SDK përpiqet të hyjë në zinxhirin e çelësave. Derisa Apple të zgjidhë një defekt, ju mund të punoni rreth tij duke mundësuar Ndarjen Keychain për aplikacionin tuaj nën skedën Kapacitetet e synuar të aplikacionit tuaj. Ky defekt ndikon vetëm në simulatorët. Ju mund të provoni në pajisjet aktuale iOS10 pa përdorur ndonjë zgjidhje.

Identifikohuni me Udhëzuesin e Fillimit të Amazon për Versionin 2.1.2 të iOS - Shkarkoni [optimizuar]
Identifikohuni me Udhëzuesin e Fillimit të Amazon për Versionin 2.1.2 të iOS - Shkarkoni

Referencat

• Manuali i Përdoruesit