Piesakieties, izmantojot iOS lietotņu Amazon darba sākšanas rokasgrāmatu

Piesakieties ar Amazon: Darba sākšanas rokasgrāmata iOS
Autortiesības © 2017 Amazon.com, Inc. vai tās saistītie uzņēmumi. Visas tiesības aizsargātas. Amazon un Amazon logotips ir Amazon.com, Inc. vai tā filiāļu preču zīmes. Visas citas preču zīmes, kas nepieder Amazon, ir to attiecīgo īpašnieku īpašums.

Ievads

Šajā rokasgrāmatā mēs parādīsim, kā pievienot pieteikšanos ar Amazon savai iOS lietotnei, izmantojot pieteikšanos ar Amazon SDK operētājsistēmai iOS v3.0 +.
Pēc šīs rokasgrāmatas pabeigšanas jūsu lietotnē vajadzētu būt darbojošai pogai Pieteikties ar Amazon, kas lietotājiem ļauj pieteikties, izmantojot savus Amazon akreditācijas datus. Lai uzzinātu vairāk par pieteikšanās plūsmu, ko klienti piedzīvos, kad jūsu lietotnē izmantos pieteikšanos ar Amazon, lūdzu, skatiet mūsu Klientu pieredze Beigāsview iOS lietotnēm.

Instalējiet iOS izstrādātāja rīkus

Instalējiet XCode

Pieteikšanās ar Amazon SDK operētājsistēmai iOS nodrošina Amazon, lai palīdzētu jums iOS pieteikumam pievienot pieteikšanos ar Amazon. SDK paredzēts izmantot kopā ar Xcode izstrādes vidi. SDK atbalsta lietotnes, kas darbojas operētājsistēmā iOS 7.0 un jaunākās versijās, izmantojot ARMv7, ARMv7s, ARM64, i386 unx86_64.
Xcode var instalēt no Mac App Store. Plašāku informāciju skatiet Xcode: kas jauns on developer.apple.com.
Pēc Xcode instalēšanas jūs varat Instalējiet pieteikšanās pieteikšanos ar Amazon SDK operētājsistēmai iOS un Palaidiet Sample App, kā aprakstīts zemāk.

Instalējiet pieteikšanās pieteikšanos ar Amazon SDK operētājsistēmai iOS

Pieteikšanās ar Amazon SDK operētājsistēmai iOS ir iekļauta divos iepakojumos. Pirmajā ir iOS bibliotēka un papildu dokumentācija. Otrais satur kāample lietojumprogramma, kas ļauj lietotājam pieteikties un view viņu profesionālisfile datus.

Ja vēl neesat instalējis Xcode, skatiet instrukcijas Instalējiet Xcode sadaļā augstāk.

1. Lejupielādēt LoginWithAmazon SDKForiOS.zip un izvelciet files uz cietā diska direktoriju.
   Jums vajadzētu redzēt direktoriju LoginWithAmazon.framework. Tajā ir bibliotēka Login with Amazon.
   Rāvējslēdzēja augšējā līmenī ir a PieteiktiesWithAmazon.docset direktorijā. Tajā ir API dokumentācija.
2. Skatiet sadaļu Pieteikšanās ar Amazon bibliotēkas instalēšana, lai iegūtu norādījumus par bibliotēkas pievienošanu iOS projektam.
   Kad ir instalēta pieteikšanās ar Amazon SDK operētājsistēmai iOS, varat to izdarīt Izveidojiet jaunu pieteikšanos ar Amazon projektu pēc tevis Reģistrējieties, izmantojot pieteikšanos Amazon.

Palaidiet Sample App

Lai palaistu sample lietojumprogrammu, atveriet sampievadiet Xcode.

1. Lejupielādēt SampleLoginWithAmazonAppForiOS.zip un nokopējiet
   SampleLoginWithAmazonAppForiOS direktoriju mapē Dokumenti.
2. Sāciet Xcode. Ja tiek parādīts dialoglodziņš Welcome to Xcode, noklikšķiniet uz Atvērt citu. Pretējā gadījumā galvenajā izvēlnē noklikšķiniet uz File un atlasiet Atvērt.
3. Atlasiet mapi Dokumenti un atlasiet
   SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/
   PieteikšanāsAmazonSample.xcodeproj. Noklikšķiniet Atvērt.
4. SampTagad projektam vajadzētu ielādēties. Kad tas ir pabeigts, izvēlieties Produkts galvenajā izvēlnē un izvēlieties Skrien.

Reģistrējieties, izmantojot pieteikšanos Amazon

Pirms varat izmantot pieteikšanos ar Amazon vietnē a webvietnē vai mobilajā lietotnē, jums ir jāreģistrē lietojumprogramma, izmantojot Login with Amazon. Lietojumprogramma Login with Amazon ir reģistrācija, kas satur pamatinformāciju par jūsu uzņēmumu un informāciju par katru webjūsu izveidotā vietne vai mobilā lietotne, kas atbalsta pieteikšanos ar Amazon. Šī uzņēmuma informācija tiek rādīta lietotājiem ikreiz, kad viņi savā ierīcē izmanto pieteikšanos ar Amazon webvietne vai mobilā lietotne. Lietotāji redzēs jūsu lietojumprogrammas nosaukumu, jūsu logotipu un saiti uz jūsu konfidencialitātes politiku. Šīs darbības parāda, kā reģistrēt savu iOS lietotni lietošanai ar pieteikšanos ar Amazon.

Reģistrējiet savu pieteikšanos ar Amazon lietojumprogrammu

1. Dodieties uz https://login.amazon.com.
2. Ja iepriekš esat reģistrējies pakalpojumam Login ar Amazon, noklikšķiniet uz Lietotņu konsole. Pretējā gadījumā noklikšķiniet uz Reģistrēties. Jūs tiksiet novirzīts uz vietni Seller Central, kas veic pieteikumu reģistrāciju pieteikšanās veikšanai ar Amazon. Ja jūs pirmo reizi izmantojat pārdevēja centrāli, jums tiks lūgts izveidot pārdevēja centrālo kontu.
3. Noklikšķiniet Reģistrēt jaunu pieteikumu. The Reģistrējiet savu pieteikumu parādīsies veidlapa:
   
   a. Reģistrācijas pieteikuma veidlapā ievadiet a Vārds un a Apraksts jūsu pieteikumam. The Vārds ir vārds, kas tiek parādīts piekrišanas ekrānā, kad lietotāji piekrīt kopīgot informāciju ar jūsu lietojumprogrammu. Šis nosaukums attiecas uz Android, iOS un webjūsu lietojumprogrammas vietnes versijas.
   The Apraksts palīdz atšķirt katru pieteikšanās pieteikumu ar Amazon lietojumprogrammām un netiek parādīts lietotājiem.
   b. Ievadiet a Paziņojums par konfidencialitāti URL jūsu pieteikumam.
   Privātuma paziņojums URL ir jūsu uzņēmuma vai lietojumprogrammas konfidencialitātes politikas atrašanās vieta (piemample, http://www.example.com/privacy.html). Šī saite tiek rādīta lietotājiem piekrišanas ekrānā.
   c. Ja vēlaties pievienot a Logotipa attēls savam pieteikumam noklikšķiniet uz Izvēlieties File un atrodiet atbilstošo attēlu.
   Šis logotips tiek parādīts pierakstīšanās un piekrišanas ekrānā, lai attēlotu jūsu uzņēmumu vai webvietne.
   Ja logotips ir garāks par 50 pikseļiem, logotips tiks samazināts līdz 50 pikseļiem; logotipa platumam nav ierobežojumu.
4. Noklikšķiniet Saglabāt. Jūsu sampreģistrācijai vajadzētu izskatīties līdzīgi:
   
   Kad jūsu lietojumprogrammas pamata iestatījumi ir saglabāti, varat pievienot iestatījumus konkrētiem webvietnes un mobilās lietotnes, kurās tiks izmantota šī pieteikšanās ar Amazon kontu.
   Ja dažādām jūsu lietotnes versijām ir atšķirīgi komplekta ID, piemēram, vienai vai vairākām testēšanas versijām un ražošanas versijai, katrai versijai ir nepieciešama sava API atslēga. Lietotnes iOS iestatījumos noklikšķiniet uz Pievienot API atslēga pogu, lai savai lietotnei izveidotu papildu atslēgas (pa vienai versijai).

Pievienojiet iOS iestatījumus savai lietojumprogrammai

Kad jūsu lietojumprogrammas pamata iestatījumi ir saglabāti, varat pievienot iestatījumus konkrētiem webvietnes un mobilās lietotnes, kurās tiks izmantota pieteikšanās ar Amazon.
Lai reģistrētu iOS lietotni, jums jānorāda lietotnes projekta paketes identifikators. Pieteikšanās ar Amazon izmantos komplekta ID, lai ģenerētu API atslēgu. API atslēga piešķirs jūsu lietotnei piekļuvi autorizācijas pakalpojumam Login with Amazon. Lai savam kontam pievienotu iOS lietotni, veiciet šīs darbības:

1. No Pieteikums ekrāns, noklikšķiniet iOS iestatījumi. Ja jums jau ir reģistrēta iOS lietotne, meklējiet Pievienot API atslēgu pogu iOS iestatījumi sadaļā.
   The Informācija par iOS lietojumprogrammu parādīsies veidlapa:
   
2. Ievadiet Etiķete savas iOS lietotnes.
   Tam nav jābūt jūsu lietotnes oficiālajam nosaukumam. Tas vienkārši identificē šo konkrēto iOS lietotni starp lietotnēm un webvietnes, kas reģistrētas jūsu pieteikšanās pieteikumā, izmantojot Amazon.
3. Ievadiet savu Bundle ID. Tam jāatbilst jūsu iOS projekta kopas identifikatoram. Lai noteiktu komplekta identifikatoru, atveriet projektu Xcode. Atveriet projekta rekvizītu sarakstu (-Info.plist) sadaļā Projekta navigators. The Komplekta identifikators ir viena no īpašībām sarakstā.
4. Noklikšķiniet Saglabāt.

Ja dažādām jūsu lietotnes versijām ir atšķirīgi komplekta ID, piemēram, vienai vai vairākām testēšanas versijām un ražošanas versijai, katrai versijai ir nepieciešama sava API atslēga. Lietotnes iOS iestatījumos noklikšķiniet uz pogas Pievienot API atslēgu, lai savai lietotnei izveidotu papildu atslēgas (pa vienai versijai).

iOS komplekta ID un API atslēgas

Komplekta identifikators ir unikāls katrai iOS lietotnei. Pieteikšanās ar Amazon konstruēšanai izmanto Bundle ID
jūsu API atslēgu. API atslēga ļauj autorizēšanās pakalpojumam Login with Amazon atpazīt jūsu lietotni.

Nosakiet iOS lietotnes komplekta identifikatoru

1. Atveriet lietotnes projektu Xcode.
2. Atveriet Informācija Īpašums Saraksts projektam (-Info.plist) sadaļā Projekta navigators.
3. Atrast Komplekta identifikators īpašību sarakstā.

Ielādējiet iOS API atslēgu

Pēc tam, kad esat reģistrējis iOS versiju un norādījis Bundle ID, jūs varat izgūt API atslēgu no pieteikšanās pieteikšanās ar Amazon reģistrācijas lapas. Šī API atslēga būs jāievieto sava projekta īpašumu sarakstā. Kamēr to nedarīsit, lietotne nebūs pilnvarota sazināties ar autorizācijas pakalpojumu Login with Amazon.

1. Dodieties uz https://login.amazon.com.
2. Noklikšķiniet Lietotņu konsole.
3. In Lietotnes noklikšķiniet uz savas lietojumprogrammas.
4. Atrodiet savu iOS lietotni sadaļā iOS iestatījumi sadaļā.
   Ja vēl neesat reģistrējis iOS lietotni, skatiet Pievienojiet lietojumprogrammai iOS iestatījumus.
5. Noklikšķiniet Ģenerēt API atslēgas vērtību. Uznirstošajā logā tiks parādīta jūsu API atslēga. Lai nokopētu atslēgu, noklikšķiniet uz Atlasiet visu lai atlasītu visu taustiņu.
   Piezīme: API atslēgas vērtība daļēji ir balstīta uz tās ģenerēšanas laiku. Tādējādi nākamā (-ās) API atslēgas vērtība (-es) var atšķirties no sākotnējās. Savā lietotnē varat izmantot jebkuru no šīm API atslēgu vērtībām, jo ​​tās visas ir derīgas.
6. Skatiet sadaļu API atslēgas pievienošana lietotņu īpašumu sarakstam, lai iegūtu norādījumus par API atslēgas pievienošanu iOS lietotnei

Izveidojiet pieteikšanos ar Amazon Project

Šajā sadaļā jūs uzzināsiet, kā izveidot jaunu Xcode projektu Login ar Amazon un konfigurēt projektu.

Izveidojiet jaunu pieteikšanos ar Amazon projektu

Ja jums vēl nav lietojumprogrammas projekta Login with Amazon lietošanai, izpildiet tālāk sniegtos norādījumus, lai to izveidotu. Ja jums jau ir lietotne, pārejiet uz Instalējiet pieteikšanās ar Amazon bibliotēku sadaļā zemāk.

1. Palaist Xcode.
2. Ja jums tiek parādīts a Laipni lūdzam Xcode dialoglodziņā atlasiet Izveidot jauns Xcode projekts.
   Pretējā gadījumā no File izvēlnē atlasiet Jauns un Projekts.
3. Atlasiet projekta veidu, kuru vēlaties izveidot, un noklikšķiniet uz Tālāk.
4. Ievadiet a Produkta nosaukums un a Uzņēmuma identifikators. Ievērojiet savu Komplekta identifikators, un noklikšķiniet uz Tālāk.
5. Atlasiet vietu, kur saglabāt savu projektu, un noklikšķiniet uz Izveidot.

Tagad jums būs jauns projekts, kuru varat izmantot, lai izsauktu Login ar Amazon.

Instalējiet pieteikšanās ar Amazon bibliotēku

Ja vēl neesat lejupielādējis Login with Amazon SDK for iOS, skatiet Instalējiet pieteikšanās pieteikšanos ar Amazon SDK operētājsistēmai iOS.

Pieteikšanās ar Amazon projektam ir jāsaista Pieteikties ar Amazon.framework un Drošība.rāmis bibliotēkas. Jums būs jākonfigurē arī ietvara meklēšanas ceļš, lai atrastu Login with Amazon galvenes.

1. Ja jūsu projektam nav mapes Frameworks, ar peles labo pogu noklikšķiniet uz projekta nosaukuma Navigator
   rūtiņā Xcode, pēc tam noklikšķiniet uz Jauna grupa.
2. Nosauciet jauno grupu Rāmji.
3. Izvēlieties Ietvari mapi un noklikšķiniet uz File no galvenās izvēlnes.
4. Izvēlieties Pievienot Files uz Projekts.
5. Dialoglodziņā atlasiet Pieteikties ar Amazon.framework un noklikšķiniet Pievienot.
   Ja izmantojāt bibliotēku Login with Amazon 1.0, izdzēsiet login-with-amazon-sdk direktoriju un login-with-amazon-sdk.a no mapes Frameworks. Galvenajā izvēlnē noklikšķiniet uz Rediģēt un atlasiet Dzēst.
6. Projekta navigatorā atlasiet sava projekta nosaukumu.
   The Projekta redaktors parādīsies Xcode darbvietas redaktora apgabalā.
7. Noklikšķiniet uz sava projekta nosaukuma zem Mērķi, un atlasiet Veidošanas fāzes. Izvērst Saistiet bināro failu ar bibliotēkām un noklikšķiniet uz pluszīmes, lai pievienotu bibliotēku.
8. Meklēšanas lodziņā ievadiet Drošība.rāmis. Izvēlieties Drošība.frameworkk un noklikšķiniet Pievienot.
9. Meklēšanas lodziņā ievadiet SafariServices.framework. Izvēlieties SafariServices.framework un noklikšķiniet Pievienot.
   
10. Atlasiet Veidot iestatījumus. Noklikšķiniet uz Visas view visi iestatījumi.
11. Sadaļā Meklēšanas ceļi pārliecinieties, vai Pieteikties ar Amazon.framework direktorija atrodas Ietvara meklēšanas ceļi.
    Piemēram,ample:
    
12. Ja pirms projekta veidošanas izmantojāt bibliotēku Pieteikšanās ar Amazon 1.0, savā avotā nomainiet #import “AIMobileLib.h”, #import “AIAuthenticationDelegate.h” un #import “AIError.h”. files ar vienu #importu
    . LoginWithAmazon.hline ietver visu pieteikšanos ar Amazon galvenēm uzreiz.
    Varat arī noņemt visas atsauces uz 1.0 bibliotēkas ceļu Galvenes meklēšanas ceļi vai bibliotēkas meklēšanas ceļi.
    13. Galvenajā izvēlnē noklikšķiniet uz Produkts un atlasiet Veidot. Veidošana būtu jāpabeidz veiksmīgi.

Pievienojiet API atslēgu lietotnes īpašumu sarakstam

Reģistrējot savu iOS lietojumprogrammu vietnē Login with Amazon, jums tiek piešķirta API atslēga. Tas ir identifikators, kuru Amazon Mobile Library izmantos, lai identificētu jūsu pieteikumu autorizācijas pakalpojumam Login with Amazon. Amazon mobilā bibliotēka izpildes laikā ielādē šo vērtību no APIKey rekvizīta vērtības jūsu lietojumprogrammas informācijas īpašumu sarakstā.

1. Kad jūsu projekts ir atvērts, atlasiet Atbalstot Files mapi, pēc tam atlasiet -Info.plist file (kur ir jūsu projekta nosaukums). Tam vajadzētu atvērt rekvizītu sarakstu rediģēšanai:
   
2. Pārliecinieties, ka neviens no ierakstiem nav atlasīts. Pēc tam galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet APIKey un nospiediet Ievadiet.
3. Veiciet dubultklikšķi zem Vērtība kolonnā, lai pievienotu vērtību. Kā vērtību ielīmējiet API atslēgu.

Pievienojiet a URL Shēma jūsu lietotņu īpašumu sarakstam

Kad lietotājs piesakās, viņam tiks parādīta Amazon pieteikšanās lapa. Lai jūsu lietotne saņemtu apstiprinājumu par pieteikšanos, jums jāpievieno URL shēma, lai web lapu var novirzīt atpakaļ uz jūsu lietotni. The URL shēma ir jādeklarē kā amzn- (piemēram,ample, amzncom.example.app). Plašāku informāciju skatiet Izmantojot URL Shēmas saziņai ar lietotnēm vietnē developer.apple.com.

1. Kad projekts ir atvērts, atlasiet Atbalsts Files mapi, pēc tam atlasiet -Info.plist file (kur ir jūsu projekta nosaukums). Tam vajadzētu atvērt rekvizītu sarakstu rediģēšanai:
   
2. Pārliecinieties, ka neviens no ierakstiem nav atlasīts. Pēc tam galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet vai atlasiet URL veidi un nospiediet Ievadiet.
3. Izvērst URL veidi atklāt Vienums 0. Izvēlieties Vienums 0 un galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet vai atlasiet URL Identifikators un nospiediet Ievadiet.
4. Izvēlieties 0. punkts zem URL Identifikators un veiciet dubultklikšķi zem Vērtība kolonnā, lai pievienotu vērtību. Vērtība ir jūsu kopas ID. Paketes ID varat atrast kā Komplekta identifikators īpašumu sarakstā.
5. Izvēlieties Vienums 0 zem URL veidi un galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet vai atlasiet URL Shēmas un nospiediet Enter.
6. Izvēlieties 0. punkts zem URL Shēmas un veiciet dubultklikšķi zem kolonnas Vērtība, lai pievienotu vērtību. Vērtība ir jūsu kopas ID ar amzn- iepriekš pievienots (piemample, amzn com.example.app). Paketes ID varat atrast kā Komplekta identifikators īpašumu sarakstā.

Pievienojiet lietotnei Pieteikšanās ar Amazon pogām

Pieteikšanās ar Amazon nodrošina vairākas standarta pogas, kuras varat izmantot, lai mudinātu lietotājus pieteikties no jūsu lietotnes.
Šajā sadaļā sniegtas darbības, lai lejupielādētu oficiālu pieteikšanos ar Amazon attēlu un savienotu to pārī ar iOS UIBpoga.

1. Pievienojiet standartu UIBpoga savai lietotnei.
   Apmācības un informāciju par pogas pievienošanu lietotnei skatiet Izveide un konfigurēšana View Objekti un Sāciet izstrādāt iOS lietotnes jau šodien vietnē developer.apple.com.
2. Pievienojiet Pieskarieties augšpusē notikums pogai uz metodi, kas nosaukta
   onLoginButtonClicked. Pagaidām atstājiet ieviešanu tukšu. The Izveide un konfigurēšana View Objekti un Sāciet izstrādāt iOS lietotnes jau šodien dokumentos vietnē developer.apple.com ir iekļautas darbības pogas notikuma pievienošanai.
3. Izvēlieties pogas attēlu.
   Skatiet mūsu pieteikšanās pieteikumu, izmantojot Amazon stila vadlīnijas, lai iegūtu sarakstu ar pogām, kuras varat izmantot savā lietotnē. Lejupielādējiet LWA_for_iOS.zip kopiju file. Atrodiet vēlamo pogu gan 1x, gan 2x direktorijos un izvelciet tos no zip. Izvelciet savas pogas _piespiesto versiju, ja vēlaties pogu parādīt atlasītā stāvoklī.
4. Pievienojiet attēlus savam projektam.
   a. Xcode ar ielādētu projektu noklikšķiniet uz File galvenajā izvēlnē un izvēlieties Pievienot Files uz “projektu”.
   b. Dialoglodziņā atlasiet pogas attēlu filelejupielādētās un noklikšķiniet uz Pievienot.
   c. Pogām tagad jābūt projektā, kas atrodas jūsu projekta direktorijā. Pārvietojiet tos uz atbalstu Files mape.
5. Pievienojiet attēlu savai pogai.
   Lai iespējotu pogas attēlu, varat mainīt pogas atribūtu vai izmantot setImage: forState metode uz UIBpoga objekts. Veiciet šīs darbības, lai modificētu pogas attēla atribūtu:
   a. Atveriet savas lietotnes storyboard.
   b. Izvēlieties pogu savā tastatūrā, noklikšķinot uz tās vai atlasot to no View Kontroliera aina koks.
   c. In Komunālie pakalpojumi logs, atveriet Atribūtu inspektors.
   d. Augšpusē Atribūtu inspektors, iestatiet Tips no pogas uz Sistēma.
   e. Otrajā iestatījumu grupā atlasiet Noklusējums Valsts konfigur.
   f. Otrajā iestatījumu grupā nolaižamo pogu Attēls iestatījumu.
   g. Atlasiet projektam pievienoto pogas Pieteikties ar Amazon pogu. Neatlasiet 2x versiju: ​​tā tiks automātiski ielādēta augsta blīvuma displeja (Retina) ierīcēs.
   h. Iestatiet to pašu attēlu Fons iestatījumu.
   i. Ja vēlaties norādīt nospiestu pogas versiju, atlasiet Atlasīts priekš Štata konfigurācija, un iestatiet Attēls uz _Spiedis pogas versija.
   j. Veidošanas grafikā pielāgojiet pogas lielumu, lai tas būtu piemērots attēlam, ja nepieciešams.
   Šajā sadaļā jūs savam projektam pievienosiet kodu, lai pierakstītos lietotājā ar Login with Amazon.

Izmantojiet SDK iOS API

Šajā sadaļā jūs savam projektam pievienosiet kodu, lai pierakstītos lietotājā ar Login with Amazon.

Pievienojiet lietotnes pārstāvi

Īstenot pieteikums: atvērtsURL: opcijas: jūsu projekta klasē, kas nodarbojas ar UIApplicationDelegate protokols. Pēc noklusējuma tas būs AppDelegate klasē. Kad lietotājs veiksmīgi piesakās jūsu lietotnē, izmantojot pieteikšanos ar Amazon, viņš tiks novirzīts no Amazon pieteikšanās ekrāna atpakaļ uz jūsu lietotni, pamatojoties uz URL Shēma jūs iepriekš pievienojāt savu lietotņu īpašumu sarakstam. Lai veiktu šo novirzīšanu, jums ir jāievieš pieteikums: atvērtsURL: opcijas: metode, kas atgriež JĀ, ja URL tiek veiksmīgi apstrādāts.

Pieteikšanās ar Amazon SDK iOS nodrošina bibliotēkas funkciju, rokturiAtvērtURL: sourceApplication: kas apstrādā jebkuru novirzīšanu URL nosūtīti no Amazon lapām. Tas atgriež JĀ, ja URL veiksmīgi apstrādā SDK. Izsauciet šo metodi pieteikums: atvērtsURL: opcijas: metode.

Lai izmantotu šo metodi, jums būs jāimportē .

importēt @ ieviešana AppDelegate - (BOOL) lietojumprogramma: (UIApplication *) ir atvērta lietojumprogrammaURL: (NSURL *) url opcijas: (NSDictionaryURLOptionsKey, id> *) options { return [AMZNAuthorizationManager handOpenURL:url sourceApplication: opcijas [UIApplicationOpenURLOptionsSourceApplicationKey]]; } @beigas

Rīkojieties ar pieteikšanās pogu un iegūstiet Profile Dati

Šajā sadaļā ir paskaidrots, kā izsaukt autorizāciju: withHandler: API, lai pieteiktos lietotājam. Tas ietver onLoginButtonClicked: klausītāja izveidi savai Login with Amazon pogai.

1. Pievienojiet pieteikšanos ar Amazon savam iOS projektam. Skat Instalējiet pieteikšanās ar Amazon bibliotēku.
2. Importējiet pieteikšanās ar Amazon API savā avotā file.
   Lai importētu pieteikšanos ar Amazon API, pievienojiet šo #importa paziņojumi savam avotam file:

   #import

3. Zvaniet autorizēt: withHandler: iekšā onLoginButtonClicked. Ja esat izpildījis darbības, kas norādītas sadaļā Pieteikšanās pieteikšanās ar Amazon pogu savai lietotnei, jums vajadzētu būt onLoginButtonClicked: metode saistīts ar pogu Pieteikties ar Amazon. Izmantojot šo metodi, zvaniet autorizēt: withHandler: aicināt lietotāju pieteikties un autorizēt jūsu lietojumprogrammu.

Šī metode ļaus lietotājam pierakstīties un piekrist pieprasītajai informācijai vienā no šiem veidiem:

1. Pārslēdzas uz web view drošā kontekstā (ja ierīcē ir instalēta lietotne Amazon Shopping)
2. Pārslēdzas uz Safari View Kontrolieris (operētājsistēmā iOS 9 un jaunākās versijās)
3. Pārslēdzas uz sistēmas pārlūku (operētājsistēmā iOS 8 un vecākām)
   Pirmās opcijas drošais konteksts ir pieejams, kad ierīcē ir instalēta lietotne Amazon Shopping. Ja lietotājs jau ir pierakstījies Amazon Shopping lietotnē, šī API izlaidīs pierakstīšanās lapu, kā rezultātā tiks izveidots Single Pierakstīšanās (SSO) pieredze. Skatiet klientu pieredzi [PDF], lai uzzinātu vairāk.
   Pirmais parametrs autorizēt: withHandler: ir AMZNAautorizeRequest objekts, kas norāda, kādai jomai jūsu lietojumprogramma pieprasa autorizāciju. A darbības jomu ietver tos lietotāja datus, kurus pieprasāt no Login with Amazon. Pirmo reizi, kad lietotājs piesakās jūsu lietotnē, viņam tiks parādīts to datu saraksts, kurus pieprasāt un kuriem lūdzat apstiprinājumu.
   Pieteikšanās ar Amazon pašlaik atbalsta šādus tvērumus:

   Darbības jomas nosaukums	Apraksts
   profile	Piešķir piekļuvi lietotāja vārdam, e-pasta adresei un Amazon konta ID.
   profile:Lietotāja ID	Piešķir piekļuvi tikai lietotāja Amazon konta ID.
   pasta indekss	Piešķir piekļuvi lietotāja pasta indeksam file viņu Amazon kontam.

   Izmantojiet metodes, kas definētas AMZNProfileDarbības joma lai iegūtu darbības objektu un pievienotu to savam AMZNAautorizeRequest objekts. Skatiet sampsīkāku informāciju skatiet zemāk.
   Otrais parametrs, ar kuru autorizēt: withHandler: ir AMZNAuthorizationRequestHandler, kas aprakstīts nākamajā solī.

4. Izveidojiet an AMZNAautorizācijas pieprasījumu apstrādātājs bloķēt objektu. AMZNAautorizācijas pieprasījumu apstrādātājs apstrādā autorizēt: withHandler: zvans. Lai uzzinātu vairāk par mērķa-c blokiem, skatiet Darbs ar blokiem vietnē developer.apple.com.
   Pirmais parametrs AMZNAautorizācijas pieprasījumu apstrādātājs ir an AMZNAuthorizeResult objekts. Kad lietotājs ir veiksmīgi autorizēts, AMZNAuthorizeResult satur piekļuves pilnvaru, ko var izmantot, lai piekļūtu lietotāja profesionālimfile dati, un an AMZNUser objekts, kas satur lietotāja profile dati. Otrais parametrs AMZNAautorizācijas pieprasījumu apstrādātājs ir Būla nosaukums userDidcancel. Šis parametrs tiks iestatīts uz true, ja lietotājs:
   1. Aizver Safari View Kontrolieris pieteikšanās un autorizācijas laikā (operētājsistēmā iOS 9 un jaunākās versijās)
   2. Aizver web view lietotnē Amazon Shopping
   3. Anulē pieteikšanos vai noraida autorizāciju
   Trešais parametrs AMZNAautorizācijas pieprasījumu apstrādātājs ir an NSEerror objekts, kurā ir informācija par kļūdu, ja pieteikšanās un autorizācija neizdodas SDK vai autorizācijas servera dēļ.

   - (IBAction) onLogInButtonClicked: (id) sūtītājs { // Izveidojiet autorizācijas pieprasījumu. AMZNAuthorizeRequest * pieprasījums = [[AMZNAuthorizeRequest piešķirt] init]; request.scopes = [NSArray masīvsWithObjects: // [AMZNProfileDarbības joma userID], [AMZNProfileDarbības joma profile], [AMZNProfileDarbības joma postalCode]]; // Veikt autorizācijas zvanu uz pieteikšanos, izmantojot Amazon SDK. [[AMZNAuthorizationManager sharedManager] autorizēt: pieprasījums withHandler: ^ (AMZNAuthorizeResult * rezultāts, BOOL userDidCancel, NSError * kļūda) { if (kļūda) { // Apstrādājiet kļūdas no SDK vai autorizācijas servera. } cits, ja (userDidCancel) { // Apstrādājiet kļūdas, kas radušās, kad lietotājs atceļ pieteikšanos. } cits { // Autentifikācija bija veiksmīga. // Iegūstiet piekļuves pilnvaru un user profile datus. NSString * accessToken = result.token; AMZNUser * lietotājs = result.user; NSString * userID = user.userID; } }]; }

Ielādēt User Profile Dati

Kamēr lietotājs ir pieteicies un autorizējies jūsu lietotnē, varat izgūt viņa lietotāja profilufile datus jebkurā laikā.
Šajā sadaļā ir paskaidrots, kā lietot atnest: metode AMZNUser klasē, lai iegūtu visjaunāko lietotāja profesionālifile dati par lietotājiem, kuri pašlaik ir pilnvaroti. Profesionālisfile dati, kurus varat izgūt, ir balstīti uz darbības jomu, kas norādīta sadaļā pilnvarot zvanu.

1. Zvaniet AMZNUser ienest:.
   Šī metode iegūs profile datus, izmantojot AMZNUserFetchRequestHandler bloķēt objektu. Pirmais parametrs AMZNUserRequestHandler ir an AMZNUser objektu. The AMZNUser objekts var ietvert a Lietotāja ID, vārds, e-pasts un pasta indekss, atkarībā no pieprasītās darbības jomas.

   [AMZNUser ielādēt: ^ (AMZNUser * lietotājs, NSError * kļūda) { if (kļūda) { // Kļūda no SDK vai neviens lietotājs nav pilnvarojis lietotni. } cits, ja (lietotājs) { NSString * userID = user.userID; // NSString * name = user.name; // NSString * email = user.email; // NSString * postalCode = user.postalCode; } }];

Startēšanas laikā pārbaudiet lietotāja pieteikšanos

Ja lietotājs piesakās jūsu lietotnē, aizver lietotni un vēlāk restartē lietotni, tā joprojām ir pilnvarota izgūt datus. Lietotājs netiek automātiski izrakstīts. Startējot, varat parādīt lietotājam pieteicies, ja jūsu lietotne joprojām ir autorizēta. Šajā sadaļā ir paskaidrots, kā to izmantot autorizēt: withHandler: lai redzētu, vai lietotne joprojām ir autorizēta.

1. Izveidojiet an AMZNAautorizeRequest objektu un norādiet darbības jomas, kas norāda tos lietotāja datus, kuru lietojumprogramma pieprasa autorizāciju. Plašāku informāciju par darbības jomām sk Rīkojieties ar Pieteikšanās poga un Get Profile Dati.
2. Iestatīt AMZNAautorizeRequest.interaktīvā stratēģija uz AMZNIinteractiveStrategyNekad. AMZNAautorizeRequest atbalsta vairākas stratēģijas, lai mudinātu lietotāju pieteikties:

• AMZNIinteractiveStrategyAuto (noklusējums): SDK meklē lokāli saglabātu autorizācijas piešķīrumu no iepriekšējā autorizēt: withHandler: atbildes. Ja tāds ir pieejams, derīgs un satur visus pieprasītos tvērumus, SDK atgriezīs veiksmīgu atbildi, izmantojot AMZNAautorizācijas pieprasījumu apstrādātājs, un neliks lietotājam pieteikties. Pretējā gadījumā lietotājam tiks piedāvāts pieteikties.
• AMZNInteractiveStrategyAway: SDK vienmēr liks lietotājam pieteikties neatkarīgi no tā, vai viņš iepriekš ir pilnvarots lietot lietotni. Kad lietotājam tiek parādīts uzaicinājums, SDK noņems visus lokāli kešatmiņā saglabātos lietotnes autorizācijas piešķīrumus.
• AMZNIinteractiveStrategyNekad: SDK meklē lokāli saglabātu autorizācijas piešķīrumu no iepriekšējā autorizēt: withHandler atbildes. Ja tāds ir pieejams, derīgs un satur visus pieprasītos tvērumus, SDK atgriezīs vērtību AMZNAuthorizeResult objekts, kas satur piekļuves pilnvaru un user profile datus.
  Pretējā gadījumā tas atgriezīs NSEerror objekts caur AMZNAautorizācijas pieprasījumu apstrādātājs.

  // Izveidojiet autorizācijas pieprasījumu. AMZNAuthorizeRequest * pieprasījums = [[AMZNAuthorizeRequest piešķirt] init]; request.scopes = [NSArray masīvsWithObjects: // [AMZNProfileDarbības joma userID], [AMZNProfileDarbības joma profile], [AMZNProfileDarbības joma postalCode]]; request.interactiveStrategy = AMZNInteractiveStrategyNever; [[AMZNAuthorizationManager sharedManager] autorizēt: pieprasījums withHandler: ^ (AMZNAuthorizeResult * rezultāts, BOOL userDidCancel, NSError * kļūda) { if (kļūda) { // Kļūda no SDK, norādot, ka lietotājs iepriekš nebija jūsu lietotnei ir pilnvarots pieprasītajiem darbības jomām. } cits { // Lietotājs iepriekš bija pilnvarots izmantot jūsu lietotni. // Iegūstiet piekļuves pilnvaru un user profile datus. NSString * accessToken = result.token; AMZNUser * lietotājs = result.user; NSString * userID = user.userID; } }];

Notīriet autorizācijas datus un izrakstieties no lietotāja

Šajā sadaļā ir paskaidrots, kā lietot izrakstīties metode, kā notīrīt lietotāja autorizācijas datus no abiem AIMobileLib vietējo datu krātuvi un autorizācijas serveri. Lai lietotne varētu ielādēt pro, lietotājam būs jāpiesakās vēlreizfile dati. Izmantojiet šo metodi, lai izrakstītos no lietotāja vai novērstu pieteikšanās problēmas lietotnē.

1. Ieviesiet atteikšanās mehānismu.
   Kad lietotājs ir veiksmīgi pieteicies, jums jānodrošina atteikšanās mehānisms, lai viņš varētu notīrīt savu profesionālifile datus un iepriekš atļautās darbības jomas. Jūsu mehānisms var būt hipersaite, poga vai izvēlnes vienums.
2. Zvaniet izrakstīties:.
   Zvaniet izrakstīties: savā izrakstīšanās apstrādātājā, lai noņemtu lietotāja autorizācijas datus (piekļuves pilnvaras, profile) no vietējā veikala un to autentifikācijas stāvokli no servera. Ievades parametrs līdz izrakstīties ir an AMZNAautorizācijas pieprasījumu apstrādātājs bloķēt objektu. Blokam vajadzētu atklāt un rīkoties NSEerror objekti, kurus atdod, kad izrakstīties: neizdodas.

   [[AMZNAuthorizationManager sharedManager] signOut: ^ (NSError * _Nullable kļūda) { ja (! kļūda) { // kļūda no SDK vai Piesakieties ar Amazon autorizācijas serveri. } }];

Pārbaudiet savu integrāciju

Palaidiet savu lietotni iOS ierīcē vai simulatorā un apstipriniet, ka varat pieteikties, izmantojot savus Amazon.com akreditācijas datus.

Piezīme: Testējot iOS10 simulatoros, iespējams, redzēsit kļūdas ziņojumu APIKey lietojumprogrammai nav derīgs priekš an AuthorizeUserForScopes  pieprasījums vai nezināms kļūdas kods clearAuthorizationState pieprasījumu. Tas ir zināma kļūda ar Apple kas notiek, kad SDK mēģina piekļūt atslēgu ķēdei. Kamēr Apple nav novērsis kļūdu, varat to novērst, iespējojot Atslēgu piekariņu koplietošana savai lietotnei zem Iespējas jūsu lietotnes mērķa cilni. Šī kļūda ietekmē tikai simulatorus. Varat testēt ar faktiskām iOS10 ierīcēm, neizmantojot nekādu risinājumu.

 

Pieteikšanās ar Amazon darba sākšanas rokasgrāmatu iOS lietotnēm - Lejupielādēt [optimizēts]
Pieteikšanās ar Amazon darba sākšanas rokasgrāmatu iOS lietotnēm - Lejupielādēt

Atsauces

• Lietotāja rokasgrāmata