Ukungena nge-Amazon Isikhokelo sokuQala kwii -apps ze-iOS
Ngena ngeAmazon: Isikhokelo sokuQalisa se-iOS
Ilungelo lokushicilela © 2017 Amazon.com, Inc., okanye abaxhasi bayo. Onke Amalungelo Agciniwe. IAmazon kunye nelogo yeAmazon ziimpawu zorhwebo zeAmazon.com, Inc.kanye abaxhasi bayo. Zonke ezinye iimpawu zorhwebo ezingezizo ezaseAmazon ziyipropathi yabanini bazo.
Intshayelelo
Kwesi sikhokelo siya kukubonisa indlela yokongeza nge-Ngena ngeAmazon kwi-app yakho ye-iOS, usebenzisa i-Login nge-Amazon SDK ye-iOS v3.0+.
Emva kokugqiba esi sikhokelo kufuneka ube nokuNgena okusebenzayo kunye neqhosha le-Amazon kwi-app yakho evumela abasebenzisi ukuba bangene ngeempawu zabo ze-Amazon. Ukuze ufunde ngakumbi malunga nokuhamba kokungena abathengi bakho baya kuba nakho xa besebenzisa Ngena ngeAmazon ngaphakathi kweapp yakho, nceda ubone yethu Amava oMthengi Ngaphezuluview yeeapps ze-iOS.
Faka i-iOS Developer Tools
Faka i-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 on developer.apple.com.
Emva kokuba iXcode ifakiwe, unako Faka iNgeno ngeAmazon SDK ye-iOS kwaye Baleka iSample App, 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.
- Khuphela NgenaNgeAmazonSDKForiOS.zip kwaye ukhuphe i files kulawulo olukwihard drive yakho.
Kuya kufuneka ubone i-LoginWithAmazon.framework directory. Oku kuqulathe uNgena ngethala leencwadi laseAmazon.
Kwinqanaba eliphezulu le-zip yi-a NgenaNgeAmazon.docset ulawulo. Oku kuqulathe uxwebhu lwe-API. - Jonga uFakelo lokuNgena ngeThala leeNcwadi laseAmazon ngemiyalelo malunga nendlela yokongeza ithala leencwadi kwiprojekthi ye-iOS.
Xa i-Login kunye ne-Amazon SDK ye-iOS ifakiwe, unako Yenza ungene ngokuNtsha ngeProjekthi yeAmazon Emveni koba Bhalisa nge Login kunye Amazon.
Baleka iSampApp
Ukuqhuba sample isicelo, vula i-sample kwi Xcode.
- Khuphela SampleLoginWithAmazonAppForiOS.zip kwaye khuphela i
SampleLoginWithAmazonAppForiOS ulawulo kwifolda yakho yaMaxwebhu. - Qalisa i-Xcode. Ukuba i Wamkelekile kwincoko yababini yeXcode pops up, cofa Vula Okunye. Ngaphandle koko, kwimenyu ephambili, cofa File uze ukhethe Vula.
- Khetha i Amaxwebhu fowulda, uze ukhethe
SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/
Ngena ngeAmazonSample.xcodeproj. Cofa Vula. - I sample projekthi kufuneka ilayishe ngoku. Xa igqityiwe, khetha Imveliso kwimenyu engundoqo, kwaye ukhethe Baleka.
Bhalisa 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-app yakho ye-iOS ukuze isetyenziswe kunye ne-Login nge-Amazon.
Bhalisa ukungena kwakho kunye nesicelo seAmazon
- Yiya e https://login.amazon.com.
- Ukuba ubhalisele ukungena ngeAmazon ngaphambili, cofa Isixhobo seConsole. Ngaphandle koko, cofa 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.
- Cofa Bhalisa isicelo esitsha. I Bhalisa isicelo sakho ifom iya kuvela:
a. Kwirejista yesicelo sakho, faka a Igama kunye a 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.
I Inkcazo ikunceda ukuba uhlukanise nganye yokuNgena kwakho kunye nezicelo zeAmazon kwaye ayiboniswa kubasebenzisi.
b. Ngena a 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 kwisikrini semvume.
c. Ukuba ufuna ukudibanisa i Umfanekiso weLogo kwisicelo sakho, cofa Khetha File kwaye ufumane umfanekiso ofanelekileyo.
Le logo iboniswa kwisikrini sokungena kunye nesivumelwano sokumela ishishini lakho okanye webindawo.
I-logo iya kucutheka ibe ngama-pixels angama-50 ukuphakama ukuba inde kuneepikseli ezingama-50; akukho mda kububanzi be logo. - 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. Ukusuka kwiSeto lwe-iOS yeapp yakho, cofa i Yongeza API Key iqhosha lokwenza amaqhosha ongezelelweyo kwi-app yakho (inye kwinguqulelo nganye).
Yongeza Izicwangciso ze-iOS kwiSicelo sakho
Emva kokuba useto lwakho olusisiseko lugciniwe, unokongeza useto oluthile webiisayithi kunye neeapps eziphathwayo eziza kusebenzisa Ngena ngeAmazon.
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:
- Isuka e Isicelo isikrini, cofa Izicwangciso ze-iOS. Ukuba sele une-app ye-iOS ebhalisiweyo, khangela i Yongeza isitshixo se-API iqhosha kwi Izicwangciso ze-iOS icandelo.
I iOS Iinkcukacha zosetyenziso ifom iya kuvela:
- 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. - 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. I Isichongi senqwaba yenye yeepropati kuluhlu.
- Cofa Gcina.
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. Ukusuka kwiiSetingi ze-iOS zosetyenziso lwakho, cofa iqhosha lokongeza i-API ukwenza izitshixo ezongezelelweyo ze-app yakho (enye ngoguqulelo ngalunye).
iOS Bundle ID kunye API Keys
Isichongi seBundle sikhethekile kuyo yonke i-app ye-iOS. Ngena ngeAmazon isebenzisa i-ID yeBundle 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 Ipropati yolwazi Uluhlu yeprojekthi (-Info.plist) kwi Navigator yeprojekthi.
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.
- Yiya e https://login.amazon.com.
- Cofa App Console.
- Kwi Usetyenziso ibhokisi, cofa isicelo sakho.
- Fumana usetyenziso lwakho lwe-iOS phantsi kwe Izicwangciso ze-iOS icandelo.
Ukuba awukabhalisi i-app ye-iOS, bona Yongeza Izicwangciso ze-iOS kwiSicelo. - 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. - Jonga Yongeza isitshixo sakho se-API kuLuhlu lwePropati ye-App yakho ngemiyalelo yokongeza isitshixo se-API kwi-app yakho ye-iOS
Yenza ukungena ngeProjekthi yeAmazon
Kweli candelo, uya kufunda ukwenza iprojekthi entsha yeXcode yokuNgena ngeAmazon kwaye uqwalasele iprojekthi.
Yenza ungene ngokuNtsha ngeProjekthi yeAmazon
Ukuba awukabi nayo iprojekthi yosetyenziso lokungena ngeAmazon, landela le miyalelo ingezantsi ukwenza enye. Ukuba une-app esele ikhona, tsiba uye kwi Faka ukungena ngeThala leencwadi laseAmazon icandelo elingezantsi.
- Qalisa Xcode.
- Ukuba unikwe a Wamkelekile kwi Xcode incoko yababini, khetha Yenza iProjekthi entsha yeXcode.
Kungenjalo, ukusuka kwi File imenyu, khetha Entsha kwaye Iprojekthi. - Khetha uhlobo lweprojekthi onqwenela ukuyenza kwaye ucofe Okulandelayo.
- Ngena a Igama lemveliso kunye a Isichongi seNkampani. Qaphela eyakho Isichongi seBundle, kwaye ucofe Okulandelayo.
- 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.
- Ukuba iprojekthi yakho ayinayo ifolda yeNkqubo, cofa ekunene igama leprojekthi kwiNavigator
ipayini kwiXcode, emva koko ucofe Iqela elitsha. - Xela iqela elitsha Iinkqubo.
- Khetha i Iinkqubo ifolda kwaye ucofe File ukusuka kwiMain menu.
- Khetha Yongeza Files ukuya Iprojekthi.
- Kwincoko yababini, khetha LoginWithAmazon.framework kwaye ucofe Yongeza.
Ukuba usebenzise iNgena ngelayibrari yeAmazon 1.0, cima i Ngena-nge-amazon-sdk ulawulo kunye Ngena-nge-amazon-sdk.a ukusuka kulawulo lweNkqubo. Cofa Hlela kwimenyu ephambili kwaye ukhethe Cima. - Khetha igama leprojekthi yakho kwiProjekthi yeNavigator.
I Umhleli weProjekthi izakuvela kwindawo yomhleli wendawo yokusebenza ye Xcode. - Cofa igama leprojekthi yakho ngaphantsi Ekujoliswe kuko, kwaye ukhethe Yakha izigaba. Yandisa Xhumanisa iBhinary kunye namaThala eencwadi kwaye ucofe uphawu lokudibanisa ukongeza ithala leencwadi.
- Kwibhokisi yokukhangela, ngenisa Ukhuseleko.isakhelo. Khetha Ukhuseleko.isakhelok kwaye ucofe Yongeza.
- Kwibhokisi yokukhangela, ngenisa SafariServices.framework. Khetha SafariServices.framework kwaye ucofe Yongeza.
- Khetha Useto loKwakha. Cofa Konke ukuze view zonke izicwangciso.
- Phantsi kweendlela zokukhangela, qinisekisa ukuba i LoginWithAmazon.framework uvimba weefayili ukwi Iindlela zokukhangela ze-Framework.
Umzekeloample:
- Ngaphambi kokwakha iprojekthi yakho, ukuba usebenzise iNgena ngelayibrari yeAmazon 1.0, buyisela #import "AIMobileLib.h", #import "AIAuthenticationDelegate.h", kunye #import "AIError.h" kwimvelaphi yakho files ngenye #ngenisa ngaphandle
. I-LoginWithAmazon.hline ibandakanya konke uNgena kunye neentloko ze-Amazon ngaxeshanye.
Ukongeza, ungasusa naziphi na iimbekiselo kwindlela yethala leencwadi eli-1.0 kwi IiNdlela zokuKhangela eziPhezulu okanye iiNdlela zokuKhangela zeThala leeNcwadi.
13. Ukusuka kwimenyu ephambili, cofa Imveliso kwaye ukhethe Yakha. Ulwakhiwo kufuneka lugqitywe ngempumelelo.
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 ye-APIKey kuLuhlu lwePropati yoLwazi lwesicelo sakho.
- 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:
- Qinisekisa ukuba akukho nalinye kumangeniso elikhethiweyo. Emva koko, kwimenyu ephambili, cofa uMhleli, kwaye Yongeza into. Ngena APIKey kwaye ucinezele Ngena.
- 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.
- Ngeprojekthi yakho evuliweyo, khetha i Ukuxhasa Files incwadi eneenkcukacha, uze ukhethe i -Info.plist file (apho ligama leprojekthi yakho). Oku kufuneka kuvule uluhlu lwempahla ukuze kuhlelwe:
- Qinisekisa ukuba akukho nalinye kumangeniso elikhethiweyo. Emva koko, kwimenyu ephambili, cofa uMhleli, kwaye Yongeza into. Ngena okanye ukhethe URL iintlobo kwaye ucinezele Ngena.
- 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.
- Khetha into 0 phantsi URL Isichongi kwaye nqakraza kabini phantsi kwe Ixabiso ikholamu yokongeza ixabiso. Ixabiso yi-ID yakho yenqwaba. Unokufumana i-ID yakho ye-bundle edweliswe njenge Isichongi senqwaba kuluhlu lwepropati.
- Khetha Into 0 phantsi URL iintlobo kwaye, kwimenyu ephambili, cofa Umhleli kwaye Yongeza Into. Ngena okanye ukhethe URL Amacebo kwaye ucinezele u-Enukufumana.
- Khetha into 0 phantsi URL Amacebo kwaye nqakraza kabini phantsi koluhlu lwexabiso ukongeza 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.
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.
- Yongeza umgangatho UIButton 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. - Yongeza i Chukumisa Ngaphakathi isiganeko seqhosha kwindlela enegama
onLoginButtonCliziwe. Yeka ukuphunyezwa kungenanto okwangoku. I Ukuyila kunye nokuqwalasela View Izinto kwaye Qala ukuphuhlisa i-iOS Apps namhlanje amaxwebhu kwi-developer.apple.com abandakanya amanyathelo okongeza isiganeko seqhosha. - Khetha umfanekiso weqhosha.
Qhagamshelana ngokuNgena kwethu kunye neziKhokelo zeSitayile saseAmazon kuluhlu lwamaqhosha onokuwasebenzisa kusetyenziso lwakho. Khuphela ikopi 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. - Yongeza imifanekiso kwiprojekthi yakho.
a. Kwi-Xcode, ngeprojekthi yakho elayishiwe, cofa File kwimenyu enkulu kwaye ukhethe Faka Files ukuya “kwiprojekthi”.
b. Kwincoko yababini, khetha umfanekiso weqhosha file(s) okhutshelweyo kwaye ucofe Yongeza.
c. Amaqhosha ngoku kufuneka abe kwiprojekthi phantsi kolawulo lweprojekthi yakho. Bafudusele kwiNkxaso Files ifolda. - 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 Indawo yoMlawuli umthi.
c. Kwi Izinto eziluncedo windows, vula i Iimpawu zoMhloli.
d. Phezulu kwe Umhloli weempawu, seta i Uhlobo yeqhosha ukuya Inkqubo.
e. Kwiqela lesibini loseto, khetha Miyo i-State Config.
f. Kwiqela lesibini leseto, yehlisa i Umfanekiso ulungiselelo.
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 we Imvelaphi ulungiselelo.
i. Ukuba ufuna ukukhankanya uguqulelo olucinezelweyo lweqhosha, khetha Ikhethiwe ngenxa i-State Config, kwaye usete i Umfanekiso kwi _Icinezelwe uguqulelo lweqhosha lakho.
j. Kwibhodi yamabali, lungisa ubungakanani beqhosha lakho ukulungiselela umfanekiso, ukuba kuyimfuneko.
Kweli candelo, uyakongeza ikhowudi kwiprojekthi yakho ukuze usayine kumsebenzisi ngeNgena ngeAmazon.
Sebenzisa i-SDK ye-iOS APIs
Kweli candelo, uyakongeza ikhowudi kwiprojekthi yakho ukuze usayine kumsebenzisi ngeNgena ngeAmazon.
Qhagamshela uMthunywa we-App
Phumeza isicelo:vulaURL:ukhetho: kwiklasi kwiprojekthi yakho ephethe i UIAapplicationDelegate iprotocol. Ngokungagqibekanga, oku kuya kuba yi AppDelegate iklasi. Xa umsebenzisi engena ngempumelelo kwi-app yakho esebenzisa uNgena nge-Amazon, baya kuhanjiswa ukusuka kwisikrini sokungena kwi-Amazon sibuyele kwi-app yakho ngokusekelwe URL Inkqubo wongeze kuLuhlu lwePropati ye-App yakho ngaphambili. Ukuze ukwazi ukuphatha oku kukwalathisa, kufuneka usebenzise i isicelo:vulaURL:ukhetho: indlela, ebuyisela EWE ukuba i URL iphathwa ngempumelelo.
Ukungena ngeAmazon SDK ye-iOS ibonelela ngomsebenzi wethala leencwadi, phathaVulaURL:sourceApplication: ephatha nakuphi na ukuhanjiswa kwakhona URL ithunyelwe ukusuka kumaphepha eAmazon. Ibuyisela EWE ukuba i URL iphathwa ngempumelelo yi-SDK. Biza le ndlela ngaphakathi kwe isicelo:vulaURL:ukhetho: indlela.
Ukucela le ndlela, kuya kufuneka ungenise ngaphandle .
| ngenisa @ukuphunyezwa kwe-AppDelegate -(BOOL)isicelo:(UIA isicelo *)isicelo sivuliweURL:(NSURL *) url iinketho:(NSDictionaryURLOptionsKey, id> *) iinketho { buyisela [AMZNAuthorizationManager handleOpenURL:url umthomboIsicelo: iinketho[UIApplicationOpenURLOptionsSourceApplicationKey]]; } @isiphelo |
Eli candelo lichaza indlela yokubiza ugunyaziso:withHandler: API ukungena kumsebenzisi. Oku kubandakanya ukwenza i-OnLoginButtonClicked:umphulaphuli ngokuNgena kwakho ngeqhosha leAmazon.
- Yongeza Ngena ngeAmazon kwiprojekthi yakho ye-iOS. 'Yabona Faka ukungena ngeThala leencwadi laseAmazon.
- Ngenisa ukungena ngeAmazon API kumthombo wakho file.
Ukungenisa ukungena nge-Amazon API, yongeza oku kulandelayo #iingxelo ezivela ngaphandle kumthombo wakho file:#ngenisa - Fowuna gunyazisa:ngeHandler: kwi onLoginButtonCliziwe. Ukuba ulandele amanyathelo okuFaka ukungena ngeqhosha leAmazon kwiApp yakho, kuya kufuneka ube ne onLoginButtonCofa:indlela idityaniswe kwi-Login ngeqhosha le-Amazon. Ngaloo ndlela, biza gunyazisa:ngeHandler: ukwazisa umsebenzisi ukuba angene kwaye agunyazise isicelo sakho.
Le ndlela izakwenza ukuba umsebenzisi angene kwaye avume ulwazi oluceliweyo ngenye yezi ndlela zilandelayo:
- Tshintshela kwi web view kwimeko ekhuselekileyo (ukuba i-Amazon Shopping app ifakwe kwisixhobo)
- Tshintshela kwiSafari View Umlawuli (kwi-iOS 9 nasemva koko)
- Tshintshela kwisikhangeli senkqubo (kwi-iOS 8 nangaphambili)
Umxholo okhuselekileyo wokhetho lokuqala uyafumaneka xa i-Amazon Shopping app ifakwe kwisixhobo. Ukuba umsebenzisi sele engenile kwi-app ye-Amazon Shopping, le API iyakutsiba uphawu lokungena kwiphepha, elikhokelela kuNye Sayina (SSO) amava. Bona umthengi-amava-ios [PDF] ukufunda ngakumbi.
Ipharamitha yokuqala ukuya gunyazisa:ngeHandler:yi i AMZNAuthorizeRequest into ebonisa ukuba isicelo sakho sicela isigunyaziso sawuphi umda. A ububanzi iquka idatha yomsebenzisi oyicelayo kwiNgena ngeAmazon. Ixesha lokuqala umsebenzisi engena kwi-app yakho, baya kunikwa uluhlu lwedatha oyicelayo kwaye bacele imvume.
Ngena ngeAmazon ngoku ixhasa le miba ilandelayo:Igama lomda Inkcazo uProfile Inika ukufikelela kwigama lomsebenzisi, idilesi ye-imeyile, kunye ne-ID yeakhawunti ye-Amazon. uProfile:Isazisi somsebenzisi Inika ukufikelela kwi-ID yeakhawunti ye-Amazon yomsebenzisi kuphela. Ikhowudi yePosi Inika ufikelelo kwikhowudi yeposi/yeposi yomsebenzisi file kwiakhawunti yabo yeAmazon. Sebenzisa iindlela ezichazwe kwi AMZNProfileUbubanzi ukufumana into yobubanzi kwaye uyongeze kweyakho AMZNAuthorizeRequest into. Bona i-sample ikhowudi ngezantsi iinkcukacha.
Eyesibini iparameter ukugunyazisa:withHandler: is AMZNAuthorizationRequestHandler, ichazwe kwinyathelo elilandelayo. - Yenza i AMZNAAuthorizationRequestHandler block into. AMZNAAuthorizationRequestHandler iinkqubo isiphumo se gunyazisa:ngeHandler: umnxeba. Ukufunda ngakumbi malunga neebhloko zenjongo-c, bona Ukusebenza ngeebhloko kwi-developer.apple.com.
Iparameter yokuqala ye AMZNAAuthorizationRequestHandler yi AMZNAuthorizeResult into. Emva kokuba umsebenzisi egunyaziswe ngempumelelo, AMZNAuthorizeResult iyakuqulatha ithokheni yofikelelo enokusetyenziswa ukufikelela kwipro yomsebenzisifile idatha, kunye ne AMZNUser into, equlathe ipro yomsebenzisifile idatha.Iparamitha yesibini ye AMZNAAuthorizationRequestHandler yi Boolean ebizwa umsebenzisiDidcancel. Le parameter izakumiselwa ukuba iyinyani ukuba umsebenzisi:
1. Ivala iSafari View Umlawuli ngexesha lokungena kunye nogunyaziso (kwi-iOS 9 nasemva koko)
2. Ivala i web view kwi-app ye-Amazon Shopping
3. Irhoxisa ukungena okanye yale ugunyaziso
Iparamitha yesithathu ye AMZNAAuthorizationRequestHandler yi NSError into equlathe iinkcukacha zemposiso ukuba igama lokungena kunye nogunyaziso aluphumeleli ngenxa ye-SDK okanye iseva yogunyaziso.– (IBAction)onLogInButtonClick:(id)umthumeli {
// Yakha isicelo sokugunyazisa.
AMZNAuthorizeRequest *sicelo = [[AMZNAuthorizeRequest alloc] init];
request.scopes = [NSArray arrayWithObjects:
// [AMZNProfileI-Scope userID],
[AMZNProfileUbubanzi beprofile],
[AMZNProfileIKhowudi yeposi yoMda]];// Yenza umnxeba wokuGunyazisa ukungena nge-Amazon SDK.
[[AMZNAuthorizationManager sharedManager] gunyazisa:sicelo
withHandler:^(AMZNAuthorizeResult *isiphumo, BOOL
userDidCancel, NSError *impazamo) {
ukuba (impazamo) {
// Bamba iimpazamo ezivela kwi-SDK okanye iseva yogunyaziso.
} okunye ukuba (userDidCancel) {
// Bamba iimpazamo ezibangelwa xa umsebenzisi erhoxisa ukungena.
} enye {
// Uqinisekiso lube yimpumelelo.
// Fumana ithokheni yokufikelela kunye nepro yomsebenzisifile idatha.
NSString *accessToken = result.token;
AMZNUser *umsebenzisi = result.user;
NSString *userID = user.userID;
}
}];
}
Landa uMsebenzisi weProfile Idatha
Logama nje umsebenzisi engenile kwaye egunyaziswe kwi-app yakho, ungalanda umsebenzisi wabo weprofile data nangaliphi na ixesha.
Eli candelo lichaza indlela yokusebenzisa i landa: indlela ye AMZNUser iklasi ukufumana eyona pro yamva nje yomsebenzisifile idatha kubasebenzisi abagunyazisiweyo ngoku. Iprofile idatha onokuyibuyisela isekelwe kumda oboniswe kwi gunyazisa umnxeba.
- Fowuna AMZNUser landa:.
Le ndlela izakuthatha iprofile idatha nge AMZNUserFetchRequestHandler block into. Iparameter yokuqala ukuya AMZNUserRequestHandler yi AMZNUser into. I AMZNUser into ingabandakanya a Isazisi somsebenzisi, igama, i-imeyile, kunye Ikhowudi yePosi, kuxhomekeke kumda oceliweyo.[AMZNUser fetch:^(AMZNUser *user, NSError *error) {
ukuba (impazamo) {
// Impazamo evela kwi-SDK, okanye akukho msebenzisi ugunyazisiweyo kwi-app.
} okunye ukuba (umsebenzisi) {
NSString *userID = user.userID;
//NSString *igama = user.name;
//NSString *imeyile = user.email;
//NSString *postalCode = user.postalCode;
}
}];
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 gunyazisa:ngeHandler: ukubona ukuba i-app isagunyaziswe.
- Yenza i AMZNAuthorizeRequest into kwaye ucacise imida ebonisa idatha yomsebenzisi isicelo sakho esicela ugunyaziso. Ngolwazi oluthe vetshe ngemida, bona Phatha i Iqhosha lokungena kwaye ufumane iProfile Idatha.
- Seta AMZNAuthorizeRequest.iQhinga elisebenzisanayo ukuya AMZNIInteractiveStrategyNever. AMZNAuthorizeRequest ixhasa izicwangciso-qhinga ezininzi zokukhuthaza ukungena kwabasebenzisi:
- AMZNInteractiveStrategyAuto (okwendalo): I-SDK ikhangela isibonelelo sogunyaziso esigcinwe ekuhlaleni ukusuka kwangaphambili gunyazisa:ngeHandler: iimpendulo. Ukuba enye iyafumaneka, iyasebenza, kwaye iqulethe yonke imida eceliweyo, i-SDK iya kubuyisela impendulo eyimpumelelo nge AMZNAAuthorizationRequestHandler, kwaye ayizukukhuthaza umsebenzisi ukuba angenise. Ngaphandle koko, umsebenzisi uya kucelwa ukuba angene.
- AMZNInteractiveStrategySoloko: I-SDK iya kusoloko ikhuthaza umsebenzisi ukuba angene nokuba wayekhe wagunyaziswa ngaphambili ukuba asebenzise usetyenziso. Xa umsebenzisi eyalelwe, i-SDK iyakususa zonke iigranti zogunyaziso ezigcinwe kwindawo yosetyenziso.
- AMZNIInteractiveStrategyNever: I-SDK ijonga igranti yogunyaziso egcinwe kwindawo yangaphambili gunyazisa:ngeHandler iimpendulo. Ukuba enye iyafumaneka, iyasebenza, kwaye iqulathe yonke imida eceliweyo, i-SDK izakubuyisela i AMZNAuthorizeResult into equlathe uphawu lofikelelo kunye nomsebenzisi profile idatha.
Kungenjalo, iya kubuya i NSError into nge AMZNAAuthorizationRequestHandler.// Yakha isicelo sokugunyazisa.
AMZNAuthorizeRequest *sicelo = [[AMZNAuthorizeRequest alloc] init];
request.scopes = [NSArray arrayWithObjects:
// [AMZNProfileI-Scope userID],
[AMZNProfileUbubanzi beprofile],
[AMZNProfileIKhowudi yeposi yoMda]];request.interactiveStrategy = AMZNInteractiveStrategyNever;[[AMZNAuthorizationManager sharedManager] gunyazisa:request
withHandler:^(AMZNAuthorizeResult *isiphumo, BOOL
userDidCancel, NSError *impazamo) {
ukuba (impazamo) {
// Impazamo evela kwi-SDK, ebonisa ukuba umsebenzisi wayengekho ngaphambili
kugunyaziswe kwi-app yakho kwimida eceliweyo.
} enye {
// Umsebenzisi wayegunyaziswe ngaphambili kwi-app yakho.
// Fumana ithokheni yokufikelela kunye nepro yomsebenzisifile idatha.
NSString *accessToken = result.token;
AMZNUser *umsebenzisi = result.user;
NSString *userID = user.userID;
}
}];
Eli candelo lichaza indlela yokusebenzisa i phuma indlela yokucima idatha yogunyaziso lomsebenzisi kuzo zombini AIMobileLib ivenkile yedata yendawo, kunye neseva yogunyaziso. Umsebenzisi kuya kufuneka ungene kwakhona ukuze usetyenziso lufumane kwakhona iprofile idatha. Sebenzisa le ndlela ukuphuma komsebenzisi, okanye ukulungisa iingxaki zokungena kwi-app.
- Sebenzisa indlela yokuphuma.
Xa umsebenzisi engenile ngempumelelo, kuya kufuneka unikezele ngenkqubo yokuphuma ukuze bacoce iprofile idatha kunye nemida egunyazisiweyo ngaphambili. Indlela yakho inokuba likhonkco, iqhosha, okanye umba wemenyu. - Fowuna phuma:.
Fowuna phuma: kwisiphathi sakho sokuphuma ukususa idatha yogunyaziso lomsebenzisi (iithokheni zofikelelo, iprofile) ukusuka kwivenkile yasekhaya, kunye nemeko yazo yoqinisekiso kumncedisi. Ungeniso lweparameter ukuya phuma yi AMZNAAuthorizationRequestHandler block into. Ibhloko kufuneka ibone kwaye iphathe NSError izinto, ezibuyiswa xa phuma: iyasilela.[[AMZNAuthorizationManager sharedManager] Phuma:^(NSError * _Ayinakwenzeka
impazamo) {
ukuba (!impazamo) {
// impazamo evela kwi-SDK okanye Ngena nge-Amazon yogunyaziso iseva.
}
}];
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 simulators, unokubona umyalezo wemposiso I-APIKey yeSicelo ayisebenzi ukwenzela i gunyazisaUserForScopes isicelo, okanye ikhowudi yemposiso engaziwayo ye clearAuthorizationState isicelo. Oku yi ibug eyaziwayo ngeApple okwenzekayo xa i-SDK izama ukufikelela kwikhonkco elitshixo. De iApple isombulule i-bug, ungasebenza kuyo ngokuvumela Ukwabelana ngekhonkco yeapp yakho phantsi kwe Izakhono 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 kwiiapps ze-iOS - Khuphela [kulungisiwe]
Ngena ngeAmazon IsiKhokelo sokuQalisa kwiiapps ze-iOS - Khuphela
