Ingia na Mwongozo wa Kuanza kwa Amazon kwa iOS

 

Ingia na Amazon: Mwongozo wa Kuanza kwa iOS

Hakimiliki © 2016 Amazon.com, Inc., au washirika wake. Haki zote zimehifadhiwa.
Amazon na nembo ya Amazon ni alama za biashara za Amazon.com, Inc au washirika wake. Alama zingine zote za biashara ambazo hazimilikiwi na Amazon ni mali ya wamiliki wao.

Kuanza kwa iOS

Katika mwongozo huu tutakuonyesha jinsi ya kuongeza Kuingia na Amazon kwenye programu yako ya iOS. Baada ya kumaliza mwongozo huu unapaswa kuwa na Ingia ya kufanya kazi na kitufe cha Amazon katika programu yako ili kuruhusu watumiaji kuingia na sifa zao za Amazon

Inasakinisha Xcode

Kuingia na Amazon SDK ya iOS hutolewa na Amazon kukusaidia kuongeza Kuingia na Amazon kwenye programu yako ya iOS. SDK imekusudiwa kutumiwa na mazingira ya maendeleo ya Xcode. SDK inasaidia programu zinazoendesha kwenye iOS 7.0 na baadaye kutumia ARMv7, ARMv7s, ARM64, i386, andx86_64.

Unaweza kusanikisha Xcode kutoka Duka la Programu ya Mac. Kwa habari zaidi, angalia Xcode: Nini Mpya kwenye developer.apple.com.

Baada ya Xcode kusanikishwa, unaweza Sakinisha Ingia na Amazon SDK ya iOS na Endesha SampProgramu, kama ilivyoelezwa hapo chini.

Sakinisha Ingia na Amazon SDK ya iOS

Kuingia na Amazon SDK ya iOS inakuja katika vifurushi viwili. Ya kwanza ina maktaba ya iOS na nyaraka zinazounga mkono. Ya pili ina kamaampmaombi ambayo inaruhusu mtumiaji kuingia na view pro yaofile data.

Ikiwa bado haujasakinisha Xcode, angalia maagizo katika Weka Xcode sehemu ya juu.

1. Pakua IngiaWithAmazonSDKForiOS.zip na dondoo ya files kwa saraka kwenye gari yako ngumu.
   Unapaswa kuona a KuingiaWithAmazon.framework saraka. Hii ina Ingia na maktaba ya Amazon.
   Katika kiwango cha juu cha zip ni a KuingiaWithAmazon.doc weka saraka. Hii ina nyaraka za API.
2. Tazama Sakinisha Ingia na Maktaba ya Amazon kwa maagizo ya jinsi ya kuongeza maktaba kwenye mradi wa iOS.

Wakati Kuingia na Amazon SDK ya iOS imewekwa, unaweza Unda Kuingia Mpya na Mradi wa Amazon baada ya Kusajili na Ingia na Amazon.

Endesha SampProgramu

Kuendesha sample maombi, fungua sample katika Xcode.

1. Pakua SampleLoginWithAmazonAppForiOS.zip na nakala ya
   SampleLoginWithAmazonAppForiOS saraka kwa folda yako ya Nyaraka.
2. Anza Xcode. Ikiwa mazungumzo ya Karibu kwenye Xcode yataibuka, bonyeza Fungua Nyingine. Vinginevyo, kutoka kwenye menyu kuu, bonyeza File na uchague Fungua.
3. Chagua folda ya Nyaraka, na uchague
   SampleLoginWithAmazonAppForiOS / LoginWithAmazonSample / LoginWithAmazonSamplexxodeproj. Bofya Fungua.
4. Sample inapaswa sasa kupakia. Inapomalizika, chagua Bidhaa kutoka kwenye menyu kuu na uchague Kimbia

Kusajili na Ingia na Amazon

Kabla ya kutumia Ingia na Amazon kwenye a webtovuti au katika programu ya simu, lazima usajili programu na Ingia na Amazon. Kuingia kwako na programu ya Amazon ni usajili ambao una taarifa za msingi kuhusu biashara yako, na taarifa kuhusu kila moja webtovuti au programu ya simu unayounda inayoauni Ingia ukitumia Amazon. Maelezo haya ya biashara yanaonyeshwa kwa watumiaji kila wakati wanapotumia Ingia na Amazon kwenye yako webtovuti au programu ya simu. Watumiaji wataona jina la programu yako, nembo yako, na kiunga cha sera yako ya faragha. Hatua hizi zinaonyesha jinsi ya kusajili Ingia na matumizi ya Amazon na kuongeza programu ya iOS kwenye akaunti hiyo.

Tazama mada zifuatazo

• Sajili Kuingia kwako na Maombi ya Amazon
• Ongeza Programu ya iOS kwenye Programu ya Usalamafile
• Kitambulisho cha kifungu cha iOS na Funguo za API
  o Tambua Kitambulisho cha Kifungu cha Programu ya iOS
  o Pata Ufunguo wa API ya iOS

Sajili Kuingia kwako na Maombi ya Amazon

1. Nenda kwa https://login.amazon.com.
2. Ikiwa umejiandikisha kwa Ingia na Amazon hapo awali, bonyeza Dashibodi ya Programu. Vinginevyo, bofya Jisajili.
   Utaelekezwa kwa muuzaji wa Kati, ambayo inashughulikia usajili wa maombi ya Kuingia na Amazon. Ikiwa hii ni mara yako ya kwanza kutumia Central Seller, utaulizwa kusanidi akaunti kuu ya muuzaji.
3. Bofya Sajili Programu Mpya. The Sajili Maombi Yako fomu itaonekana:
   
   a. Katika Sajili Fomu yako ya Maombi, ingiza Jina na a Maelezo kwa maombi yako.
   The Jina ni jina linaloonyeshwa kwenye skrini ya idhini watumiaji wanapokubali kushiriki maelezo na programu yako. Jina hili linatumika kwa Android, iOS, na webmatoleo ya tovuti ya programu yako.
   b. Ingiza Ilani ya Faragha URL kwa maombi yako.
   Ilani ya Faragha URL ni eneo la sera ya faragha ya kampuni yako au programu (kwa example, http: //www.example.com/privacy.html). Kiungo hiki kinaonyeshwa kwa watumiaji kwenye skrini ya idhini.
   c. Ikiwa unataka kuongeza a Picha ya Nembo kwa maombi yako, bofya Vinjari na utafute picha inayotumika.
   Nembo hii inaonyeshwa kwenye skrini ya kuingia na idhini ili kuwakilisha biashara yako au webtovuti. Nembo hiyo itapungua hadi saizi 50 kwa urefu ikiwa ni ndefu kuliko saizi 50; hakuna kikomo juu ya upana wa nembo.
4. Bofya Hifadhi. S yakoampusajili wa le unapaswa kuonekana sawa na hii:
   Baada ya mipangilio yako ya msingi ya programu kuhifadhiwa, unaweza kuongeza mipangilio maalum webtovuti na programu za rununu ambazo zitatumia Ingia hii na akaunti ya Amazon.
   

Ikiwa matoleo tofauti ya programu yako yana vitambulisho tofauti vya kifungu, kama vile toleo moja au zaidi ya majaribio na toleo la uzalishaji, kila toleo linahitaji Ufunguo wake wa API. Kutoka Mipangilio ya iOS ya programu yako, bonyeza Ongeza Ufunguo wa API kifungo kuunda vitufe vya ziada kwa programu yako (moja kwa toleo).

Ongeza Programu ya iOS kwenye Programu ya Usalamafile

Baada ya mipangilio yako ya msingi ya programu kuhifadhiwa, unaweza kuongeza mipangilio maalum webtovuti na programu za rununu ambazo zitatumia Ingia hii na akaunti ya Amazon.

Ili kusajili Programu ya iOS, lazima uainishe kitambulisho cha kifungu cha mradi wa programu. Kuingia na Amazon itatumia kitambulisho cha kifungu kutengeneza kitufe cha API. Kitufe cha API kitakupa programu yako ufikiaji wa Ingia na huduma ya idhini ya Amazon. Fuata hatua hizi ili kuongeza programu ya iOS kwenye akaunti yako:

1. Kutoka kwa skrini ya Maombi, bofya Mipangilio ya iOS. Ikiwa tayari unayo programu ya iOS iliyosajiliwa, tafuta Ongeza Ufunguo wa API kifungo katika Mipangilio ya iOS sehemu.
   The Matumizi ya iOS Fomu ya maelezo itaonekana:
   
2. Ingiza Lebo ya App yako ya iOS. Hili lazima liwe jina rasmi la programu yako. Inabainisha tu programu hii ya iOS kati ya programu na webtovuti zilizosajiliwa kwa Ingia yako na matumizi ya Amazon.
3. Ingiza yako Kitambulisho cha Mfuko. Hii lazima ilingane na kitambulisho cha kifungu cha mradi wako wa iOS. Kuamua kitambulisho chako cha kifungu, fungua mradi katika Xcode. Fungua orodha ya mali ya mradi ( -Info.plist) katika faili ya Navigator ya Mradi. Kitambulisho cha kifungu ni moja wapo ya mali katika orodha.
4. Bofya Hifadhi.

Kitambulisho cha kifungu cha iOS na Funguo za API

Kitambulisho cha Kifungu ni cha kipekee kwa kila programu ya iOS. Kuingia na Amazon hutumia Kitambulisho cha kifungu kuunda Ufunguo wako wa API. Ufunguo wa API huwezesha Kuingia na huduma ya idhini ya Amazon kutambua programu yako.

Tambua Kitambulisho cha Kifungu cha Programu ya iOS

1. Fungua mradi wako wa programu katika Xcode.
2. Fungua Orodha ya Mali ya Habari kwa mradi huo ( -Info.plist) katika Navigator ya Mradi.
3. Tafuta Kitambulisho cha kifungu katika orodha ya mali.

Rejesha Kitufe cha API cha iOS

Baada ya kusajili toleo la iOS na kutoa Kitambulisho cha kifungu, unaweza kupata kitufe cha API kutoka kwa ukurasa wa usajili wa Ingia yako na programu ya Amazon. Utahitaji kuweka ufunguo huo wa API kwenye orodha ya mali ya mradi wako. Hadi utakapofanya, programu haitaidhinishwa kuwasiliana na Ingia na huduma ya idhini ya Amazon.

1. Nenda kwa https://login.amazon.com.
2. Bofya Dashibodi ya Programu.
3. Katika Programu sanduku, bonyeza programu yako.
4. Pata programu yako ya iOS chini ya Mipangilio ya iOS sehemu. Ikiwa bado haujasajili programu ya iOS, angalia Ongeza Programu ya iOS kwenye Programu ya Usalamafile.
5. Bofya Tengeneza Thamani muhimu ya API. Dirisha ibukizi litaonyesha ufunguo wako wa API. Ili kunakili ufunguo, bonyeza Chagua Zote kuchagua kitufe chote.
Kumbuka: Thamani ya Ufunguo wa API inategemea, kwa sehemu, kwa wakati inazalishwa. Kwa hivyo, Thamani muhimu za API unazotengeneza zinaweza kutofautiana na asili. Unaweza kutumia yoyote ya Thamani Muhimu za API katika programu yako kwa kuwa zote ni halali.
6. Tazama Ongeza Ufunguo wako wa API kwenye Orodha yako ya Mali ya Programu kwa maagizo juu ya kuongeza kitufe cha API kwenye programu yako ya iOS

Kuunda Kuingia na Mradi wa Amazon

Katika sehemu hii, utajifunza jinsi ya kuunda mradi mpya wa Xcode wa Kuingia na Amazon na usanidi mradi huo.

Tazama mada zifuatazo:

• Unda Kuingia Mpya na Mradi wa Amazon
• Sakinisha Ingia na Maktaba ya Amazon
• Ongeza Ufunguo wako wa API kwenye Orodha yako ya Mali ya Programu
• Ongeza a URL Mpango kwa Orodha yako ya Mali ya Programu
• Ongeza Msamaha wa Usalama wa Usafirishaji wa App kwa Amazon kwenye App Yako Orodha ya Mali
  KUMBUKA: Hatua hii mpya kwa sasa inahitajika wakati wa kuendeleza kwenye iOS 9 SDK
• Ongeza Ingia na Kitufe cha Amazon kwenye Programu Yako

Unda Kuingia Mpya na Mradi wa Amazon

Ikiwa bado hauna mradi wa programu ya kutumia Ingia na Amazon, fuata maagizo hapa chini kuunda moja. Ikiwa una programu iliyopo, ruka kwenye Sakinisha Ingia na sehemu ya Maktaba ya Amazon hapa chini.

1. Uzinduzi Xcode.
2. Ikiwa umewasilishwa na Karibu kwenye Xcode dialog, chagua Unda Mradi Mpya wa Xcode.
   Vinginevyo, kutoka kwa File menyu, chagua Mpya na Mradi.
3. Chagua aina ya mradi unayotaka kuunda na ubofye Inayofuata.
4. Ingiza a Jina la Bidhaa na a Kitambulisho cha Kampuni. Kumbuka yako Kitambulisho cha Bundle, na ubofye Inayofuata.
5. Chagua mahali pa kuhifadhi mradi wako na ubofye Unda.
   Sasa utakuwa na mradi mpya ambao unaweza kutumia kupiga simu Ingia na Amazon.

Sakinisha Ingia na Maktaba ya Amazon

Ikiwa bado haujapakua Ingia na Amazon SDK ya iOS, angalia Sakinisha Ingia na Amazon SDK ya iOS.

Kuingia na mradi wa Amazon lazima kuunganishe KuingiaWithAmazon.framework na Usalama kazi maktaba. Utahitaji pia kusanidi njia ya utaftaji wa mfumo ili kupata Ingia na vichwa vya Amazon

1. Mradi wako ukiwa wazi katika Xcode, chagua Mifumo folda, bonyeza File kutoka kwenye menyu kuu, kisha uchague Ongeza Files kwa "Mradi".
2. Katika mazungumzo, chagua KuingiaWithAmazon.framework na bonyeza Ongeza.
   Ikiwa ulitumia Ingia na maktaba ya Amazon 1.0, futa saraka ya kuingia-na-amazon sdk na uingie-na-amazon-sdk.a kutoka kwa folda ya Mfumo. Bonyeza Hariri kutoka kwenye menyu kuu na uchague Futa.
3. Chagua jina la mradi wako katika Navigator ya Mradi.
   The Mhariri wa Mradi itaonekana katika eneo la mhariri wa eneo la kazi la Xcode.
4. Bonyeza jina la mradi wako chini Malengo, na uchague Jenga Awamu. Panua Kiunga Cha Kibinadamu na Maktaba na bonyeza alama ya kuongeza kuongeza maktaba.
5. Katika sanduku la utaftaji, ingiza Usalama kazi. Chagua Usalama kazi ya simu na bonyeza Ongeza.
6. Katika sanduku la utaftaji, ingiza Mfumo wa Huduma za Safari. Chagua Mfumo wa Huduma za Safari na bonyeza Ongeza.
7. Katika sanduku la utaftaji, ingiza CoreGraphics. Kazi ya simulizi. Chagua CoreGraphics. Kazi ya simulizi na bonyeza Ongeza
8. Chagua Jenga Mipangilio. Bonyeza Wote kwa view mipangilio yote.
9. Chini ya Tafuta Njia, kuhakikisha kuwa KuingiaWithAmazon.framework saraka iko katika Mfumo Njia za Kutafuta.
   Kwa mfanoample:
   
   Ikiwa ulitumia Ingia na maktaba ya Amazon 1.0, unaweza kuondoa marejeleo yoyote kwenye njia ya maktaba ya 1.0 kwenye Njia za Kutafuta Kichwa or Njia za Kutafuta Maktaba.
10. Kutoka kwa menyu kuu, bofya Bidhaa na uchague Jenga. Ujenzi unapaswa kukamilika kwa mafanikio.
    Kabla ya kujenga mradi wako, ikiwa ulitumia Ingia na maktaba ya Amazon 1.0, badilisha #port "AIMobileLib.h", #port "AIAuthenticationDelegate.h", or #kuagiza "AIError.h" katika chanzo chako files na #kuagiza
    .
    KuingiaNaAmazon.h inajumuisha Ingia yote na vichwa vya Amazon mara moja.

Ongeza Ufunguo wako wa API kwenye Orodha yako ya Mali ya Programu

Unaposajili programu yako ya iOS na Ingia na Amazon, umepewa kitufe cha API. Hiki ni kitambulisho ambacho Maktaba ya rununu ya Amazon itatumia kutambua programu yako kwenye Ingia na huduma ya idhini ya Amazon. Maktaba ya Simu ya Mkononi ya Amazon hupakia dhamana hii wakati wa kukimbia kutoka kwa Thamani ya Mali muhimu ya API katika Orodha ya Mali ya Habari ya programu yako.

1. Mradi wako ukiwa wazi, chagua Kuunga mkono Files folda, kisha chagua -Info.plist file (wapi jina la mradi wako). Hii inapaswa kufungua orodha ya mali kwa kuhariri:
   
2. Hakikisha kuwa hakuna maandishi yoyote yaliyochaguliwa. Kisha, kutoka kwenye menyu kuu, bonyeza Mhariri, na Ongeza Bidhaa. Ingiza APIKey na vyombo vya habari Ingiza.
3. Bonyeza mara mbili chini ya Thamani safu kuongeza thamani. Bandika Ufunguo wako wa API kama thamani.

Ongeza a URL Mpango kwa Orodha yako ya Mali ya Programu

Mtumiaji anapoingia, atawasilishwa na ukurasa wa kuingia wa Amazon. Ili programu yako ipokee uthibitisho wa kuingia kwao, lazima uongeze faili ya URL mpango ili web ukurasa unaweza kuelekeza tena kwenye programu yako. The URL mpango lazima utangazwe kama amzn- (kwa mfanoample, amzncom.exampprogramu). Kwa habari zaidi, angalia Kutumia URL Mipango ya Kuwasiliana na Programu kwenye developer.apple.com.

1. Mradi wako ukiwa wazi, chagua Kuunga mkono Files folda, kisha chagua -Info.plist file (wapi jina la mradi wako). Hii inapaswa kufungua orodha ya mali kwa kuhariri:
   
2. Hakikisha kuwa hakuna maandishi yoyote yaliyochaguliwa. Kisha, kutoka kwenye menyu kuu, bonyeza Mhariri, na Ongeza Bidhaa. Ingiza au chagua URL aina na vyombo vya habari Ingiza.
3. Panua URL aina kufichua Kipengee 0. Chagua Kipengee 0 na, kutoka kwenye menyu kuu, bonyeza Mhariri na Ongeza Bidhaa. Ingiza au chagua URL Kitambulisho na bonyeza Ingiza.
4. Chagua Sehemu ya 0 chini URL Kitambulisho na bonyeza mara mbili chini ya Thamani safu kuongeza thamani. Thamani ni kitambulisho chako cha kifungu. Unaweza kupata kitambulisho chako cha kifungu kilichoorodheshwa kama kitambulisho cha kifungu katika orodha ya mali.
5. Chagua Sehemu ya 0 chini URL aina na, kutoka kwenye menyu kuu, bonyeza Mhariri na Ongeza Bidhaa. Ingiza au chagua URL Mipango na bonyeza Enter.
6. Chagua Sehemu ya 0 chini URL Mipango na bonyeza mara mbili chini ya Thamani safu ya kuongeza thamani. Thamani ni kitambulisho chako cha kifurushi amzn- imetangazwa (kwa example, amzn com.exampprogramu.). Unaweza kupata kitambulisho chako cha kifungu kilichoorodheshwa kama Kitambulisho cha kifungu katika orodha ya mali.

Ongeza Msamaha wa Usalama wa Usafirishaji wa App kwa Amazon kwenye App Yako
Orodha ya Mali

Kuanzia na iOS 9, Apple inalinda Usalama wa Usafirishaji wa App (ATS) kwa unganisho salama kati ya programu na web huduma. Sehemu ya mwisho (api.amazon.com) Kuingia na Amazon SDK inaingiliana na kubadilishana habari hailingani na ATS bado. Ongeza ubaguzi kwa api.amazon.com kuwezesha mawasiliano bila mshono kati ya SDK na seva ya Amazon.

1. Mradi wako ukiwa wazi, chagua Kuunga mkono Files folda, kisha chagua -Info.plist file (wapi jina la mradi wako). Hii inapaswa kufungua utabiri wa orodha ya mali:
   
2. Hakikisha kuwa hakuna kiingilio chochote Kisha, kutoka kwenye menyu kuu, bonyeza Mhariri, na Ongeza Kipengee. Ingiza au chagua Usafirishaji wa NSAppTransportSecurity na vyombo vya habari Ingiza.
3. Panua Usafirishaji wa NSAppTransportSecurity na, kutoka kwenye menyu kuu, bonyeza Mhariri na Ongeza Kipengee. Ingiza au chagua NSExceptionDomains na vyombo vya habari Ingiza.
4. Panua NSExceptionDomains na, kutoka kwenye menyu kuu, bonyeza Mhariri na Ongeza Kipengee. Ingiza amazon.com na bonyeza Ingiza.
5. Panua amazon.com na, kutoka kwenye menyu kuu, bonyeza Mhariri na Ongeza KipengeeIngiza NSExceptionInahitaji MbeleSecrecy na vyombo vya habari Ingiza.
6. Chagua NSExceptionInahitaji MbeleSecrecy na bonyeza mara mbili chini ya Thamani safu ya kuongeza Chagua Aina of Boolean na a Thamani of HAPANA.

Ongeza Ingia na Kitufe cha Amazon kwenye Programu Yako

Kuingia na Amazon hutoa vifungo kadhaa vya kawaida unavyoweza kutumia kushawishi watumiaji kuingia kutoka kwa programu yako. Sehemu hii inatoa hatua za kupakua Ingia rasmi na picha ya Amazon na kuiunganisha na iOS UIButton.

1. Ongeza UIButton ya kawaida kwenye programu yako.
   Kwa mafunzo na habari juu ya jinsi ya kuongeza kitufe kwenye programu, angalia Kuunda na kusanidi View Vitu na Anza Kutengeneza Programu za iOS Leo kwenye developer.apple.com.
2. Ongeza Gusa Juu Ndani tukio la kifungo kwa njia iliyoitwa onLoginButtonBonyeza. Acha utekelezaji wazi kwa sasa. The Kuunda na Inasanidi View Vitu na Anza Kutengeneza Programu za iOS Leo hati kwenye apple.com ni pamoja na hatua za kuongeza hafla ya kitufe.
3. Chagua picha ya kitufe.
   Wasiliana na Ingia yetu na Amazon Miongozo ya Mtindo kwa orodha ya vifungo ambavyo unaweza kutumia katika programu yako. Pakua nakala ya LWA_for_iOS.zip file. Pata kitufe unachopendelea katika saraka zote za 1x na 2x na uziondoe kwenye zip. Toa toleo la _Bonyeza kitufe chako ikiwa unataka kuonyesha kitufe katika hali Iliyochaguliwa.
4. Ongeza picha kwenye mradi wako.
   a. Katika Xcode, na mradi wako umebeba, bonyeza File kutoka kwenye menyu kuu na uchague Ongeza Files kwa "mradi".
   b. Katika mazungumzo, chagua picha ya kitufe fileuliyopakua na bonyeza Ongeza.
   c. Vifungo lazima sasa iwe katika mradi chini ya saraka ya mradi wako. Hoja yao kwa Kusaidia Filefolda.
5. Ongeza picha kwenye kifungo chako.
   Ili kuwezesha picha kwa kifungo chako, unaweza kurekebisha sifa ya kifungo au kutumia setImage: kwaState njia kwenye Kitufe cha UIB kitu. Fuata hatua hizi kurekebisha sifa ya picha kwa kitufe chako:
   a. Fungua ubao wa hadithi wa programu yako.
   b. Chagua kitufe kwenye ubao wako wa hadithi kwa kubofya au kuchagua kutoka View Kidhibiti Mti wa eneo.
   c. Katika Huduma Dirisha, fungua Sifa Mkaguzi.
   
   d. Juu ya Mkaguzi wa Sifa, weka Aina ya kitufe kwenye Mfumo.
   e. Katika kikundi cha pili cha mipangilio, chagua chaguo-msingi kwa Usanidi wa Jimbo.
   f. Katika kikundi cha pili cha mipangilio, angusha mipangilio ya Picha.
   g. Chagua Ingia na picha ya kitufe cha Amazon uliyoongeza kwenye mradi huo. Usichague toleo la 2x: litapakiwa kiatomati kwenye vifaa vya kuonyesha msongamano mkubwa (Retina).
   h. Weka picha sawa kwa mpangilio wa Usuli.
   i. Ikiwa unataka kutaja toleo lililobanwa la kitufe, chagua Iliyochaguliwa kwa Usanidi wa Jimbo, na uweke Picha kwenye toleo la _Bonyeza kitufe chako.
   j. Kwenye ubao wa hadithi, rekebisha saizi ya kitufe chako ili kuweka picha, ikiwa ni lazima.

Kutumia SDK kwa API za iOS

Katika sehemu hii, utaongeza nambari kwenye mradi wako ili uingie mtumiaji na Ingia na Amazon.
Tazama mada zifuatazo:

• Shughulikia Kitufe cha Ingia na Pata Profile Data
• Angalia Ingia ya Mtumiaji katika Mwanzo
• Futa Hali ya Uidhinishaji na Ingia Mtumiaji

Shughulikia Kitufe cha Ingia na Pata Profile Data

Sehemu hii inaelezea jinsi ya kupiga simu ruhusuUserForScopes: mjumbe: na pataProfile: APIs kuingia kwenye mtumiaji na kupata pro yaofile data. Hii ni pamoja na kuunda faili ya onLoginButtonBonyeza: msikilizaji kwa Ingia yako na kitufe cha Amazon.

1. Ongeza Ingia na Amazon kwenye mradi wako wa iOS. Angalia Sakinisha Ingia na Maktaba ya Amazon.
2. Ingiza Kuingia na Amazon API kwenye chanzo chako file.
   Ili kuagiza Ingia na Amazon API, ongeza zifuatazo #maarifa kwa chanzo chako file:

   #mport

3. Tengeneza AMZAidhinishaUsaidizi wa Daraja la Huduma kutekeleza
   Uthibitishaji wa Ugawiji Shiriki.
   Wakati ruhusuUserForScopes: mjumbe: inakamilisha, itaita ombiIlifanikiwa: or ombiDidFail: njia juu ya kitu ambacho kinatumia Uthibitishaji wa Ugawiji Shiriki itifaki.

   @interface AMZNAidhinishaUserDelegate: NSObject @ mwisho

   Kwa habari zaidi, ona Kufanya kazi na Itifaki  kwenye developer.apple.com.
4. Piga simu ruhusuUserForScopes: mjumbe: in onLoginButtonBonyeza.
   Ikiwa ulifuata hatua katika Ongeza Ingia na Kitufe cha Amazon kwenye Programu Yako, unapaswa kuwa na onLoginButtonClicked: method iliyounganishwa na Ingia na kitufe cha Amazon. Kwa njia hiyo, piga simu AuthorizeUserForScopes: mjumbe: kwa mshawishi mtumiaji kuingia na kuidhinisha programu yako.
   Njia hii itamwezesha mtumiaji kuingia na kukubali habari iliyoombwa kwa moja ya njia zifuatazo:
   1.) Hubadilisha hadi web view katika hali salama (ikiwa programu ya Ununuzi ya Amazon imewekwa kwenye kifaa)
   2.) Inabadilisha kwenda Safari View Kidhibiti (kwenye iOS 9 na baadaye)
   3.) Inabadilisha kivinjari cha mfumo (kwenye iOS 8 na mapema)
   Mazingira salama ya chaguo la kwanza yanapatikana wakati programu ya Ununuzi ya Amazon imewekwa kwenye kifaa. Ikiwa mtumiaji tayari ameingia kwenye programu ya Ununuzi wa Amazon, ukurasa wa kuingia umerukwa, na kusababisha Kuingia Moja kwa Moja (SSO) uzoefu.

   Programu yako inapoidhinishwa, inaruhusiwa kwa seti moja au zaidi ya data inayojulikana kama upeo. Kigezo cha kwanza ni safu ya upeo ambao unajumuisha data ya mtumiaji unayoomba kutoka Ingia na Amazon. Mara ya kwanza mtumiaji anapoingia kwenye programu yako, atawasilishwa na orodha ya data unayoomba na kuomba idhini. Kuingia na Amazon kwa sasa inasaidia upeo tatu: profile, ambayo ina jina la mtumiaji, anwani ya barua pepe, na kitambulisho cha akaunti ya Amazon; profile: mtumiaji_id, ambayo ina id ya akaunti ya Amazon tu; na nambari ya posta, ambayo ina msimbo wa zip / posta wa mtumiaji.
   Kigezo cha pili kwa ruhusuUserForScopes: mjumbe: ni kitu kinachotimiza Uthibitishaji wa Itifaki ya Utoaji wa Sheria, katika kesi hii mfano wa AMZAidhinishaUserDelegate darasa.

   - (IBAction) kwenyeLogInButtonBonyeza: (id) mtumaji { // Fanya idhini ya kupiga simu kwa SDK kupata ishara ya ufikiaji salama // kwa mtumiaji. // Wakati unapiga simu ya kwanza unaweza kutaja msingi wa chini // upeo unahitajika. // Kuuliza upeo wote kwa mtumiaji wa sasa. NSArray * ombiScopes = [NSArray arrayWithObjects: @ ”profile", @" Nambari ya posta ", nil]; AMZNAuthorizeUserDelegate * mjumbe = [[AMZNAuthorizeUserDelegate alloc] initWithParentController: binafsi]; [AIMobileLib idhiniUserForScopes: ombiScopes mjumbe: mjumbe];

   Ongeza kichwa chako cha utekelezaji cha mjumbe kwenye wito wa darasa
   idhinishaUserForScopes:. Kwa mfanoample:

   #port "AMZNAuthorizeUserDelegate.h"

5. Unda AMZNGetProfileMjumbe.
   AMZNGetProfileWajumbe jina letu kwa darasa linalotumia
   Uthibitishaji wa Itifaki ya Utoaji wa Sheria, na itashughulikia matokeo ya pataProfile: wito. Kama AuthorizeUserForScopes: mjumbe :, GetProfile: inasaidia ombiIlifanikiwa: na ombiDidFail: mbinu za itifaki. ombiIlifanikiwa: hupokea Matokeo ya mwili kitu na profile data katika mali ya matokeo. ombiDidFail: hupokea Hitilafu ya AI kitu na habari juu ya kosa katika mali ya kosa.
   Kuunda darasa la mjumbe kutoka kwa tamko la kawaida la darasa, ingiza
   Uthibitishaji wa Ugawajiji mkono ongeza itifaki kwa tamko katika kichwa chako cha darasa file:

   #mport @ kiunganishi AMZNGetProfileMjumbe: NSObject @end

    

6. Tekeleza ombiIlifanikiwa: kwa yako AMZAidhinishaUserDelegate. In ombiIlifanikiwa :, piga simu pataProfile: kupata mteja profile. pataProfile:, kama AuthorizeUserForScopes: mjumbe :, hutumia itifaki ya AIAuthenticationDelegate.
   

   - (batili) ombiImefanikiwa: (APIResult *) apiResult { // Nambari yako baada ya mtumiaji kuidhinisha programu ya // upeo ulioombwa. // Pakia mpya view mtawala na habari ya kutambua mtumiaji // kama mtumiaji sasa ameingia kwa mafanikio. AMZNGetProfileKukabidhi * mjumbe = [[AMZNGetProfileKaumu alloc] initWithParentController:parentViewMdhibiti] autorelease]; [AIMobileLib pataProfile: mjumbe]; }

   Ongeza kichwa chako cha utekelezaji cha mjumbe kwenye wito wa darasa pataProfile:. Forexample:
   

   #port "AMZNGetProfileUjumbe.h ”

7. Tekeleza ombiIlifanikiwa: kwa ajili yako AMZNGetProfileMjumbe.
   ombiIlifanikiwa: ina kazi kuu mbili: kupata profile data kutoka kwa Matokeo, na kupitisha data kwa UI.
   Kupata profile data kutoka kwa Matokeo, fikia mali ya matokeo. Kwa pataProfile: majibu, mali hiyo itakuwa na kamusi ya maadili ya mali kwa mtumiaji profile mali. Mtaalamfile mali ni jina, barua pepe, na mtumiaji_id kwa profile upeo na
   posta_code kwa posta_code upeo.

   - (batili) ombiImefanikiwa: (APIResult *) apiResult { // Pata profile ombi limefanikiwa. Ondoa profile habari // na kuipitisha kwa mzazi view mtawala NSString * name = [(NSDictionary *) apiResult.result objectForKey: @ "name"]; NSString * barua pepe = [(NSDictionary *) apiResult.result objectForKey: @ "email"]; NSString * mtumiaji_id = [((NSDictionary *) apiResult.result objectForKey: @ "user_id"]; NSString * posta_code = [((NSDictionary *) apiResult.result objectForKey: @ "postal_code"]; // Pitisha data kwenda view mtawala }

8. Tekeleza ombiDidFail: kwa ajili yako AMZNGetProfileMjumbe.
   ombiDidFail: inajumuisha Kosa la API kitu kilicho na maelezo juu ya kosa. onyeshaLogInPageis njia ya kudhani ambayo ingeweka upya kuu view mtawala kuonyesha Kuingia na kitufe cha Amazon.

   - (batili) ombiDidFail: (APIError *) errorResponse { // Pata Profile ombi limeshindwa kwa profile upeo. // Ikiwa nambari ya makosa = kAIAplicationIsiidhinishwa, // ruhusu mtumiaji kuingia tena. ikiwa (errorResponse.error.code == kAIApplicationNotAuthorized) { // Onyesha idhinisha kitufe cha mtumiaji. [mzaziViewShowLogInPage ya Mdhibiti]; } mwingine { // Shughulikia makosa mengine [[[UIAlertView alloc] initWithTitle: @ ”” ujumbe: [NSString stringWithFormat: @ ”Hitilafu ilitokea na ujumbe:% @”, errorResponse.error.message] mjumbe: nil cancelButtonTitle: @ "OK" otherButtonTitles: nil] autorelease] onyesha]; } }

9. Tekeleza ombiDidFail: kwa yako AMZAidhinishaUserDelegate.
   

   - (batili) ombiDidFail: (APIError *) errorResponse { NSString * message = errorResponse.error.message; // Nambari yako wakati idhini itashindwa. [[[UIAlertView alloc] initWithTitle: @ ”” ujumbe: [NSString stringWithFormat: @ ”Idhini ya mtumiaji imeshindwa na ujumbe:% @”, errorResponse.error.message] mjumbe: nil cancelButtonTitle: @ "OK" otherButtonTitles: nil] autorelease] onyesha]; }

   10. Tekeleza maombi: funguaURL: chanzo Maombi: ufafanuzi: darasani katika mradi wako unaoshughulikia Ugawaji wa UIA itifaki (kwa chaguo-msingi hii itakuwa Kikundi cha AppGelegate katika mradi wako). Wakati programu inawasilisha ukurasa wa kuingia wa Amazon, na mtumiaji akikamilisha kuingia, itaelekeza kwenye programu kwa kutumia URL Mpango programu iliyosajiliwa mapema. Uelekezaji huo umepitishwa kwa maombi: funguaURL: chanzo Maombi: ufafanuzi :, ambayo inarudi NDIYO ikiwa URL ilishughulikiwa vyema. shikaFunguaURLchanzo ni kazi ya maktaba ya SDK ambayo itashughulikia Kuingia na kuelekeza Amazon URLs kwako. Kama shikaFunguaURL: chanzoApplication: inarudi NDIYO, kisha ya URL ilishughulikiwa.

   - (BOOL) maombi: (UIAplication) * maombi waziURL: (NSURL *)url chanzoApplication: (NSString *) chanzoApplication ufafanuzi: (id) ufafanuzi { // Pita kwenye url kwa SDK kuchanganua nambari ya idhini // kutoka url. BOOL niValidRedirectSignInURL = [AIMobileLib kushughulikia FunguaURL:url chanzoApp cation: sour ceApplicati on); ikiwa (! isValidRedirect Si gnlnURL) kurudi NO; // Programu inaweza kutaka kushughulikia e url kurudi YES; }

   KUMBUKA: Njia hii imedharauliwa katika iOS 9 lakini inapaswa kujumuishwa katika mradi wako kudumisha msaada kwa watumiaji kwenye majukwaa ya zamani. Kwa habari zaidi juu ya maombi: funguaURL: chanzo Maombi: ufafanuzi :, ona UIApplicationDelegate Itifaki ya Itifaki kwenye developer.apple.com.

Angalia Ingia ya Mtumiaji katika Mwanzo

Ikiwa mtumiaji huingia kwenye programu yako, anafunga programu hiyo, na kuanza tena programu hiyo baadaye, programu hiyo bado imeidhinishwa kupata data. Mtumiaji hajatoka otomatiki. Wakati wa kuanza, unaweza kuonyesha mtumiaji kama ameingia ikiwa programu yako bado imeidhinishwa. Sehemu hii inaelezea jinsi ya kutumia
pataAccessTokenForScopes: naOverrideParams: mjumbe: kuona ikiwa programu bado imeidhinishwa.

1. Unda AMZNGetAccessTokenDelegate darasa. AMZNGetAccessTokenDelegatements ya Uthibitishaji wa Ugawiji Shiriki itifaki, na itashughulikia matokeo ya
   pataAccessTokenForScopes: naOverrideParams: mjumbe: piga simu. Uthibitishaji wa Ugawiji Shiriki ina njia mbili, ombiIlifanikiwa: na ombiDidFail:. ombiIlifanikiwa: hupokea Matokeo ya mwili kitu na data ya ishara, wakati ombiDidFail: hupokea Kosa la API kitu na habari juu ya kosa.

   #mport @interface AMZNGetAccessTokenDelegate: NSObject @mwisho

   Ongeza kichwa chako cha utekelezaji cha mjumbe kwenye wito wa darasa
   pataAccessTokenForScopes: naOverrideParams: mjumbe :. Forexample:

   #mport "AMZNGetAccessTokenDelegate.h"

2. Kwenye kuanza kwa programu, piga simu
   pataAccessTokenForScopes: naOverrideParams: mjumbe: kuona ikiwa programu bado imeidhinishwa. pataAccessTokenForScopes: naOverrideParams: mjumbe: inapata ishara ya ufikiaji mbichi ambayo Ingia na Amazon hutumia kupata pro ya mtejafile. Ikiwa njia hiyo inafanikiwa, programu bado imeidhinishwa na simu kwa pataProfile: inapaswa kufaulu. pataAccessTokenForScopes: naOverrideParams: mjumbe: hutumia Uthibitishaji wa Ugawiji Shiriki itifaki kwa njia sawa na ruhusuUserForScopes: mjumbe :. Pitisha kitu kinachotekeleza itifaki kama kigezo cha mjumbe.

   - (batili) angaliaIsUserSignedIn { AMZNGetAccessTokenDelegate * mjumbe = [[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorelease]; NSArray * ombiScopes = [NSArray arrayWithObjects: @ ”profile", @" Nambari ya posta ", nil]; [AIMobileLib getAccessTokenForScopes: requestScopes withOverrideParams: nil messenger: mjumbe]; }

3. Tekeleza ombiIlifanikiwa: juu yako AMZNGetAccessTokenDelegate. ombiIlifanikiwa: ina kazi moja: kupiga simu pataProfile:. Ex huyuampsimu pataProfile: kutumia msikilizaji yule yule uliyetangaza katika sehemu iliyopita (angalia hatua 6-8).
   

   #port "AMZNGetProfileUjumbe.h ” #mport - (batili) ombiImefanikiwa: (APIResult *) apiResult { // Nambari yako ya kutumia ishara ya ufikiaji inakwenda hapa. // Kwa kuwa programu ina idhini ya upeo wetu, tunaweza // pata pro ya mtumiajifile. AMZNGetProfileMjumbe * mjumbe = [[[AMZNGetProfileKabidhi mjumbe] initWithParentController: parentViewMdhibiti] autorelease]; [AIMobileLib pataProfile: mjumbe]; }

4. Tekeleza ombiDidFail: juu yako AMZNGetAccessTokenDelegate.
   ombiDidFail: inajumuisha Kosa la API kitu kilicho na maelezo juu ya kosa. Ukipokea kosa, unaweza kuweka upya kuu view mtawala kuonyesha Kuingia na kitufe cha Amazon.

   - (batili) ombiDidFail: (APIError *) errorResponse { // Nambari yako ya kushughulikia urejeshi wa ishara ya ufikiaji haukufaulu. // Ikiwa nambari ya makosa = kAIAplicationIsiidhinishwa, ruhusu mtumiaji // kuingia tena. ikiwa (errorResponse.error.code == kAIApplicationNotAuthorized) { // Onyesha Kuingia na kitufe cha Amazon. } mwingine { // Shughulikia makosa mengine [[[UIAlertView alloc] initWithTitle: @ ”” ujumbe: [NSString stringWithFormat: @ ”Kosa limetokea na ujumbe:% @”, errorResponse.error.message] mjumbe: nil cancelButtonTitle:@”Sawa” otherButtonTitles:nil] autorelease] show]; } }

Futa Hali ya Uidhinishaji na Ingia Mtumiaji

The waziAuthorizationState: njia itaondoa data ya idhini ya mtumiaji kutoka kwa AIMobileLib duka la data la hapa. Mtumiaji atalazimika kuingia tena ili programu ipate profile data. Tumia njia hii kutoka kwa mtumiaji, au kusuluhisha shida za kuingia kwenye programu.

1. Tangaza AMZNLogoutDelegate. Hili ni darasa linalotumia
   Itifaki ya Uthibitishaji wa Sheria. Kwa madhumuni yetu, tunaweza kurithi darasa kutoka Kichwa cha NSO:
   

   #mport @ interface # AMZNLogoutToa Mkutano wa NSObject @mwisho

   Ongeza kichwa chako cha utekelezaji cha mjumbe kwenye wito wa darasa clearAuthorizationState :. Kwa mfanoample:

   #mport "AMZNLogoutDelegate.h"

2. Piga simu clearAuthorizationState :.
   Mtumiaji anapoingia kwa mafanikio, unaweza kutoa utaratibu wa kutoka ili waweze kufuta data yao ya idhini. Utaratibu wako unaweza kuwa kiunga, au kitu cha menyu, lakini kwa hali hii wa zamaniample itaunda faili ya logoutButtonBonyeza njia kwa kitufe cha kutoka.

   - (IBAction) logoutButtonBonyeza: (id) mtumaji { AMZNLogoutDelegate* delegate = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorelease]; [AIMobileLib clearAuthorizationState:delegate]; }

   Kigezo pekee cha clearAuthorizationState ni Uthibitishaji wa Ugawiji Shiriki hiyo inatekeleza ombiIlifanikiwa: na ombiDidFail:.

3. Tekeleza ombiIlifanikiwa:. Njia hii itaitwa wakati habari ya mtumiaji itafutwa. Unapaswa kuwaonyesha kama wametoka nje.
   

   - (batili) ombiImefanikiwa: (APIResult *) apiResult { // Mantiki yako ya ziada baada ya idhini ya mtumiaji // hali imefutwa. [[[UIAlertView alloc] initWithTitle: @ ”” message: @ ”Mtumiaji Ameingia.” delegate:nil cancelButtonTitle:@”Sawa” otherButtonTitles:nil] show]; }

4. Tekeleza ombiDidFail:. Njia hii itaitwa ikiwa kwa sababu fulani habari ya mtumiaji haiwezi kufutwa kutoka kwa kashe. Katika kesi hiyo, haupaswi kuwaonyesha kuwa wameingia nje.
   

   - (batili) ombiDidFail: (APIError *) errorResponse { // Mantiki yako ya ziada baada ya SDK kushindwa kufutwa // hali ya idhini. [[[UIAlertView alloc] initWithTitle: @ ”” ujumbe: [NSString stringWithFormat: @ ”Kuingia kwa Mtumiaji hakufanikiwa na ujumbe:% @”, errorResponse.error.message] mjumbe: nil cancelButtonTitle:@”Sawa” otherButtonTitles:nil] autorelease] show]; }

Jaribu ujumuishaji wako

Anzisha programu yako kwenye kifaa cha iOS au simulator na uthibitishe kuwa unaweza kuingia na sifa zako za Amazon.com.

Kumbuka: Wakati wa kujaribu kwenye simulators za iOS10, unaweza kuona ujumbe wa makosa APIKey Maombi sio sahihi kwa ombi la kuidhinishaUserForScopes, au Nambari ya Hitilafu isiyojulikana ya ombi wazi la AuthorizationState. Hii ni mdudu anayejulikana na Apple ambayo hufanyika wakati SDK inapojaribu kupata keychain. Hadi Apple itatatua mdudu, unaweza kufanya kazi kuzunguka kwa kuwezesha Kushiriki kwa Keychain kwa programu yako chini ya kichupo cha Uwezo cha shabaha ya programu yako. Mdudu huyu huathiri tu simulators. Unaweza kujaribu vifaa halisi vya iOS10 bila kutumia kazi yoyote.

Ingia na Mwongozo wa Kuanza wa Amazon kwa Toleo la iOS 2.1.2 - Pakua [imeboreshwa]
Ingia na Mwongozo wa Kuanza wa Amazon kwa Toleo la iOS 2.1.2 - Pakua

Marejeleo

• Mwongozo wa Mtumiaji