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

 

Piesakieties ar Amazon: Darba sākšanas rokasgrāmata iOS

Autortiesības © 2016 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.

Darba sākšana operētājsistēmai iOS

Šajā ceļvedī mēs parādīsim, kā pievienot pieteikšanos ar Amazon savai iOS lietotnei. Pēc šīs rokasgrāmatas pabeigšanas jūsu lietotnē vajadzētu būt darbojošai pogai Pieteikties ar Amazon, lai lietotāji varētu pieteikties, izmantojot savus Amazon akreditācijas datus

Xcode instalēšana

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 vietnē 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 a Pieteikties ar Amazon.framework direktorijā. Tajā ir bibliotēka Login with Amazon.
   Rāvējslēdzēja augšējā līmenī ir a Pieteikties ar Amazon.doc iestatīt direktoriju. Tajā ir API dokumentācija.
2. Skat Instalējiet pieteikšanās ar Amazon bibliotēku instrukcijas 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 Reģistrēšanās ar Login ar 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/ Pieteikties ar AmazonSample.xcodeproj. Noklikšķiniet Atvērt.
4. SampTagad projektam vajadzētu ielādēties. Kad tas ir pabeigts, izvēlieties Produkts galvenajā izvēlnē un atlasiet Skrien

Reģistrēšanās ar Login ar 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 pieteikšanos, izmantojot Amazon lietojumprogrammu, un pievienot šim kontam iOS lietotni.

Skatiet šīs tēmas

• Reģistrējiet savu pieteikšanos ar Amazon lietojumprogrammu
• Pievienojiet iOS lietotni Security Profile
• iOS komplekta ID un API atslēgas
  o Nosakiet iOS lietotnes komplekta identifikatoru
  o Ielādējiet iOS API atslēgu

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 vārdu 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.
   b. Ievadiet konfidencialitātes paziņojumu 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 lietotājiem tiek parādīta piekrišanas ekrānā.
   c. Ja vēlaties pievienot a Logotipa attēls savam pieteikumam noklikšķiniet uz Pārlūkot 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. Logotips tiks samazināts līdz 50 pikseļiem, ja tas būs garāks par 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. No iOS iestatījumi savā lietotnē noklikšķiniet uz Pievienot API atslēgu pogu, lai savai lietotnei izveidotu papildu atslēgas (pa vienai versijai).

Pievienojiet iOS lietotni Security Profile

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.

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. Lietojumprogrammas ekrānā noklikšķiniet uz iOS iestatījumi. Ja jums jau ir reģistrēta iOS lietotne, meklējiet Pievienot API atslēgu pogu iOS iestatījumi sadaļā.
   The iOS lietojumprogramma Parādīsies detalizētas informācijas veidlapa:
   
2. Ievadiet Etiķete jūsu iOS lietotnē. 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) Projekta navigators. Komplekta identifikators ir viens no saraksta rekvizītiem.
4. Noklikšķiniet Saglabāt.

iOS komplekta ID un API atslēgas

Komplekta identifikators ir unikāls katrai iOS lietotnei. Pieteikšanās ar Amazon izmanto Bundle ID, lai izveidotu 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 savu lietotnes projektu Xcode.
2. Atveriet Informācija Īpašumu 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. sadaļā Lietotnes noklikšķiniet uz savas lietojumprogrammas.
4. Atrodiet savu iOS lietotni zem iOS iestatījumi sadaļā. Ja vēl neesat reģistrējis iOS lietotni, skatiet Pievienojiet iOS lietotni Security Profile.
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. Skat Pievienojiet API atslēgu lietotnes īpašumu sarakstam instrukcijas par API atslēgas pievienošanu iOS lietotnei

Pieteikšanās izveide ar Amazon projektu

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

Skatiet šādas tēmas:

• Izveidojiet jaunu pieteikšanos ar Amazon projektu
• Instalējiet pieteikšanās ar Amazon bibliotēku
• Pievienojiet API atslēgu lietotnes īpašumu sarakstam
• Pievienojiet a URL Shēma jūsu lietotņu īpašumu sarakstam
• Pievienojiet savai lietotnei Amazon transporta drošības izņēmumu Amazon Īpašumu saraksts
  PIEZĪME: Šis jaunais solis pašlaik ir nepieciešams, izstrādājot iOS 9 SDK
• Pievienojiet lietotnei pieteikumvārdu ar Amazon pogu

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 zemāk esošo sadaļu Instalēt pieteikšanos ar Amazon bibliotēku.

1. Palaist Xcode.
2. Ja jums tiek parādīts a Laipni lūdzam Xcode dialoglodziņā atlasiet Izveidojiet jaunu Xcode projektu.
   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 Pakas identifikatorsun 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. Kad jūsu projekts ir atvērts Xcode, atlasiet Ietvari noklikšķiniet uz File galvenajā izvēlnē un pēc tam atlasiet Pievienot Files uz “Projekts”.
2. Dialoglodziņā atlasiet Pieteikties ar Amazon.framework un noklikšķiniet uz Pievienot.
   Ja izmantojāt bibliotēku Login with Amazon 1.0, mapē Frameworks izdzēsiet login-with-amazon sdk direktoriju un login-with-amazon-sdk.a. Klikšķis Rediģēt galvenajā izvēlnē un atlasiet Dzēst.
3. Sadaļā atlasiet sava projekta nosaukumu Projekta navigators.
   The Projekta redaktors parādīsies Xcode darbvietas redaktora apgabalā.
4. Noklikšķiniet uz sava projekta nosaukuma zem Mērķi, un atlasiet Veidošanas fāzes. Izvērsiet saiti Binary with Libraries un noklikšķiniet uz pluszīmes, lai pievienotu bibliotēku.
5. Meklēšanas lodziņā ievadiet Drošība.rāmis. Izvēlieties Security.framework un noklikšķiniet Pievienot.
6. Meklēšanas lodziņā ievadiet SafariServices.framework. Izvēlieties SafariServices.framework un noklikšķiniet Pievienot.
7. Meklēšanas lodziņā ievadiet CoreGraphics.framework. Izvēlieties CoreGraphics.framework un noklikšķiniet Pievienot
8. Izvēlieties Būvējuma iestatījumi. Noklikšķiniet uz Visas view visi iestatījumi.
9. Zem Meklēt ceļus, pārliecinieties, ka Pieteikties ar Amazon.framework direktorija atrodas Ietvara meklēšanas ceļi.
   Piemēram,ample:
   
   Ja izmantojāt bibliotēku Login with Amazon 1.0, varat noņemt visas atsauces uz 1.0 bibliotēkas ceļu Galvenes meklēšanas ceļi or Bibliotēkas meklēšanas ceļi.
10. Galvenajā izvēlnē noklikšķiniet uz Produkts un atlasiet Veidot. Veidošana būtu jāpabeidz veiksmīgi.
    Pirms projekta izveidošanas, ja izmantojāt bibliotēku Login with Amazon 1.0, nomainiet #importēt “AIMobileLib.h”, #importēt “AIAuthenticationDelegate.h”, or #importēt “AIERror.h” savā avotā files ar #importēt
    .
    Pieteikties ar Amazon.h ietver visas pieteikšanās ar Amazon galvenēm uzreiz.

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 API Key rekvizīta vērtības jūsu lietojumprogrammas informācijas rekvizītu 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 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 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 kolonnas Vērtība, lai pievienotu vērtību. Vērtība ir jūsu kopas ID. Īpašumu sarakstā varat atrast savu kopas ID kā paketes identifikatoru.
5. Izvēlieties 0. punkts zem URL veidi un galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet vai atlasiet URL Shēmas un nospiediet taustiņu Enter.
6. Izvēlieties 0. punkts zem URL Shēmas un veiciet dubultklikšķi zem Vērtība kolonnā, lai pievienotu a 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 savai lietotnei Amazon transporta drošības izņēmumu Amazon
Īpašumu saraksts

Sākot ar iOS 9, Apple ievieš lietotņu transporta drošību (ATS), lai nodrošinātu drošus savienojumus starp lietotni un web pakalpojumus. Galapunkts (api.amazon.com), kurā pieteikšanās ar Amazon SDK mijiedarbojas, lai apmainītos ar informāciju, vēl neatbilst ATS. Pievienojiet api.amazon.com izņēmumu, lai nodrošinātu nevainojamu saziņu starp SDK un Amazon serveri.

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 īpašumu sarakstu, kas paredzēts:
   
2. Pārliecinieties, ka neviens no ierakstiem nav. Pēc tam galvenajā izvēlnē noklikšķiniet uz Redaktors, un Pievienot vienumu. Ievadiet vai atlasiet NSAppTransportSecurity un nospiediet Ievadiet.
3. Izvērst NSAppTransportSecurity un galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet vai atlasiet NSExceptionDomains un nospiediet Ievadiet.
4. Izvērst NSExceptionDomains un galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu. Ievadiet amazon.com un nospiediet Ievadiet.
5. Izvērst amazon.com un galvenajā izvēlnē noklikšķiniet uz Redaktors un Pievienot vienumu.Ievadiet NSExceptionRequiresForwardSecrecy un nospiediet Ievadiet.
6. Izvēlieties NSExceptionRequiresForwardSecrecy un veiciet dubultklikšķi zem Vērtība kolonnu, lai pievienotu atlasi a Tips of Būla un a Vērtība of NĒ.

Pievienojiet lietotnei pieteikumvārdu ar Amazon pogu

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ļā ir norādītas darbības, kā lejupielādēt oficiālu pieteikšanos ar Amazon attēlu un savienot to pārī ar iOS UIB taustiņu.

1. Pievienojiet savai lietotnei standarta UIB taustiņu.
   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 Radīšana un Konfigurēšana View Objekti un Sāciet izstrādāt iOS lietotnes jau šodien Apple.com dokumentos ir pogas notikuma pievienošanas darbības.
3. Izvēlieties pogas attēlu.
   Konsultējieties ar mūsu Pieteikšanās ar Amazon Stila vadlīnijas pogām, kuras varat izmantot savā lietotnē. Lejupielādējiet LWA_for_iOS.zip 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 atlasiet Pievienot Files uz “projektu”.
   b. Dialoglodziņā atlasiet pogas attēlu file(s), ko lejupielādējāt un noklikšķiniet Pievienot.
   c. Pogām tagad jābūt projektā, kas atrodas jūsu projekta direktorijā. Pārvietojiet tos uz atbalstu Filemape.
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 Kontrolieris Ainas koks.
   c. In Komunālie pakalpojumi logs, atveriet Atribūtu inspektors.
   
   d. Atribūtu inspektora augšdaļā iestatiet pogas veidu Sistēma.
   e. Otrajā iestatījumu grupā valsts konfigurācijai atlasiet Noklusējums.
   f. Otrajā iestatījumu grupā nolaižamo iestatījumu Attēls.
   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. Iestatījumam Fons iestatiet to pašu attēlu.
   i. Ja vēlaties norādīt nospiestu pogas versiju, izvēlieties State Config (Atlasīts) un iestatiet Attēla vērtību uz pogas _Nospiediet versiju.
   j. Veidošanas grafikā pielāgojiet pogas lielumu, lai tas būtu piemērots attēlam, ja nepieciešams.

SDK izmantošana iOS API

Šajā sadaļā jūs savam projektam pievienosiet kodu, lai pierakstītos lietotājā ar Login with Amazon.
Skatiet šādas tēmas:

• Rīkojieties ar pieteikšanās pogu un iegūstiet Profile Dati
• Startēšanas laikā pārbaudiet lietotāja pieteikšanos
• Notīriet autorizācijas stāvokli un izrakstieties no lietotāja

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

Šajā sadaļā ir paskaidrots, kā piezvanīt authorizeUserForScopes: deleģēt: un getProfile: API lai pieteiktos lietotājā un izgūtu viņa profesionālifile dati. Tas ietver izveidi onLoginButtonClicked: klausītājs jūsu pogai Pieteikties ar Amazon.

1. Pievienojiet pieteikšanos ar Amazon savam iOS projektam. Skatiet sadaļu Instalēt pieteikšanos 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. Izveidojiet AMZNAuthorizeUserDelegateclass īstenot
   AIAautenticationDelegate.
   Kad authorizeUserForScopes: deleģēt: pabeigs, tas izsauks requestDidSucceed: or requestDidFail: metode objektam, kas īsteno AIAautenticationDelegate protokols.

   @ interfeiss AMZNAuthorizeUserDelegate: NSObject @ end

   Plašāku informāciju skatiet Darbs ar protokoliem  vietnē developer.apple.com.

4. Zvaniet authorizeUserForScopes: deleģēt: in onLoginButtonClicked.
   Ja izpildījāt Pievienojiet lietotnei pieteikumvārdu ar Amazon pogu, jums vajadzētu būt onLoginButtonClicked: metode saistīts ar pogu Pieteikties ar Amazon. Izmantojot šo metodi, zvaniet autorizeUserForScopes: deleģēt: uz aiciniet 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 lietotnē Amazon Shopping, pierakstīšanās lapa tiek izlaista, novedot pie Vienotā pierakstīšanās (SSO) pieredze.

   Kad jūsu lietojumprogramma ir autorizēta, tā ir pilnvarota vienai vai vairākām datu kopām, kas pazīstamas kā darbības jomas. Pirmais parametrs ir darbības jomu masīvs, kas 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 trīs jomas: profile, kurā ir lietotāja vārds, e-pasta adrese un Amazon konta ID; profile:Lietotāja ID, kurā ir tikai Amazon konta ID; un Pasta indekss, kurā ir lietotāja pasta indekss.
   Otrais parametrs authorizeUserForScopes: deleģēt: ir objekts, kas īsteno AIAautentifikācijaDelegateprotokol, šajā gadījumā AMZNAathorizeUserDelegate klasē.

   - (IBAction) onLogInButtonClicked: (id) sūtītājs { // Veiciet autorizācijas zvanu SDK, lai iegūtu drošas piekļuves pilnvaru // lietotājam. // Veicot pirmo zvanu, varat norādīt minimālo pamata līmeni // vajadzīgas darbības jomas. // Pieprasot pašreizējam lietotājam abas darbības jomas. NSArray * requestScopes = [NSArray masīvsWithObjects:@”profile”, @” Postal_code ”, nulle]; AMZNAuthorizeUserDelegate * delegate = [[AMZNAuthorizeUserDelegate piešķirt] initWithParentController: self]; [AIMobileLib authorizeUserForScopes: requestScopes deleģēt: deleģēt];

   Pievienojiet sava delegāta ieviešanas galveni klases izsaukumam
   AuthorizeUserForScopes :. Piemēram,ample:

   #importēt “AMZNAuthorizeUserDelegate.h”

5. Izveidojiet an AMZNGetProfileDeleģēt.
   AMZNGetProfileDelegāts mūsu nosaukums klasei, kas īsteno
   AIAautentifikācijaDelegateprotokol, un apstrādās getProfile: zvanu. Patīk AuthorizeUserForScopes: delegate :, getProfile: atbalsta requestDidSucceed: un requestDidFail: protokola metodes. requestDidSucceed: saņem APIRrezultāts objekts ar profile dati rezultāta īpašumā. requestDidFail: saņem AIEkļūda objekts ar informāciju par kļūdu rekvizītā.
   Lai izveidotu delegātu klasi no parastas klases deklarācijas, importējiet
   AIAuthenticationDelegate.hand pievienojiet protokolu deklarācijai savā klases galvenē file:

   #importēt @interfeiss AMZNGetProfileDelegāts: NSObject @end

    

6. Īstenot requestDidSucceed: par jūsu AMZNAathorizeUserDelegate. In requestDidSucceed :, zvanu getProfile: lai izgūtu klientu profile. getProfile:, patīk autorizeUserForScopes: delegate:, izmanto protokolu AIAuthenticationDelegate.
   

   - (void) requestDidSucceed: (APIResult *) apiResult { // Jūsu kods pēc tam, kad lietotājs ir autorizējis pieteikumu // pieprasītās darbības jomas. // Ielādēt jaunu view kontrolieris ar lietotāja identifikācijas informāciju // jo lietotājs tagad ir veiksmīgi pieteicies. AMZNGetProfileDeleģēt* deleģēt = [[[AMZNGetProfileDeleģēt alloc] initWithParentController:parentViewKontrolieris] autorelease]; [AIMobileLib getProfile: delegāts]; }

   Pievienojiet sava delegāta ieviešanas galveni klases izsaukumam getProfile:. Forexample:
   

   #importēt “AMZNGetProfileDeleģēt.h ”

7. Īstenot requestDidSucceed: par jūsu AMZNGetProfileDeleģēt.
   requestDidSucceed: ir divi galvenie uzdevumi: iegūt profile dati no APIRrezultāts, un nodot datus UI.
   Lai ielādētu profesionālifile dati no APIRrezultāts, piekļūt rezultāta īpašumam. Priekš getProfile: atbilde, šajā īpašumā būs lietotāja pro īpašumu vērtību vārdnīcafile īpašības. Profesionālisfile īpašības ir vārds, e-pasts, un user_id par profile tvērums un
   pasta indekss priekš pasta indekss darbības jomu.

   - (void) requestDidSucceed: (APIResult *) apiResult { // Iegūstiet profile pieprasījums izdevās. Izsaiņojiet profesionālifile informāciju // un nodod to vecākiem view kontrolieris NSString * nosaukums = [(NSDictionary *) apiResult.result objectForKey: @ ”nosaukums”]; NSString * e-pasts = [(NSDictionary *) apiResult.result objectForKey: @ ”e-pasts”]; NSString * user_id = [(NSDictionary *) apiResult.result objectForKey: @ ”user_id”]; NSString * postal_code = [(NSDictionary *) apiResult.result objectForKey: @ ”postal_code”]; // Pārsūtīt datus uz view kontrolieris }

8. Īstenot requestDidFail: par jūsu AMZNGetProfileDeleģēt.
   requestDidFail: ietver an API kļūda objekts, kurā ir informācija par kļūdu. showLogInPageis hipotētiska metode, kas atiestatītu galveno view kontrolieris, lai parādītu pogu Pieteikties ar Amazon.

   - (void) requestDidFail: (APIError *) errorResponse { // Iegūstiet Profile profesionāļa pieprasījums neizdevāsfile darbības jomu. // Ja kļūdas kods = kAIApplicationNotAuthorized, // ļauj lietotājam vēlreiz pieteikties. if (errorResponse.error.code == kAIApplicationNotAuthorized) { // Rādīt lietotāja autorizācijas pogu. [vecāksViewKontrolieris showLogInPage]; } else { // Rīkoties ar citām kļūdām [[[[UIAbrīdinājumsView alloc] initWithTitle:@”” ziņojums: [NSString stringWithFormat: @ ”Kļūda ar ziņojumu:% @”, errorResponse.error.message] deleģēt: nulle cancelButtonTitle: @ ”OK” otherButtonTitles: nulle] autorelease] rādīt]; } }

9. Īstenot requestDidFail: par jūsu AMZNAathorizeUserDelegate.
   

   - (void) requestDidFail: (APIError *) errorResponse { NSString * ziņojums = errorResponse.error.message; // Jūsu kods, kad autorizācija neizdodas. [[[[UIAlertView alloc] initWithTitle:@”” ziņojums: [NSString stringWithFormat: @ ”Lietotāja autorizācija neizdevās ar ziņojumu:% @”, errorResponse.error.message] deleģēt: nulle cancelButtonTitle: @ ”OK” otherButtonTitles: nulle] autorelease] rādīt]; }

   10. Īstenot pieteikums: atvērtsURL: sourceApplication: anotācija: savā projekta klasē, kas nodarbojas ar UIApplicationDelegate protokols (pēc noklusējuma tas būs AppDelegateclass jūsu projektā). Kad lietotne parāda Amazon pieteikšanās lapu un lietotājs pabeidz pieteikšanos, tā novirzīs uz lietotni, izmantojot URL Shēmojiet lietotni, kas reģistrēta agrāk. Šī novirzīšana tiek nodota lietotājam pieteikums: atvērtsURL: sourceApplication: anotācija :, kas atgriežas JĀ ja URL tika veiksmīgi apstrādāts. rokturiAtvērtURL: avotsPieteikums: ir SDK bibliotēkas funkcija, kas apstrādās pieteikšanos ar Amazon novirzīšanu URLs jums. Ja rokturiAtvērtURL: sourceApplication: atgriež YES, tad URL tika apstrādāts.

   - (BOOL) lietojumprogramma: (UIApplication *) lietojumprogramma atvērtsURL: (NSURL *)url sourceApplication: (NSString *) sourceApplication anotācija: (id) anotācija { // nodot tālāk url SDK, lai parsētu autorizācijas kodu // no url. BOOL irValidRedirectSignInURL = [AIMobileLib handOpenURL:url sourceAppliation: skābs ceApplicati ieslēgts); ja (! isValidRedirect Si gnlnURL) atgriezt NO; // Lietotne var vēlēties rīkoties e url atgriezties JĀ; }

   PIEZĪME: Šī metode ir novecojusi operētājsistēmā iOS 9, taču tā jāiekļauj projektā, lai uzturētu atbalstu lietotājiem vecākās platformās. Lai iegūtu vairāk informācijas par pieteikums: atvērtsURL: sourceApplication: anotācija :, skat UIApplicationDelegate protokola atsauce vietnē developer.apple.com.

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
getAccessTokenForScopes: withOverrideParams: deleģēt: lai redzētu, vai lietotne joprojām ir autorizēta.

1. Izveidojiet an AMZNGetAccessTokenDelegate klasē. AMZNGetAccessTokenDelegateimplements uz AIAautenticationDelegate protokolu un apstrādās protokola rezultātu
   getAccessTokenForScopes: withOverrideParams: deleģēt: zvanu. AIAautenticationDelegate satur divas metodes, requestDidSucceed: un requestDidFail :. requestDidSucceed: saņem APIRrezultāts objekts ar token datiem, kamēr requestDidFail: saņem API kļūda objekts ar informāciju par kļūdu.

   #import @interface AMZNGetAccessTokenDelegate: NSObject @beigas

   Pievienojiet sava delegāta ieviešanas galveni klases izsaukumam
   getAccessTokenForScopes: withOverrideParams: deleģēt :. Forexample:

   #import “AMZNGetAccessTokenDelegate.h”

2. Sākot lietotni, zvaniet
   getAccessTokenForScopes: withOverrideParams: deleģēt: lai redzētu, vai lietojumprogramma joprojām ir atļauta. getAccessTokenForScopes: withOverrideParams: deleģēt: izgūst neapstrādātu piekļuves pilnvaru, ko pieteikšanās ar Amazon izmanto, lai piekļūtu klientu profile. Ja metode izdodas, lietotne joprojām ir autorizēta un tiek zvanīts getProfile: vajadzētu gūt panākumus. getAccessTokenForScopes: withOverrideParams: deleģēt: izmanto AIAautenticationDelegate protokolu tādā pašā veidā kā authorizeUserForScopes: deleģēt :. Nosūtiet objektu, kas ievieš protokolu kā delegāta parametru.

   - (void) checkIsUserSignedIn { AMZNGetAccessTokenDelegate * delegate = [[[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorlease]; NSArray * requestScopes = [NSArray masīvsWithObjects:@”profile”, @” Postal_code ”, nulle]; [AIMobileLib getAccessTokenForScopes: requestScopes withOverrideParams: nil delegate: delegate]; }

3. Īstenot requestDidSucceed: uz jūsu AMZNGetAccessTokenDelegate. requestDidSucceed: ir viens uzdevums: piezvanīt getProfile:. Šis bijušaisampzvana getProfile: izmantojot to pašu klausītāju, kuru deklarējāt iepriekšējā sadaļā (skatiet 6. – 8. darbību).
   

   #importēt “AMZNGetProfileDeleģēt.h ” #import - (void) requestDidSucceed: (APIResult *) apiResult { // Šeit tiek ievadīts jūsu kods piekļuves marķiera izmantošanai. // Tā kā lietojumprogrammai ir autorizācija mūsu darbības jomām, mēs varam // iegūt lietotāja profile. AMZNGetProfileDeleģēt* delegātu = [[[AMZNGetProfileDeleģēt alloc] initWithParentController: vecāksViewKontrolieris] autorelease]; [AIMobileLib getProfile: delegāts]; }

4. Īstenot requestDidFail: uz jūsu AMZNGetAccessTokenDelegate.
   requestDidFail: ietver an API kļūda objekts, kas satur informāciju par kļūdu. Ja tiek parādīta kļūda, varat atiestatīt galveno view kontrolieris, lai parādītu pogu Pieteikties ar Amazon.

   - (void) requestDidFail: (APIError *) errorResponse { // Jūsu kods, lai apstrādātu piekļuves pilnvaras izgūšanu. // Ja kļūdas kods = kAIApplicationNotAuthorized, atļaujiet lietotājam // lai atkal pieteiktos. if (errorResponse.error.code == kAIApplicationNotAuthorized) { // Rādīt pieteikšanos ar Amazon pogu. } else { // Rīkoties ar citām kļūdām [[[[UIAbrīdinājumsView alloc] initWithTitle:@”” ziņojums: [NSString stringWithFormat: @ ”Kļūda ar ziņojumu:% @”, errorResponse.error.message] delegate: nil cancelButtonTitle:@”OK” otherButtonTitles:nil] autorlease] show]; } }

Notīrīt autorizācijas stāvokli un atteikties no lietotāja

The ClearAuthorizationState: metode izdzēsīs lietotāja autorizācijas datus no AIMobileLib vietējā datu krātuve. Lai lietotne varētu izgū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. Paziņojiet AMZNLogoutDelegate. Šī ir klase, kas īsteno
   AIAautentifikācijaDelegateprotokol. Mūsu vajadzībām mēs varam mantot klasi no NSObjekts:
   

   #import @interface AMZNLogoutDelegate NSObject @beigas

   Pievienojiet sava delegāta ieviešanas galveni klases izsaukumam clearAuthorizationState :. Piemēram,ample:

   #importēt “AMZNLogoutDelegate.h”

2. Zvaniet clearAuthorizationState :.
   Kad lietotājs ir veiksmīgi pieteicies, varat nodrošināt atteikšanās mehānismu, lai viņš varētu notīrīt savus autorizācijas datus. Jūsu mehānisms var būt hipersaite vai izvēlnes vienums, taču šajā gadījumā example izveidos a logoutButtonClicked metode atteikšanās pogai.

   - (IBAction) logoutButtonClicked: (id) sūtītājs { AMZNLogoutDelegate* delegate = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorlease]; [AIMobileLib clearAuthorizationState:delegate]; }

   Vienīgais parametrs clearAuthorizationState ir an AIAautenticationDelegate kas īsteno requestDidSucceed: un requestDidFail :.

3. Īstenot requestDidSucceed :. Šī metode tiks izsaukta, kad tiks notīrīta lietotāja informācija. Pēc tam jums tie jāparāda kā atteikušies.
   

   - (void) requestDidSucceed: (APIResult *) apiResult { // Jūsu papildu loģika pēc lietotāja autorizācijas // stāvoklis ir notīrīts. [[[UIAbrīdinājumsView alloc] initWithTitle:@”” message:@”Lietotājs ir izrakstījies.” delegate:nil cancelButtonTitle:@”OK” otherButtonTitles:nil] show]; }

4. Īstenot requestDidFail :. Šī metode tiks izsaukta, ja kāda iemesla dēļ lietotāja informāciju nevarēs notīrīt no kešatmiņas. Tādā gadījumā jums nevajadzētu tos parādīt kā pieteicušos.
   

   - (void) requestDidFail: (APIError *) errorResponse { // Jūsu papildu loģiku pēc SDK neizdevās notīrīt // autorizācijas stāvoklis. [[[[UIAlertView alloc] initWithTitle:@”” ziņojums: [NSString stringWithFormat: @ ”Lietotāja atteikšanās neizdevās ar ziņojumu:% @”, errorResponse.error.message] deleģēt: nulle cancelButtonTitle:@”OK” otherButtonTitles:nil] autorlease] show]; }

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 ar iOS10 simulatoriem, var tikt parādīts kļūdas ziņojums APIKey lietojumprogrammai nav derīgs autorizeUserForScopes pieprasījumam vai nezināms kļūdas kods clearAuthorizationState pieprasījumam. Tas ir zināma kļūda ar Apple kas notiek, kad SDK mēģina piekļūt atslēgu piekariņam. Līdz brīdim, kamēr Apple novērsīs kļūdu, varat to novērst, savas lietotnes mērķauditorijas cilnē Iespējas iespējojot savas lietotnes atslēgu piekariņu koplietošanu. Šī kļūda ietekmē tikai simulatorus. Varat pārbaudīt faktiskajās iOS10 ierīcēs, neizmantojot nekādu risinājumu.

Piesakieties ar Amazon Darba sākšanas rokasgrāmata iOS 2.1.2 versijai - Lejupielādēt [optimizēts]
Piesakieties ar Amazon Darba sākšanas rokasgrāmata iOS 2.1.2 versijai - Lejupielādēt

Atsauces

• Lietotāja rokasgrāmata