Hasi saioa Amazon Hasierako Gida iOS-erako

 

Sartu Amazon-ekin: iOS-erako Hasierako Gida

Copyright © 2016 Amazon.com, Inc. edo bere filialak. Eskubide guztiak erreserbatuak.
Amazon eta Amazon logotipoa Amazon.com, Inc. edo bere filialen marka komertzialak dira. Amazonen jabetzakoak ez diren gainerako marka guztiak dagokien jabeen jabetzakoak dira.

IOSerako lehen urratsak

Gida honetan, Amazon-ekin saioa nola gehitu zure iOS aplikazioan erakutsiko dizugu. Gida hau osatu ondoren, Amazon-ekin saioa hasteko botoi bat izan beharko zenuke zure aplikazioan erabiltzaileek Amazon-eko kredentzialekin saioa hasteko.

Xcode instalatzen

Amazon-erako saioa iOS SDK-rekin iOS-ek Amazon-ek eskaintzen du Amazon-ekin saioa zure iOS aplikazioan gehitzen laguntzeko. SDK Xcode garapen ingurunearekin erabiltzeko pentsatuta dago. SDK-k iOS 7.0 eta geroago ARMv7, ARMv7s, ARM64, i386 eta x86_64 erabiltzen dituzten aplikazioak onartzen ditu.

Xcode Mac App Store-tik instalatu dezakezu. Informazio gehiagorako, ikus Xcode: Zer da berria developer.apple.com webgunean.

Xcode instalatu ondoren, egin dezakezu Instalatu Saioa hasteko Amazon SDK iOS-erako eta Exekutatu Sample App, jarraian azaltzen den moduan.

Instalatu Saioa hasteko Amazon SDK iOS-erako

IOS SDS Amazon SDK-rekin saioa bi paketetan dator. Lehenengoan iOS liburutegia eta laguntza dokumentazioa daude. Bigarrenak honela daukaamperabiltzaileari saioa hastea ahalbidetzen dion aplikazioa eta view beren profile datuak.

Xcode oraindik instalatu ez baduzu, ikusi argibideak Instalatu Xcode goiko atala.

1. Deskargatu Saioa hasiAmazonSDKForiOS.zip eta atera filezure disko gogorreko direktorio batera.
   Ikusi beharko zenuke Saioa hasiWithAmazon.framework direktorioa. Honek Amazon-ekin saioa hasteko liburutegia dauka.
   Kremaileraren goiko mailan LoginWithAmazon.doc ezarri direktorioa. Honek APIaren dokumentazioa dauka.
2. Ikusi Instalatu Saioa hasi Amazon liburutegiarekin Liburutegia iOS proiektu batean nola gehitzeko argibideak lortzeko.

IOSerako Amazon SDK-rekin Saioa hasteko instalatuta dagoenean, egin dezakezu Sortu saio berria Amazon Project-ekin ondoren Saioa hasi Amazon-ekin erregistratzea.

Exekutatu Sample App

S exekutatzekoampaplikazioa, ireki sample Xcode-n.

1. Deskargatu SampleLoginWithAmazonAppForiOS.zip eta kopiatu
   SampleLoginWithAmazonAppForiOS direktorioa zure Dokumentuak karpetan.
2. Hasi Xcode. Welcome to Xcode elkarrizketa-koadroa agertzen bada, sakatu Ireki beste. Bestela, menu nagusian, egin klik File eta hautatu Ireki.
3. Hautatu Dokumentuak karpeta eta hautatu
   SampleLoginWithAmazonAppForiOS / LoginWithAmazonSample/ LoginWithAmazonSample.xcodeproj. Egin klik Ireki.
4. SampProiektua orain kargatu beharko litzateke. Amaitutakoan, aukeratu Produktua menu nagusian eta hautatu Korrika

Amazon-ekin saioa hasita erregistratzea

Hasi saioa Amazon-ekin erabili aurretik webwebgunean edo mugikorretarako aplikazio batean, aplikazio bat erregistratu behar duzu Login Amazon-ekin. Zure Amazon-ekin saioa hasteko aplikazioa zure negozioari buruzko oinarrizko informazioa eta bakoitzari buruzko informazioa biltzen dituen erregistroa da webAmazon-ekin saioa hastea onartzen duen webgunea edo aplikazio mugikorra. Enpresa-informazio hau erabiltzaileei bistaratzen zaie Amazon-ekin saioa zure gailuan erabiltzen duten bakoitzean webgunea edo mugikorretarako aplikazioa. Erabiltzaileek zure aplikazioaren izena, zure logotipoa eta zure pribatutasun politikarako esteka ikusiko dituzte. Urrats hauek Amazon aplikazioarekin saioa hasi eta kontu horri iOS aplikazio bat nola gehitu erakusten dute.

Ikus hurrengo gaiak

• Erregistratu saioa hastea Amazon aplikazioarekin
• Gehitu iOS aplikazio bat Security Pro batifile
• iOS sorta IDa eta API gakoak
  o Zehaztu iOS aplikazio baterako sorta-identifikatzailea
  o Berreskuratu iOS API gako bat

Erregistratu saioa hastea Amazon aplikazioarekin

1. Joan zaitez https://login.amazon.com.
2. Amazonekin saioa hasteko saioa hasi baduzu, egin klik Aplikazio kontsola. Bestela, egin klik Izena eman.
   Seller Central-era birbideratuko zara, Amazon-ekin saioa hasteko aplikazioen erregistroa kudeatzen duena. Seller Central erabiltzen duzun lehen aldia bada, Seller Central kontu bat konfiguratzeko eskatuko zaizu.
3. Egin klik Erregistratu Aplikazio Berria. The Erregistratu zure aplikazioa inprimakia agertuko da:
   
   a. Erregistratu zure eskaera formularioan, idatzi Izena eta a Deskribapena zure aplikaziorako.
   The Izena erabiltzaileek zure aplikazioarekin informazioa partekatzea onartzen dutenean baimena pantailan bistaratzen den izena da. Izen hau Android, iOS eta webzure aplikazioaren gune bertsioak.
   b. Sartu Pribatutasun-oharra URL zure aplikaziorako.
   Pribatutasun oharra URL zure enpresaren edo aplikazioaren pribatutasun-gidalerroaren kokalekua da (adibidezample, http: //www.example.com/privacy.html). Esteka hau erabiltzaileei erakusten zaie baimenaren pantailan.
   c. bat gehitu nahi baduzu Logotipoaren irudia zure aplikaziorako, egin klik Arakatu eta kokatu dagokion irudia.
   Logotipo hau saioa hasteko eta baimen pantailan agertzen da zure negozioa edo webgunea. Logotipoa 50 pixeleko altuerara murriztuko da 50 pixel baino altuagoa bada; logotipoaren zabaleran ez dago mugarik.
4. Egin klik Gorde. Zure samperregistroak honen antzekoa izan beharko luke:
   Zure oinarrizko aplikazioaren ezarpenak gorde ondoren, ezarpen zehatzetarako gehi ditzakezu webAmazon kontuarekin Saioa hasteko hau erabiliko duten gune eta mugikorreko aplikazioak.
   

Zure aplikazioaren bertsio ezberdinek sorta ID desberdinak badituzte, adibidez, proba-bertsio bat edo gehiago eta ekoizpen-bertsio batentzat, bertsio bakoitzak bere API gakoa behar du. Tik iOS ezarpenak Zure aplikazioaren, egin klik Gehitu API gakoa botoia zure aplikaziorako gako osagarriak sortzeko (bat bertsio bakoitzeko).

Gehitu iOS aplikazio bat Security Pro batifile

Zure oinarrizko aplikazioaren ezarpenak gorde ondoren, ezarpen zehatzetarako gehi ditzakezu webAmazon kontuarekin Saioa hasteko hau erabiliko duten gune eta mugikorreko aplikazioak.

IOS aplikazio bat erregistratzeko, aplikazioaren proiektuaren Bundle identifikatzailea zehaztu behar duzu. Amazon-ekin saioa hasteko sorta IDa API gakoa sortzeko erabiliko da. API gakoak zure aplikazioari sarbidea emango dio Amazon baimen zerbitzuarekin Saioa hasteko. Jarraitu urrats hauek iOS aplikazio bat zure kontuan gehitzeko:

1. Aplikazio-pantailan, egin klik iOS ezarpenak. IOS aplikazio bat erregistratuta baduzu, bilatu Gehitu API gakoa botoian iOS ezarpenak atala.
   The iOS aplikazioa Xehetasun inprimakia agertuko da:
   
2. Sartu Etiketa zure iOS aplikazioarena. Hau ez da zure aplikazioaren izen ofiziala izan behar. Besterik gabe, iOS aplikazio jakin hau aplikazioen artean identifikatzen du eta webAmazon Saioa hasteko aplikazioarekin erregistratutako guneak.
3. Sartu zure Bundle ID. Honek zure iOS proiektuaren sortaren identifikatzailearekin bat etorri behar du. Zure sortaren identifikatzailea zehazteko, ireki proiektua Xcode-n. Ireki proiektuaren propietateen zerrenda ( -Info.plist) in Proiektuen nabigatzailea. Sortaren identifikatzailea zerrendako propietateetako bat da.
4. Egin klik Gorde.

iOS sorta IDa eta API gakoak

Sortearen identifikatzaile bakarra da iOS aplikazio guztietan. Amazon-ekin saioa hasteko Bundle IDa erabiltzen du zure API gakoa eraikitzeko. API gakoak Amazon-ekin saioa hasteko baimena zerbitzuari zure aplikazioa ezagutzeko aukera ematen dio.

Zehaztu iOS aplikazio baterako sorta identifikatzailea

1. Ireki zure aplikazioaren proiektua Xcode-n.
2. Ireki Informazioaren Jabetza Zerrenda proiekturako ( -Info.plist) urtean Proiektuen nabigatzailea.
3. Aurkitu Bundle identifikatzailea propietateen zerrendan.

Eskuratu iOS API gakoa

IOS bertsioa erregistratu eta sorta IDa eman ondoren, API gakoa berreskuratu ahal izango duzu Amazon aplikazioarekin saioa hasteko erregistratzeko orrian. API gako hori zure proiektuaren jabetza zerrendan kokatu beharko duzu. Hori egin arte, aplikazioak ez du baimenik izango Saioa hasi Amazon baimen zerbitzuarekin komunikatzeko.

1. Joan hona https://login.amazon.com.
2. Egin klik Aplikazio kontsola.
3. En Aplikazioak koadroan, egin klik zure aplikazioan.
4. Aurkitu zure iOS aplikazioa azpian iOS ezarpenak atala. Oraindik ez baduzu iOS aplikaziorik erregistratu, ikus Gehitu iOS aplikazio bat Security Pro batifile.
5. Egin klik Sortu API gako balioa. Popup leiho batek zure API gakoa erakutsiko du. Gakoa kopiatzeko, egin klik Hautatu Guztiak tekla osoa hautatzeko.
Oharra: API gakoaren balioa, neurri batean, sortzen den denboran oinarritzen da. Horrela, sortzen dituzun API gakoen balioak jatorrizkoaren aldean egon daitezke. APIko balio gako horietako edozein erabil dezakezu zure aplikazioan, guztiak baliozkoak baitira.
6. Ikus Gehitu APIaren giltza zure aplikazioaren propietateen zerrendan iOS aplikazioan API gakoa gehitzeko argibideak lortzeko

Amazon Project-ekin saioa hastea

Atal honetan, Amazon-ekin Saioa hasteko Xcode proiektu berria nola sortu eta proiektua konfiguratzen ikasiko duzu.

Ikusi gai hauek:

• Sortu saio berria Amazon Project-ekin
• Instalatu Saioa hasi Amazon liburutegiarekin
• Gehitu APIaren giltza zure aplikazioaren propietateen zerrendan
• Gehitu a URL Zure aplikazioaren jabetza zerrendaren eskema
• Gehitu Amazon-en Garraiorako Segurtasun Salbuespen bat zure aplikaziora Jabetza zerrenda
  OHARRA: Urrats berri hau beharrezkoa da iOS 9 SDK-an garatzeko
• Gehitu Saioa hasi Amazon botoiarekin zure aplikazioan

Sortu saio berria Amazon Project-ekin

Oraindik ez baduzu Amazon-ekin saioa hasteko aplikazio proiekturik, jarraitu beheko argibideei bat sortzeko. Lehendik dagoen aplikazio bat baduzu, joan Instalatu saioa Amazon Liburutegiarekin saioa beheko atalera.

1. Abiarazi Xcode.
2. A aurkezten bazaizu Ongi etorri Xcode-era elkarrizketa-koadroa, hautatu Sortu Xcode proiektu berri bat.
   Bestela, File menua, hautatu Berria eta Proiektua.
3. Aukeratu sortu nahi duzun proiektu mota eta egin klik Hurrengoa.
4. Sartu a Produktuaren izena eta a Enpresaren identifikatzailea. Kontuan izan zure Multzoaren identifikatzailea, eta egin klik Hurrengoa.
5. Aukeratu zure proiektua gordetzeko kokapena eta egin klik Sortu.
   Orain Amazonekin saioa hasteko deitzeko erabil dezakezun proiektu berri bat izango duzu.

Instalatu Saioa hasi Amazon liburutegiarekin

Oraindik ez baduzu saioa deskargatu Amazon SDK-rekin iOS-erako, ikusi Instalatu Saioa hasteko Amazon SDK iOS-erako.

Amazon proiektuarekin Saioa hasteko Saioa hasiWithAmazon.framework eta Segurtasuna.esparrua liburutegiak. Markoaren bilaketa-bidea ere konfiguratu beharko duzu Amazon goiburuekin saioa hasteko

1. Zure proiektua Xcode-n irekita dagoela, hautatu Esparruak karpeta, egin klik File menu nagusitik, eta gero hautatu Gehitu Files to “proiektua”.
2. Elkarrizketan, hautatu Saioa hasiWithAmazon.framework eta egin klik Gehitu.
   Login with Amazon 1.0 liburutegia erabili baduzu, ezabatu login-with-amazon sdk direktorioa eta login-with-amazon-sdk.a Frameworks karpetatik. Egin klik Editatu menu nagusian eta hautatu Ezabatu.
3. Hautatu zure proiektuaren izena atalean Proiektuen nabigatzailea.
   The Proiektuaren editorea Xcode laneko espazioko editorearen eremuan agertuko da.
4. Egin klik azpian zure proiektuaren izenean Helburuak, eta hautatu Eraiki faseak. Zabaldu Link Binary Liburutegiekin eta egin klik plus ikurra liburutegi bat gehitzeko.
5. Bilaketa-koadroan, sartu Segurtasuna.esparrua. Hautatu Segurtasuna.markoa eta egin klik Gehitu.
6. Bilaketa-koadroan, sartu SafariServices.framework. Hautatu SafariServices.framework eta egin klik Gehitu.
7. Bilaketa-koadroan, sartu CoreGraphics.markoa. Hautatu CoreGraphics.markoa eta egin klik Gehitu
8. Hautatu Eraiki ezarpenak. Egin klik Guztiak egiteko view ezarpen guztiak.
9. Azpian Bilatu bideak, ziurtatu du Saioa hasiWithAmazon.framework direktorioa fitxategian dago Esparru Bilaketa Bideak.
   Adibidezample:
   
   Hasi saioa Amazon 1.0 liburutegiarekin erabili baduzu, 1.0 liburutegiko bidearen edozein erreferentzia ken dezakezu Goiburuko bilaketa bideak or Liburutegien bilaketa bideak.
10. Menu nagusitik, egin klik Produktua eta hautatu Eraiki. Eraikuntza behar bezala osatu beharko litzateke.
    Zure proiektua eraiki aurretik, Amazon 1.0 liburutegiarekin saioa hasi baduzu, ordezkatu #import “AIMobileLib.h”, #import “AIAuthenticationDelegate.h”, or #inportatu "AIError.h" zure iturrian files-rekin #inportatu
    .
    LoginWithAmazon.h Amazon goiburuekin saioa hasteko guztiak aldi berean biltzen ditu.

Gehitu APIaren giltza zure aplikazioaren propietateen zerrendan

Zure iOS aplikazioa Login Amazon-ekin erregistratzen duzunean, API gako bat esleitzen zaizu. Hau Amazon Mobile Liburutegiak zure aplikazioa identifikatzeko erabiliko duen identifikatzaile bat da. Amazon Mobile Library-k balio hori exekutatzen ari den unean kargatzen du zure aplikazioaren Informazioaren Propietateen Zerrendako API Gakoaren propietatearen baliotik.

1. Zure proiektua irekita dagoela, hautatu Laguntzea Files karpeta, eta hautatu -Info.plist file (non zure proiektuaren izena da). Editatzeko propietate zerrenda ireki beharko litzateke:
   
2. Ziurtatu sarrerarik ez dagoela hautatuta. Ondoren, menu nagusitik, egin klik Editorea, eta Gehitu elementua. Sartu APKey eta sakatu Sartu.
3. Egin klik bikoitza Balioa zutabea balio bat gehitzeko. Itsatsi API gakoa balio gisa.

Gehitu a URL Zure aplikazioaren jabetza zerrendaren eskema

Erabiltzailea saioa hasten denean, Amazon saio hasiera orria aurkeztuko zaie. Zure aplikazioak saioa hasteko baieztapena jaso dezan, hau gehitu behar duzu URL eskema beraz web orrialdeak zure aplikaziora birbideratu dezake. The URL eskema gisa adierazi behar da amzn- (adibidezample, amzncom.example.app). Informazio gehiagorako, ikus Erabiliz URL Aplikazioekin komunikatzeko eskemak developer.apple.com webgunean.

1. Zure proiektua irekita dagoela, hautatu Laguntzea Files karpeta, eta hautatu -Info.plist file (non zure proiektuaren izena da). Editatzeko propietate zerrenda ireki beharko litzateke:
   
2. Ziurtatu sarrerarik ez dagoela hautatuta. Ondoren, menu nagusitik, egin klik Editorea, eta Gehitu elementua. Sartu edo hautatu URL motak eta sakatu Sartu.
3. Zabaldu URL motak agerian jartzeko Elementua 0. Hautatu Elementua 0 eta, menu nagusitik, sakatu Editorea eta Gehitu elementua. Sartu edo hautatu URL Identifikatzailea eta sakatu Sartu.
4. Hautatu 0. elementua azpian URL Identifikatzailea eta egin klik bikoitza Balioa zutabearen azpian balio bat gehitzeko. Balioa zure sortaren IDa da. Zure sortaren ID sortaren identifikatzaile gisa zerrendatuta aurki dezakezu jabetza zerrendan.
5. Hautatu 0. elementua azpian URL motak eta, menu nagusian, egin klik Editorea eta Gehitu elementua. Sartu edo hautatu URL Eskemak eta sakatu Sartu.
6. Hautatu 0. elementua azpian URL Eskemak eta egin klik bikoitza ikurraren azpian Balioa a gehitzeko zutabea balioa. Balioa zure sortaren IDa da amzn- aurrez (adibidezample, amzn com.example.app). Zure sorta ID gisa zerrendatuta aurki dezakezu Bundle identifikatzailea jabetza zerrendan.

Gehitu Amazon-en Garraiorako Segurtasun Salbuespen bat zure aplikaziora
Jabetza zerrenda

iOS 9-tik hasita, Apple-k App Transport Security (ATS) aplikatzen du aplikazio baten eta aplikazioen arteko konexio seguruetarako web zerbitzuak. Amazon SDK-arekin saioa hasteko amaiera-puntua (api.amazon.com) informazioa trukatzeko elkarreragiten duen puntua ez dago oraindik ATSarekin bat. Gehitu api.amazon.com-en salbuespen bat SDK-aren eta Amazon zerbitzariaren arteko komunikaziorik gabekoa gaitzeko.

1. Zure proiektua irekita dagoela, hautatu Laguntzea Files karpeta, eta hautatu -Info.plist file (non da zure proiektuaren izena). Honek propietateen zerrenda ireki beharko luke editatzeko:
   
2. Ziurtatu sarrera bat ere ez dela. Ondoren, menu nagusitik, egin klik Editorea, eta Gehitu elementua. Sartu edo hautatu NSAppTransportSecurity eta sakatu Sartu.
3. Zabaldu NSAppTransportSecurity eta, menu nagusian, egin klik Editorea eta Gehitu elementua. Sartu edo hautatu NSExceptionDomains eta sakatu Sartu.
4. Zabaldu NSExceptionDomains eta, menu nagusian, egin klik Editorea eta Gehitu elementua. Sartu amazon.com eta sakatu Sartu.
5. Zabaldu amazon.com eta, menu nagusian, egin klik Editorea eta Gehitu elementua.Sartu NSExceptionRequiresForwardSecrecy eta sakatu Sartu.
6. Hautatu NSExceptionRequiresForwardSecrecy eta egin klik bikoitza ikurraren azpian Balioa zutabe bat gehitzeko Hautatu a Mota of Boolearra eta a Balioa of EZ.

Gehitu Saioa hasi Amazon botoiarekin zure aplikazioan

Amazon-ekin saioa hasteko hainbat botoi estandar eskaintzen ditu erabiltzaileei zure aplikaziotik saioa hasteko eskatzeko. Atal honek Amazon-eko irudiarekin Saioa hasteko modu ofiziala deskargatzeko eta iOS UIButton batekin parekatzeko urratsak ematen ditu.

1. Gehitu UIButton estandar bat zure aplikazioan.
   Aplikazio bati botoia gehitzeko tutorialak eta informazioa lortzeko, ikusi Sortzea eta konfiguratzea View Objektuak eta Hasi iOS aplikazioak garatzen gaur developer.apple.com webgunean.
2. Gehitu Ukitu Barruan izeneko metodoaren botoiaren gertaera onLoginButtonClicked. Utzi inplementazioa hutsik oraingoz. The Sortzen eta Konfiguratzen View Objektuak eta Hasi iOS aplikazioak garatzen gaur apple.com-eko dokumentuek botoi-gertaera bat gehitzeko urratsak biltzen dituzte.
3. Aukeratu botoiaren irudia.
   Kontsultatu Amazon-ekin saioa hastea Estilo jarraibideak zure aplikazioan erabil ditzakezun botoien zerrenda lortzeko. Deskargatu LWA_for_iOS.zip file. Bilatu nahiago duzun botoia 1x eta 2x direktorioetan eta atera zip-etik. Atera botoiaren bertsio sakatua botoia Hautatutako egoeran erakutsi nahi baduzu.
4. Gehitu irudiak zure proiektuari.
   a. Xcode-en, zure proiektua kargatuta, egin klik File menu nagusian eta hautatu Gehitu Files "proiektatzeko".
   b. Elkarrizketa-koadroan, hautatu botoiaren irudia file(s) deskargatu dituzun eta egin klik Gehitu.
   c. Botoiak zure proiektuaren direktorioko proiektuan egon beharko lirateke. Mugi itzazu euskarrira Filesfolder.
5. Gehitu irudia zure botoiari.
   Zure botoiaren irudia gaitzeko, botoiaren atributua alda dezakezu edo setImage: forState metodoa UIBton objektua. Jarraitu urrats hauei zure botoiaren irudiaren atributua aldatzeko:
   a. Ireki zure aplikazioaren storyboard.
   b. Aukeratu zure storyboard-eko botoia klik eginez edo hautatu View Kontrolatzailea Eszenaren zuhaitza.
   c. urtean Utilitateak leihoa ireki Atributuak Ikuskaria.
   
   d. Attribute Inspector-en goialdean, ezarri Mota botoia Sistema moduan.
   e. Bigarren ezarpenen taldean, hautatu Lehenetsia Egoera konfigurazioan.
   f. Bigarren ezarpen taldean, jaitsi Irudiaren ezarpena.
   g. Hautatu proiektuan gehitu duzun Saioa hasi Amazon botoia grafikoa. Ez hautatu 2x bertsioa: automatikoki kargatuko da dentsitate handiko pantailako (Retina) gailuetan.
   h. Ezarri irudi bera Atzeko planoaren ezarpenerako.
   i. Sakatutako botoiaren bertsio bat zehaztu nahi baduzu, hautatu Hautatu egoera konfiguraziorako eta ezarri Irudia zure botoiaren _Pressed bertsioan.
   j. Storyboard-ean, egokitu botoiaren tamaina irudia egokitzeko, beharrezkoa bada.

iOS APIetarako SDK-a erabiltzea

Atal honetan, zure proiektuari kodea gehituko diozu erabiltzaile batekin saioa hasteko Amazon-ekin erabiltzaile batekin saioa hasteko.
Ikusi gai hauek:

• Maneiatu Saioa hasteko botoia eta lortu Profile Datuak
• Begiratu Erabiltzaile Saioa hasteko abiaraztean
• Garbitu baimenaren egoera eta amaitu erabiltzaile bat

Maneiatu Saioa hasteko botoia eta lortu Profile Datuak

Atal honetan azaltzen da nola deitu authorizeUserForScopes:delegate: eta getProfile:APIak erabiltzaile bat saioa hasteko eta bere pro berreskuratzekofile datuak. Horrek bat sortzea barne hartzen du onLoginButtonClicked:entzulea Hasi saioa Amazon botoian.

1. Gehitu Amazon-ekin saioa hasi zure iOS proiektuan. Ikus Instalatu saioa Amazon liburutegiarekin.
2. Inportatu Saioa hasi Amazon APIarekin zure iturrira file.
   Saio hasiera Amazon APIarekin inportatzeko, gehitu honako hau # garrantzitsuadierazpenak zure iturrira file:

   #garrantzia

3. Sortu AMZNAuthorizeUserDelegateclass ezartzeko
   AIAAuthenticationDelegate.
   Noiz authorizeUserForScopes:delegate: osatu, deituko du requestDidSucceed: or requestDidFail: metodoa inplementatzen duen objektu batean AIAAuthenticationDelegate protokoloa.

   @interface AMZNAuthorizeUserDelegate : NSObject @amaiera

   Informazio gehiagorako, ikus Protokoloekin lan egitea  developer.apple.com webgunean.
4. Deitu authorizeUserForScopes:delegate: in onLoginButtonClicked.
   atalean urratsak jarraitu badituzu Gehitu Saioa hasi Amazon botoiarekin zure aplikazioan, bat izan beharko zenuke onLoginButtonClicked: metodoa Amazon botoiarekin saioa hastearekin lotuta. Metodo horretan, deitu authorizeUserForScopes:delegate:to eskatu erabiltzaileari saioa hasteko eta zure aplikazioa baimentzeko.
   Metodo honi esker, erabiltzaileari saioa hasteko eta eskatutako informazioa onartzeko baimena emango zaio modu hauetako batean:
   1.) Hona aldatzen da web view testuinguru seguru batean (Amazon Shopping aplikazioa gailuan instalatuta badago)
   2.) Safarira aldatzen da View Kontrolatzailea (iOS 9 eta berriagoetan)
   3.) Sistemaren arakatzailera aldatzen da (iOS 8 eta berriagoetan)
   Lehenengo aukeraren testuinguru segurua eskuragarri dago Amazon Shopping aplikazioa gailuan instalatzen denean. Erabiltzailea Amazon Shopping aplikazioan saioa hasita badago, saioa hasteko orria saltatu egingo da, a Saio-hasiera bakarra (SSO) esperientzia.

   Zure aplikazioa baimenduta dagoenean, esparru gisa ezagutzen diren datu multzo baterako edo gehiagorako baimenduta dago. Lehenengo parametroa Amazon-ekin saioa hasteko eskatzen ari zaren erabiltzaile-datuak biltzen dituen esparru sorta bat da. Erabiltzaile bat zure aplikazioan saioa hasten den lehen aldian, eskatzen ari zaren datuen zerrenda bat aurkeztuko zaio eta onarpena eskatuko zaio. Une honetan Amazon-ekin saioa hastea hiru esparru onartzen ditu: profile, erabiltzailearen izena, helbide elektronikoa eta Amazon kontuaren IDa dituena; profile: erabiltzailea_id, Amazon kontuaren IDa soilik duena; eta posta kodea, erabiltzailearen posta / kodea.
   Bigarren parametroa authorizeUserForScopes:delegate: inplementatzen duen objektua da AIAAuthenticationDelegateprotokoloa, kasu honetan ren instantzia bat AMZNAuthorizeUserDelegate klasea.

   - (IBAction) onLogInButtonClicked: (id) igorlea { // Egin baimendu SDK-ra sarbide-token seguru bat lortzeko // erabiltzailearentzat. // Lehenengo deia egiten duzun bitartean oinarrizkoa minimoa zehaztu dezakezu // esparruak behar dira. // Uneko erabiltzaileari bi esparruak eskatzea. NSArray *requestScopes = [NSArray arrayWithObjects:@”profile”, @”posta_kodea”, nil]; AMZNAuthorizeUserDelegate* delegatu = [[AMZNAuthorizeUserDelegate alloc] initWithParentController:self]; [AIMobileLib authorizeUserForScopes:requestScopes delegatu:delegate];

   Gehitu zure delegatuaren ezarpenaren goiburua klase-deian
   authorizeUserForScopes:. Adibidezample:

   #import "AMZNAuthorizeUserDelegate.h"

5. Sortu bat AMZNGetProfileOrdezkaria.
   AMZNGetProfileDelegatuak gure izena inplementatzen duen klase baterako
   AIAAuthenticationDelegateprotokoloa, eta emaitza prozesatuko du getProfile: deitu. Atsegin dut authorizeUserForScopes:delegate:, getProfile: onartzen du requestDidSucceed: eta requestDidFail: protokolo metodoak. requestDidSucceed: bat jasotzen du APIResult objektua profile datuak emaitza propietatean. requestDidFail: bat jasotzen du AIEerrorea objektua errorearen propietatearen erroreari buruzko informazioa duena.
   Klase arrunteko deklarazio batetik delegatu-klase bat sortzeko, inportatu
   AIAauthenticationDelegate.hand gehitu protokoloa zure klaseko goiburuko deklarazioari file:

   #inportatu @interface AMZNGetProfileOrdezkaria: NSObject @end

    

6. Ezartzea requestDidSucceed:for zure AMZNAuthorizeUserDelegate. In requestDidSucceed:, deitu getProfile: bezeroaren pro berreskuratzekofile. getProfile:, atsegin authorizeUserForScopes:delegate:, AIAuthenticationDelegate protokoloa erabiltzen du.
   

   – (huts) eskaera Arrakasta egin du: (APIResult *)apiResult { // Erabiltzaileak aplikaziorako baimena eman ondoren zure kodea // eskatutako esparruak. // Kargatu berria view erabiltzailearen identifikazio-informazioa duen kontrolatzailea // erabiltzailea saioa hasita dagoenez. AMZNGetProfileOrdezkari* ordezkari = [[AMZNGetProfileDelegatu alloc] initWithParentController:gurasoaViewKontrolatzailea] autorelease]; [AIMobileLib getProfile:ordezkaria]; }

   Gehitu zure delegatuaren ezarpenaren goiburua klase-deian getProfile:. Forexample:
   

   #inportatu "AMZNGetProfileDelegatua.h”

7. Ezartzea requestDidSucceed: zuretzat AMZNGetProfileOrdezkaria.
   requestDidSucceed:du bi zeregin nagusi: pro berreskuratzeafile -tik datozen datuak APIResult, eta datuak UIra pasatzeko.
   Pro berreskuratzekofile -tik datozen datuak APIResult, atzitu emaitzaren propietatea. Batentzat getProfile:erantzuna, propietate horrek propietate-balioen hiztegi bat edukiko du erabiltzailearen profile propietateak. Profile propietateak dira izena, posta elektronikoa, eta erabiltzaile_id profesionalentzatfile esparrua eta
   posta_kodea rentzat posta_kodea esparrua.

   – (huts) eskaera Arrakasta egin du: (APIResult *)apiResult { // Lortu profile eskaerak arrakasta izan du. Deskonprimitu profesionalafile informazioa // eta gurasoari pasa view kontrolatzailea NSString* izena = [(NSDictionary*)apiResult.result objectForKey:@”izena”]; NSString* email = [(NSDictionary*)apiResult.result objectForKey:@”email”]; NSString* user_id = [(NSDictionary*)apiResult.result objectForKey:@”user_id”]; NSString* postal_code = [(NSDictionary*)apiResult.result objectForKey:@”posta_kodea”]; // Pasatu datuak view kontrolatzailea }

8. Ezartzea requestDidFail: zuretzat AMZNGetProfileOrdezkaria.
   requestDidFail: bat barne hartzen du APIEerrorea erroreari buruzko xehetasunak dituen objektua. showLogInPageis nagusia berrezartuko lukeen metodo hipotetikoa view kontrolagailua Amazon-ekin saioa hasteko botoia erakusteko.

   – (void)requestDidFail:(APIError *)errorResponse { // Lortu Profile eskaera huts egin du pro-rakofile esparrua. // Errore kodea = kAIApplicationNotAuthorized bada, // erabiltzaileari berriro saioa hasteko baimena eman. if(errorResponse.error.code == kAIApplicationNotAuthorized) { // Erakutsi baimendu erabiltzaile botoia. [gurasoaViewKontrolatzailea showLogInPage]; } bestela { // Beste akats batzuk kudeatu [[[[UIAlertView alloc] initWithTitle:@”” mezua:[NSString stringWithFormat:@”Errorea gertatu da mezuarekin: %@”, errorResponse.error.message] delegatu: nul cancelButtonTitle:@”OK”otherButtonTitles: nil] autorelease] show]; } }

9. Ezartzea requestDidFail:for zure AMZNAuthorizeUserDelegate.
   

   – (void)requestDidFail:(APIError *)errorResponse { NSString *message = errorResponse.error.message; // Zure kodea baimenak huts egiten duenean. [[[[UIAlertView alloc] initWithTitle:@”” mezua:[NSString stringWithFormat:@”Erabiltzaileen baimenak huts egin du mezuarekin: %@”, errorResponse.error.message] delegate: nil cancelButtonTitle:@”OK”otherButtonTitles: nil] autorelease] show]; }

   10. Ezartzea aplikazioa: irekiaURL:sourceApplication:anotation: kudeatzen duen zure proiektuko klasean UIA eskaeraDelegatua protokoloa (lehenespenez hau izango da AppDelegateclass zure proiektuan). Aplikazioak Amazon saio-hasiera orria aurkezten duenean eta erabiltzaileak saioa hasten duenean, aplikaziora birbideratuko du aplikazioa erabiliz. URL Programatu lehenago erregistratutako aplikazioa. Berbideratze hori pasatzen da aplikazioa: irekiaURL:sourceApplication:anotation:, itzultzen dena BAI bada URL arrakastaz kudeatu da. heldulekuaIrekiURL:iturriaAplikazioa: Amazon-en birbideraketarekin saioa hasi behar duen SDK liburutegiko funtzio bat da URLs zuretzat. Bada heldulekuaIrekiURL:sourceApplication: BAI itzultzen du, gero URL kudeatu zen.

   – (BOOL)aplikazioa:(UIApplication *)aplikazioa irekitaURL: (NSURL *)url sourceApplication:(NSString *)sourceApplication anotación:(id)anotación { // Pasatu url SDK-ra baimen-kodea //tik analizatzeko url. BOOL isValidRedirectSignInURL = [AIMobileLib heldulekuaIrekiURL:url iturburuAplikazioa:sour ceApplicati on); bada (!isValidRedirect Si gnlnURL) itzuli EZ; // Baliteke aplikazioak ere kudeatu nahi izatea url itzuli BAI ; }

   OHARRA: Metodo hau iOS 9-n zaharkituta dago, baina zure proiektuan sartu beharko litzateke plataforma zaharretako erabiltzaileentzako laguntza mantentzeko. Informazio gehiagorako aplikazioa: irekiaURL:sourceApplication:anotation:, ikusi UIApplicationDelegate Protokolo-erreferentzia developer.apple.com webgunean.

Begiratu Erabiltzaile Saioa hasteko abiaraztean

Erabiltzaile batek zure aplikazioan saioa hasten badu, aplikazioa itxi eta beranduago berrabiarazten badu, aplikazioak datuak berreskuratzeko baimena izango du oraindik. Erabiltzailea ez da saioa amaitzen. Abiaraztean, erabiltzaileari saioa hasita duela erakuts diezaiokezu zure aplikazioak oraindik baimena badu. Atal honetan nola erabili azaltzen da
getAccessTokenForScopes:withOverrideParams:delegate: aplikazioa oraindik baimenduta dagoen ikusteko.

1. Sortu bat AMZNGetAccessTokenDelegate klasea. AMZNGetAccessTokenDelegateimplements du AIAAuthenticationDelegate protokoloa, eta emaitza prozesatuko du
   getAccessTokenForScopes:withOverrideParams:delegate: deitu. AIAAuthenticationDelegate bi metodo ditu, requestDidSucceed: eta requestDidFail:. requestDidSucceed: bat jasotzen du APIResult token datuekin objektua, bitartean requestDidFail: bat jasotzen du APIEerrorea objektu akatsari buruzko informazioarekin.

   #garrantzia @interface AMZNGetAccessTokenDelegate :NSObject @amaiera

   Gehitu zure delegatuaren ezarpenaren goiburua klase-deian
   getAccessTokenForScopes:withOverrideParams:delegate:. Forexample:

   #import "AMZNGetAccessTokenDelegate.h"

2. Aplikazioa abiarazten denean, deitu
   getAccessTokenForScopes:withOverrideParams:delegate: eskaera oraindik baimenduta dagoen ikusteko. getAccessTokenForScopes:withOverrideParams:delegate: Login-ekin Amazon-ek bezero profesional batera sartzeko erabiltzen duen sarbide-token gordina berreskuratzen dufile. Metodoa arrakastatsua bada, aplikazioa oraindik baimenduta dago eta dei egiten zaio getProfile: arrakasta izan beharko luke. getAccessTokenForScopes:withOverrideParams:delegate: erabiltzen du AIAAuthenticationDelegate protokoloaren modu berean baimenduUserForScopes:delegate:. Pasatu protokoloa inplementatzen duen objektua delegatu-parametro gisa.

   – (huts) checkIsUserSignedIn { AMZNGetAccessTokenDelegate* delegatu = [[[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorelease]; NSArray *requestScopes = [NSArray arrayWithObjects:@”profile”, @”posta_kodea”, nil]; [AIMobileLib getAccessTokenForScopes:requestScopes withOverrideParams:nil delegate:delegate]; }

3. Ezartzea requestDidSucceed: zure gainean AMZNGetAccessTokenDelegate. requestDidSucceed: zeregin bat du: deitzea getProfile:. Adibample deiak getProfile: aurreko atalean adierazi duzun entzule bera erabiliz (ikus 6-8 urratsak).
   

   #inportatu "AMZNGetProfileDelegatua.h” #garrantzia – (huts) eskaera Arrakasta egin du: (APIResult *)apiResult { // Sarbide-tokena erabiltzeko zure kodea hemen doa. // Aplikazioak gure esparruetarako baimena duenez, ahal dugu // lortu erabiltzailea profile. AMZNGetProfileOrdezkaria* delegatua = [[AMZNGetProfileDelegatu alloc] initWithParentController:gurasoaViewKontrolatzailea] autorelease]; [AIMobileLib getProfile:ordezkaria]; }

4. Ezartzea requestDidFail: zure gainean AMZNGetAccessTokenDelegate.
   requestDidFail: bat barne hartzen du APIEerrorea erroreari buruzko xehetasunak dituen objektua. Errore bat jasotzen baduzu, nagusia berrezarri dezakezu view kontrolagailua Amazon-ekin saioa hasteko botoia erakusteko.

   – (void)requestDidFail:(APIError *)errorResponse { // Sarbide-token hutsegitearen berreskurapena kudeatzeko zure kodea. // Errore kodea = kAIApplicationNotAuthorized bada, baimendu erabiltzailea // berriro saioa hasteko. if(errorResponse.error.code == kAIApplicationNotAuthorized) { // Erakutsi saioa Amazon botoiarekin. } bestela { // Beste akats batzuk kudeatu [[[[UIAlertView alloc] initWithTitle:@”” mezua:[NSString stringWithFormat:@”Errorea gertatu da mezuarekin: %@”, errorResponse.error.message] delegate: nil cancelButtonTitle:@”OK” otherButtonTitles: nil] autorelease] show]; } }

Garbitu baimen-egoera eta amaitu saioa Erabiltzaile batean

The clearAuthorizationState: metodoak erabiltzailearen baimen-datuak garbituko ditu AIMobileLib tokiko datu biltegia. Erabiltzaile batek berriro saioa hasi beharko du aplikazioak pro berreskuratzekofile datuak. Erabili metodo hau erabiltzaile bat amaitzeko edo aplikazioko saio-hasierako arazoak konpontzeko.

1. Adierazi AMZNLoutDelegate. Hau inplementatzen duen klase bat da
   AIAAuthenticationDelegateprotokoloa. Gure helburuetarako, klasea hereda dezakegu NSOobjektua:
   

   #garrantzia @interface AMZNLogoutDelegate NSObject @amaiera

   Gehitu zure delegatuaren ezarpenaren goiburua klase-deian clearAuthorizationState:. Adibidezample:

   #import "AMZNLogoutDelegate.h"

2. Deitu clearAuthorizationState:.
   Erabiltzaileak saioa behar bezala hasi duenean, saioa amaitzeko mekanismo bat eskain dezakezu bere baimen-datuak garbitu ditzan. Zure mekanismoa hiperesteka bat edo menu-elementu bat izan daiteke, baina eszenatoki honetarako adibidezample bat sortuko du logoutButtonClickedmetodoa saioa amaitzeko botoi baterako.

   – (IBAction)logoutButtonClicked:(id) bidaltzailea { AMZNLogoutDelegate* delegate = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorelease]; [AIMobileLib clearAuthorizationState: delegatu]; }

   Parametro bakarra garbituAuthorizationState bat da AIAAuthenticationDelegate gauzatzen duena. requestDidSucceed: eta requestDidFail:.

3. Ezartzea requestDidSucceed:. Metodo honi deituko zaio erabiltzailearen informazioa garbitzen denean. Ondoren, saioa amaituta dagoela erakutsi beharko zenuke.
   

   – (huts) eskaera Arrakasta egin du: (APIResult *)apiResult { // Zure logika gehigarria erabiltzailearen baimenaren ondoren // egoera garbitu da. [[UIAlertView alloc] initWithTitle:@”” mezua:@”Erabiltzailea saioa amaitu da.” delegate: nil cancelButtonTitle:@”OK” otherButtonTitles: nil] show]; }

4. Ezartzea requestDidFail:. Metodo hau deituko da arrazoiren batengatik erabiltzailearen informazioa cachetik ezin bada garbitu. Kasu horretan, ez dituzu saioa amaituta bezala erakutsi behar.
   

   – (void)requestDidFail:(APIError *)errorResponse { // SDK-aren ondoren zure logika gehigarria ez da garbitu // baimen-egoera. [[[[UIAlertView alloc] initWithTitle:@”” mezua:[NSString stringWithFormat:@”Erabiltzaileen saioak huts egin du mezuarekin: %@”, errorResponse.error.message] delegatu: nul cancelButtonTitle:@”OK” otherButtonTitles: nil] autorelease] show]; }

Probatu zure integrazioa

Abiarazi aplikazioa iOS gailu edo simulagailu batean eta baieztatu Amazon.com egiaztagiriekin saioa has zaitezkeela.

Oharra: iOS10 simulagailuetan probatzen ari zarenean, baliteke aplikaziorako APKey errore-mezua baliogabea dela authorizeUserForScopes eskaera baterako, edo errore-kode ezezaguna clearAuthorizationState eskaera baterako. Hau da Apple-rekin ezagutzen den akatsa SDK giltza-katean sartzen saiatzen denean gertatzen dena. Applek akatsa konpondu arte, horri aurre egin dezakezu zure aplikaziorako giltza-kateen partekatzea gaituta zure aplikazioaren xedeko Gaitasunak fitxan. Akats honek simulagailuetan bakarrik eragiten du. Benetako iOS10 gailuetan probatu dezakezu inolako konponbiderik erabili gabe.

Hasi saioa Amazon Hasierako Gida iOS 2.1.2 bertsiorako - Deskargatu [optimizatua]
Hasi saioa Amazon Hasierako Gida iOS 2.1.2 bertsiorako - Deskargatu

Erreferentziak

• Erabiltzailearen eskuliburua