Shiga tare da Jagoran farawa na Amazon don ƙa'idodin iOS
Shiga ciki tare da Amazon: Farawar Jagora don iOS
Hakkin mallaka © 2017 Amazon.com, Inc., ko kuma rassanta. Duk haƙƙoƙi. Amazon da tambarin Amazon alamun kasuwanci ne na Amazon.com, Inc. ko kuma rassansa. Duk sauran alamun kasuwanci ba mallakin Amazon bane mallakar masu mallakar su ne.
Gabatarwa
A cikin wannan jagorar za mu nuna muku yadda za a ƙara Shiga tare da Amazon zuwa app ɗinku na iOS, ta amfani da Shiga tare da Amazon SDK don iOS v3.0 +.
Bayan kammala wannan jagorar yakamata ku sami Shiga aiki tare da maballin Amazon a cikin aikace-aikacenku wanda zai bawa masu amfani damar shiga tare da takardun shaidarka na Amazon. Don ƙarin koyo game da shigowar shiga kwastomomin ku zasu dandana lokacin da suke amfani da Shiga tare da Amazon cikin aikace-aikacenku, da fatan za a duba namu Kwarewar Abokin Ciniki Ƙarsheview don iOS apps.
Shigar da Kayan aikin Developer na iOS
Shigar da XCode
Shiga ciki tare da Amazon SDK don iOS an samar dashi ta Amazon don taimaka muku ƙara Shiga tare da Amazon zuwa aikace-aikacenku na iOS. SDK ana nufin amfani dashi tare da yanayin haɓaka Xcode. SDK tana tallafawa ƙa'idodin da ke gudana akan iOS 7.0 kuma daga baya ta amfani da ARMv7, ARMv7s, ARM64, i386, andx86_64.
Kuna iya shigar da Xcode daga Mac App Store. Don ƙarin bayani, duba Xcode: Menene sabo on developer.apple.com.
Bayan an shigar da Xcode, zaka iya Shigar da Shiga tare da Amazon SDK don iOS kuma Run da Sampda App, kamar yadda aka bayyana a kasa.
Shigar da Shiga tare da Amazon SDK don iOS
Shiga tare da Amazon SDK don iOS ya zo cikin fakiti biyu. Na farko ya ƙunshi ɗakin karatu na iOS da takaddun tallafi. Na biyu ya ƙunshi kamarample aikace-aikacen da ke ba mai amfani damar shiga da view su profile data.
Idan baku shigar da Xcode ba tukuna, duba umarnin a cikin Shigar Xcode sashe na sama.
- Zazzagewa ShigaWithAmazonSDKForiOS.zip da fitar da files zuwa shugabanci a kan rumbun kwamfutarka.
Ya kamata ku ga kundin adireshi na LoginWithAmazon.framework. Wannan ya ƙunshi Shiga ciki tare da laburaren Amazon.
A saman matakin zip din akwai ShigaWithAmazon.docset kundin adireshi. Wannan ya ƙunshi takaddun API. - Duba Shigar da Shiga tare da Amazon Library don umarnin kan yadda zaka kara dakin karatu zuwa aikin iOS.
Lokacin da Login tare da Amazon SDK don iOS aka sanya, zaka iya Irƙiri Sabuwar Shiga tare da Aikin Amazon Bayan ku Yi rijista tare da Shiga tare da Amazon.
Run da Sampda App
Don gudanar da sample application, bude sampa cikin Xcode.
- Zazzagewa SampleLoginWithAmazonAppForiOS.zip da kwafi
SampleLoginWithAmazonAppForiOS kundin adireshi - Fara Xcode. Idan maganganun Barka da zuwa Xcode ya tashi, danna Buɗe Wani. In ba haka ba, daga babban menu, danna File kuma zaɓi Buɗe.
- Zaɓi babban fayil ɗin Takardu, kuma zaɓi
SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/
ShigaDa AmazonSample.xcodeproj. Danna Bude - A sampaikin ya kamata yanzu ya ɗauka. Idan an gama, zaɓi Samfura daga babban menu, sai ka zaba Gudu
Yi rijista tare da Shiga tare da Amazon
Kafin ka iya amfani da Login tare da Amazon akan wani website ko a cikin wayar hannu, dole ne ka yi rajistar aikace-aikace tare da Login tare da Amazon. Shigar ku tare da aikace-aikacen Amazon shine rajistar da ke ƙunshe da mahimman bayanai game da kasuwancin ku, da bayani game da kowane website ko aikace-aikacen hannu da kuka ƙirƙira wanda ke goyan bayan Shiga da Amazon. Ana nuna wannan bayanin kasuwanci ga masu amfani duk lokacin da suka yi amfani da Login tare da Amazon akan ku website ko mobile app. Masu amfani za su ga sunan aikace-aikacen ku, tambarin ku, da hanyar haɗi zuwa manufofin keɓaɓɓen ku. Waɗannan matakan suna nuna yadda ake yin rijistar app ɗin ku na iOS don amfani da Login tare da Amazon.
Yi rijistar shiga ku tare da Aikace-aikacen Amazon
- Je zuwa https://login.amazon.com.
- Idan kayi rijista don Shiga tare da Amazon kafin, danna App Console. In ba haka ba, danna Shiga. Za a miƙa ku zuwa Seller Central, wanda ke kula da rajistar aikace-aikace don Shiga tare da Amazon. Idan wannan shine karonku na farko ta amfani da Seller Central, za'a umarce ku da saita asusun Seller Central.
- Danna Yi Rajista Sabon Aikace-aikace. The Yi Rijista Aikace-aikacenku fom zai bayyana:
a. A cikin Rijistar takardar neman aikin ku, shigar da Suna kuma a Bayani don aikace-aikacenku. Da Suna shine sunan da aka nuna akan allon yarda lokacin da masu amfani suka yarda don raba bayanai tare da aikace-aikacenku. Wannan sunan ya shafi Android, iOS, da websigogin rukunin aikace -aikacenku.
The Bayani yana taimaka muku bambance kowane Login ku tare da aikace-aikacen Amazon kuma ba a nuna shi ga masu amfani ba.
b. Shigar a Sanarwa Keɓaɓɓu URL don aikace-aikacen ku.
Sanarwar Sirri URL shine wurin manufofin sirrin kamfanin ku ko aikace -aikacen (don tsohonample, http://www.example.com/privacy.html). Wannan mahaɗin yana nunawa ga masu amfani akan allon yarda.
c. Idan kuna son ƙara a Hoton tambari don aikace-aikacen ku, danna Zabi File kuma nemo hoton da ya dace.
Ana nuna wannan tambarin akan alamar shiga da allon yarda don wakiltar kasuwancin ku ko website.
Alamar za ta ragu zuwa pixels 50 a tsayi idan ta fi ta pixels 50; babu iyakancewa akan fadin tambarin. - Danna Ajiye s kuamprajista ya kamata yayi kama da wannan:
Bayan an ajiye saitunan aikace-aikacenku na asali, zaku iya ƙara saitunan takamaiman webshafuka da aikace -aikacen hannu waɗanda za su yi amfani da wannan Shiga tare da asusun Amazon.
Idan nau'ikan nau'ikan aikace-aikacenku suna da ID daban-daban, kamar na nau'ikan gwaji ɗaya ko fiye da sigar samarwa, kowane juzu'i yana buƙatar maɓallin API nasa. Daga Saitunan iOS na app ɗinku, danna .ara Maɓallin API maballin don ƙirƙirar ƙarin maɓallan don aikace-aikacenku (ɗayan kowace siga)
Settingsara Saitunan iOS zuwa Aikace-aikacenku
Bayan an ajiye saitunan aikace-aikacenku na asali, zaku iya ƙara saitunan takamaiman webshafukan yanar gizo da aikace-aikacen hannu waɗanda za su yi amfani da Login tare da Amazon.
Don yin rijistar App na iOS, dole ne ku tantance mai gano forunshi don aikin app. Shiga ciki tare da Amazon zai yi amfani da ID ɗin cuta don ƙirƙirar maɓallin API. Maballin API zai ba wa app ɗinka damar shiga tare da sabis na izini na Amazon. Bi waɗannan matakan don ƙara aikin iOS zuwa asusunku:
- Daga Aikace-aikace allon, danna iOS Saituna. Idan kun riga kun yi rijistar aikace-aikacen iOS, bincika Keyara Mabuɗin API button a cikin Saitunan iOS sashe.
The Bayanai na Aikace-aikacen iOS fom zai bayyana:
- Shigar da Lakabi na iOS App.
Wannan ba dole ba ne ya zama sunan hukuma na app ɗin ku. Yana kawai gano wannan musamman iOS app tsakanin apps da webrukunin yanar gizo da aka yi rijista don Shiga ku tare da aikace -aikacen Amazon. - Shigar da naku ID na dam. Wannan dole ne ya dace da mai gano ƙididdigar aikin iOS ɗinku. Don ƙayyade mai gano tarinku, buɗe aikin a cikin Xcode. Bude jerin kayan don aikin (-Info.plist) a cikin Navigator Project. The Mai gano tarin yana ɗaya daga cikin kaddarorin a cikin jerin.
- Danna Ajiye
Idan nau'ikan nau'ikan aikace-aikacenku suna da ID daban-daban, kamar na nau'ikan gwaji ɗaya ko fiye da sigar samarwa, kowane juzu'i yana buƙatar maɓallin API na kansa. Daga Saitunan iOS na kayan aikinku, danna maɓallin APIara API don ƙirƙirar ƙarin maɓallan aikace-aikacenku (ɗayan kowace sigar).
ID Bundle ID da ma andallan API
Mai gano Bundle na musamman ne ga kowane aikace-aikacen iOS. Shiga ciki tare da Amazon yana amfani da ID na ID don ginawa
Maballin API. Mabuɗin API yana ba da damar Shiga tare da sabis na izini na Amazon don gane aikinku.
Ayyade Mai leayyade leungiya don App ɗin iOS
1. Bude aikin app dinka a cikin Xcode.
2. Bude Bayanin Kadarorin Jerin domin aikin (-Info.plist) a cikin Mai Binciken Injiniya.
3. Nemo Mai gano tarin a cikin jerin kaddarorin.
Dawo da Maɓallin API na iOS
Bayan kayi rijistar sigar iOS kuma ka bayar da ID na Bundle, zaka iya dawo da maɓallin API daga shafin rajista don Shiga ciki tare da aikace-aikacen Amazon. Kuna buƙatar sanya wannan maɓallin API a cikin jerin kayan aikin ku. Har sai kun yi, ba za a ba da izinin aikin ba don sadarwa tare da Shiga ciki tare da sabis na izini na Amazon.
- Je zuwa https://login.amazon.com.
- Danna App Console.
- A cikin Aikace-aikace akwati, danna aikace-aikacenku.
- Nemo aikace-aikacenku na iOS a ƙarƙashin Saitunan iOS sashe.
Idan baku riga kun yi rijistar aikace-aikacen iOS ba, duba Addara Saitunan iOS zuwa Aikace-aikace. - Danna Haɗa Keyimar Mabuɗin API. Wani taga zai fito da maballin API. Don kwafin mabuɗin, danna Zaɓi Duk don zaɓar maɓallin duka.
Lura: Maballin Maballin API ya dogara ne, a wani ɓangare, a kan lokacin da aka ƙirƙira shi. Sabili da haka, Valididdigar Mabuɗin API na gaba da kuka ƙirƙira na iya bambanta da asali. Kuna iya amfani da ɗayan waɗannan Keyididdigar Mabuɗin API a cikin app ɗinku saboda duk suna aiki. - Duba Addara Mabuɗin API ɗinku a Lissafin Kayan Kayan Kayan Ku don umarnin kan ƙara mabuɗin API ɗin a cikin manhajar iOS ɗinku
Createirƙiri Shiga tare da aikin Amazon
A wannan ɓangaren, zaku koyi yadda ake ƙirƙirar sabon aikin Xcode don Shiga ciki tare da Amazon kuma saita aikin.
Irƙiri Sabuwar Shiga tare da Aikin Amazon
Idan har yanzu ba ku da aikin aikace-aikace don amfani da Shiga tare da Amazon, bi umarnin da ke ƙasa don ƙirƙirar ɗaya. Idan kana da wata manhaja data kasance, tsallaka zuwa ga Shigar da Shiga tare da Amazon Library sashe a kasa.
- Kaddamar Xcode.
- Idan an gabatar muku da Maraba da zuwa Xcode magana, zaži Ƙirƙiri sabon aikin Xcode.
In ba haka ba, daga File menu, zaži Sabo kuma Aikin. - Zaɓi nau'in aikin da kuke son ƙirƙira ku danna Na gaba.
- Shigar a Sunan samfur kuma a Gano Kamfanin. Lura da Mai ganowa, kuma danna Next.
- Zaɓi wurin da zaku adana aikin ku kuma danna Ƙirƙiri
Yanzu zaku sami sabon aikin da zaku iya amfani dashi don kiran Shiga tare da Amazon.
Shigar da Shiga tare da Amazon Library
Idan bakayi saukar da Shiga ciki tare da Amazon SDK don iOS ba, duba Shigar da Shiga tare da Amazon SDK don iOS.
Shiga ciki tare da aikin Amazon dole ne ya haɗu da ShigaWithAmazon.framework kuma Tsaro. Aikin dakunan karatu. Hakanan kuna buƙatar saita hanyar bincike don nemo hanyar shiga tare da taken Amazon.
- Idan aikinku bashi da babban fayil na Tsarin aiki, danna-dama sunan aikin a cikin Navigator
ayyuka a cikin Xcode, sannan danna Sabon Rukuni. - Sanya sabon rukuni Tsarin aiki.
- Zaɓin Tsarin tsari babban fayil kuma danna File daga Babban menu.
- Zaɓi Ƙara Files ku Aikin.
- A cikin maganganun, zaɓi ShigaWithAmazon.framework kuma danna Ƙara.
Idan kayi amfani da Shiga tare da ɗakin karatu na Amazon 1.0, share shiga-tare-da-amazon-sdk shugabanci da shiga-tare-da-amazon-sdk.a daga babban fayil ɗin Frameworks. Danna Shirya daga menu na ainihi sai ka zaba Share. - Zaɓi sunan aikin ku a cikin Navigator na Project.
The Edita na aikin zai bayyana a yankin edita na filin aikin Xcode. - Danna sunan aikin ku a ƙarƙashin Manufa, kuma zaɓi Gina matakai. Fadada Haɗa Binary tare da dakunan karatu kuma danna alamar ƙari don ƙara ɗakin karatu.
- A cikin akwatin bincike, shigar Tsaro. Aikin. Zaɓi Tsarok kuma latsa Ƙara.
- A cikin akwatin bincike, shigar SabisServices.framework. Zaɓi SabisServices.framework kuma danna Ƙara.
- Zaɓi Saitunan Gina. Danna Duk don view duk saituna.
- A karkashin Hanyoyin Bincike, tabbatar da cewa ShigaWithAmazon.framework kundin adireshi yana cikin Hanyoyin Bincike Tsarin.
Don misaliampda:
- Kafin gina aikin ku, idan kun yi amfani da Login tare da ɗakin karatu na Amazon 1.0, maye gurbin #import "AIMobileLib.h", #import "AIAuthenticationDelegate.h", da #import "AIError.h" a cikin tushen ku files tare da #shigo da guda ɗaya
. LoginWithAmazon.hline ya hada da dukkan Shiga ciki tare da taken Amazon lokaci daya.
Allyari, za ku iya cire duk abin da yake nuni zuwa hanyar ɗakin karatu na 1.0 a cikin Hanyoyin Bincike na Kai ko Hanyoyin Bincike Laburare.
13. Daga babban menu, danna Samfura kuma zaɓi Gina Ya kamata ginin ya kammala cikin nasara.
Ara Mabuɗin API ɗinku a Lissafin Kayan Kayan Kayan Ku
Lokacin da kuka yi rijistar aikace-aikacenku na iOS tare da Shiga tare da Amazon, an sanya muku maɓallin API. Wannan ganowa ne wanda Amazon Library Library zai yi amfani dashi don gano aikace-aikacenku zuwa Shiga tare da sabis na izini na Amazon. Laburaren Wayar Hannu na Amazon yana ɗaukar wannan ƙimar a lokacin gudu daga ƙimar kadarar APIKey a cikin Lissafin Kadarorin Bayani na Bayananku.
- Tare da bude aikin ka, zabi Taimakawa Files babban fayil, sannan ka zaɓa -Info.plist file (ku shine sunan aikin ku). Wannan ya kamata ya buɗe jerin kayan don gyara:
- Tabbatar cewa babu ɗayan shigarwar da aka zaɓa. Bayan haka, daga babban menu, danna Edita, kuma Itara Abu. Shiga APIKey kuma danna Shiga
- Danna sau biyu a ƙarƙashin Daraja shafi don ƙara darajar. Manna maɓallin API ɗinka azaman ƙimar.
Ƙara a URL Makirci ga Kayan Kayan Kayan Kayan Ku
Lokacin da mai amfani ya shiga, za a gabatar da su tare da shafin shiga na Amazon. Domin aikinka ya karbi tabbaci na shigarsu, dole ne ka kara a URL tsarin don haka web shafi na iya turawa zuwa app ɗin ku. The URL dole ne a bayyana makirci azaman amson- (na example, amzncom.example.app). Don ƙarin bayani, duba Amfani URL Makirci don Sadarwa tare da Ayyuka akan developer.apple.com.
- Tare da buɗe aikin ku, zaɓi Supporting Files babban fayil, sannan zaɓin -Info.plist file (ku shine sunan aikin ku). Wannan ya kamata ya buɗe jerin kayan don gyara:
- Tabbatar cewa babu ɗayan shigarwar da aka zaɓa. Bayan haka, daga babban menu, danna Edita, kuma Itara Abu. Shigar ko zaɓi URL iri kuma danna Shiga
- Fadada URL iri don bayyana Abu 0. Zaɓi Abu 0 kuma, daga babban menu, danna Edita kuma Itara Abu. Shigar ko zaɓi URL Mai ganowa kuma danna Shiga
- Zaɓi Farashin 0 karkashin URL Mai ganowa kuma danna sau biyu a ƙarƙashin Daraja shafi don ƙara darajar. Isimar ita ce ID ɗinku na cuta. Kuna iya nemo ID ɗinku mai lamba wanda aka jera azaman Mai gano tarin a cikin jerin kayan.
- Zaɓi Abu 0 karkashin URL iri kuma, daga babban menu, danna Edita da Addara Abu. Shigar ko zaɓi URL Tsare-tsare kuma latsa Enter.
- Zaɓi Farashin 0 karkashin URL Tsare-tsare kuma danna sau biyu a ƙarƙashin shafi na ueimar don ƙara ƙima. Valueimar ita ce ID ɗin damunku tare da amson- wanda aka riga aka shirya (don example, amzn com.example.app). Kuna iya nemo ID ɗinku mai haɗawa kamar Mai gano tarin a cikin jerin kayan.
Shiga tare da Amazon yana samar da maɓallan daidaitattun maɓallan da zaku iya amfani dasu don faɗakar da masu amfani don shiga daga app ɗinku.
Wannan ɓangaren yana ba da matakai don saukar da Login hukuma tare da hoton Amazon da haɗa shi tare da iOS UIButton.
- Aara misali UIButton zuwa ga manhajarku.
Don koyawa da bayani kan yadda ake ƙara maɓalli a kan aikace-aikace, duba Irƙira da Tattaunawa View Abubuwa kuma Fara Haɓaka Ayyukan IOS A Yau akan developer.apple.com. - Ƙara da Shafar Sama Ciki taron don maɓallin zuwa hanyar mai suna
akanLoginButtonClicked. Bar aiwatar fanko a yanzu. Da Irƙira da Tattaunawa View Abubuwa kuma Fara Haɓaka Ayyukan IOS A Yau takardu akan developer.apple.com sun haɗa da matakai kan ƙara taron maɓallin. - Zaba maɓallin hoto.
Tuntuɓi Shiga mu tare da Jagororin Salon Amazon don jerin maɓallan da zaku iya amfani da su a cikin app ɗin ku. Zazzage kwafin LWA_for_iOS.zip file. Nemo maballin da kuka fi so a duka kundin adireshi 1x da 2x kuma cire su daga zip ɗin. Cire nau'in _Latsa maɓallin maɓallin ku idan kuna son nuna maɓallin a cikin Yanayin da aka zaɓa. - Sanya hotuna zuwa aikinku.
a. A cikin Xcode, tare da ɗaukar aikinku, danna File daga babban menu kuma zaɓi Ƙara Files zuwa "aikin".
b. A cikin maganganun, zaɓi hoton maɓallin file(s) da kuka zazzage kuma danna Add.
c. Ya kamata maɓallan yanzu su kasance cikin aikin a ƙarƙashin kundin aikinku. Matsar dasu zuwa Tallafi Files fayil. - Theara hoton a maɓallinku.
Don ba da damar hoton don maɓallinku, za ku iya canza sifar maballin ko amfani da setImage: jihar Hanyar kan UIButton abu. Bi waɗannan matakan don haɓaka sifar hoto don maɓallinku:
a. Bude allon labari don aikinka.
b. Zaɓi maɓallin a cikin allon labarinku ta danna shi ko zaɓi shi daga View Mai Kula da Yanayi itace.
c. A cikin Abubuwan amfani taga, bude Halayen Sufeto.
d. A saman Sanya Sifeto, saita da Nau'in na maballin Tsari.
e. A rukuni na biyu na saituna, zaɓi Tsoffin Jihar Config.
f. A rukuni na biyu na saitunan, sauke saukar da Hoto saitin.
g. Zaɓi Shiga ciki tare da maɓallin maɓallin Amazon wanda kuka ƙara zuwa aikin. Kada a zabi sigar 2x: za a ɗora ta atomatik akan na'urorin nuni masu girma (Retina).
h. Kafa wannan hoto don Fage saitin.
i. Idan kanaso ka saka maballin da aka matse, saika zabi zaba domin Jihar Config, kuma saita Hoto zuwa ga _Latsa sigar maɓallinku.
j. A kan allo, daidaita girman maɓallin ka don ɗaukar hoto, idan ya cancanta.
A wannan ɓangaren, zaku ƙara lambar zuwa aikinku don shiga cikin mai amfani tare da Shiga ciki tare da Amazon.
Yi amfani da SDK don iOS APIs
A wannan ɓangaren, zaku ƙara lambar zuwa aikinku don shiga cikin mai amfani tare da Shiga ciki tare da Amazon.
Haɗa Wakilin App
Aiwatar da aikace-aikace: budeURL: zaɓuɓɓuka: a cikin aji a cikin aikin ku wanda ke kulawa da Aikace-aikacen UIADelegate yarjejeniya. Ta tsohuwa, wannan zai zama AppDelegate aji. Lokacin da mai amfani yayi nasarar shiga cikin app ɗinku ta amfani da Shiga tare da Amazon, za a tura su daga allon shiga ta Amazon da baya zuwa ga aikinku bisa ga URL Tsari kun kara a cikin Jerin Kayan Kayan Ku na Kayan aiki a baya. Don ɗaukar wannan turawar, dole ne ku aiwatar da aikace-aikace: budeURL: zaɓuɓɓuka: hanya, wanda ya dawo YES idan URL an sarrafa shi cikin nasara
Shiga ciki tare da Amazon SDK don iOS yana ba da aikin laburare, rikeBudeURL: tushenAikace-aikace: wanda ke ɗaukar kowane turawa URL aika daga shafukan Amazon. Yana dawo YES idan URL SDK ne ke sarrafa shi cikin nasara Kira wannan hanyar a cikin aikace-aikace: budeURL: zaɓuɓɓuka: hanya.
Don kiran wannan hanyar, kuna buƙatar shigowa .
shigo da @ aiwatarda AppDelegate - (BOOL) aikace-aikacen: (UIApplication *) aikace-aikace a budeURL: (NSURL *) url zaɓuɓɓuka: (NSDictionaryURLZabukaKey, id> *) za optionsu options {ukan { dawo [AMZNAmutsalarManager handleOpenURL:url SourceAikace-aikace: zaɓuɓɓuka [UIApplicationOpenURLZabukaSourceApplicationKey]]; } @karshe |
Wannan ɓangaren yana bayanin yadda ake kiran izini: withHandler: API don shiga mai amfani. Wannan ya haɗa da ƙirƙirar onLoginButtonClicked: mai sauraro don Shiga ciki tare da maɓallin Amazon.
- Loara Shiga tare da Amazon zuwa aikin iOS ɗin ku. Duba Shigar da Shiga tare da Amazon Library.
- Shigo da Shiga tare da Amazon API zuwa tushenku file.
Don shigo da Shiga tare da Amazon API, ƙara waɗannan masu zuwa #matsaloli zuwa tushen ku file:# shigo da kaya - Kira ba da izini: withHandler: in akanLoginButtonClicked. Idan ka bi matakai a Addara Shiga tare da Button Amazon zuwa Abubuwan Ka, ya kamata ka sami onLoginButtonClicked: hanya haɗa shi da Shiga tare da maɓallin Amazon. A wannan hanyar, kira ba da izini: withHandler: don faɗakar da mai amfani don shiga da ba da izinin aikace-aikacenku.
Wannan hanyar za ta ba mai amfani damar shiga da kuma yarda da bayanin da aka nema a ɗayan hanyoyin masu zuwa:
- Sauya zuwa web view a cikin amintaccen mahallin (idan an shigar da app ɗin Siyayya na Amazon akan na'urar)
- Canja zuwa Safari View Mai sarrafawa (akan iOS 9 da kuma daga baya)
- Sauya zuwa burauzar tsarin (akan iOS 8 kuma a baya)
Yanayin amintacce don zaɓin farko yana samuwa lokacin da aka shigar da aikace-aikacen Siyayya na Amazon zuwa na'urar. Idan mai amfani ya riga ya shiga aikace-aikacen Siyayya na Amazon, wannan API ɗin zai tsallake alamar a cikin shafi, wanda zai haifar da Single Shiga-Kan (SSO) kwarewa. Duba abokin ciniki-gwaninta-ios [PDF] don ƙarin koyo.
Saitin farko zuwa ba da izini: withHandler: shine AMZNA ba da izini Buƙatun abin da ke nuna abin da girman aikace-aikacenku yake neman izini don. A iyaka ya ƙunshi bayanan mai amfani da kuke nema daga Shiga tare da Amazon. A karo na farko da wani mai amfani ya shiga manhajarku, za a gabatar musu da jerin bayanan da kuke nema kuma a nemi izinin su.
Shiga ciki tare da Amazon a halin yanzu yana tallafawa abubuwan da ke gaba:Sunan bigiren Bayani profile Yana ba da dama ga sunan mai amfani, adireshin imel, da ID na asusun Amazon. profile:mai amfani_id Yana ba da dama ga ID na asusu na mai amfani kawai. lambar gidan waya Yana ba da dama ga zip/kodin gidan waya na mai amfani a kunne file don asusun Amazon ɗin su. Yi amfani da hanyoyin da aka bayyana a ciki AMZNProfileIyakar don samun abu mai faɗi kuma ƙara shi zuwa ga AMZNA ba da izini Buƙatun abu. Duba sample code kasa don cikakkun bayanai.
Sigogi na biyu don ba da izini: withHandler: shine AMZNAuthorizationRequestHandler, wanda aka bayyana a mataki na gaba. - Ƙirƙiri wani AMZNAn iziniRequestHandler toshe abun. AMZNAn iziniRequestHandler aiwatar da sakamakon ba da izini: withHandler: kira. Don ƙarin koyo game da abubuwan haƙiƙa-c, duba Aiki tare da Tubalan akan developer.apple.com.
Saitin farko na AMZNAn iziniRequestHandler wani ne AMZNA ba da izini Sakamakon abu. Bayan an ba da izinin mai amfani cikin nasara, AMZNA ba da izini Sakamakon zai ƙunshi alamar shiga wacce za a iya amfani da ita don samun dama ga mai amfanifile data, a AMZNUser abu, wanda ya ƙunshi pro na mai amfanifile data.Sai na biyu na AMZNAn iziniRequestHandler shine ake kira da 'Yan Boolean mai amfani. Wannan saita za a saita zuwa gaskiya idan mai amfani:
1. Yana rufe Safari View Mai sarrafawa yayin shiga da izini (akan iOS 9 da kuma daga baya)
2. Yana rufewa web view a cikin Amazon Siyayya app
3. Canja izinin shiga ko ƙin yarda
Sigogi na uku na AMZNAn iziniRequestHandler wani ne NSError abu wanda ya ƙunshi cikakkun bayanai na kuskure idan shiga da izini ya gaza saboda SDK ko uwar garken izini.- (IBAction) onLogInButtonClicked: (id) mai aikawa {
// Gina neman izini.
AMZNAuthorizeRequest * request = [[AMZNAuthorizeRequest alloc] init];
request.scopes = [NSArray tsararruWithObjects:
// [AMZNProfileMai amfani ID],
[AMZNPRfileGirman profile],
[AMZNPRfileIyakar lambar gidan waya]];// Yi kira mai izini zuwa Shiga tare da Amazon SDK.
[[AMZNAuthorizationManager sharedManager] izni: nema
withHandler: ^ (AMZNAuthorizeResult * sakamakon, BOOL
userDidCancel, NSError * kuskure) {
idan (kuskure) {
// Kula da kurakurai daga SDK ko sabar izini.
} kuma idan (userDidCancel) {
// Kula da kurakurai da aka haifar lokacin da mai amfani ya soke shiga.
} kuma {
// Tabbatarwa tayi nasara.
// Sami alamar shiga da pro mai amfanifile data.
NSString * samun damarToken = result.token;
AMZNUser * mai amfani = result.user;
NSString * userID = mai amfani.userID;
}
}];
}
Nemo Mai Amfani Profile Bayanai
Muddin mai amfani ya shiga kuma yana ba da izini ga app ɗin ku, zaku iya ɗauko mai amfani da sufile data a kowane lokaci.
Wannan ɓangaren yana bayanin yadda ake amfani da debo: hanyar na AMZNUser aji don dawo da mafi sabuntar mai amfani profile bayanai don masu amfani waɗanda aka ba da izini a halin yanzu. The profile bayanan da zaku iya dawo dasu sun dogara ne akan iyakar da aka nuna a cikin ba da izini kira.
- Kira AMZNUser kawo:.
Wannan hanyar za ta sami profile data via an AMZNUserFetchRequestHandler toshe abun. Siffar farko zuwa AMZNUserRequestHandler wani ne AMZNUser abu. The AMZNUser abu na iya haɗawa da mai amfani, suna, imel, da Lambar gidan waya, dangane da ikon yinsa.[AMZNUser kawo: ^ (mai amfani da AMZNUser *, kuskuren NSError *)) {
idan (kuskure) {
// Kuskure daga SDK, ko babu wani mai amfani da ya ba izini ga ka'idar.
} kuma idan (mai amfani) {
NSString * userID = mai amfani.userID;
// NSString * suna = sunan mai amfani;
// NSString * email = mai amfani.email;
// NSString * postalCode = mai amfani.postalCode;
}
}];
Bincika don Shiga Mai amfani a Allon farawa
Idan wani mai amfani ya shiga cikin app ɗin ku, ya rufe aikin, kuma ya sake kunna app daga baya, har yanzu ana ba da izinin aikin dawo da bayanai. Mai amfanin baya shiga ta atomatik. A farkon farawa, zaku iya nuna mai amfani kamar yadda ya shiga idan har yanzu app ɗinku yana da izini. Wannan sashin yana bayanin yadda ake amfani da shi ba da izini: withHandler: don ganin idan har yanzu app ɗin yana da izini.
- Ƙirƙiri wani AMZNA ba da izini Buƙatun ƙin kuma ƙayyade abubuwan da ke nuna bayanan mai amfani da aikace-aikacenku ke neman izini don. Don ƙarin bayani game da bigiren, duba Karɓar da Maballin shiga kuma sami Profile Bayanai.
- Saita AMZNA ba da izini Buƙatun.Bayani mai amfani ku AMZNIInteractiveStrategyKada. AMZNA ba da izini Buƙatun goyon bayan dabaru da yawa don sa hanzarin shiga mai amfani:
- AMZNIInteractiveStrategyAuto (tsoho): SDK yana neman tallafin izini a cikin gida daga wanda ya gabata ba da izini: withHandler: martani. Idan ɗayan ya kasance, ingantacce, kuma ya ƙunshi duk abubuwan da aka nema, SDK zai dawo da amsar nasara ta hanyar AMZNAn iziniRequestHandler, kuma ba zai sa mai amfani ya shiga ba. In ba haka ba, za a sa mai amfani ya shiga.
- AMZNIInteractiveStrategyKoyaushe: SDK koyaushe zai faɗakar da mai amfani don shiga ba tare da la'akari da ko a baya an ba su izini su yi amfani da aikace-aikacen ba. Lokacin da aka sa mai amfani, SDK zai cire duk taimakon izini da aka ajiye a cikin gida don aikace-aikacen.
- AMZNIInteractiveStrategyKada: SDK yana neman tallafin izini a cikin gida daga wanda ya gabata ba da izini: withHandler martani. Idan ɗayan ya kasance, mai inganci, kuma ya ƙunshi dukkan abubuwan da aka nema, SDK zai dawo da shi AMZNA ba da izini Sakamakon abu wanda ya ƙunshi alamar shiga da pro mai amfanifile data.
In ba haka ba, zai dawo da wani NSError abu ta hanyar AMZNAn iziniRequestHandler.// Gina neman izini.
AMZNAuthorizeRequest * request = [[AMZNAuthorizeRequest alloc] init];
request.scopes = [NSArray tsararruWithObjects:
// [AMZNProfileMai amfani ID],
[AMZNPRfileGirman profile],
[AMZNPRfileScope postalCode]];request.interactiveStrategy = AMZNInteractiveStrategyNever;[[AMZNAuthorizationManager sharedManager] ya ba da izini: buƙatar
withHandler: ^ (AMZNAuthorizeResult * sakamakon, BOOL
userDidCancel, NSError * kuskure) {
idan (kuskure) {
// Kuskure daga SDK, yana nuna mai amfani bai kasance a baya ba
an ba da izini ga kayan aikinku don abubuwan da aka nema.
} kuma {
// Mai amfani an ba shi izini a baya don aikace-aikacenku.
// Sami alamar shiga da pro mai amfanifile data.
NSString * samun damarToken = result.token;
AMZNUser * mai amfani = result.user;
NSString * userID = mai amfani.userID;
}
}];
Wannan ɓangaren yana bayanin yadda ake amfani da sa hannu hanya don share bayanan izinin mai amfani daga duka AIMobileLib kantin bayanan gida, da uwar garken izini. Dole mai amfani ya sake shiga domin app ɗin ya dawo da profile bayanai. Yi amfani da wannan hanyar don fita mai amfani, ko don warware matsalolin shiga cikin app.
- Aiwatar da hanyar fita.
Lokacin da mai amfani ya sami nasarar shiga, yakamata ku samar da tsarin fitarwa don su iya share profile bayanai da iyakoki masu izini a baya. Na'urar ku na iya zama hanyar haɗin kai, maɓalli, ko abun menu. - Kira sa hannu:.
Kira sa hannu: a cikin mai sarrafa ficewar ku don cire bayanan izini na mai amfani (alamu na shiga, profile) daga kantin sayar da gida, da kuma yanayin tabbatar da su daga uwar garken. Sigar shigarwa zuwa sa hannu wani ne AMZNAn iziniRequestHandler toshe abun. Yakamata block din ya gano kuma ya rike NSError abubuwa, waɗanda aka dawo dasu lokacin sa hannu: kasa.Alamar [[AMZNAuthorizationManager sharedManager] saiti: ^ (NSError * _Nullable
kuskure) {
idan (! kuskure) {
// kuskure daga SDK ko Shiga tare da sabar izini na Amazon.
}
}];
Gwada Hadin kai
Kaddamar da aikace-aikacenku a cikin na'urar iOS ko na'urar kwaikwayo kuma ku tabbatar kuna iya shiga tare da takardun shaidarku na Amazon.com.
Lura: Lokacin gwaji akan masu kwaikwayon iOS10, kuna iya ganin saƙon kuskure APIKey don Aikace-aikacen baya aiki za a ba da izini ga UserForScopes nema, ko Lambar Kuskuren da Ba a sani ba don a bayyanaAuthorizationState nema. Wannan shi ne san bug tare da Apple wanda ke faruwa yayin da SDK yayi ƙoƙarin samun damar maɓallin kewayawa. Har sai Apple ya warware kwaro, zaku iya aiki a kusa da shi ta hanyar ba da damar Raba maɓallan maɓalli don aikace-aikacenku a ƙarƙashin Abubuwan iyawa shafin abin da kake so. Wannan kwaron yana tasiri ne kawai ga masu kwaikwaya. Kuna iya gwada akan ainihin kayan aikin iOS10 ba tare da amfani da kowane aiki ba.
Shiga ciki tare da Jagoran Farawa na Amazon don ƙa'idodin iOS - Zazzage [gyarawa]
Shiga ciki tare da Jagoran Farawa na Amazon don ƙa'idodin iOS - Zazzagewa