Amazon қолданбасына кіру iOS қосымшаларына арналған нұсқаулық

Amazon жүйесімен кіріңіз: iOS жұмысына кірісу нұсқаулығы
Авторлық құқық © 2017 Amazon.com, Inc. немесе оның филиалдары. Барлық құқықтар сақталған. Amazon және Amazon логотипі - Amazon.com, Inc. немесе оның филиалдарының сауда белгілері. Amazon-ға тиесілі емес барлық басқа сауда белгілері тиісті иелерінің меншігі болып табылады.

Кіріспе

Бұл нұсқаулықта iOS v3.0 + жүйесіне арналған Amazon SDK арқылы кіруді пайдаланып, iOS қосымшасына Amazon-мен кіруді қалай қосуға болатынын көрсетеміз.
Осы нұсқаулықты аяқтағаннан кейін қолданбада Amazon тіркелгі деректерімен кіруге мүмкіндік беретін Amazon-мен жұмыс істейтін Кіру түймесі болуы керек. Сіздің тұтынушыларыңыз сіздің логиніңізді Amazon-да сіздің қолданбаңызда пайдаланған кездегі кіру ағыны туралы көбірек білу үшін біздің сілтемені қараңыз Тұтынушы тәжірибесі Біттіview iOS қосымшалары үшін.

IOS Developer Tools бағдарламасын орнатыңыз

XCode орнатыңыз

IOS-қа арналған Amazon SDK жүйесімен кіруді Amazon компаниясы сіздің iOS қосымшаңызға Amazon арқылы кіруді қосуға көмектесу үшін ұсынады. SDK Xcode даму ортасымен бірге пайдалануға арналған. SDK iOS 7.0 жүйесінде жұмыс жасайтын және ARMv7, ARMv7s, ARM64, i386, andx86_64 қолданбаларын қолдайды.
Xcode-ді Mac App Store дүкенінен орнатуға болады. Қосымша ақпарат алу үшін қараңыз Xcode: жаңалықтар on developer.apple.com.
Xcode орнатылғаннан кейін сіз жасай аласыз IOS үшін Amazon SDK көмегімен кіруді орнатыңыз және S іске қосыңызample қосымшасы, төменде сипатталғандай.

IOS үшін Amazon SDK көмегімен кіруді орнатыңыз

iOS жүйесіне арналған Amazon SDK көмегімен кіру екі пакетте келеді. Біріншісі iOS кітапханасын және қосымша құжаттаманы қамтиды. Екіншісі ретінде барample қолданушыға кіруге мүмкіндік беретін және view олардың кәсіпқойларыfile деректер.

Егер сіз Xcode-ді әлі орнатпаған болсаңыз, ішіндегі нұсқауларды қараңыз Xcode орнатыңыз жоғарыдағы бөлім.

1. Жүктеп алу КіруAmazonSDKForiOS.zip және шығарып алыңыз files қатты дискідегі каталогқа өтеді.
   Сіз LoginWithAmazon.framework каталогын көруіңіз керек. Онда Amazon кітапханасымен кіру бар.
   Зиптің жоғарғы деңгейінде а КіруAmazon.docset анықтамалық. Мұнда API құжаттамасы бар.
2. Кітапхананы iOS жобасына қосу туралы нұсқаулық үшін Amazon Library with Login бағдарламасын орнату бөлімін қараңыз.
   IOS үшін Amazon SDK көмегімен кіру орнатылған кезде, сіз жасай аласыз Amazon Project көмегімен жаңа логин жасаңыз Сізден кейін Amazon-ге кіру арқылы тіркеліңіз.

S іске қосыңызample қосымшасы

S іске қосу үшінample қолданбасын ашыңызampXcode -де.

1. Жүктеп алу SampleLoginWithAmazonAppForiOS.zip және көшіріңіз
   SampleLoginWithAmazonAppForiOS Сіздің құжаттарыңыздың каталогы.
2. Xcode іске қосыңыз. Егер Xcode -ға қош келдіңіз диалогтық терезесі ашылса, Басқаларды ашу түймешігін басыңыз. Әйтпесе, негізгі мәзірден шертіңіз File және Ашу опциясын таңдаңыз.
3. Құжаттар қалтасын таңдап, таңдаңыз
   SampleLoginWithAmazonAppForiOS/LoginWithAmazonSampле/
   LoginWithAmazonSample.xcodeproj. басыңыз Ашық.
4. Sampжоба енді жүктелуі керек. Аяқтағаннан кейін таңдаңыз Өнім негізгі мәзірден таңдаңыз Жүгіру.

Amazon-ге кіру арқылы тіркеліңіз

Amazon арқылы кіруді қолданбас бұрын a webсайтында немесе мобильді қолданбада Amazon арқылы Login арқылы қолданбаны тіркеу керек. Amazon арқылы кіру қолданбасы бизнесіңіз туралы негізгі ақпаратты және әрқайсысы туралы ақпаратты қамтитын тіркеу болып табылады webAmazon арқылы кіруді қолдайтын сайт немесе сіз жасаған мобильді қолданба. Бұл бизнес ақпараты пайдаланушыларға Amazon арқылы кіру мүмкіндігін пайдаланған сайын көрсетіледі webсайт немесе мобильді қолданба. Пайдаланушылар қолданбаңыздың атын, логотипіңізді және құпиялылық саясатыңызға сілтемені көреді. Бұл қадамдар Amazon арқылы кіру арқылы пайдалану үшін iOS қолданбасын тіркеу жолын көрсетеді.

Кіруді Amazon қосымшасына тіркеңіз

1. өтіңіз https://login.amazon.com.
2. Егер сіз Amazon-ге кіруге бұрын тіркелген болсаңыз, нұқыңыз Қолданба консолі. Әйтпесе, басыңыз Тіркелу. Сіз Amazon-ге кіруге өтінімдерді тіркеуді жүзеге асыратын Орталық сатушыға бағытталасыз. Егер сіз Seller Central-ты бірінші рет қолдансаңыз, сізден Seller Central есептік жазбасын құру сұралады.
3. басыңыз Жаңа қолданбаны тіркеңіз. The Өтінішіңізді тіркеңіз форма пайда болады:
   
   a. Сіздің өтінім формаңызға тіркеліп, a енгізіңіз Аты және а Сипаттама Сіздің өтінішіңіз үшін. The Аты пайдаланушылар қолданбаңызбен ақпаратты бөлісуге келіскен кезде келісім экранында көрсетілетін атау. Бұл атау Android, iOS және webсіздің қосымшаның сайт нұсқалары.
   The Сипаттама Amazon қосымшаларымен кірудің әрқайсысын ажыратуға көмектеседі және пайдаланушыларға көрсетілмейді.
   b. А енгізіңіз Құпиялық туралы ескерту URL өтінішіңіз үшін.
   Құпиялылық туралы хабарлама URL бұл сіздің компанияңыздың немесе қосымшаның құпиялылық саясатының орналасқан жері (мысалыampле, http://www.example.com/privacy.html). Бұл сілтеме пайдаланушыларға келісім экранында көрсетіледі.
   c. қосқыңыз келсе, а Логотип кескіні қолданбаңыз үшін басыңыз таңдаңыз File және тиісті кескінді табыңыз.
   Бұл логотип сіздің бизнесіңізді көрсету үшін кіру және келісім экранында көрсетіледі webсайт.
   Логотиптің биіктігі 50 пиксельге дейін кішірейтіледі, егер ол 50 пиксельден жоғары болса; логотиптің еніне шектеу қойылмайды.
4. басыңыз Сақтау. Сіздің сampтіркеу келесіге ұқсас болуы керек:
   
   Негізгі қолданба параметрлері сақталғаннан кейін арнайы параметрлерді қосуға болады webAmazon тіркелгісімен осы кіруді пайдаланатын сайттар мен мобильді қосымшалар.
   Егер сіздің қосымшаңыздың әр түрлі нұсқаларында әртүрлі пакеттік идентификаторлар болса, мысалы, бір немесе бірнеше тестілеу нұсқалары және өндіріс нұсқасы үшін, әр нұсқа өзінің API кілтін қажет етеді. Қолданбаның iOS параметрлерінен Қосу түймесін басыңыз API кілті қосымшаңызға қосымша кілттер жасау үшін батырма (әр нұсқаға бір).

Қосымшаңызға iOS параметрлерін қосыңыз

Негізгі қолданба параметрлері сақталғаннан кейін арнайы параметрлерді қосуға болады webAmazon арқылы кіруді пайдаланатын сайттар мен мобильді қолданбалар.
IOS қосымшасын тіркеу үшін қолданба жобасы үшін Bundle идентификаторын көрсету керек. Amazon-мен кіру API кілтін жасау үшін бума идентификаторын қолданады. API кілті қолданбаңызға Amazon авторизациялау қызметімен кіруге рұқсат береді. Есептік жазбаңызға iOS қосымшасын қосу үшін келесі әрекеттерді орындаңыз:

1. бастап Қолданба экранды басыңыз iOS параметрлері. Егер сізде iOS қолданбасы тіркелген болса, іздеңіз API кілтін қосыңыз ішіндегі түйме iOS параметрлері бөлім.
   The iOS қосымшасы туралы мәліметтер форма пайда болады:
   
2. енгізіңіз Белгі сіздің iOS қосымшаңыз.
   Бұл қолданбаның ресми атауы болуы міндетті емес. Ол жай ғана қолданбалар арасында осы нақты iOS қолданбасын анықтайды webAmazon қосымшасымен кіруге тіркелген сайттар.
3. Өзіңізді енгізіңіз Топтама идентификаторы. Бұл сіздің iOS жобаңыздың байлам идентификаторына сәйкес келуі керек. Бума идентификаторын анықтау үшін жобаны Xcode-де ашыңыз. Жоба үшін қасиеттер тізімін ашыңыз (Ақпараттық тізім) ішінде Жоба Навигаторы. The Бума идентификаторы - тізімдегі қасиеттердің бірі.
4. басыңыз Сақтау.

Егер сіздің қолданбаңыздың әр түрлі нұсқаларында әр түрлі бума идентификаторлары болса, мысалы, бір немесе бірнеше тестілеу нұсқалары және өндіріс нұсқасы үшін, әр нұсқа өзінің API кілтін қажет етеді. Қолданбаңыздың iOS параметрлерінен қосымшаңызға қосымша кілттер жасау үшін API кілтін қосу түймесін басыңыз (нұсқаға біреуі).

iOS жиынтық идентификаторы және API кілттері

Бума идентификаторы әрбір iOS қосымшасына ғана тән. Амазонмен кіру құрастыру үшін Bundle идентификаторын қолданады
сіздің API кілтіңіз. API кілті сіздің қосымшаңызды тану үшін Amazon-мен авторизациялау қызметіне кіруге мүмкіндік береді.

IOS қосымшасы үшін бума идентификаторын анықтаңыз

1. Xcode-де қолданба жобаңызды ашыңыз.
2. ашыңыз Ақпараттық меншік Тізім жоба үшін (Ақпараттық тізім) ішінде Жобаның навигаторы.
3. Табыңыз Бума идентификаторы қасиеттер тізімінде.

IOS API кілтін шығарып алыңыз

Сіз iOS нұсқасын тіркеп, пакеттің идентификаторын ұсынғаннан кейін, API кілтін Amazon паролімен кіру үшін тіркеу бетінен алуға болады. Сізге API кілтін жобаңыздың меншік тізіміне енгізу қажет болады. Сіз жасамайынша, қолданбаға Amazon-мен авторизациялау қызметімен кіруге рұқсат етілмейді.

1. өтіңіз https://login.amazon.com.
2. басыңыз Қолданба консолі.
3. жылы Қолданбалар терезесінде қосымшаны басыңыз.
4. Ішінен iOS қосымшасын табыңыз iOS параметрлері бөлім.
   Егер сіз iOS қосымшасын әлі тіркемеген болсаңыз, қараңыз Бағдарламаға iOS параметрлерін қосыңыз.
5. басыңыз API кілт мәнін жасау. Қалқымалы терезеде сіздің API кілтіңіз көрсетіледі. Кілтті көшіру үшін нұқыңыз Барлығын таңдаңыз бүкіл кілтті таңдау үшін.
   Ескерту: API кілті мәні ішінара ол жасалған уақытқа негізделген. Осылайша, сіз тудыратын келесі API кілт мәндері бастапқыдан өзгеше болуы мүмкін. Сіз өзіңіздің қолданбаңызда осы API негізгі мәндерінің кез-келгенін пайдалана аласыз, себебі олардың барлығы жарамды.
6. IOS қосымшасына API кілтін қосу туралы нұсқауларды API кілтін қолданба сипаттамаларының тізіміне қосу бөлімінен қараңыз

Amazon Project көмегімен логин жасаңыз

Бұл бөлімде сіз Amazon-мен кіруге арналған жаңа Xcode жобасын құруды және жобаны конфигурациялауды үйренесіз.

Amazon Project көмегімен жаңа логин жасаңыз

Егер сізде Amazon-мен жүйеге кіруді қолданатын жоба жоқ болса, оны жасау үшін төмендегі нұсқауларды орындаңыз. Егер сізде бұрыннан бар қолданба болса, өтіңіз Кіруді Amazon кітапханасымен орнатыңыз төмендегі бөлім.

1. Іске қосу Xcode.
2. Егер сізге а Xcode-ге қош келдіңіз диалог терезесін таңдаңыз Жасау жаңа Xcode жобасы.
   Әйтпесе, File мәзірін таңдаңыз Жаңа және Жоба.
3. Жасағыңыз келетін жоба түрін таңдап, басыңыз Келесі.
4. А енгізіңіз Өнім атауы және а Компания идентификаторы. Сіздің назар аударыңыз Бума идентификаторы, және Келесі түймесін басыңыз.
5. Жобаңызды сақтайтын орынды таңдап, басыңыз Жасау.

Енді сізде Amazon-мен кіруге қоңырау шалуға болатын жаңа жоба болады.

Кіруді Amazon кітапханасымен орнатыңыз

Егер сіз iOS жүйесіне арналған Amazon SDK жүйесімен кіруді жүктеп алмаған болсаңыз, қараңыз IOS үшін Amazon SDK көмегімен кіруді орнатыңыз.

Amazon жобасымен кіру сілтемені байланыстыруы керек КіруAmazon.framework және Қауіпсіздік кітапханалар. Сондай-ақ, Amazon тақырыптарымен кіруді табу үшін кадр іздеу жолын конфигурациялау қажет.

1. Егер сіздің жобаңызда Frameworks қалтасы болмаса, Navigator ішіндегі жоба атын тінтуірдің оң жағымен басыңыз
   Xcode панелінде, содан кейін түймесін басыңыз Жаңа топ.
2. Жаңа топтың атын атаңыз Фреймворктар.
3. таңдаңыз Фреймворктер қалтаны таңдап, басыңыз File Бас мәзірден.
4. таңдаңыз қосу Files дейін Жоба.
5. Диалог терезесінде таңдаңыз КіруAmazon.framework және басыңыз қосу.
   Егер сіз Amazon 1.0 кітапханасымен кіруді қолданған болсаңыз, Amazon-sdk-пен-кіру анықтамалық және Amazon-sdk.a-мен кіру Frameworks қалтасынан. Негізгі мәзірден Өңдеу батырмасын шертіп, таңдаңыз Жою.
6. Project Navigator ішінен жобаңыздың атын таңдаңыз.
   The Жобаның редакторы Xcode жұмыс кеңістігінің редакторы аймағында пайда болады.
7. Жоба атауын басыңыз Мақсаттар, және таңдаңыз Құру кезеңдері. Кеңейту Екілік кітапханалармен байланыстыру және кітапхананы қосу үшін қосу белгісін басыңыз.
8. Іздеу өрісіне енгізіңіз Қауіпсіздік. таңдаңыз Қауіпсіздік.framework түймесін басыңыз қосу.
9. Іздеу өрісіне енгізіңіз SafariServices.framework. таңдаңыз SafariServices.framework және басыңыз қосу.
   
10. Құрастыру параметрлерін таңдаңыз. Барлығын нұқыңыз view барлық параметрлер.
11. Іздеу жолдары астында, КіруAmazon.framework каталогы Рамалық іздеу жолдары.
    Мысалыampле:
    
12. Жобаңызды жасамас бұрын Amazon 1.0 кітапханасымен кіруді пайдалансаңыз, дереккөздегі #import “AIMobileLib.h”, #import “AIAuthenticationDelegate.h” және #import “AIError.h” дегенді ауыстырыңыз. fileбір #импортпен
    . LoginWithAmazon.hline құрамына Amazon тақырыптарымен барлық кіру бірден кіреді.
    Сонымен қатар, 1.0 кітапханасының жолына сілтемелерді жоюға болады Тақырыпты іздеу жолдары немесе кітапхананы іздеу жолдары.
    13. Негізгі мәзірден нұқыңыз Өнім және таңдаңыз Құру. Құрылыс сәтті аяқталуы керек.

Сіздің API кілтіңізді қолданбалар тізіміне қосыңыз

Сіз өзіңіздің iOS қосымшаңызды Amazon арқылы Login жүйесінде тіркеген кезде сізге API кілті беріледі. Бұл Amazon Mobile Library қызметімен жүйеге кіруге қосымшаңызды анықтау үшін Amazon Mobile Library пайдаланатын идентификатор. Amazon ұялы кітапханасы бұл мәнді сіздің қосымшаңыздың ақпараттық қасиеттер тізіміндегі APIKey қасиеті мәнінен жұмыс уақытында жүктейді.

1. Жобаңыз ашық болған кезде, таңдаңыз Қолдау Files қалтасын таңдаңыз, содан кейін Ақпараттық тізім file (қайда бұл сіздің жобаңыздың атауы). Бұл редакциялау үшін сипат тізімін ашуы керек:
   
2. Жазбалардың ешқайсысы таңдалмағанына көз жеткізіңіз. Содан кейін, негізгі мәзірден Редакторды нұқыңыз және Элемент қосу. Енгізіңіз APIKey және басыңыз Енгізіңіз.
3. Астында екі рет нұқыңыз Мән мән қосу үшін баған. API кілтін мән ретінде қойыңыз.

А қосыңыз URL Қолданба сипаттамалары тізіміне схема

Пайдаланушы кірген кезде оларға Amazon кіру парағы ұсынылады. Сіздің қосымшаңыз жүйеге кіру туралы растауын алу үшін, а қосыңыз URL схемасы осылайша web бет сіздің қолданбаңызға қайта бағытталуы мүмкін. The URL схемасы ретінде жариялануы керек amzn- (мысалыampле, amzncom.example.app). Қосымша ақпарат алу үшін қараңыз Қолдану URL Қолданбалармен байланыс схемалары developer.apple.com сайтында.

1. Жобаңыз ашық болғанда, Қолдау көрсетуді таңдаңыз Files қалтасын таңдаңыз, содан кейін таңдаңыз Ақпараттық тізім file (қайда бұл сіздің жобаңыздың атауы). Бұл редакциялау үшін сипат тізімін ашуы керек:
   
2. Жазбалардың ешқайсысы таңдалмағанына көз жеткізіңіз. Содан кейін, негізгі мәзірден Редакторды нұқыңыз және Элемент қосу. Кіріңіз немесе таңдаңыз URL түрлері және басыңыз Енгізіңіз.
3. Кеңейту URL түрлері ашу Элемент 0. таңдаңыз Элемент 0 және негізгі мәзірден нұқыңыз Редактор және Элемент қосу. Кіріңіз немесе таңдаңыз URL Идентификатор және басыңыз Енгізіңіз.
4. таңдаңыз 0 тармақ астында URL Идентификатор және астында екі рет нұқыңыз Мән мән қосу үшін баған. Мән сіздің байлам идентификаторыңыз. Сіз бума идентификаторын келесі тізімде таба аласыз Бума идентификаторы меншік тізімінде.
5. таңдаңыз Элемент 0 астында URL түрлері және негізгі мәзірден нұқыңыз Редактор және Элемент қосу. Кіріңіз немесе таңдаңыз URL Схемалар және E түймесін басыңызnтер.
6. таңдаңыз 0 тармақ астында URL Схемалар және мән қосу үшін Мән бағанының астына екі рет нұқыңыз. Мән сіздің идентификаторыңыз болып табылады амзн- алдын ала (мысалыampле, amzn com.example.app). Сіз бума идентификаторын келесі тізімде таба аласыз Бума идентификаторы меншік тізімінде.

Қолданбаңызға Amazon батырмаларымен кіруді қосыңыз

Amazon-ге кіру пайдаланушыларға сіздің қосымшаңыздан кіруге шақыру үшін бірнеше стандартты батырмаларды ұсынады.
Бұл бөлімде Amazon кескінімен ресми кіруді жүктеу және оны iOS жүйесімен жұптастыруға арналған қадамдар берілген UI түймесі.

1. Стандартты қосыңыз UI түймесі қолданбаңызға.
   Бағдарламаға батырманы қалай қосуға болатындығы туралы оқулықтар мен ақпаратты мына жерден қараңыз Жасау және конфигурациялау View Объектілер және iOS қолданбаларын әзірлеуді бүгіннен бастаңыз developer.apple.com сайтында.
2. қосыңыз Ішін түртіңіз деп аталатын әдіске батырмаға арналған оқиға
   onLoginButtonClicked. Әзірге іске асыруды бос қалдырыңыз. The Жасау және конфигурациялау View Объектілер және iOS қолданбаларын әзірлеуді бүгіннен бастаңыз developer.apple.com сайтындағы құжаттар батырма оқиғасын қосу қадамдарын қамтиды.
3. Түйме кескінін таңдаңыз.
   Қолданбаңызда пайдалануға болатын түймелер тізімін алу үшін Amazon стилінің нұсқауларымен кіру бөлімін қараңыз. LWA_for_iOS.zip көшірмесін жүктеп алыңыз file. 1x және 2x каталогтарынан өзіңізге ұнайтын түймені табыңыз және оларды zip -тен шығарыңыз. Егер түймені Таңдалған күйде көрсеткіңіз келсе, түйменің _ Басылған нұсқасын шығарыңыз.
4. Кескіндерді жобаңызға қосыңыз.
   a. Xcode-де сіздің жобаңыз жүктелген кезде нұқыңыз File негізгі мәзірден Қосу пәрменін таңдаңыз Files «жобаға».
   b. Тілқатысу терезесінде түйме суретін таңдаңыз file(лар) жүктеп алып, Қосу түймесін басыңыз.
   c. Түймелер енді сіздің жобалық каталогыңыздағы жобада болуы керек. Оларды Қолдауға ауыстырыңыз Files қалтасы.
5. Суретті батырмаңызға қосыңыз.
   Түйменің кескінін қосу үшін батырма атрибутын өзгертуге немесе setImage: forState әдісі UI түймесі объект. Түйменің кескін төлсипатын өзгерту үшін келесі әрекеттерді орындаңыз:
   a. Қолданбаға арналған сюжеттік тақтаны ашыңыз.
   b. Сюжетті тақтадағы батырманы нұқыңыз немесе оны таңдаңыз View Контроллер көрінісі ағаш.
   c. жылы Утилиталар терезесін ашыңыз Атрибуттар инспекторы.
   d. Жоғарғы жағында Төлсипат инспекторы, орнатыңыз Түр түймешігін басыңыз Жүйе.
   e. Параметрлердің екінші тобында Әдепкі параметрін таңдаңыз Мемлекеттік конфигурация.
   f. Параметрлердің екінші тобында төмен қарай ашыңыз Сурет орнату.
   g. Жобаға қосқан «Амазонмен кіру» батырмасын таңдаңыз. 2х нұсқасын таңдамаңыз: ол автоматты түрде жоғары тығыздықтағы (Retina) дисплей құрылғыларына жүктеледі.
   h. Үшін бірдей суретті орнатыңыз Фон орнату.
   i. Егер сіз батырманың басылған нұсқасын көрсеткіңіз келсе, таңдаңыз Таңдалған үшін Мемлекеттік конфигурация, және орнатыңыз Сурет -ға _Қысылған сіздің батырмаңыздың нұсқасы.
   j. Қажет болса, сюжетті тақтада кескінді орналастыру үшін батырмаңыздың өлшемін реттеңіз.
   Бұл бөлімде сіз өзіңіздің жобаңызға Amazon арқылы Login арқылы кіру үшін кодты қосасыз.

IOS API үшін SDK пайдаланыңыз

Бұл бөлімде сіз өзіңіздің жобаңызға Amazon арқылы Login арқылы кіру үшін кодты қосасыз.

Қолданба өкілін қосыңыз

Іске асыру қосымша: ашықURL:опциялар: сіздің жобаңыздағы сыныпта UIApplicationDeleg хаттама. Әдепкі бойынша, бұл болады AppDelegate сынып. Қолданушы сіздің Amazon жүйеңізге кіру арқылы сәтті кірген кезде, олар Amazon кіру экранынан сіздің қолданбаңызға қайта бағытталады. URL Схема сіз өзіңіздің қолданбаларыңыздың тізіміне бұрын қосқансыз. Бұл қайта бағыттауды өңдеу үшін сіз қосымша: ашықURL:опциялар: әдіс, егер ИӘ болса, қайтарады URL сәтті өңделуде.

IOS үшін Amazon SDK көмегімен кіру кітапхана функциясын ұсынады, тұтқасыАшықURL: sourceApplication: кез келген бағыттауды басқаратын URL Amazon парақтарынан жіберілді. Ол ИӘ қайтарады, егер URL SDK басқарады. Осы әдіске қоңырау шалыңыз қосымша: ашықURL:опциялар: әдіс.

Бұл әдісті қолдану үшін сізге импорттау қажет болады .

импорт @ іске асыру AppDelegate - (BOOL) қосымшасы: (UIApplication *) қосымшасы ашықURL: (NSURL *) url опциялар: (NSDictionaryURLOptionsKey, id> *) параметрлер { return [AMZNAuthorizationManager дескрипторАшықURL:url sourceApplication: опциялар [UIApplicationOpenURLOptionsSourceApplicationKey]]; } @Соңы

Кіру түймесін басып, Pro алыңызfile Деректер

Бұл бөлім авторизацияны қалай шақыруға болатынын түсіндіреді: withHandler: API қолданушыға кіру үшін. Онда onLoginButtonClicked: Amazon батырмасымен кіру үшін тыңдаушыны құру кіреді.

1. Amazon жүйесімен жүйеге кіруді iOS жобасына қосыңыз. Қараңыз Кіруді Amazon кітапханасымен орнатыңыз.
2. Кіруді Amazon API көмегімен импорттаңыз file.
   Amazon API көмегімен кіруді импорттау үшін келесіні қосыңыз # импорттық мәлімдемелер сіздің көзіңізге file:

   # импорт

3. Қоңырау авторизациялау: withHandler: в onLoginButtonClicked. Егер сіз өзіңіздің қосымшаңызға Amazon батырмасы бар кіруді қосу бөліміндегі қадамдарды орындаған болсаңыз, онда сізде болуы керек onLoginButtonClicked: әдіс Amazon батырмасымен кіруге байланысты. Бұл әдіс бойынша қоңырау шалыңыз авторизациялау: withHandler: қолданушыны сіздің қосымшаңызға кіруге және авторизациялауға шақыру.

Бұл әдіс пайдаланушыға келесі тәсілдердің бірімен сұралған ақпаратқа кіруге және келісуге мүмкіндік береді:

1. ауысады web view қауіпсіз контексте (егер Amazon Shopping бағдарламасы құрылғыға орнатылған болса)
2. Safari-ге ауысады View Контроллер (iOS 9 және одан кейінгі нұсқаларында)
3. Жүйелік шолғышқа ауысады (iOS 8 және одан бұрынғы нұсқаларында)
   Бірінші опция үшін қауіпсіз контекст құрылғыға Amazon Shopping қосымшасы орнатылған кезде қол жетімді. Егер пайдаланушы Amazon Shopping қолданбасына әлдеқашан кірген болса, онда бұл API кіру парағын өткізіп жібереді, сөйтіп Single Кіру (SSO) тәжірибе. IOS клиенттерінің тәжірибесін қараңыз Қосымша ақпарат алу үшін [PDF].
   Үшін бірінші параметр авторизациялау: withHandler: болып табылады AMZNAuthorizeRequest сіздің өтініміңіз қандай көлем үшін авторизация сұрайтынын көрсететін объект. A ауқымы Amazon-мен кіруден сұрайтын пайдаланушы деректерін қамтиды. Пайдаланушы сіздің қосымшаңызға бірінші рет кірген кезде, олар сіз сұраған деректердің тізімін ұсынады және мақұлдауды сұрайды.
   Amazon-ге кіру қазіргі уақытта келесі аяларды қолдайды:

   Ауқымы атауы	Сипаттама
   проfile	Пайдаланушының атына, электрондық пошта мекенжайына және Amazon тіркелгісінің идентификаторына қол жеткізуге мүмкіндік береді.
   проfile:Қолданушының ID	Тек пайдаланушының Amazon тіркелгісінің идентификаторына қол жеткізуге мүмкіндік береді.
   Пошта Индексі	Пайдаланушының пошталық/пошталық индексіне кіруге рұқсат береді file олардың Amazon аккаунты үшін.

   Анықталған әдістерді қолданыңыз AMZNProfileҚолдану аясы ауқым нысанын алу және оны өзіңізге қосу үшін AMZNAuthorizeRequest объект. s қараңызampегжей-тегжейлі ақпарат алу үшін төмендегі кодты қараңыз.
   Авторизациялаудың екінші параметрі: withHandler: келесі қадамда сипатталған AMZNAuthorizationRequestHandler.

4. жасау AMZNA AvtorizatsiyaRequestHandler блок нысаны. AMZNA AvtorizatsiyaRequestHandler нәтижесін өңдейді авторизациялау: withHandler: қоңырау. Object-c блоктары туралы көбірек білу үшін қараңыз Блоктармен жұмыс developer.apple.com сайтында.
   Бірінші параметр AMZNA AvtorizatsiyaRequestHandler болып табылады AMZNA авторизациялау нәтижесі объект. Пайдаланушыға сәтті рұқсат берілгеннен кейін, AMZNA авторизациялау нәтижесі пайдаланушының кәсіпқойына қол жеткізу үшін пайдалануға болатын рұқсат белгісін қамтидыfile деректер және а AMZNUсері пайдаланушының кәсіби нұсқасын қамтитын нысанfile деректер. Екінші параметр AMZNA AvtorizatsiyaRequestHandler логикалық деп аталады userDidcancel. Бұл параметр шын мәніне орнатылады, егер пайдаланушы:
   1. Сафариді жабады View Кіру және авторизация кезінде контроллер (iOS 9 және одан кейінгі нұсқаларында)
   2. жабады web view Amazon Shopping қолданбасында
   3. Кіруді тоқтатады немесе авторизациядан бас тартады
   Үшінші параметр AMZNA AvtorizatsiyaRequestHandler болып табылады NSEқатесі егер SDK немесе авторизация серверіне байланысты логин мен авторизация сәтсіз болса, қателік туралы мәліметтерді қамтитын объект.

   - (IBAction) onLogInButtonClicked: (id) жіберуші { // авторизациялау туралы сұрау салу. AMZNAuthorizeRequest * сұрау = [[AMZNAuthorizeRequest ayır] init]; request.scopes = [NSArray arrayWithObjects: // [AMZNProfileПайдаланушы идентификаторының ауқымы], [AMZNProfileScope profile], [AMZNProfileҚолданылу аясы пошта коды]];// Amazon SDK арқылы кіруге рұқсат беру қоңырауын жасаңыз. [[AMZNAuthorizationManager sharedManager] авторизация: сұрау withHandler: ^ (AMZNAuthorizeResult * нәтижесі, BOOL userDidCancel, NSError * қатесі) { егер (қате) { // SDK немесе авторизация серверінің қателерін өңдеу. } else if (userDidCancel) { // Пайдаланушы кіруді тоқтатқан кезде пайда болған қателіктерді өңдейді. } басқа { // Аутентификация сәтті өтті. // Қатынас таңбалауышын және пайдаланушы профессионалын алыңызfile деректер. NSString * accessToken = result.token; AMZNUser * user = result.user; NSString * userID = user.userID; } }]; }

User Pro алуfile Деректер

Пайдаланушы жүйеге кіріп, қолданбаға авторизацияланған болса, сіз оның пайдаланушы маманын ала аласызfile деректер кез келген уақытта.
Бұл бөлімде әкелу: әдісі AMZNUсері ең жаңарған пайдаланушы кәсіпқойларын алу үшін классfile қазіргі уақытта рұқсаты бар пайдаланушыларға арналған деректер. Профессорfile алуға болатын деректер рұқсат ету қоңырау шалу.

1. Қоңырау AMZNҚолданушыны алу:.
   Бұл әдіс кәсіпқойларды шығарадыfile арқылы деректер AMZNUserFetchRequestHandler блок нысаны. Үшін бірінші параметр AMZNUserRequestHandler болып табылады AMZNUсері объект. The AMZNUсері нысанға а кіруі мүмкін Қолданушының ID, аты, электрондық пошта және Пошта Индексі, сұралған ауқымға байланысты.

   [AMZNUser алу: ^ (AMZNUser * пайдаланушысы, NSError * қатесі) { егер (қате) { // SDK қателігі немесе қолданушыға бағдарламаға рұқсаты жоқ. } else if (пайдаланушы) { NSString * userID = user.userID; // NSString * name = user.name; // NSString * email = user.email; // NSString * mailCode = user.postalCode; } }];

Іске қосу кезінде пайдаланушының кіруін тексеріңіз

Егер пайдаланушы сіздің қосымшаңызға кіріп, қолданбаны жауып, бағдарламаны кейінірек қайта іске қосса, қолданбаға деректерді шығаруға рұқсат беріледі. Пайдаланушы жүйеден автоматты түрде шықпайды. Іске қосу кезінде сіз қолданбаңызға әлі рұқсат етілген болса, пайдаланушыны кірген ретінде көрсете аласыз. Бұл бөлімде қалай қолдану керектігі түсіндіріледі авторизациялау: withHandler: қолданбаның әлі де рұқсат етілгендігін тексеру.

1. жасау AMZNAuthorizeRequest Сіздің қосымшаңыз авторизация сұрайтын пайдаланушы деректерін көрсететін ауқымды көрсетіңіз. Қолдану аясы туралы қосымша ақпаратты мына жерден қараңыз өңдеу Жүйеге кіру түймесі және Pro алыңызfile Деректер.
2. Орнату AMZNAuthorizeRequest.интерактивтіСтратегия дейін AMZNinteractiveStrategyЕшқашан. AMZNAuthorizeRequest пайдаланушыға кіруге шақырудың бірнеше стратегиясын қолдайды:

• AMZNIinteractiveStrategyAuto (әдепкі): SDK алдыңғы сақталған авторизация грантын іздейді авторизациялау: withHandler: жауаптар. Егер біреуі қол жетімді, жарамды және барлық сұралған аумақтарды қамтыса, SDK арқылы сәтті жауап қайтарылады AMZNA AvtorizatsiyaRequestHandler, және пайдаланушыға кіруді сұрамайды. Әйтпесе, пайдаланушыдан жүйеге кіру сұралады.
• AMZNInteractiveStrategyӘрқашан: SDK әрдайым қолданушыны қолданбаны пайдалануға рұқсаты бар-жоғына қарамастан жүйеге кіруге шақырады. Пайдаланушы сұралғанда, SDK қолданбаға арналған барлық жергілікті кэшталған авторизация гранттарын жояды.
• AMZNinteractiveStrategyЕшқашан: SDK бұрынғы сақталған авторизация грантын іздейді авторизациялау: withHandler жауаптар. Егер біреуі қол жетімді, жарамды және барлық сұралған аумақтарды қамтыса, SDK an қайтарады AMZNA авторизациялау нәтижесі қатынас таңбалауышы мен пайдаланушы pro бар нысанfile деректер.
  Әйтпесе, ол NSEқатесі арқылы объект AMZNA AvtorizatsiyaRequestHandler.

  // авторизациялау туралы сұрау салу. AMZNAuthorizeRequest * сұрау = [[AMZNAuthorizeRequest ayır] init]; request.scopes = [NSArray arrayWithObjects: // [AMZNProfileПайдаланушы идентификаторының ауқымы], [AMZNProfileScope profile], [AMZNProfileҚолдану аясы пошта коды]];request.interactiveStrategy = AMZNIinteractiveStrategyNever;[[AMZNAuthorizationManager sharedManager] авторизация:сұрау withHandler: ^ (AMZNAuthorizeResult * нәтижесі, BOOL userDidCancel, NSError * қатесі) { егер (қате) { // SDK қателігі қолданушының бұрын болмағанын көрсетеді сұралған көлем үшін сіздің қолданбаңызға рұқсат етілген. } басқа { // Пайдаланушы сіздің қосымшаңызға бұрын рұқсат берген. // Қатынас таңбалауышын және пайдаланушы профессионалын алыңызfile деректер. NSString * accessToken = result.token; AMZNUser * user = result.user; NSString * userID = user.userID; } }];

Авторизация туралы деректерді өшіріп, пайдаланушыны шығарыңыз

Бұл бөлімде шығу пайдаланушының авторизация деректерін екеуінен де тазарту әдісі AIMobileLib жергілікті деректер қоймасы және авторизация сервері. Қолданбаның кәсіби нұсқасын алуы үшін пайдаланушы жүйеге қайта кіруі керекfile деректер. Бұл әдісті қолданушыдан шығу немесе қолданбадағы кіру мәселелерін шешу үшін қолданыңыз.

1. Шығу механизмін енгізіңіз.
   Пайдаланушы сәтті кірген кезде, сіз олардың профилін тазалай алатындай шығу механизмін қамтамасыз етуіңіз керекfile деректер және бұрын рұқсат етілген аумақтар. Сіздің механизміңіз гиперсілтеме, түйме немесе мәзір элементі болуы мүмкін.
2. Қоңырау шығу:.
   Қоңырау шығу: пайдаланушының авторизация деректерін жою үшін жүйеден шығу өңдегішінде (қатынау белгілері, проfile) жергілікті дүкеннен және олардың аутентификация күйі серверден. Енгізу параметрі шығу болып табылады AMZNA AvtorizatsiyaRequestHandler блок нысаны. Блокты анықтап, өңдеу керек NSEқатесі қашан қайтарылатын нысандар шығу: орындалмайды.

   [[AMZNAuthorizationManager sharedManager] signOut: ^ (NSError * _Nullable қате) { егер (! қате) { // SDK қателігі немесе Amazon авторизация серверімен кіру. } }];

Өз интеграцияңызды тексеріңіз

Қолданбаны iOS құрылғысында немесе тренажерде іске қосып, Amazon.com тіркелгі деректерімен кіруге болатындығын растаңыз.

Ескерту: IOS10 тренажерларында тестілеу кезінде қате туралы хабарламаны көруіңіз мүмкін Қосымшаның APIK кілті жарамсыз үшін авторизацияUserForScopes  сұраныс немесе а. үшін белгісіз қате коды clearAuthorizationState сұрау. Бұл Apple-ге қатысты қате бұл SDK брелокке қол жеткізуге тырысқанда пайда болады. Apple қатені жойғанға дейін сіз оны қосу арқылы жұмыс жасай аласыз Салпыншақпен бөлісу қосымшасы үшін Мүмкіндіктер қолданбаның мақсатты қойындысы. Бұл қате тек тренажерларға әсер етеді. Сіз кез келген шешімді қолданбай нақты iOS10 құрылғыларында тестілеуге болады.

 

Amazon қолданбасына кіру iOS қосымшаларына арналған нұсқаулық - Жүктеу [оңтайландырылған]
Amazon қолданбасына кіру iOS қосымшаларына арналған нұсқаулық - Жүктеп алу

Анықтамалар

• Пайдаланушы нұсқаулығы