Pag-login gamit ang Panudlo sa Pagsugod sa Amazon alang sa mga iOS app
Pag-login uban ang Amazon: Pagsugod sa Giya alang sa iOS
Copyright © 2017 Amazon.com, Inc., o mga kauban niini. Gireserba ang tanan nga mga katungod. Ang Amazon ug ang logo sa Amazon mga marka sa pamaligya sa Amazon.com, Inc. o mga kauban niini. Ang tanan nga uban pang mga marka sa pamaligya nga wala tag-iya sa Amazon gipanag-iya sa tagsatagsa nila nga mga tag-iya.
Pasiuna
Sa kini nga panudlo ipakita namon kanimo kung unsaon pagdugang ang Pag-login gamit ang Amazon sa imong iOS app, gamit ang Login nga adunay Amazon SDK alang sa iOS v3.0 +.
Pagkahuman sa pagkompleto sa kini nga panudlo kinahanglan ka adunay usa ka nagtrabaho nga Login nga adunay buton sa Amazon sa imong app nga nagtugot sa mga ninggamit nga mag-login gamit ang ilang mga kredensyal sa Amazon. Aron mahibal-an ang bahin sa pag-agos sa pag-login nga masinati sa imong mga kustomer kung gamiton nila ang Pag-login gamit ang Amazon sulud sa imong app, palihug tan-awa ang among Kasinatian sa Kustomer Tapos naview alang sa mga iOS app.
Pag-instalar sa Mga Himan sa Developer sa iOS
Pag-instalar sa XCode
Ang Pag-login nga adunay Amazon SDK alang sa iOS gihatag sa Amazon aron matabangan ka nga makadugang Pag-login sa Amazon sa imong aplikasyon sa iOS. Ang SDK gituyo aron magamit sa palibot sa pagpalambo sa Xcode. Gisuportahan sa SDK ang mga app nga nagdagan sa iOS 7.0 ug pagkahuman nga gigamit ang ARMv7, ARMv7s, ARM64, i386, ugx86_64.
Mahimo nimong i-install ang Xcode gikan sa Mac App Store. Alang sa dugang nga kasayuran, tan-awa Xcode: Unsa ang Bag-o on developer.apple.com.
Pagkahuman ma-install ang Xcode, mahimo nimo I-install ang Login gamit ang Amazon SDK alang sa iOS ug Pagdagan ang Sampang App, sama sa gihulagway sa ubus.
I-install ang Login gamit ang Amazon SDK alang sa iOS
Ang Login sa Amazon SDK alang sa iOS moabut sa duha ka mga pakete. Ang una naglangkob sa librarya sa iOS ug pagsuporta sa dokumentasyon. Ang ikaduha naglangkob sa ingonample aplikasyon nga nagtugot sa usa ka user sa pag-log in ug view ilang profile datos.
Kung wala pa nimo ma-install ang Xcode, tan-awa ang mga panudlo sa I-install ang Xcode seksyon sa ibabaw.
- Pag-download LoginWithAmazonSDKForiOS.zip ug i-extract ang files sa usa ka direktoryo sa imong hard drive.
Kinahanglan nimo nga makita ang usa ka direktoryo sa LoginWithAmazon.framework. Adunay kini sulud nga Login uban ang librarya sa Amazon.
Sa taas nga lebel sa zip usa ka LoginWithAmazon.docset direktoryo Naglangkob kini sa dokumentasyon sa API. - Tan-awa ang Pag-install sa Login uban ang Amazon Library alang sa mga panudlo kung giunsa makadugang ang librarya sa usa ka proyekto sa iOS.
Kung ang Pag-login uban ang Amazon SDK alang sa iOS na-install, mahimo nimo Paghimo usa ka Bag-ong Pag-login sa Amazon Project pagkahuman nimo Pagrehistro uban ang Pag-login sa Amazon.
Pagdagan ang Sampang App
Aron mapadagan ang sample aplikasyon, ablihi ang sample sa Xcode.
- Pag-download SampleLoginWithAmazonAppForiOS.zip ug kopyaha ang
SampleLoginWithAmazonAppForiOS direktoryo sa imong folder nga Mga Dokumento. - Pagsugod sa Xcode. Kung ang dialog nga Welcome sa Xcode mo-pop up, i-klik ang Open Other. Kung dili, gikan sa main menu, i-klik File ug pilia ang Open.
- Pilia ang folder nga Mga Dokumento, ug pilia
SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/
LoginWithAmazonSample.xcodeproj. Pag-klik Bukas. - Ang sampAng proyekto kinahanglan nga mag-load. Kung nahuman na, pilia produkto gikan sa punoan nga menu, ug pilia Dagan.
Pagrehistro uban ang Pag-login sa Amazon
Sa dili pa nimo magamit ang Login sa Amazon sa usa ka website o sa usa ka mobile app, kinahanglang magparehistro ka og aplikasyon gamit ang Login sa Amazon. Ang imong Login sa Amazon nga aplikasyon mao ang pagrehistro nga adunay sukaranan nga kasayuran bahin sa imong negosyo, ug kasayuran bahin sa matag usa website o mobile app nga imong gihimo nga nagsuporta sa Login gamit ang Amazon. Kini nga impormasyon sa negosyo gipakita ngadto sa mga tiggamit sa matag higayon nga sila mogamit sa Login uban sa Amazon sa imong website o mobile app. Makita sa mga tiggamit ang ngalan sa imong aplikasyon, imong logo, ug usa ka link sa imong palisiya sa pagkapribado. Gipakita niini nga mga lakang kung giunsa pagparehistro ang imong iOS app aron magamit sa Pag-login sa Amazon.
Pagrehistro sa Imong Pag-login sa Amazon Application
- Adto sa https://login.amazon.com.
- Kung nagpalista ka alang sa Pag-login sa Amazon kaniadto, pag-klik App Console. Kung dili, i-klik Sign Up. Mahatud ka sa direksyon sa Seller Central, nga nagdumala sa pagparehistro sa aplikasyon alang sa Pag-login gamit ang Amazon. Kung kini ang imong unang higayon sa paggamit sa Seller Central, hangyuon ka nga mag-set up usa ka Seller Central account.
- Pag-klik Pagrehistro sa Bag-ong Aplikasyon. Ang Irehistro ang Imong Aplikasyon porma makita:
a. Sa rehistro sa Imong aplikasyon nga porma, pagsulud a Ngalan ug a Deskripsyon alang sa imong aplikasyon. Ang Ngalan mao ang ngalan nga gipakita sa screen sa pagtugot kung ang mga tiggamit miuyon nga ipaambit ang kasayuran sa imong aplikasyon. Kini nga ngalan magamit sa Android, iOS, ug webmga bersyon sa site sa imong aplikasyon.
Ang Deskripsyon makatabang kanimo nga mailhan ang matag usa sa imong Pag-login sa mga aplikasyon sa Amazon ug wala ipakita sa mga ninggamit.
b. Pagsulod a Pahibalo sa Pagkapribado URL alang sa imong aplikasyon.
Ang Pahibalo sa Pagkapribado URL ang lokasyon sa patakaran sa pagkapribado sa imong kompanya o aplikasyon (alang sa pananglitanample, http://www.example.com/privacy.html). Ang kini nga link gipakita sa mga ninggamit sa screen sa pagtugot.
c. Kung gusto nimong idugang ang usa ka Hulagway sa Logo para sa imong aplikasyon, i-klik Pilia File ug pangitaa ang angay nga imahe.
Ang kini nga logo gipakita sa pag-sign-in ug pagtugot nga screen aron representahan ang imong negosyo o website.
Ang logo maminusan hangtod sa 50 pixel ang gitas-on kung kini mas taas sa 50 nga mga pixel; wala’y limitasyon ang gilapdon sa logo. - Pag-klik Tipigi. Ang imong sampAng pagparehistro kinahanglan nga susama niini:
Human ma-save ang imong sukaranan nga mga setting sa aplikasyon, mahimo nimong idugang ang mga setting alang sa piho webmga site ug mobile app nga mogamit sa kini nga Pag-login gamit ang Amazon account.
Kung ang lainlaing mga bersyon sa imong app adunay lainlaing mga bundle ID, sama sa usa o daghang mga bersyon sa pagsulay ug usa ka bersyon sa paghimo, ang matag bersyon nanginahanglan kaugalingon nga API Key. Gikan sa Mga setting sa iOS sa imong app, i-klik ang Pagdugang API Key buton aron makahimo dugang nga mga yawi alang sa imong app (usa matag bersyon).
Idugang ang Mga setting sa iOS sa imong Paggamit
Human ma-save ang imong sukaranan nga mga setting sa aplikasyon, mahimo nimong idugang ang mga setting alang sa piho webmga site ug mobile apps nga mogamit sa Login gamit ang Amazon.
Aron magparehistro sa usa ka iOS App, kinahanglan nimo nga ipiho ang nagpaila sa Bundle alang sa proyekto sa app. Ang pag-login gamit ang Amazon mogamit sa bundle ID aron makahimo usa ka yawi sa API. Hatagan ang yawi sa API sa imong app og access sa Login nga adunay serbisyo sa pagtugot sa Amazon. Sunda ang kini nga mga lakang aron makadugang usa ka iOS app sa imong account:
- Gikan sa Aplikasyon screen, pag-klik Mga setting sa iOS. Kung adunay ka na rehistrado nga iOS app, pangitaa ang Pagdugang API Key buton sa Mga Setting sa iOS seksyon.
Ang Mga Detalye sa Pag-apply sa iOS porma makita:
- Pagsulod sa Label sa imong iOS App.
Dili kinahanglan nga kini ang opisyal nga ngalan sa imong app. Kini yano nga nagpaila niining partikular nga iOS app taliwala sa mga app ug webmga site nga narehistro sa imong Pag-login nga adunay aplikasyon sa Amazon. - Pagsulod sa imong Bundle ID. Kinahanglan nga parehas kini sa nagpaila sa bundle sa imong proyekto sa iOS. Aron mahibal-an ang imong tag-ila sa bundle, ablihi ang proyekto sa Xcode. Ablihi ang lista sa mga kabtangan alang sa proyekto (-Info.plist) sa Project Navigator. Ang Nagpaila sa bundle mao ang usa sa mga kabtangan sa lista.
- Pag-klik Tipigi.
Kung ang lainlaing mga bersyon sa imong app adunay lainlaing mga bundle ID, sama sa usa o daghang mga bersyon sa pagsulay ug usa ka bersyon sa paghimo, ang matag bersyon nanginahanglan kaugalingon nga API Key. Gikan sa Mga setting sa iOS sa imong app, i-klik ang Add API Key button aron makahimo dugang nga mga yawe alang sa imong app (usa matag bersyon).
iOS Bundle ID ug API Keys
Ang nagpaila sa Bundle talagsaon sa matag iOS app. Ang pag-login gamit ang Amazon naggamit sa Bundle ID aron matukod
imong API Key. Gihatag sa API Key ang Pag-login nga adunay serbisyo sa pagtugot sa Amazon aron maila ang imong app.
Pagtino sa usa ka Bundle Identifier alang sa usa ka iOS App
1. Ablihi ang imong proyekto sa app sa Xcode.
2. Ablihi ang Impormasyon nga Panag-iya Listahan alang sa proyekto (-Info.plist) sa Ang Project Navigator.
3. Pangitaa Nagpaila sa bundle sa lista sa mga kabtangan.
Kuhaa ang usa ka iOS API Key
Pagkahuman nimo pagrehistro ang usa ka bersyon sa iOS ug paghatag usa ka Bundle ID, mahimo nimo makuha ang key sa API gikan sa panid sa pagrehistro alang sa imong pag-login uban ang aplikasyon sa Amazon. Kinahanglan nimo ibutang ang yawe nga API sa lista sa kabtangan sa imong proyekto. Hangtud nga imong buhaton, dili hatagan pagtugot ang app nga makigsulti sa Pag-login nga adunay serbisyo sa pagtugot sa Amazon.
- Adto sa https://login.amazon.com.
- Pag-klik App Console.
- Diha sa Aplikasyon kahon, i-klik ang imong aplikasyon.
- Pagpangita sa imong iOS app sa ilalum sa Mga Setting sa iOS seksyon.
Kung wala ka pa nakarehistro usa ka iOS app, kitaa Idugang ang Mga setting sa iOS sa usa ka Pag-apply. - Pag-klik Paghimo API Key Value. Ipakita sa usa ka popup window ang imong API key. Aron makopya ang yawi, pag-klik Pilia ang Tanan aron mapili ang tibuuk nga yawi.
Mubo nga sulat: Ang API Key Value gibase, sa bahin, sa oras nga gihimo kini. Sa ingon niini, ang mga misunod nga (mga) Key API nga nahimo nimo mahimong lahi sa orihinal. Mahimo nimong magamit ang bisan unsa sa mga API Key Values sa imong app tungod kay silang tanan balido. - Tan-awa ang Idugang ang Imong API nga Yawi sa Imong Lista sa Panag-iya sa App alang sa mga panudlo sa pagdugang sa API key sa imong iOS app
Paghimo usa ka Pag-login uban ang Amazon Project
Niini nga seksyon, mahibal-an nimo kung unsaon paghimo usa ka bag-ong proyekto sa Xcode alang sa Pag-login gamit ang Amazon ug pag-configure ang proyekto.
Paghimo usa ka Bag-ong Pag-login sa Amazon Project
Kung wala ka pa usa ka proyekto sa app alang sa paggamit sa Pag-login gamit ang Amazon, sunda ang mga panudlo sa ubus aron makahimo usa. Kung adunay ka adunay us aka app, laktawi ang I-install ang Login sa Amazon Library seksyon sa ubos.
- Ilusad Xcode.
- Kung gipakita kanimo ang a Malipayon nga pag-abut sa Xcode dialog, pagpili Paghimo usa ka Bag-ong Project sa Xcode.
Kung dili, gikan sa File menu, pilia Bag-o ug Proyekto. - Pilia ang klase sa proyekto nga gusto nimong buhaton ug i-klik Sunod.
- Pagsulod a Ngalan sa Produkto ug a Tigpaila sa Kompanya. Hinumdomi ang imong Identifier sa Bundle, ug i-klik ang Next.
- Pagpili usa ka lokasyon diin ibutang ang imong proyekto ug i-klik Paghimo.
Adunay ka us aka bag-ong proyekto nga mahimo nimo gamiton aron matawag ang Pag-login uban ang Amazon.
I-install ang Login sa Amazon Library
Kung wala pa nimo ma-download ang Login uban ang Amazon SDK alang sa iOS, kitaa I-install ang Login gamit ang Amazon SDK alang sa iOS.
Ang usa ka proyekto sa Pag-login nga adunay Amazon kinahanglan nga mag-link sa LoginWithAmazon.framework ug Security.framework mga librarya. Kinahanglan mo usab nga i-configure ang agianan sa pagpangita sa framework aron makapangita ang Pag-login nga adunay mga header sa Amazon.
- Kung ang imong proyekto wala’y folder nga Frameworks, i-klik sa tuo ang ngalan sa proyekto sa Navigator
pane sa Xcode, dayon i-klik Bag-ong Grupo. - Nganli ang bag-ong grupo Mga Framework.
- Pilia ang Mga Framework folder ug i-klik File gikan sa Main menu.
- Pagpili Idugang Files sa Proyekto.
- Sa dayalogo, pilia LoginWithAmazon.framework ug i-klik Idugang.
Kung gigamit nimo ang Login nga adunay librarya sa Amazon 1.0, tangtanga ang pag-login-sa-amazon-sdk direktoryo ug pag-login-sa-amazon-sdk.a gikan sa folder nga Frameworks. Pag-klik sa Edit gikan sa punoan nga menu ug pilia Pagtangtang. - Pilia ang ngalan sa imong proyekto sa Project Navigator.
Ang Project Editor makita sa lugar sa editor sa workspace sa Xcode. - Pag-klik sa imong ngalan sa proyekto sa ilalum Mga target, ug pilia Paghimo Mga Bahin. Pagpalapad Pag-link sa Binary sa Mga Library ug i-klik ang plus sign aron makadugang usa ka librarya.
- Sa search box, isulud Security.framework. Pagpili Seguridad.framework ug pag-klik Idugang.
- Sa search box, isulud SafariServices.framework. Pagpili SafariServices.framework ug i-klik Idugang.
- Pilia ang Mga Setting sa Pagtukod. I-klik ang Tanan aron view tanang setting.
- Ubos sa Mga Path sa Pagpangita, siguruha nga ang LoginWithAmazon.framework ang direktoryo naa sa Mga Dalan sa Pagpangita sa Framework.
Kay example:
- Sa dili pa matukod ang imong proyekto, kung imong gigamit ang Login gamit ang Amazon 1.0 library, ilisan ang #import "AIMobileLib.h", #import "AIAuthenticationDelegate.h", ug #import "AIError.h" sa imong gigikanan files nga adunay usa ka #import
. Ang LoginWithAmazon.hline adunay kauban nga tanan nga Pag-login nga adunay mga header sa Amazon kausa.
Ingon kadugangan, mahimo nimong tangtangon ang bisan unsang mga pakisayran sa 1.0 nga agianan sa librarya sa Mga Path sa Pagpangita sa Header o Mga Path sa Pagpangita sa Library.
13. Gikan sa punoan nga menu, pag-klik produkto ug pilia Pagtukod. Ang pagtukod kinahanglan malampuson nga pagkompleto.
Idugang ang Imong API Key sa Lista sa Imong App
Kung giparehistro nimo ang imong aplikasyon sa iOS gamit ang Pag-login sa Amazon, gihatagan ka usa ka key sa API. Kini usa ka nagpaila nga gamiton sa Amazon Mobile Library aron mahibal-an ang imong aplikasyon sa Login nga adunay serbisyo sa pagtugot sa Amazon. Gikarga sa Amazon Mobile Library kini nga kantidad sa runtime gikan sa APIKey nga kantidad sa propiedad sa Impormasyon sa Lista sa Kabtangan sa Impormasyon
- Sa pagbukas sa imong proyekto, pilia ang Pagsuporta Files folder, unya pilia ang -Info.plist file (diin ang ngalan sa imong proyekto). Kini kinahanglan magbukas sa lista sa kabtangan alang sa pag-edit:
- Siguruha nga wala sa mga entry ang mapili. Pagkahuman, gikan sa punoan nga menu, i-klik ang Editor, ug Idugang Butang. Pagsulod APIKey ug press Pagsulod.
- Pag-double click sa ilalum sa Bili kolum aron makadugang usa ka kantidad. Ipapilit ang imong API Key ingon kantidad.
Idugang ang a URL Scheme sa Imong Lista sa Tag-iya sa App
Kung mag-log in ang tiggamit, ipakita kanila ang usa ka panid sa pag-login sa Amazon. Aron makadawat ang imong app kompirmasyon sa ilang pag-login, kinahanglan nimo nga idugang a URL laraw aron ang web Ang panid mahimong mag-redirect balik sa imong app. Ang URL laraw kinahanglan ipahayag ingon amzn- (alang sa example, amzncom.example.app). Alang sa dugang nga kasayuran, tan-awa Paggamit URL Mga Scheme aron Makigsulti sa Mga Apps sa developer.apple.com.
- Sa pagbukas sa imong proyekto, pilia ang Pagsuporta Files folder, unya pilia ang -Info.plist file (diin ang ngalan sa imong proyekto). Kini kinahanglan magbukas sa lista sa kabtangan alang sa pag-edit:
- Siguruha nga wala sa mga entry ang mapili. Pagkahuman, gikan sa punoan nga menu, i-klik ang Editor, ug Idugang Butang. Pagsulud o pagpili URL mga tipo ug press Pagsulod.
- Pagpalapad URL mga tipo sa pagpadayag butang 0. Pagpili butang 0 ug, gikan sa punoan nga menu, i-klik Editor ug Idugang Butang. Pagsulud o pagpili URL Identifier ug press Pagsulod.
- Pagpili aytem 0 ubos URL Identifier ug doble nga pag-klik sa ilalum sa Bili kolum aron makadugang usa ka kantidad. Ang kantidad mao ang imong bundle ID. Makita nimo ang imong bundle ID nga nakalista ingon Nagpaila sa bundle sa lista sa kabtangan.
- Pagpili butang 0 ubos URL mga tipo ug, gikan sa punoan nga menu, i-klik Editor ug Idugang Butang. Pagsulud o pagpili URL Mga laraw ug ipadayon ang Enter.
- Pagpili aytem 0 ubos URL Mga laraw ug doble nga pag-klik sa ilalum sa haligi nga Halaga aron makadugang usa ka kantidad. Ang kantidad mao ang imong bundle ID nga adunay amzn- prepended (alang sa example, amzn com.example.app). Makita nimo ang imong bundle ID nga nakalista ingon Nagpaila sa bundle sa lista sa kabtangan.
Ang pag-login gamit ang Amazon naghatag daghang mga sumbanan nga mahimo nimong magamit aron maaghat ang mga ninggamit sa pag-log in gikan sa imong app.
Ang kini nga seksyon naghatag mga lakang alang sa pag-download sa usa ka opisyal nga Pag-login nga adunay imahen sa Amazon ug gipares kini sa usa ka iOS UIButton.
- Pagdugang usa ka sukaranan UIButton sa imong app.
Alang sa mga panudlo ug kasayuran kung unsaon pagdugang usa ka buton sa usa ka app, kitaa Paghimo ug Pag-configure View Mga butang ug Sugdi ang Pagpalambo sa iOS Apps Karon sa developer.apple.com. - Idugang ang Paghikap sa Sulod panghitabo alang sa buton sa usa ka pamaagi nga ginganlan
onLoginButtonClicked. Ibutang nga blangko ang pagpatuman sa karon. Ang Paghimo ug Pag-configure View Mga butang ug Sugdi ang Pagpalambo sa iOS Apps Karon Ang mga dokumento sa developer.apple.com adunay mga lakang sa pagdugang usa ka hitabo sa buton. - Pagpili usa ka imahe sa buton.
Konsultaha ang among Login gamit ang Amazon Style Guidelines para sa listahan sa mga buton nga imong magamit sa imong app. Pag-download ug kopya sa LWA_for_iOS.zip file. Pangitaa ang imong gusto nga buton sa parehas nga 1x ug 2xdirectories ug kuhaa kini gikan sa zip. Kuhaa ang _Pressed nga bersyon sa imong buton kung gusto nimo ipakita ang buton sa usa ka Pinili nga estado. - Idugang ang mga imahe sa imong proyekto.
a. Sa Xcode, kauban ang imong proyekto nga gikarga, pag-klik File gikan sa main menu ug pilia ang Add Files sa "proyekto".
b. Sa dialog, pilia ang buton nga imahe file(mga) nga imong gi-download ug i-klik ang Add.
c. Ang mga buton kinahanglan nga naa sa proyekto sa ilalum sa direktoryo sa proyekto. Igbalhin sila sa Pagsuporta Files folder. - Idugang ang imahe sa imong buton.
Aron mapalihok ang imahe alang sa imong buton, mahimo nimong usbon ang hiyas sa buton o gamiton ang setImage: alang sa Estado pamaagi sa UIButton butang Sunda ang kini nga mga lakang aron mausab ang hiyas sa imahe alang sa imong buton:
a. Ablihi ang storyboard alang sa imong app.
b. Pilia ang butones sa imong storyboard pinaagi sa pag-klik niini o pagpili niini gikan sa View Eksena sa Controller kahoy.
c. Diha sa Mga gamit bentana, ablihi ang Mga Inspektor sa Mga Kinaiya.
d. Sa ibabaw sa Inspektor sa Kinaiya, ibutang ang Type sa buton sa Sistema.
e. Sa ikaduha nga grupo sa mga setting, pilia ang Default alang Config sa Estado.
f. Sa ikaduha nga grupo sa mga setting, ihulog ang Hulagway setting.
g. Pilia ang graphic sa Pag-login nga adunay Amazon button nga imong gidugang sa proyekto. Ayaw pilia ang bersyon nga 2x: awtomatikong kini nga ma-load sa mga lalang nga high density display (Retina).
h. Itakda ang parehas nga imahe alang sa Background setting.
i. Kung gusto nimong ipiho ang usa ka napugos nga bersyon sa buton, pilia Gipili kay Config sa Estado, ug ibutang ang Hulagway ngadto sa _Nipilit bersyon sa imong buton.
j. Sa storyboard, ayuhon ang gidak-on sa imong buton aron mapaabut ang imahe, kung kinahanglan.
Niini nga seksyon, makadugang ka code sa imong proyekto aron mag-sign in us aka gumagamit gamit ang Pag-login gamit ang Amazon.
Gamita ang SDK alang sa mga iOS API
Niini nga seksyon, makadugang ka code sa imong proyekto aron mag-sign in us aka gumagamit gamit ang Pag-login gamit ang Amazon.
Ikonektar ang Delegado sa App
Ipatuman aplikasyon: ablihanURL: mga kapilian: sa klase sa imong proyekto nga nagdumala sa UIApplicationDelegate protokol. Pinaagi sa default, kini ang AppDelegate klase. Kung ang usa ka gumagamit malampuson nga nag-log in sa imong app gamit ang Pag-login gamit ang Amazon, igahatag kini gikan sa screen sa pag-login sa Amazon balik sa imong app pinasukad sa URL Eskema nadugangan nimo ang imong App Property List kaniadto. Aron madumala kini nga pag-redirect, kinahanglan nimo ipatuman ang aplikasyon: ablihanURL: mga kapilian: pamaagi, nga nagbalik YES kung ang URL malampuson nga pagdumala.
Ang Pag-login uban ang Amazon SDK alang sa iOS naghatag usa ka pagpaandar sa librarya, kuptananURL: gigikananAplikasyon: nga nagdumala sa bisan unsang pag-redirect URL gipadala gikan sa mga panid sa Amazon. Mobalik kini Oo kung ang URL malampuson nga gidumala sa SDK. Tawgon kini nga pamaagi sa sulud sa aplikasyon: ablihanURL: mga kapilian: pamaagi.
Aron makuha ang kini nga pamaagi, kinahanglan nimo nga i-import .
| import @implementasyon AppDelegate - aplikasyon (BOOL): (UIApplication *) bukas ang aplikasyonURL: (NSURL *) url mga kapilian: (NSDictionaryURLMga kapilianKK, id> *) mga kapilian { ibalik [AMZNAuthorizationManager handleOpenURL:url sourceApplication: kapilian [UIApplicationOpenURLMga KapilianSourceApplicationKey]]; } @katapusan |
Gipasabut sa kini nga seksyon kung giunsa tawagan ang pagtugot: withHandler: API aron mag-login ang usa ka ninggamit. Kauban niini ang paghimo sa usa ka onLogin ButtonClicked: tigpaminaw alang sa imong Login nga adunay buton sa Amazon.
- Pagdugang Login uban ang Amazon sa imong proyekto sa iOS. Kitaa I-install ang Login sa Amazon Library.
- Pag-import sa Login gamit ang Amazon API sa imong gigikanan file.
Aron ma-import ang Login gamit ang Amazon API, idugang ang mosunud #pagpahayag sa imong tinubdan file:#import - Tawag pagtugot: withHandler: sa onLoginButtonClicked. Kung gisunud nimo ang mga lakang sa Pagdugang usa ka Pag-login nga adunay Button sa Amazon sa Imong App, kinahanglan adunay ka onLogin ButtonClicked: pamaagi na-link sa usa ka butnga sa Pag-login nga adunay Amazon. Sa kana nga pamaagi, pagtawag pagtugot: withHandler: aron maaghat ang mogamit sa pag-login ug pagtugot sa imong aplikasyon.
Ang kini nga pamaagi makahimo sa tiggamit nga mag-sign in ug motugot sa gihangyo nga kasayuran sa usa sa mga mosunud nga paagi:
- Mobalhin sa web view sa usa ka luwas nga konteksto (kung ang Amazon Shopping app na-install sa aparato)
- Mobalhin sa Safari View Controller (sa iOS 9 ug sa ulahi)
- Pagbalhin sa browser sa sistema (sa iOS 8 ug mas sayo pa)
Ang luwas nga konteksto alang sa una nga kapilian magamit kung ang Amazon Shopping app na-install sa aparato. Kung ang gumagamit naka-sign in na sa Amazon Shopping app, laktawan sa kini nga API ang panid sa pag-sign in, nga mosangpot sa usa ka Single Pag-sign-On (SSO) kasinatian. Tan-awa ang mga kasinatian sa kostumer sa mga ios [PDF] aron mahibal-an ang dugang pa.
Ang una nga parameter sa pagtugot: withHandler: mao ang usa ka AMZNAuthorizeRequest butang nga nagpaila kung unsang sakup ang gihangyo sa imong aplikasyon nga pagtugot. A kasangkaran naglangkob sa datos sa mogamit nga imong gihangyo gikan sa Pag-login gamit ang Amazon. Sa unang higayon nga mag-log in ang usa ka mogamit sa imong app, ipakita sa ila ang lista sa datos nga imong gihangyo ug gihangyo nga aprubahan.
Ang pag-login uban ang Amazon karon nagsuporta sa mga mosunud nga lakang:Ngalan sa sakup Deskripsyon profile Naghatag access sa ngalan sa gumagamit, email address, ug Amazon account ID. profile: user_id Naghatag access sa Amazon account ID ra sa naggamit. postal_code Naghatag access sa zip / postal code sa gumagamit sa file alang sa ilang Amazon account. Gamita ang mga pamaagi nga gihubit sa AMZNProfileKasangkaran aron makakuha usa ka butang sa sakup ug idugang kini sa imong AMZNAuthorizeRequest butang. Tan-awa ang sample code sa ubos para sa mga detalye.
Ang ikaduha nga parameter nga hatagan pagtugot: withHandler: mao ang AMZNAuthorizationRequestHandler, nga gihulagway sa sunod nga lakang. - Paghimo og AMZNAuthorizationRequestHandler babag nga butang. AMZNAuthorizationRequestHandler giproseso ang sangputanan sa pagtugot: withHandler: tawag. Aron mahibal-an pa ang bahin sa mga block-sa katuyoan-c, kitaa Pagtrabaho uban ang mga Bloke sa developer.apple.com.
Ang una nga parameter sa AMZNAuthorizationRequestHandler mao ang usa ka AMZNAuthorizeResult butang Pagkahuman nga malampuson nga gitugutan ang usa ka gumagamit, AMZNAuthorizeResult maglangkob ug access token nga magamit sa pag-access sa pro sa usa ka userfile data, ug AMZNUser butang, nga naglangkob sa pro sa userfile data.Ang ikaduhang parametro sa AMZNAuthorizationRequestHandler gitawag ang usa ka Boolean tiggamitDidcancel. Kini nga parameter igatakda sa tinuod kung ang mogamit:
1. Gisira ang Safari View Controller sa panahon sa pag-login ug pagtugot (sa iOS 9 ug sa ulahi)
2. Nagsira sa web view sa Amazon Shopping app
3. Nakansela ang pag-login o gisalikway ang pagtugot
Ang ikatulo nga parameter sa AMZNAuthorizationRequestHandler mao ang usa ka NSError butang nga adunay sulud nga mga detalye sa sayup kung ang pag-login ug pagtugot napakyas tungod sa SDK o server sa pagtugot.- (IBAction) onLogInButtonClicked: (id) nagpadala {
// Paghimo usa ka hangyo sa pagtugot.
AMZNAuthorizeRequest * hangyo = [[AMZNAuthorizeRequest gigahin] init];
request.scope = [NSArray arrayWithObjects:
// [AMZNProfileSakop userID],
[AMZNProfileSakop profile],
[AMZNProfileScope postalCode]];// Paghimo ug Authorize nga tawag sa Login gamit ang Amazon SDK.
[[AMZNAuthorizationManager sharedManager] pagtugot: hangyo
withHandler: ^ (resulta sa AMZNAuthorizeResult *, BOOL
userDidCancel, NSError * sayup) {
kung (sayup) {
// Pagdumala mga sayup gikan sa SDK o server sa pagtugot.
} uban pa kung (userDidCancel) {
// Mga sayup nga pagdumala hinungdan sa pagkansela sa pag-login sa gumagamit.
} uban pa {
// Ang pagpanghimatuud malampuson.
// Pagkuha sa access token ug user profile datos.
NSString * accessToken = result.token;
AMZNUser * user = resulta.user;
NSString * userID = user.userID;
}
}];
}
Kuhaa ang Pro nga Gigamitfile Data
Hangtud nga ang usa ka user naka-log in ug gitugutan sa imong app, mahimo nimong makuha ang ilang user profile data sa bisan unsang oras.
Kini nga seksyon nagpatin-aw kung giunsa gamiton ang kuhaa: pamaagi sa AMZNUser klase aron makuha ang pinakabag-o nga user profile datos alang sa mga tiggamit nga gitugutan karon. Ang profile ang datos nga mahimo nimo makuha mao ang gibase sa nasakup nga kasangkaran sa pagtugot tawag.
- Tawag AMZNUser kuha:.
Kini nga pamaagi makakuha og profile datos pinaagi sa AMZNUserFetchRequestHandler babag nga butang. Ang una nga parameter sa AMZNUserRequestHandler mao ang usa ka AMZNUser butang. Ang AMZNUser butang mahimong mag-uban a userID, ngalan, email, ug postalCode, depende sa gihangyo nga kasangkaran.[AMZNUser fetch: ^ (AMZNUser * user, NSError * error) {
kung (sayup) {
// Error gikan sa SDK, o wala’y tiggamit nga gitugutan sa app.
} uban pa kung (tiggamit) {
NSString * userID = user.userID;
// NSString * ngalan = user.name;
// NSString * email = user.email;
// NSString * postalCode = user.postalCode;
}
}];
Susihon ang Pag-login sa Gumagamit sa Pagsugod
Kung ang usa ka gumagamit mag-log sa imong app, isira ang app, ug i-restart ang app sa ulahi, ang app gitugutan pa nga makuha ang datos. Ang mogamit dili awtomatikong gi-log out. Sa pagsugod, mahimo nimo ipakita ang gumagamit ingon naka-log in kung gitugot pa ang imong app. Gipasabut sa kini nga seksyon kung unsaon paggamit pagtugot: withHandler: aron makita kung gitugot pa ang app.
- Paghimo og AMZNAuthorizeRequest pagtutol ug paghingalan sa mga sakup nga gipakita ang datos sa mogamit sa imong aplikasyon nga gihangyo pagtugot. Alang sa dugang nga kasayuran sa mga sakup, tan-awa Pagdumala sa Butang sa Pag-login ug Pagkuha og Profile Data.
- Gitakda AMZNAuthorizeRequest.interactive nga Strategy sa AMZNInteractive StrategyNever. AMZNAuthorizeRequest nagsuporta sa daghang mga estratehiya alang sa pag-aghat sa pag-login sa gumagamit:
- AMZNInteractive StrategyAuto (default): Ang SDK nangita alang sa usa ka lokal nga gitipig nga pagtugot sa pagtugot gikan sa miaging pagtugot: withHandler: mga tubag. Kung adunay usa nga magamit, balido, ug adunay sulud nga tanan nga gihangyo nga mga lakang, ibalik sa SDK ang usa ka malampuson nga tubag pinaagi AMZNAuthorizationRequestHandler, ug dili mag-aghat sa gumagamit nga mag-login. Kung dili man, ang mag-aghat mag-login.
- AMZNInteractive Strategy Kanunay: Kanunay nga aghaton sa SDK ang gumagamit sa pag-login dili igsapayan kung gitugot ba sila kaniadto nga gamiton ang app. Kung giaghat ang gumagamit, kuhaon sa SDK ang tanan nga mga lokal nga gihatag nga pagtugot sa cache alang sa app.
- AMZNInteractive StrategyNever: Ang SDK nangita alang sa usa ka lokal nga gitipig nga paghatag sa pagtugot gikan sa miaging pagtugot: withHandler mga tubag. Kung adunay usa nga magamit, balido, ug adunay sulud nga tanan nga gihangyo nga mga lakang, ibalik sa SDK ang usa AMZNAuthorizeResult butang nga adunay sulod nga access token ug user profile datos.
Kung dili, ibalik kini an NSError butang pinaagi sa AMZNAuthorizationRequestHandler.// Paghimo usa ka hangyo sa pagtugot.
AMZNAuthorizeRequest * hangyo = [[AMZNAuthorizeRequest gigahin] init];
request.scope = [NSArray arrayWithObjects:
// [AMZNProfileSakop userID],
[AMZNProfileSakop profile],
[AMZNProfileSakop postalCode]];request.interactiveStrategy = AMZNInteractiveStrategyNever;[[AMZNAuthorizationManager sharedManager] pagtugot:hangyo
withHandler: ^ (resulta sa AMZNAuthorizeResult *, BOOL
userDidCancel, NSError * sayup) {
kung (sayup) {
// Error gikan sa SDK, gipakita nga ang gigamit dili kaniadto
otorisado sa imong app alang sa gihangyo nga mga lakang.
} uban pa {
// Ang tiggamit gihatagan daan pagtugot sa imong app.
// Pagkuha sa access token ug user profile datos.
NSString * accessToken = result.token;
AMZNUser * user = resulta.user;
NSString * userID = user.userID;
}
}];
Kini nga seksyon nagpatin-aw kung giunsa gamiton ang pag-signout pamaagi aron malimpyohan ang datos sa pagtugot sa ninggamit gikan sa pareho nga AIMobileLib lokal nga tindahan sa datos, ug ang server sa pagtugot. Ang user kinahanglan nga mag-login pag-usab aron makuha sa app ang profile datos Gamita kini nga pamaagi aron mag-log out ang usa ka ninggamit, o aron masulbad ang mga problema sa pag-login sa app.
- Pagpatuman usa ka mekanismo sa pag-logout.
Kung ang usa ka gumagamit malampuson nga naka-log in, kinahanglan ka maghatag usa ka mekanismo sa pag-logout aron malimpyohan nila ang ilang profile datos ug kaniadto gitugutan nga mga sakup. Ang imong mekanismo mahimong usa ka hyperlink, buton, o butang sa menu. - Tawag pag-signout:.
Tawag pag-signout: sa imong logout handler aron tangtangon ang data sa pagtugot sa usa ka user (access tokens, profile) gikan sa lokal nga tindahan, ug ang ilang estado sa pag-authenticate gikan sa server. Ang input parameter sa pag-signout mao ang usa ka AMZNAuthorizationRequestHandler babag nga butang. Kinahanglan nga makit-an ug makontrol sa bloke NSError mga butang, nga gibalik kung kanus-a pag-signout: napakyas.[[AMZNAuthorizationManager sharedManager] signOut: ^ (NSError * _Nableable
sayup) {
kung (! sayup) {
// error gikan sa SDK o Login nga adunay server sa pagtugot sa Amazon.
}
}];
Sulayi ang imong Paghiusa
Ilunsad ang imong app sa usa ka iOS device o simulator ug kumpirmahi nga mahimo ka mag-log in gamit ang imong mga kredensyal sa Amazon.com.
Mubo nga sulat: Kung gisulayan ang mga simulator sa iOS10, mahimo nimo makita ang mensahe nga sayup Ang APIKey alang sa Aplikasyon dili wasto alang sa usa ka authorizeUserForScope hangyo, o Wala mailhi nga Error Code alang sa a tin-awAuthorizationState hangyo Kini usa ka nahibal-an nga bug sa Apple nga mahitabo kung ang SDK mosulay sa pag-access sa keychain. Hangtod nga wala masulbad sa Apple ang bug, mahimo nimo kini nga buhaton pinaagi sa pagpaandar Pagpakigbahin sa Keychain alang sa imong app sa ilalum sa Mga katakus tab sa target sa imong app. Ang kini nga bug nakaapekto lang sa mga simulator. Mahimo nimong sulayan ang tinuud nga mga iOS10 nga aparato nga wala mogamit bisan unsang solusyon.
Pag-login gamit ang Panudlo sa Pagsugod sa Amazon alang sa mga iOS app - Pag-download [na-optimize]
Pag-login gamit ang Panudlo sa Pagsugod sa Amazon alang sa mga iOS app - Pag-download
