Ngena ngeAmazon IsiKhokelo sokuQalisa se-iOS

 

Ngena ngeAmazon: Isikhokelo sokuQalisa se-iOS

Ilungelo lokushicilela © 2016 Amazon.com, Inc., okanye amaqabane ayo. Onke Amalungelo Agciniwe.
IAmazon kunye nelogo yeAmazon ziimpawu zorhwebo zeAmazon.com, Inc. okanye imibutho yayo. Zonke ezinye iimpawu zorhwebo ezingezizo ezeAmazon ziyipropathi yabanini bazo.

Ukuqalisa kwi-iOS

Kwesi sikhokelo siza kukubonisa indlela yokongeza ukungena ngeAmazon kwi-app yakho ye-iOS. Emva kokugqiba esi sikhokelo kuya kufuneka ube nokuNgena okusebenzayo ngeqhosha leAmazon kwi-app yakho ukuvumela abasebenzisi ukuba bangene ngeempawu zabo zeAmazon.

Kuhlohlwa Xcode

Ukungena nge-Amazon SDK ye-iOS ibonelelwa yiAmazon ukukunceda ukongeza uNgena ngeAmazon kwisicelo sakho se-iOS. I-SDK yenzelwe ukuba isetyenziswe kwindawo yophuhliso lwe-Xcode. I-SDK ixhasa ii-apps ezisebenza kwi-iOS 7.0 kwaye kamva zisebenzisa i-ARMv7, ARMv7s, ARM64, i386, kunye nex86_64.

Ungayifaka iXcode kwiVenkile yeApp yeMac. Ukuze ufumane inkcazelo engakumbi, bona Xcode: Yintoni Entsha kwi-developer.apple.com.

Emva kokuba iXcode ifakiwe, unako Faka iNgeno ngeAmazon SDK ye-iOS kwaye Baleka iSampApp, njengoko kuchaziwe ngezantsi.

Faka iNgeno ngeAmazon SDK ye-iOS

Ukungena nge-Amazon SDK ye-iOS kuza kwiiphakheji ezimbini. Eyokuqala iqulethe ilayibrari iOS kunye namaxwebhu axhasayo. Eyesibini iqulathe njengeample isicelo esivumela umsebenzisi ukuba angene kwaye view ipro yabofile idatha.

Ukuba awukayifaki i-Xcode, jonga imiyalelo kwi Faka iXcode icandelo ngasentla.

1. Khuphela NgenaNgeAmazonSDKForiOS.zip kwaye ukhuphe i files kulawulo olukwihard drive yakho.
   Kuya kufuneka ubone a LoginWithAmazon.framework ulawulo. Oku kuqulathe uNgena ngethala leencwadi laseAmazon.
   Kwinqanaba eliphezulu le-zip yi-a NgenaNgeAmazon.doc cwangcisa ulawulo. Oku kuqulathe uxwebhu lwe-API.
2. 'Yabona Faka ukungena ngeThala leencwadi laseAmazon ngemiyalelo yokongeza ithala leencwadi kwiprojekthi ye-iOS.

Xa i-Login kunye ne-Amazon SDK ye-iOS ifakiwe, unako Yenza ungene ngokuNtsha ngeProjekthi yeAmazon emva Ukubhalisa ngeNgena nge-Amazon.

Baleka iSampApp

Ukuqhuba sample isicelo, vula i-sample kwi Xcode.

1. Khuphela SampleLoginWithAmazonAppForiOS.zip kwaye khuphela i
   SampleLoginWithAmazonAppForiOS ulawulo kwifolda yakho yaMaxwebhu.
2. Qalisa i-Xcode. Ukuba i Wamkelekile kwincoko yababini yeXcode pops up, cofa Vula Okunye. Ngaphandle koko, kwimenyu ephambili, cofa File uze ukhethe Vula.
3. Khetha i Amaxwebhu fowulda, uze ukhethe
   SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/ NgenaNgeAmazonSample.xcodeproj. Cofa Vula.
4. I sample projekthi kufuneka ilayishe ngoku. Xa igqityiwe, khetha Imveliso kwimenyu ephambili kwaye ukhethe Baleka

Ukubhalisa ngokuNgena ngeAmazon

Ngaphambi kokuba usebenzise Ngena ngeAmazon kwi webindawo okanye kwi-app ephathwayo, kufuneka ubhalise isicelo kunye Ngena nge-Amazon. Ukungena kwakho ngesicelo seAmazon lubhaliso oluqulethe ulwazi olusisiseko malunga neshishini lakho, kunye nolwazi malunga nelinye webindawo okanye usetyenziso lweselula olwenzayo oluxhasa Ngena ngeAmazon. Olu lwazi lweshishini luboniswa kubasebenzisi ngalo lonke ixesha besebenzisa Ngena nge-Amazon kweyakho webindawo okanye i-app yeselula. Abasebenzisi baya kubona igama lesicelo sakho, ilogo yakho, kunye nekhonkco kumgaqo-nkqubo wakho wabucala. La manyathelo abonisa indlela yokubhalisa i-Login kunye nesicelo se-Amazon kwaye ungeze i-app ye-iOS kuloo akhawunti.

Jonga le zihloko zilandelayo

• Bhalisa ukungena kwakho kunye nesicelo seAmazon
• Yongeza i-App ye-iOS kuKhuseleko lweProfile
• iOS Bundle ID kunye API Keys
  o Misela isichongi seBundle seApp ye-iOS
  o Fumana iSitshixo se-API ye-iOS

Bhalisa ukungena kwakho kunye nesicelo seAmazon

1. Yiya e https://login.amazon.com.
2. Ukuba ubhalisele ukungena ngeAmazon ngaphambili, cofa App Console. Ngaphandle koko, nqakraza Bhalisa.
   Uya kuthunyelwa kwi-Seller Central, ephethe ukubhaliswa kwesicelo sokuNgena nge-Amazon. Ukuba eli lixesha lakho lokuqala usebenzisa i-Seller Central, uya kucelwa ukuba umise i-akhawunti ye-Seller Central.
3. Cofa Bhalisa isicelo esitsha. I Bhalisa isicelo sakho ifom iya kuvela:
   
   a. Kwirejista yesicelo sakho, faka iGama kunye ne Inkcazo kwisicelo sakho.
   I Igama ligama eliboniswe kwisikrini semvume xa abasebenzisi bevuma ukwabelana ngolwazi nesicelo sakho. Eli gama lisebenza Android, iOS, kunye webIinguqulelo zesiza sesicelo sakho.
   b. Ngenisa iSaziso saBucala URL kwisicelo sakho.
   Isaziso sangasese URL yindawo yomgaqo-nkqubo wabucala wenkampani yakho okanye wesicelo (umzekeloample, http: //www.example.com/privacy.html). Eli khonkco liboniswa kubasebenzisi kwiscreen semvume.
   c. Ukuba ufuna ukudibanisa i Umfanekiso weLogo kwisicelo sakho, cofa Khangela kwaye ufumane umfanekiso ofanelekileyo.
   Le logo iboniswa kwisikrini sokungena kunye nesivumelwano sokumela ishishini lakho okanye webindawo. I-logo iya kuncitshiswa ibe yi-pixels ezingama-50 ukuphakama ukuba inde kunee-pixels ezingama-50; akukho mda kububanzi belogo.
4. Cofa Gcina. Eyakhoampukubhaliswa kwe-le kufuneka kujongeke ngendlela efanayo:
   Emva kokuba useto lwakho olusisiseko lugciniwe, unokongeza useto oluthile webiisayithi kunye neeapps ezihambayo eziza kusebenzisa ukungena ngeakhawunti yeAmazon.
   

Ukuba iinguqulelo ezahlukeneyo ze-app yakho zinee-ID ezahlukeneyo zee-ID, ezinje ngenguqulelo enye okanye ezininzi zovavanyo kunye noguqulelo lwemveliso, inguqulelo nganye ifuna iSitshixo sayo se-API. Isuka e Izicwangciso ze-iOS yohlelo lwakho lokusebenza, cofa Yongeza isitshixo se-API iqhosha lokwenza amaqhosha ongezelelweyo kwi-app yakho (inye kwinguqulelo nganye).

Yongeza i-App ye-iOS kuKhuseleko lweProfile

Emva kokuba useto lwakho olusisiseko lugciniwe, unokongeza useto oluthile webiisayithi kunye neeapps ezihambayo eziza kusebenzisa ukungena ngeakhawunti yeAmazon.

Ukubhalisa i-App ye-iOS, kufuneka uchaze isichongi se-Bundle seprojekthi ye-app. Ngena nge-Amazon uya kusebenzisa i-ID ye-bundle ukuvelisa isitshixo se-API. Isitshixo se-API siya kunika ukufikelela kwi-app yakho kwi-Login ngenkonzo yogunyaziso lwase-Amazon. Landela la manyathelo ukongeza usetyenziso lwe-iOS kwiakhawunti yakho:

1. Ukusuka kwiscreen seSicelo, cofa Izicwangciso ze-iOS. Ukuba sele une-app ye-iOS ebhalisiweyo, khangela i Yongeza isitshixo se-API iqhosha kwi Izicwangciso ze-iOS icandelo.
   I Isicelo se-iOS Ifomu yeenkcukacha iya kuvela:
   
2. Ngena i Ileyibhile yeApp yakho ye-iOS. Oku akunyanzelekanga ukuba ibe ligama elisemthethweni losetyenziso lwakho. Ichonga nje le app ethile ye-iOS phakathi kwee-apps kunye webiisayithi ezibhaliswe kuNgena kwakho kunye nesicelo seAmazon.
3. Faka eyakho I-ID ye-Bundle. Oku kufuneka kuhambelane nesichongi senqwaba yeprojekthi yakho ye-iOS. Ukumisela isichongi sakho senqwaba, vula iprojekthi kwi-Xcode. Vula uluhlu lweepropati zeprojekthi ( -Info.plist) kwi Iprojekthi yeNavigator. Isichongi seBundle yenye yeepropati kuluhlu.
4. Cofa Gcina.

iOS Bundle ID kunye API Keys

Isichongi se-Bundle sikhethekile kuyo yonke i-app ye-iOS. Ngena ngeAmazon isebenzisa i-ID ye-Bundle ukwakha isitshixo sakho se-API. Isitshixo se-API senza ukuba uNgena ngenkonzo yogunyaziso yaseAmazon uqaphele iapp yakho.

Misela isichongi seBundle seApp ye-iOS

1. Vula iprojekthi yakho ye-app kwi-Xcode.
2. Vula i Uluhlu lweePropati zoLwazi kwiprojekthi ( -Info.plist) kwi Iprojekthi yeNavigator.
3. Fumana Isichongi senqwaba kuluhlu lweepropati.

Fumana isitshixo se-API ye-iOS

Emva kokuba ubhalise inguqulo ye-iOS kwaye unikeze i-ID ye-Bundle, unokufumana kwakhona isitshixo se-API kwiphepha lokubhalisa lokuNgena kwakho ngesicelo se-Amazon. Kuya kufuneka ubeke eso sitshixo se-API kuluhlu lwepropathi yeprojekthi yakho. Ude wenze, i-app ayizukugunyaziswa ukuba inxibelelane ne-Login kunye nenkonzo yogunyaziso yaseAmazon.

1. Yiya ku https://login.amazon.com.
2. Cofa Isixhobo seConsole.
3. Kwi Usetyenziso ibhokisi, cofa isicelo sakho.
4. Fumana app yakho iOS phantsi kwe Izicwangciso ze-iOS icandelo. Ukuba awukabhalisi i-app ye-iOS, bona Yongeza i-App ye-iOS kuKhuseleko lweProfile.
5. Cofa Yenza i-API Key Ixabiso. Ifestile ye popup izakubonisa isitshixo sakho se-API. Ukukopa iqhosha, cofa Khetha Zonke ukukhetha iqhosha elipheleleyo.
Phawula: Ixabiso eliPhambili le-API lisekelwe, ngokuyinxalenye, ngexesha elenziwa ngalo. Ngaloo ndlela, i-API elandelayo Ixabiso elingundoqo olenzayo linokwahluka kweyoqobo. Ungasebenzisa naziphi na ezi API zeMigangatho ziPhambili kwi-app yakho njengoko zisebenza zonke.
6. Bona Yongeza isitshixo sakho se-API kuLuhlu lwePropati ye-App yakho imiyalelo yokongeza isitshixo API app yakho iOS

Ukwenza ukuNgena ngeProjekthi yeAmazon

Kweli candelo, uya kufunda ukwenza iprojekthi entsha yeXcode yokuNgena ngeAmazon kwaye uqwalasele iprojekthi.

Bona ezi zihloko zilandelayo:

• Yenza ungene ngokuNtsha ngeProjekthi yeAmazon
• Faka ukungena ngeThala leencwadi laseAmazon
• Yongeza isitshixo sakho se-API kuLuhlu lwePropati ye-App yakho
• Yongeza a URL Inkqubo kuLuhlu lwePropati ye-App yakho
• Yongeza i-App yoKhuseleko lwezoThutho ngaphandle kwe-Amazon kwi-App yakho Uluhlu lwePropati
  PHAWULA: Eli nyathelo elitsha ngoku liyafuneka xa kuphuhliswa kwi-iOS 9 SDK
• Yongeza ukungena ngeQhosha leAmazon kwiApp yakho

Yenza ungene ngokuNtsha ngeProjekthi yeAmazon

Ukuba awukabi nayo iprojekthi yosetyenziso lokungena ngeAmazon, landela le miyalelo ingezantsi ukwenza enye. Ukuba uneapp esele ikhona, tsiba uye kuFakela uNgeno ngecandelo leThala leencwadi laseAmazon elingezantsi.

1. Qalisa Xcode.
2. Ukuba unikwe a Wamkelekile kwi Xcode incoko yababini, khetha Yenza iProjekthi entsha yeXcode.
   Kungenjalo, ukusuka kwi File imenyu, khetha Entsha kwaye Iprojekthi.
3. Khetha uhlobo lweprojekthi onqwenela ukuyenza kwaye ucofe Okulandelayo.
4. Ngena a Igama lemveliso kunye a Isichongi seNkampani. Qaphela eyakho Isichongi seBundle, kwaye ucofe Okulandelayo.
5. Khetha indawo oza kugcina kuyo iprojekthi yakho kwaye ucofe Yenza.
   Ngoku uya kuba neprojekthi entsha onokuyisebenzisa ukubiza Ngena ngeAmazon.

Faka ukungena ngeThala leencwadi laseAmazon

Ukuba awukakhuphi uNgena ngeAmazon SDK ye-iOS, yabona Faka iNgeno ngeAmazon SDK ye-iOS.

UkuNgena ngeprojekthi yeAmazon kufuneka idibanise LoginWithAmazon.framework kwaye Ukhuseleko.isakhelo amathala eencwadi. Kuya kufuneka kwakhona uqwalasele indlela yokukhangela yesakhelo ukuze ufumane iNgena ngeentloko zeAmazon

1. Ngeprojekthi yakho evuliweyo kwiXcode, khetha i Iinkqubo incwadi eneenkcukacha, cofa File kwimenyu engundoqo, uze ukhethe Yongeza Files ukuya "iprojekthi".
2. Kwincoko yababini, khetha LoginWithAmazon.framework kwaye cofaFaka.
   Ukuba usebenzise iNgena ngelayibrari ye-Amazon 1.0, cima i-login-with-amazon sdk directory kunye ne-login-with-amazon-sdk.a kwifolda yeFrameworks. Cofa Hlela kwimenyu ephambili kwaye ukhethe Cima.
3. Khetha igama leprojekthi yakho kwi Iprojekthi yeNavigator.
   I Umhleli weProjekthi izakuvela kwindawo yomhleli wendawo yokusebenza ye Xcode.
4. Cofa igama leprojekthi yakho ngaphantsi Ekujoliswe kuko, kwaye ukhethe Yakha izigaba. Yandisa iNdibaniselwano yeBhinary ngamaThala eeNcwadi kwaye ucofe uphawu lokudibanisa ukongeza ithala leencwadi.
5. Kwibhokisi yokukhangela, ngenisa Ukhuseleko.isakhelo. Khetha Security.framework kwaye ucofe Yongeza.
6. Kwibhokisi yokukhangela, ngenisa SafariServices.framework. Khetha SafariServices.framework kwaye ucofe Yongeza.
7. Kwibhokisi yokukhangela, ngenisa CoreGraphics.isakhelo. Khetha CoreGraphics.isakhelo kwaye ucofe Yongeza
8. Khetha Yakha imimiselo. Cofa Konke ukuze view zonke izicwangciso.
9. Ngaphantsi Phendla Iindlela, qinisekisa ukuba i LoginWithAmazon.framework uvimba weefayili ukwi Iindlela zokukhangela ze-Framework.
   Umzekeloample:
   
   Ukuba usebenzise uNgena ngethala leencwadi le-Amazon 1.0, ungasusa naziphi na iimbekiselo kwindlela yethala leencwadi eli-1.0 Iindlela Zokukhangela Okusentloko or Iindlela zokukhangela kwiThala leeNcwadi.
10. Ukusuka kwimenyu ephambili, cofa Imveliso kwaye ukhethe Yakha. Ulwakhiwo kufuneka lugqitywe ngempumelelo.
    Ngaphambi kokwakha iprojekthi yakho, ukuba usebenzise iNgena ngelayibrari yeAmazon 1.0, buyisela #import "AIMobileLib.h", #import "AIAuthenticationDelegate.h", or #ngenisa "AIError.h" kumthombo wakho files kunye #ngenisa
    .
    Ngena ngeAmazon.h ibandakanya yonke iNgeno ngeentloko zeAmazon ngaxeshanye.

Yongeza isitshixo sakho se-API kuLuhlu lwePropati ye-App yakho

Xa ubhalisa isicelo sakho se-iOS kunye Ngena nge-Amazon, ubelwa isitshixo se-API. Esi sisichongi esiza kusisebenzisa iThala leeNcwadi leMobile yaseAmazon ukuchonga isicelo sakho sokuNgena ngenkonzo yogunyaziso yaseAmazon. IThala leeNcwadi leeMobile zeAmazon lilayisha eli xabiso ngexesha lokusebenza ukusuka kwixabiso lepropathi engundoqo ye-API kuLuhlu lwePropati yoLwazi lwesicelo sakho.

1. Ngeprojekthi yakho evuliweyo, khetha i Ukuxhasa Files incwadi eneenkcukacha, emva koko ukhethe i -Info.plist file (apho ligama leprojekthi yakho). Oku kufuneka kuvule uluhlu lwempahla ukuze kuhlelwe:
   
2. Qinisekisa ukuba akukho nalinye kumangeniso akhethiweyo. Emva koko, kwimenyu ephambili, cofa Umhleli, kwaye Yongeza into. Ngena APIKey kwaye ucinezele Ngena.
3. Cofa kabini phantsi kwe Ixabiso ikholamu yokongeza ixabiso. Ncamathelisa isitshixo sakho se-API njengexabiso.

Yongeza a URL Inkqubo kuLuhlu lwePropati ye-App yakho

Xa umsebenzisi engena, baya kuboniswa ngekhasi lokungena kwi-Amazon. Ukuze app yakho ukufumana isiqinisekiso sokungena kwabo, kufuneka wongeze a URL isicwangciso ukuze i web iphepha lingaphinda libuyisele umva kwi-app yakho. I URL inkqubo kufuneka ibhengezwe njenge amzn- (umzekeloample, amzncom.example.app). Ukuze ufumane inkcazelo engakumbi, bona Ukusebenzisa URL Izicwangciso zoNxibelelwano neApps kwi-developer.apple.com.

1. Ngeprojekthi yakho evuliweyo, khetha i Ukuxhasa Files incwadi eneenkcukacha, emva koko ukhethe i -Info.plist file (apho ligama leprojekthi yakho). Oku kufuneka kuvule uluhlu lwempahla ukuze kuhlelwe:
   
2. Qinisekisa ukuba akukho nalinye kumangeniso akhethiweyo. Emva koko, kwimenyu ephambili, cofa Umhleli, kwaye Yongeza into. Ngena okanye ukhethe URL iintlobo kwaye ucinezele Ngena.
3. Yandisa URL iintlobo ukutyhila Into 0. Khetha Into 0 kwaye, kwimenyu ephambili, cofa Umhleli kwaye Yongeza Into. Ngena okanye ukhethe URL Isichongi kwaye ucinezele Ngena.
4. Khetha into 0 phantsi URL Isichongi kwaye nqakraza kabini phantsi koluhlu lwexabiso ukongeza ixabiso. Ixabiso yi-ID yakho yenqwaba. Unokufumana i-ID yakho ye-bundle edweliswe njengesichongi se-Bundle kuluhlu lwepropathi.
5. Khetha into 0 phantsi URL iintlobo kwaye, kwimenyu ephambili, cofa Umhleli kwaye Yongeza into. Ngena okanye ukhethe URL Izikim kwaye ucinezele u-Enter.
6. Khetha into 0 phantsi URL Amacebo kwaye nqakraza kabini phantsi kwe Ixabiso ikholamu yokudibanisa i ixabiso. Ixabiso yi-ID yakho yenqwaba nge amzn- ilungiselelwe (umzekeloample, amzn com.example.app). Unokufumana i-ID yakho ye-bundle edweliswe njenge Isichongi senqwaba kuluhlu lwepropati.

Yongeza i-App yoKhuseleko lwezoThutho ngaphandle kwe-Amazon kwi-App yakho
Uluhlu lwePropati

Ukuqala nge-iOS 9, i-Apple inyanzelisa uKhuseleko lwezoThutho lwe-App (ATS) kunxibelelwano olukhuselekileyo phakathi kwe-app kunye web iinkonzo. Isiphelo (api.amazon.com) iNgena nge-Amazon SDK inxibelelana notshintshiselwano ngolwazi ayihambelani ne-ATS okwangoku. Yongeza ngaphandle kwe-api.amazon.com ukwenza unxibelelwano olungenamthungo phakathi kwe-SDK kunye neseva yeAmazon.

1. Ngeprojekthi yakho evuliweyo, khetha i Ukuxhasa Files incwadi eneenkcukacha, emva koko ukhethe i -Info.plist file (apho ligama leprojekthi yakho). Oku kufuneka kuvule uluhlu lwepropathi yokuhlela kwangaphambili:
   
2. Qinisekisa ukuba akukho nalinye kumangeniso Emva koko, kwimenyu ephambili, cofa Umhleli, kwaye Yongeza into. Ngena okanye ukhethe NSAppTransportSecurity kwaye ucinezele Ngena.
3. Yandisa NSAppTransportSecurity kwaye, kwimenyu ephambili, cofa Umhleli kwaye Yongeza into. Ngena okanye ukhethe NSExceptionDomains kwaye ucinezele Ngena.
4. Yandisa NSExceptionDomains kwaye, kwimenyu ephambili, cofa Umhleli kwaye Yongeza into. Ngena amazon.com kwaye ucinezele Ngena.
5. Yandisa amazon.com kwaye, kwimenyu ephambili, cofa Umhleli kwaye Yongeza into.Ngena NSExceptionRequiresForwardSecrecy kwaye ucinezele Ngena.
6. Khetha NSExceptionRequiresForwardSecrecy kwaye nqakraza kabini phantsi kwe Ixabiso ikholamu ukongeza i Khetha a Uhlobo of Boolean kunye a Ixabiso of HAYI.

Yongeza ukungena ngeQhosha leAmazon kwiApp yakho

Ngena ngeAmazon ibonelela ngamaqhosha amaninzi asemgangathweni onokuwasebenzisa ukukhuthaza abasebenzisi ukuba bangene kwi-app yakho. Eli candelo linika amanyathelo okukhuphela iNgena ngokusemthethweni kunye nomfanekiso we-Amazon kwaye uyidibanise ne-iOS UIButton.

1. Yongeza i-UIButton esemgangathweni kwi-app yakho.
   Ukufumana izifundo kunye nolwazi malunga nendlela yokongeza iqhosha kwi-app, bona Ukuyila kunye nokuqwalasela View Izinto kwaye Qala ukuphuhlisa i-iOS Apps namhlanje kwi-developer.apple.com.
2. Yongeza i Chukumisa Ngaphakathi isiganeko seqhosha kwindlela enegama onLoginButtonCliziwe. Yeka ukuphunyezwa kungenanto okwangoku. I Ukudala kunye Ukuqwalasela View Izinto kwaye Qala ukuphuhlisa i-iOS Apps namhlanje amaxwebhu kwi-apple.com abandakanya amanyathelo okongeza isiganeko seqhosha.
3. Khetha umfanekiso weqhosha.
   Nxibelelana nokuNgena kwethu kwiAmazon Izikhokelo zesitayile Uluhlu lwamaqhosha onokuwasebenzisa kwi-app yakho. Khuphela ikopi yefayili ye- LWA_for_iOS.zip file. Fumana iqhosha olikhethayo kuzo zombini ii-1x kunye ne-2x directory kwaye uzikhuphe kwi-zip. Khupha i _Uguqulelo olucinezelweyo lweqhosha lakho ukuba ufuna ukubonisa iqhosha kwisimo esiKhethiweyo.
4. Yongeza imifanekiso kwiprojekthi yakho.
   a. Kwi-Xcode, ngeprojekthi yakho elayishiwe, cofa File kwimenyu ephambili kwaye ukhethe Yongeza Files ukuya “kwiprojekthi”.
   b. Kwincoko yababini, khetha umfanekiso weqhosha file(s) oyikhupheleyo kwaye ucofe Yongeza.
   c. Amaqhosha ngoku kufuneka abe kwiprojekthi phantsi kolawulo lweprojekthi yakho. Bafudusele kwiNkxaso Fileifolda.
5. Yongeza umfanekiso kwiqhosha lakho.
   Ukwenza umfanekiso weqhosha lakho, ungaguqula kancinane uphawu lweqhosha okanye usebenzise i setUmfanekiso:forState indlela kwi UIButton into. Landela la manyathelo ukulungisa uphawu lomfanekiso weqhosha lakho:
   a. Vula ibhodi yamabali kwi-app yakho.
   b. Khetha iqhosha kwibhodi yebali lakho ngokulinqakraza okanye ngokulikhetha kwi View Umlawuli Umthi wendawo.
   c. Kwi Izinto eziluncedo windows, vula i Iimpawu zoMhloli.
   
   d. Phezulu kuMhloli wophawu lophawu, seta Uhlobo lweqhosha kwiNkqubo.
   e. Kwiqela lesibini leseto, khetha Ukungagqibeki kuBumbeko beLizwe.
   f. Kwiqela lesibini leseto, yehlisa i-Image setting.
   g. Khetha iNgena ngeqhosha le-Amazon umzobo owongeze kwiprojekthi. Sukukhetha i-2x version: iya kulayishwa ngokuzenzekelayo kwi-high density display (Retina)izixhobo.
   h. Cwangcisa umfanekiso ofanayo kwiseto yangasemva.
   i. Ukuba ufuna ukukhankanya uguqulelo olucinezelweyo lweqhosha, khetha Ikhethelwe Uqwalaselo Lwelizwe, kwaye usete uMfanekiso kuguqulelo olucinezelweyo lweqhosha lakho.
   j. Kwibhodi yamabali, lungisa ubungakanani beqhosha lakho ukulungiselela umfanekiso, ukuba kuyimfuneko.

Ukusebenzisa i-SDK ye-iOS APIs

Kweli candelo, uyakongeza ikhowudi kwiprojekthi yakho ukuze usayine kumsebenzisi ngeNgena ngeAmazon.
Bona ezi zihloko zilandelayo:

• Bamba iqhosha lokungena kunye nePro Profile Idatha
• Jonga ukungena ngemvume komsebenzisi kwisiqalo
• Cacisa ukuGunyaziswa kukaRhulumente kunye nokuPhuma kuMsebenzisi

Bamba iqhosha lokungena kunye nePro Profile Idatha

Eli candelo lichaza indlela yokubiza i gunyazisaUserForScopes:delegate: kwaye getProfile:APIs ukungena kumsebenzisi kwaye ufumane ipro yabofile idatha. Oku kuquka ukwenza i onLoginButtonCliziwe:umphulaphuli ngokuNgena kwakho ngeqhosha leAmazon.

1. Yongeza Ngena ngeAmazon kwiprojekthi yakho ye-iOS. Jonga uFakelo lokuNgena ngeThala leencwadi laseAmazon.
2. Ngenisa ukungena ngeAmazon API kumthombo wakho file.
   Ukungenisa ukungena nge-Amazon API, yongeza oku kulandelayo #iingxelo ezivela ngaphandle kumthombo wakho file:

   #ngenisa

3. Yenza i AMZNAGunyazisaUserDelegateclass ukuphumeza
   AIAAuthenticationDelegate.
   Nini gunyazisaUserForScopes:delegate: igqiba, iyakubiza i isiceloIphumelele: or isiceloDidFail: indlela kwinto ephumeza i AIAAuthenticationDelegate iprotocol.

   @interface AMZNAuthorizeUserDelegate : NSObject @isiphelo

   Ukuze ufumane inkcazelo engakumbi, bona Ukusebenza ngeeProtocol  kwi-developer.apple.com.
4. Fowuna gunyazisaUserForScopes:delegate: in onLoginButtonCliziwe.
   Ukuba ulandele amanyathelo kwi Yongeza ukungena ngeQhosha leAmazon kwiApp yakho, kufuneka ube ne onLoginButtonCofa:indlela idityaniswe kwi-Login ngeqhosha le-Amazon. Ngaloo ndlela, biza gunyazisaUserForScopes:delegate:to khuthaza umsebenzisi ukuba angene kwaye agunyazise isicelo sakho.
   Le ndlela izakwenza ukuba umsebenzisi angene kwaye avume ulwazi oluceliweyo ngenye yezi ndlela zilandelayo:
   1.) Tshintshela kwi web view kwimeko ekhuselekileyo (ukuba i-Amazon Shopping app ifakwe kwisixhobo)
   2.) Tshintshela kwiSafari View Umlawuli (kwi-iOS 9 nasemva koko)
   3.) Tshintshela kwisikhangeli senkqubo (kwi-iOS 8 nangaphambili)
   Umxholo okhuselekileyo wokhetho lokuqala uyafumaneka xa i-Amazon Shopping app ifakwe kwisixhobo. Ukuba umsebenzisi sele esayinwe kwi-app ye-Amazon Shopping, i-sign in page iyatsitywa, ekhokelela kwi- Ukungena omnye (SSO) amava.

   Xa isicelo sakho sigunyazisiwe, sigunyazisiwe kwiseti yedatha enye okanye ngaphezulu ezaziwa ngokuba yimida. Iparamitha yokuqala luluhlu lwemida ebandakanya idatha yomsebenzisi oyicelayo kwiNgena ngeAmazon. Ixesha lokuqala umsebenzisi engena kwi-app yakho, baya kunikwa uluhlu lwedatha oyicelayo kwaye bacele imvume. Ngena ngeAmazon okwangoku ixhasa imida emithathu: uProfile, equlethe igama lomsebenzisi, idilesi ye-imeyile, kunye nesazisi seakhawunti yeAmazon; uProfile:Isazisi somsebenzisi, equlathe kuphela i-id yeakhawunti yeAmazon; kwaye Ikhowudi yePosi, equlathe i-zip yomsebenzisi / ikhowudi yeposi.
   Iparameter yesibini ukuya gunyazisaUserForScopes:delegate: yinto ephumeza i I-AIAuthenticationDelegateprotocol, kulo mzekelo we AMZNAGunyazisaUserDelegate iklasi.

   – (IBAction)onLogInButtonClick:(id)umthumeli { // Yenza umnxeba ogunyazisiweyo kwi-SDK ukufumana ithokheni yokufikelela ekhuselekileyo // kumsebenzisi. // Ngelixa usenza umnxeba wokuqala ungacacisa ubuncinci obusisiseko // imida efunekayo. // Ukucela imida yomibini yomsebenzisi wangoku. NSArray *requestScopes = [NSArray arrayWithObjects:@”profile”, @”ikhowudi_yeposi”, nil]; AMZNAuthorizeUserDelegate* delegate = [[AMZNAuthorizeUserDelegate alloc] initWithParentController:self]; [AIMobileLib igunyazaUserForScopes:requestScopes delegate:delegate];

   Yongeza isihloko sakho sophumezo lomthunywa kumnxeba weklasi
   gunyazisaUserForScopes:. Umzekeloample:

   #ngenisa ngaphandle "AMZNAuthorizeUserDelegate.h"

5. Yenza i AMZNGetProfileUmthunywa.
   AMZNGetProfileAbathunywa igama lethu leklasi eyenza i
   I-AIAuthenticationDelegateprotocol, kwaye iya kuqhuba isiphumo se getProfile: umnxeba. Njengo gunyazisaUserForScopes:delegate:, getProfile: ixhasa i isiceloIphumelele: kwaye isiceloDidFail: iindlela zeprotocol. isiceloIphumelele: ifumana APIResult into eneprofile idatha kwipropathi yesiphumo. isiceloDidFail: ifumana AIError into enolwazi ngempazamo kwipropati yempazamo.
   Ukwenza udidi lwabathunywa ukusuka kwisibhengezo sodidi oluqhelekileyo, ngenisa
   AIAuthenticationDelegate.hand yongeza iprotocol kwisibhengezo kwisihloko seklasi yakho file:

   #ngenisa @interface AMZNGetProfileUmthunywa : NSObject @end

    

6. Phumeza isiceloIphumelele:for yakho AMZNAGunyazisaUserDelegate. In isiceloIphumelele:, umnxeba getProfile: ukubuyisa umxhasifile. getProfile:, njengaye gunyazisaUserForScopes:delegate:, isebenzisa i AIAuthenticationDelegate protocol.
   

   – (akukho) isiceloDidSucceed:(APIResult *)apiResult { // Ikhowudi yakho emva kokuba umsebenzisi egunyazisa isicelo // imida eceliweyo. // Layisha entsha view isilawuli ngolwazi lomsebenzisi lokuchonga // njengoko umsebenzisi ngoku engene ngempumelelo. AMZNGetProfileUmthunywa* umthunywa = [[AMZNGetProfilealloc alloc] initWithParentController:parentViewUmlawuli] autorelease]; [AIMobileLib getProfile:umthunywa]; }

   Yongeza isihloko sakho sophumezo lomthunywa kumnxeba weklasi getProfile:. Forexample:
   

   #import "AMZNGetProfileUmthunywa.h”

7. Phumeza isiceloIphumelele: yakho AMZNGetProfileUmthunywa.
   isiceloUphumelele:ine imisebenzi emibini ephambili: ukufumana kwakhona iprofile idatha evela kwi APIResult, kunye nokudlulisa idatha kwi-UI.
   Ukufumana kwakhona iprofile idatha evela kwi APIResult, ukufikelela kwipropati yesiphumo. Ye getProfile: impendulo, loo propati iya kuqulatha isichazi-magama samaxabiso epropathi kumsebenzisi weprofile iipropati. Iprofile iipropati zi igama, i-imeyile, kwaye Isazisi somsebenzisi kwiprofile ububanzi kunye
   Ikhowudi yePosi ukwenzela i Ikhowudi yePosi ububanzi.

   – (akukho) isiceloDidSucceed:(APIResult *)apiResult { // Fumana iprofile isicelo siphumelele. Khulula iprofile ulwazi // kwaye uyidlulisele kumzali view umlawuli NSString* igama = [(NSDictionary*)apiResult.result objectForKey:@“igama”]; NSString* email = [(NSDictionary*)apiResult.result objectForKey:@“imeyile”]; NSString* user_id = [(NSDictionary*)apiResult.result objectForKey:@“user_id”]; NSString* postal_code = [(NSDictionary*)apiResult.result objectForKey:@”postal_code”]; // Dlulisa idatha ku view umlawuli }

8. Phumeza isiceloDidFail: yakho AMZNGetProfileUmthunywa.
   isiceloDidFail: ibandakanya i APIError into enenkcukacha malunga nephutha. showLogInPageis indlela eqikelelwayo enokuseta kwakhona eyona ingundoqo view isilawuli sokubonisa iNgena ngeqhosha le-Amazon.

   – (ingekho) isiceloDidFail: (APIError *)errorResponse { // Fumana iProfile isicelo asiphumelelanga kwiprofile ububanzi. // Ukuba ikhowudi yempazamo = kAIApplicationNotAuthorized, // vumela umsebenzisi ukuba angene kwakhona. ukuba(errorResponse.error.code == kAIApplicationNotAuthorized) { // Bonisa iqhosha logunyaziso lomsebenzisi. [umzaliViewUmlawuli bonisaLogInPage]; } enye { // Ukuphatha ezinye iimpazamo [[[UIAlertView alloc] initWithTitle:@”” umyalezo:[NSString stringWithFormat:@“Impazamo yenzekile ngomyalezo: %@”, errorResponse.error.message] delegate:nil cancelButtonTitle:@”OK”otherButtonTitles:nil] autorelease] show]; } }

9. Phumeza isiceloAkuphumelelanga:for yakho AMZNAGunyazisaUserDelegate.
   

   – (ingekho) isiceloDidFail: (APIError *)errorResponse { NSString *umyalezo = errorResponse.error.message; // Ikhowudi yakho xa ugunyaziso lungaphumeleli. [[[UIAlertView alloc] initWithTitle:@”” umyalezo:[NSString stringWithFormat:@”Ugunyaziso lomsebenzisi aluphumelelanga ngomyalezo: %@”, errorResponse.error.message] delegate:nil cancelButtonTitle:@”OK”otherButtonTitles:nil] autorelease] show]; }

   10. Phumeza isicelo:vulaURL:sourceApplication:annotation: eklasini kwiprojekthi yakho ephethe i UIAapplicationDelegate protocol (ngokungagqibekanga oku izakuba yi AppDelegateclass kwiprojekthi yakho). Xa usetyenziso lubonisa iphepha lokungena laseAmazon, kwaye umsebenzisi ugqibezela ukungena, uya kuthumela kwakhona kwi-app esebenzisa i URL Cwangcisa usetyenziso olubhalisiweyo ngaphambili. Ukwalathisa kwakhona kugqithiselwe isicelo:vulaURL:umthombo wesicelo:uchazo:, ebuyayo EWE ukuba i URL yaphathwa ngempumelelo. phathaVulaURL:sourceApplication: ngumsebenzi wethala leencwadi le-SDK oza kuphatha Ngena nge-Amazon eqondiswe ngokutsha URLs kuwe. Ukuba phathaVulaURL:sourceApplication:ibuyisela EWE, emva koko i URL yaphathwa.

   -(BOOL)isicelo:(UIAsicelo *)isicelo vulaURL:(NSURL *)url umthomboIsicelo:(NSString *)sourceApplication isihlomelo:(id)isihlomelo { // Dlula kwi url kwi-SDK ukwahlula ikhowudi yogunyaziso // ukusuka kwi url. BOOL isValidRedirectSignInURL = [AIMobileLib handleOpenURL:url umthomboIsicelo :umuncu ceApplicati on); ukuba ( !isValidRedirect Si gnlnURL) buyisela HAYI; // Usetyenziso lusenokufuna ukuphatha e url buyisela EWE; }

   PHAWULA: Le ndlela iyekisiwe kwi-iOS 9 kodwa kufuneka ibandakanywe kwiprojekthi yakho ukugcina inkxaso kubasebenzisi kumaqonga amadala. Ngolwazi oluthe vetshe kwi isicelo:vulaURL:umthombo wesicelo:uchazo:, bona UIApplicationDelegate Protocol Reference kwi-developer.apple.com.

Jonga ukungena ngemvume komsebenzisi kwisiqalo

Ukuba umsebenzisi ungena kwi-app yakho, avale i-app, kwaye aphinde aqale usetyenziso kamva, i-app isagunyaziswe ukuba ikhuphe idatha. Umsebenzisi akakhutshelwanga ngaphandle ngokuzenzekelayo. Ekuqaliseni, unokubonisa umsebenzisi njengoko engenile ukuba i-app yakho isagunyazisiwe. Eli candelo lichaza indlela yokusebenzisa
getAccessTokenForScopes:withOverrideParams:delegate: ukubona ukuba i-app isagunyaziswe.

1. Yenza i AMZNGetAccessTokenDelegate iklasi. AMZNGetAccessTokenDelegatemplements i AIAAuthenticationDelegate protocol, kwaye iyakuqhuba isiphumo se
   getAccessTokenForScopes:withOverrideParams:delegate: umnxeba. AIAAuthenticationDelegate iqulethe iindlela ezimbini, isiceloIphumelele: kwaye isiceloAkuphumelelanga:. isiceloIphumelele: ifumana APIResult into enedatha yophawu, ngelixa isiceloDidFail: ifumana APIError into enolwazi ngempazamo.

   #ngenisa @interface AMZNGetAccessTokenDelegate :NSObject @isiphelo

   Yongeza isihloko sakho sophumezo lomthunywa kumnxeba weklasi
   getAccessTokenForScopes:withOverrideParams:delegate:. Forexample:

   #import "AMZNGetAccessTokenDelegate.h"

2. Ekuqalisweni kwe-app, fowuna
   getAccessTokenForScopes:withOverrideParams:delegate: ukubona ukuba isicelo sisagunyazisiwe na. getAccessTokenForScopes:withOverrideParams:delegate: ifumana ithokheni yokufikelela ekrwada ethi Ngena ngeAmazon isebenzise ukufikelela kwipro yomthengifile. Ukuba indlela iyaphumelela, i-app isagunyazisiwe kwaye ifowunelwe getProfile: kufuneka uphumelele. getAccessTokenForScopes:withOverrideParams:delegate: isebenzisa i AIAAuthenticationDelegate protocol ngendlela efanayo gunyazisaUserForScopes:delegate:. Phumelela into ephumeza iprotocol njengogunyaziso lweparamitha.

   – (akukho) khangelaIsUserSignedIn { AMZNGetAccessTokenDelegate* umthunywa = [[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorelease]; NSArray *requestScopes = [NSArray arrayWithObjects:@”profile”, @”ikhowudi_yeposi”, nil]; [AIMobileLib getAccessTokenForScopes:requestScopes withOverrideParams:nil delegate:delegate]; }

3. Phumeza isiceloIphumelele: kweyakho AMZNGetAccessTokenDelegate. isiceloIphumelele: unomsebenzi omnye: ukufowuna getProfile:. Le example iifowuni getProfile: usebenzisa kwaloo mphulaphuli umchazeyo kwicandelo elingaphambili (jonga amanyathelo 6-8).
   

   #import "AMZNGetProfileUmthunywa.h” #ngenisa – (akukho) isiceloDidSucceed:(APIResult *)apiResult { // Ikhowudi yakho yokusebenzisa ithokheni yofikelelo iya apha. // Ekubeni isicelo sigunyazisiwe kwimiba yethu, sinako // fumana umsebenzisi profile. AMZNGetProfileUmthunywa* umthunywa = [[[AMZNGetProfilealloc alloc] initWithParentController:parentViewUmlawuli] autorelease]; [AIMobileLib getProfile:umthunywa]; }

4. Phumeza isiceloDidFail: kweyakho AMZNGetAccessTokenDelegate.
   isiceloDidFail: ibandakanya i APIError into eneenkcukacha malunga nempazamo. Ukuba ufumana impazamo, unokuseta kwakhona eyona ingundoqo view isilawuli sokubonisa iNgena ngeqhosha le-Amazon.

   – (ingekho) isiceloDidFail: (APIError *)errorResponse { // Ikhowudi yakho yokuphatha ukungaphumeleli ukufunyanwa kwakhona kwethokheni yofikelelo. // Ukuba ikhowudi yempazamo = kAIApplicationNotAuthorized, vumela umsebenzisi // ukungena kwakhona. ukuba(errorResponse.error.code == kAIApplicationNotAuthorized) { // Bonisa ukungena nge-Amazon iqhosha. } enye { // Ukuphatha ezinye iimpazamo [[[UIAlertView alloc] initWithTitle:@”” umyalezo:[NSString stringWithFormat:@”Impazamo yenzekile ngomyalezo: %@”, errorResponse.error.message] delegate:nil cancelButtonTitle:@“Kulungile” otherButtonTitles:nil] autorelease] show]; } }

Cacisa iSizwe soGunyaziso kwaye uPhume uMsebenzisi

I clearAuthorizationState: indlela iya kucima idatha yogunyaziso lomsebenzisi kwi AIMobileLib ivenkile yedatha yendawo. Umsebenzisi kuya kufuneka ungene kwakhona ukuze usetyenziso lufumane kwakhona iprofile idatha. Sebenzisa le ndlela ukuphuma komsebenzisi, okanye ukulungisa iingxaki zokungena kwi-app.

1. Xela i AMZNLogoutDelegate. Le yiklasi eyenza i
   I-AIAuthenticationDelegateprotocol. Ngeenjongo zethu, sinokuzuza ilifa iklasi NSO umxholo:
   

   #ngenisa @interface AMZNLogoutDelegate NSObject @isiphelo

   Yongeza isihloko sakho sophumezo lomthunywa kumnxeba weklasi clearAuthorizationState:. Umzekeloample:

   #import "AMZNLogoutDelegate.h"

2. Fowuna clearAuthorizationState:.
   Xa umsebenzisi engene ngempumelelo, unokubonelela ngendlela yokuphuma ukuze bacime idatha yabo yogunyaziso. Indlela yakho inokuba likhonkco, okanye umba wemenyu, kodwa kulo mzekelo i example izakwenza a logoutButtonClickedmethod yeqhosha lokuphuma.

   – (IBAction)logoutButtonClick:(id)umthumeli { AMZNLogoutDelegate* umthunywa = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorelease]; [AIMobileLib clearAuthorizationState:delegate]; }

   Ekuphela kweparameter ukuya clearAuthorizationState yi AIAAuthenticationDelegate ukuba izixhobo isiceloIphumelele: kwaye isiceloAkuphumelelanga:.

3. Phumeza isiceloIphumelele:. Le ndlela iya kubizwa xa ulwazi lomsebenzisi lucinyiwe. Kuya kufuneka ke uzibonise njengoko zikhutshiwe.
   

   – (akukho) isiceloDidSucceed:(APIResult *)apiResult { // Ingqiqo yakho eyongezelelweyo emva kogunyaziso lomsebenzisi // imeko iyacinywa. [[UIAlertView alloc] initWithTitle:@”” umyalezo:@“UMsebenzisi ukhutshiwe.” delegate:nil cancelButtonTitle:@”OK” otherButtonTitles:nil] show]; }

4. Phumeza isiceloAkuphumelelanga:. Le ndlela iya kubizwa ukuba ngenxa yesizathu esithile ulwazi lomsebenzisi alukwazi ukucocwa kwi-cache. Xa kunjalo, akufanele ubabonise njengoko bekhutshiwe.
   

   – (ingekho) isiceloDidFail: (APIError *)errorResponse { // Ingqiqo yakho eyongezelelweyo emva kokuba i-SDK ihlulekile ukucacisa // urhulumente wogunyaziso. [[[UIAlertView alloc] initWithTitle:@”” umyalezo:[NSString stringWithFormat:@”UkuPhuma koMsebenzisi kusilele ngomyalezo: %@”, errorResponse.error.message] delegate:nil cancelButtonTitle:@“Kulungile” otherButtonTitles:nil] autorelease] show]; }

Vavanya ukuDityaniswa kwakho

Qalisa i-app yakho kwisixhobo se-iOS okanye isifanisi kwaye uqinisekise ukuba ungangena ngeenkcukacha zakho ze-Amazon.com.

Phawula: Xa uvavanya kwi-iOS10 izilingisi, unokubona umyalezo wemposiso i-APIKey yeSicelo ayisebenzi kwisicelo sokugunyazisaUserForScopes, okanye iKhowudi yemposiso engaziwayo yesicelo esicacileyo se-AuthorizationState. Oku yi ibug eyaziwayo ngeApple okwenzekayo xa i-SDK izama ukufikelela kwikhonkco elitshixo. De i-Apple isombulule i-bug, ungasebenza kuyo ngokuvumela i-Keychain Sharing ye-app yakho phantsi kwe-Capabilities ithebhu ye-app yakho ekujoliswe kuyo. Le bug ichaphazela kuphela izilingisi. Unokuvavanya kwizixhobo zokwenyani ze-iOS10 ngaphandle kokusebenzisa nayiphi na indlela yokusebenza.

Ngena ngeAmazon Isikhokelo sokuQalisa i-iOS Version 2.1.2 - Khuphela [kulungisiwe]
Ngena ngeAmazon Isikhokelo sokuQalisa i-iOS Version 2.1.2 - Khuphela

Iimbekiselo

• Incwadi yokusebenzisa