Mewngofnodi gydag Amazon Getting Started Guide ar gyfer iOS

 

Mewngofnodi gydag Amazon: Canllaw Cychwyn Arni ar gyfer iOS

Hawlfraint © 2016 Amazon.com, Inc., neu ei gysylltiadau. Cedwir pob hawl.
Mae Amazon a logo Amazon yn nodau masnach Amazon.com, Inc. neu ei gysylltiadau. Mae pob nod masnach arall nad yw'n eiddo i Amazon yn eiddo i'w perchnogion priodol.

Dechrau Arni ar gyfer iOS

Yn y canllaw hwn byddwn yn dangos i chi sut i ychwanegu Mewngofnodi gydag Amazon i'ch app iOS. Ar ôl cwblhau'r canllaw hwn, dylech fod â botwm Mewngofnodi gydag Amazon yn eich app i ganiatáu i ddefnyddwyr fewngofnodi gyda'u cymwysterau Amazon

Gosod Xcode

Darperir y Mewngofnodi gydag Amazon SDK ar gyfer iOS gan Amazon i'ch helpu i ychwanegu Mewngofnodi gydag Amazon i'ch cais iOS. Bwriedir i'r SDK gael ei ddefnyddio gydag amgylchedd datblygu Xcode. Mae'r SDK yn cefnogi apiau sy'n rhedeg ar iOS 7.0 ac yn ddiweddarach gan ddefnyddio ARMv7, ARMv7s, ARM64, i386, ax86_64.

Gallwch chi osod Xcode o'r Mac App Store. Am fwy o wybodaeth, gweler Xcode: Beth sy'n Newydd ar datblygwr.apple.com.

Ar ôl gosod Xcode, gallwch chi Gosodwch y Mewngofnodi gydag Amazon SDK ar gyfer iOS a Rhedeg yr Sample App, fel y disgrifir isod.

Gosodwch y Mewngofnodi gydag Amazon SDK ar gyfer iOS

Mae'r Mewngofnodi gydag Amazon SDK ar gyfer iOS yn dod mewn dau becyn. Mae'r cyntaf yn cynnwys llyfrgell iOS a dogfennaeth ategol. Mae'r ail yn cynnwys felample rhaglen sy'n caniatáu i ddefnyddiwr fewngofnodi a view eu profile data.

Os nad ydych wedi gosod Xcode eto, gweler y cyfarwyddiadau yn y Gosod Xcode adran uchod.

1. Lawrlwythwch MewngofnodiWithAmazonSDKForiOS.zip a detholiad y files i gyfeiriadur ar eich gyriant caled.
   Fe ddylech chi weld a MewngofnodiWithAmazon.framework cyfeiriadur. Mae hyn yn cynnwys y llyfrgell Mewngofnodi gydag Amazon.
   Ar lefel uchaf y sip mae a MewngofnodiWithAmazon.doc cyfeiriadur gosod. Mae hyn yn cynnwys y ddogfennaeth API.
2. Gwel Gosodwch y Mewngofnodi gyda Llyfrgell Amazon am gyfarwyddiadau ar sut i ychwanegu'r llyfrgell at brosiect iOS.

Pan fydd y Mewngofnodi gydag Amazon SDK ar gyfer iOS wedi'i osod, gallwch chi Creu Mewngofnodi Newydd gyda Phrosiect Amazon ar ol Cofrestru gyda Mewngofnodi gydag Amazon.

Rhedeg yr Sample App

I redeg y sample cais, agorwch y sample yn Xcode.

1. Lawrlwythwch SampleLoginWithAmazonAppForiOS.zip a chopi y
   Sampcyfeiriadur leLoginWithAmazonAppForiOS i'ch ffolder Dogfennau.
2. Dechreuwch Xcode. Os bydd y deialog Croeso i Xcode yn ymddangos, cliciwch Open Other. Fel arall, o'r brif ddewislen, cliciwch File a dewiswch Agored.
3. Dewiswch y ffolder Dogfennau, a dewiswch
   SampleLoginWithAmazonAppForiOS / LoginWithAmazonSample / LoginWithAmazonSample.xcodeproj. Cliciwch Agor.
4. Y sampdylai'r prosiect nawr lwytho. Pan fydd wedi gorffen, dewiswch Cynnyrch o'r brif ddewislen a dewis Rhedeg

Cofrestru gyda Mewngofnodi gydag Amazon

Cyn y gallwch chi ddefnyddio Mewngofnodi gydag Amazon ar a websafle neu mewn ap symudol, rhaid i chi gofrestru cais gyda Mewngofnodi gydag Amazon. Eich cymhwysiad Mewngofnodi gydag Amazon yw'r cofrestriad sy'n cynnwys gwybodaeth sylfaenol am eich busnes, a gwybodaeth am bob un webgwefan neu ap symudol rydych chi'n ei greu sy'n cefnogi Mewngofnodi gydag Amazon. Mae'r wybodaeth fusnes hon yn cael ei harddangos i ddefnyddwyr bob tro y byddant yn defnyddio Mewngofnodi gydag Amazon ar eich websafle neu ap symudol. Bydd defnyddwyr yn gweld enw'ch cais, eich logo, a dolen i'ch polisi preifatrwydd. Mae'r camau hyn yn dangos sut i gofrestru cais Mewngofnodi gydag Amazon ac ychwanegu app iOS i'r cyfrif hwnnw.

Gweler y pynciau canlynol

• Cofrestrwch Eich Mewngofnodi gyda Amazon Application
• Ychwanegwch App iOS i Ddiogelwch Profile
• ID Bwndel iOS ac Allweddi API
  o Pennu Dynodwr Bwndel ar gyfer App iOS
  o Adalw Allwedd API iOS

Cofrestrwch Eich Mewngofnodi gyda Amazon Application

1. Ewch i https://login.amazon.com.
2. Os ydych wedi cofrestru ar gyfer Mewngofnodi gydag Amazon o'r blaen, cliciwch Consol App. Fel arall, cliciwch Cofrestrwch.
   Cewch eich ailgyfeirio i Seller Central, sy'n trin cofrestriad cais ar gyfer Mewngofnodi gydag Amazon. Os mai hwn yw'ch tro cyntaf yn defnyddio Seller Central, gofynnir ichi sefydlu cyfrif Gwerthwr Canolog.
3. Cliciwch Cofrestru Cais Newydd. Mae'r Cofrestrwch Eich Cais bydd y ffurflen yn ymddangos:
   
   a. Yn y ffurflen Cofrestru Eich Cais, nodwch Enw ac a Disgrifiad ar gyfer eich cais.
   Mae'r Enw yw'r enw a ddangosir ar y sgrin caniatâd pan fydd defnyddwyr yn cytuno i rannu gwybodaeth â'ch cais. Mae'r enw hwn yn berthnasol i Android, iOS, a webfersiynau gwefan o'ch cais.
   b. Rhowch Hysbysiad Preifatrwydd URL ar gyfer eich cais.
   Yr Hysbysiad Preifatrwydd URL yw lleoliad polisi preifatrwydd eich cwmni neu'ch cais (ar gyfer cynample, http: //www.example.com/privacy.html). Mae'r ddolen hon yn cael ei harddangos i ddefnyddwyr ar y sgrin gydsynio.
   c. Os ydych am ychwanegu a Delwedd Logo ar gyfer eich cais, cliciwch Pori a lleoli'r ddelwedd berthnasol.
   Arddangosir y logo hwn ar y sgrin mewngofnodi a chydsynio i gynrychioli eich busnes neu websafle. Bydd y logo yn cael ei grebachu i 50 picsel o uchder os yw'n dalach na 50 picsel; nid oes cyfyngiad ar led y logo.
4. Cliciwch Arbed. Eich sampDylai cofrestru edrych yn debyg i hyn:
   Ar ôl eich gosodiadau cais sylfaenol yn cael eu cadw, gallwch ychwanegu gosodiadau ar gyfer penodol webgwefannau ac apiau symudol a fydd yn defnyddio'r cyfrif Mewngofnodi hwn gydag Amazon.
   

Os oes gan wahanol fersiynau o'ch app IDau bwndel gwahanol, megis ar gyfer un neu fwy o fersiynau profi a fersiwn gynhyrchu, mae angen Allwedd API ei hun ar gyfer pob fersiwn. O'r Gosodiadau iOS o'ch app, cliciwch y Ychwanegu Allwedd API botwm i greu allweddi ychwanegol ar gyfer eich app (un fesul fersiwn).

Ychwanegwch App iOS i Ddiogelwch Profile

Ar ôl eich gosodiadau cais sylfaenol yn cael eu cadw, gallwch ychwanegu gosodiadau ar gyfer penodol webgwefannau ac apiau symudol a fydd yn defnyddio'r cyfrif Mewngofnodi hwn gydag Amazon.

I gofrestru App iOS, mae'n rhaid i chi nodi'r dynodwr Bwndel ar gyfer prosiect yr app. Bydd mewngofnodi gydag Amazon yn defnyddio'r ID bwndel i gynhyrchu allwedd API. Bydd yr allwedd API yn caniatáu mynediad i'ch app i'r gwasanaeth awdurdodi Mewngofnodi gydag Amazon. Dilynwch y camau hyn i ychwanegu app iOS i'ch cyfrif:

1. O'r sgrin Cais, cliciwch Gosodiadau iOS. Os oes gennych chi app iOS eisoes wedi'i gofrestru, edrychwch am y Ychwanegu Allwedd API botwm yn y Gosodiadau iOS adran.
   Mae'r Cais iOS Bydd y ffurflen fanylion yn ymddangos:
   
2. Rhowch y Label o'ch App iOS. Nid oes rhaid i hwn fod yn enw swyddogol eich app. Yn syml, mae'n nodi'r app iOS penodol hwn ymhlith yr apiau a webgwefannau sydd wedi'u cofrestru i'ch cais Mewngofnodi gydag Amazon.
3. Rhowch eich ID Bwndel. Rhaid i hyn gyd-fynd â dynodwr bwndel eich prosiect iOS. I bennu dynodwr eich bwndel, agorwch y prosiect yn Xcode. Agorwch y rhestr eiddo ar gyfer y prosiect ( -Info.plist) yn y Llywiwr y Prosiect. Dynodwr y Bwndel yw un o'r priodweddau ar y rhestr.
4. Cliciwch Arbed.

ID Bwndel iOS ac Allweddi API

Mae'r dynodwr Bwndel yn unigryw i bob app iOS. Mae mewngofnodi gydag Amazon yn defnyddio'r ID Bwndel i lunio'ch Allwedd API. Mae'r Allwedd API yn galluogi'r gwasanaeth awdurdodi Mewngofnodi gydag Amazon i gydnabod eich app.

Pennu Dynodwr Bwndel ar gyfer App iOS

1. Agorwch eich prosiect app yn Xcode.
2. Agorwch y Rhestr Eiddo Gwybodaeth ar gyfer y prosiect ( -Info.plist) yn y Llywiwr y Prosiect.
3. Darganfod Dynodwr bwndel yn y rhestr eiddo.

Adalw Allwedd API iOS

Ar ôl i chi gofrestru fersiwn iOS a darparu ID Bwndel, gallwch adfer yr allwedd API o'r dudalen gofrestru ar gyfer eich cais Mewngofnodi gydag Amazon. Bydd angen i chi roi'r allwedd API honno ar restr eiddo eich prosiect. Hyd nes y gwnewch hynny, ni fydd yr ap yn cael ei awdurdodi i gyfathrebu â'r gwasanaeth Mewngofnodi Mewngofnodi gydag Amazon.

1. Ewch i https://login.amazon.com.
2. Cliciwch Consol App.
3. Yn y Apiau blwch, cliciwch eich cais.
4. Dewch o hyd i'ch app iOS o dan y Gosodiadau iOS adran. Os nad ydych eisoes wedi cofrestru app iOS, gweler Ychwanegwch App iOS i Ddiogelwch Profile.
5. Cliciwch Cynhyrchu Gwerth Allweddol API. Bydd ffenestr naid yn arddangos eich allwedd API. I gopïo'r allwedd, cliciwch Dewiswch Pawb i ddewis yr allwedd gyfan.
Nodyn: Mae Gwerth Allweddol API wedi'i seilio'n rhannol ar yr amser y mae'n cael ei gynhyrchu. Felly, gall Gwerth (au) Allweddol API rydych chi'n eu cynhyrchu fod yn wahanol i'r gwreiddiol. Gallwch ddefnyddio unrhyw un o'r Gwerthoedd Allweddol API hyn yn eich app gan eu bod i gyd yn ddilys.
6. Gw Ychwanegwch Eich Allwedd API i'ch Rhestr Eiddo App am gyfarwyddiadau ar ychwanegu'r allwedd API i'ch app iOS

Creu Prosiect Mewngofnodi gydag Amazon

Yn yr adran hon, byddwch yn dysgu sut i greu prosiect Xcode newydd ar gyfer Mewngofnodi gydag Amazon a ffurfweddu'r prosiect.

Gweler y pynciau canlynol:

• Creu Mewngofnodi Newydd gyda Phrosiect Amazon
• Gosodwch y Mewngofnodi gyda Llyfrgell Amazon
• Ychwanegwch Eich Allwedd API i'ch Rhestr Eiddo App
• Ychwanegu a URL Cynllun i'ch Rhestr Eiddo Ap
• Ychwanegwch Eithriad Diogelwch Cludiant App ar gyfer Amazon i'ch Ap Rhestr Eiddo
  NODYN: Mae angen y cam newydd hwn ar hyn o bryd wrth ddatblygu ar y iOS 9 SDK
• Ychwanegwch Mewngofnodi gyda Botwm Amazon i'ch Ap

Creu Mewngofnodi Newydd gyda Phrosiect Amazon

Os nad oes gennych brosiect app eto ar gyfer defnyddio Mewngofnodi gydag Amazon, dilynwch y cyfarwyddiadau isod i greu un. Os oes gennych ap sy'n bodoli eisoes, sgipiwch i'r adran Gosod y Mewngofnodi gyda Llyfrgell Amazon isod.

1. Lansio Xcode.
2. Os cyflwynir a Croeso i Xcode ymgom, dewis Creu Prosiect Xcode Newydd.
   Fel arall, o'r File dewislen, dewis Newydd a Prosiect.
3. Dewiswch y math o brosiect rydych chi am ei greu a chlicio Nesaf.
4. Rhowch a Enw Cynnyrch ac a Dynodwr Cwmni. Sylwch ar eich Dynodydd Bwndel, a chliciwch Nesaf.
5. Dewiswch leoliad i storio'ch prosiect ynddo a chlicio Creu.
   Nawr bydd gennych chi brosiect newydd y gallwch ei ddefnyddio i alw Mewngofnodi gydag Amazon.

Gosodwch y Mewngofnodi gyda Llyfrgell Amazon

Os nad ydych eto wedi lawrlwytho'r Mewngofnodi gydag Amazon SDK ar gyfer iOS, gweler Gosodwch y Mewngofnodi gydag Amazon SDK ar gyfer iOS.

Rhaid i brosiect Mewngofnodi gydag Amazon gysylltu'r MewngofnodiWithAmazon.framework a Diogelwch.framework llyfrgelloedd. Bydd angen i chi hefyd ffurfweddu'r llwybr chwilio fframwaith i ddod o hyd i'r Mewngofnodi gyda phenawdau Amazon

1. Gyda'ch prosiect ar agor yn Xcode, dewiswch y Fframweithiau ffolder, cliciwch File o'r brif ddewislen, ac yna dewiswch Ychwanegu Files i “Prosiect”.
2. Yn y dialog, dewiswch MewngofnodiWithAmazon.framework a cliciwchAdd.
   Os gwnaethoch chi ddefnyddio'r Login gyda llyfrgell Amazon 1.0, dilëwch y cyfeiriadur sdk mewngofnodi a amazon a mewngofnodi-gyda-amazon-sdk.a o'r ffolder Frameworks. Cliciwch Golygu o'r brif ddewislen a dewis Dileu.
3. Dewiswch enw eich prosiect yn y Llywiwr y Prosiect.
   Mae'r Golygydd y Prosiect yn ymddangos yn ardal olygydd gweithle Xcode.
4. Cliciwch enw eich prosiect o dan Targedau, a dewis Adeiladu Cyfnodau. Ehangwch Link Binary gyda Llyfrgelloedd a chliciwch ar yr arwydd plws i ychwanegu llyfrgell.
5. Yn y blwch chwilio, nodwch Diogelwch.framework. Dewiswch Security.framework andcliciwch Ychwanegu.
6. Yn y blwch chwilio, nodwch SafariServices.framework. Dewiswch SafariServices.framework a chliciwch Ychwanegu.
7. Yn y blwch chwilio, nodwch CoreGraphics.fframwaith. Dewiswch CoreGraphics.fframwaith a chliciwch Ychwanegu
8. Dewiswch Adeiladu Gosodiadau. Cliciwch Pawb i view pob lleoliad.
9. Dan Chwilio Llwybrau, sicrhau bod y MewngofnodiWithAmazon.framework cyfeiriadur yn y Llwybrau Chwilio Fframwaith.
   Am gynample:
   
   Os gwnaethoch chi ddefnyddio'r Login gyda llyfrgell Amazon 1.0, gallwch chi gael gwared ar unrhyw gyfeiriadau at lwybr llyfrgell 1.0 yn y Llwybrau Chwilio Pennawd or Llwybrau Chwilio Llyfrgelloedd.
10. O'r brif ddewislen, cliciwch Cynnyrch a dewis Adeiladu. Dylai'r gwaith adeiladu gwblhau'n llwyddiannus.
    Cyn adeiladu eich prosiect, os gwnaethoch chi ddefnyddio'r Login gyda llyfrgell Amazon 1.0, disodli #mewnforio “AIMobileLib.h”, #mewnforio “AIAuthenticationDelegate.h”, or #mewnforio “AIError.h” yn eich ffynhonnell files gyda #mewnforio
    .
    MewngofnodiWithAmazon.h yn cynnwys yr holl Mewngofnodi gyda phenawdau Amazon ar unwaith.

Ychwanegwch Eich Allwedd API i'ch Rhestr Eiddo App

Pan fyddwch chi'n cofrestru'ch cais iOS gyda Mewngofnodi gydag Amazon, rhoddir allwedd API i chi. Mae hwn yn ddynodwr y bydd Llyfrgell Symudol Amazon yn ei ddefnyddio i nodi'ch cais i'r gwasanaeth awdurdodi Mewngofnodi gydag Amazon. Mae Llyfrgell Symudol Amazon yn llwytho'r gwerth hwn ar amser rhedeg o werth eiddo Allweddol API yn Rhestr Eiddo Gwybodaeth eich cais.

1. Gyda'ch prosiect ar agor, dewiswch y Yn cefnogi Files ffolder, yna dewiswch y -Info.plist file (lle yw enw eich prosiect). Dylai hyn agor y rhestr eiddo i'w golygu:
   
2. Sicrhewch nad oes unrhyw un o'r cofnodion yn cael eu dewis. Yna, o'r brif ddewislen, cliciwch Golygydd, a Ychwanegu Eitem. Ewch i mewn Allwedd API a gwasg Ewch i mewn.
3. Cliciwch ddwywaith o dan y Gwerth colofn i ychwanegu gwerth. Gludwch eich Allwedd API fel y gwerth.

Ychwanegu a URL Cynllun i'ch Rhestr Eiddo Ap

Pan fydd y defnyddiwr yn mewngofnodi, cyflwynir tudalen fewngofnodi Amazon iddynt. Er mwyn i'ch app dderbyn cadarnhad o'u mewngofnodi, rhaid i chi ychwanegu a URL cynllun fel bod y web gall tudalen ailgyfeirio yn ôl i'ch app. Mae'r URL rhaid datgan bod cynllun amzn- (ar gyfer example, amzncom.example.app). Am fwy o wybodaeth, gweler Defnyddio URL Cynlluniau i Gyfathrebu ag Apiau ar datblygwr.apple.com.

1. Gyda'ch prosiect ar agor, dewiswch y Yn cefnogi Files ffolder, yna dewiswch y -Info.plist file (lle yw enw eich prosiect). Dylai hyn agor y rhestr eiddo i'w golygu:
   
2. Sicrhewch nad oes unrhyw un o'r cofnodion yn cael eu dewis. Yna, o'r brif ddewislen, cliciwch Golygydd, a Ychwanegu Eitem. Rhowch neu dewiswch URL mathau a gwasg Ewch i mewn.
3. Ehangu URL mathau i ddatgelu Eitem 0. Dewiswch Eitem 0 ac, o'r brif ddewislen, cliciwch Golygydd ac Ychwanegu Eitem. Rhowch neu dewiswch URL Dynodwr a'r wasg Ewch i mewn.
4. Dewiswch Eitem 0 dan URL Dynodydd a chliciwch ddwywaith o dan y golofn Gwerth i ychwanegu gwerth. Y gwerth yw ID eich bwndel. Gallwch ddod o hyd i'ch ID bwndel wedi'i restru fel dynodwr Bwndel yn y rhestr eiddo.
5. Dewiswch Eitem 0 dan URL mathau ac, o'r brif ddewislen, cliciwch Golygydd a Ychwanegu Eitem. Rhowch neu dewiswch URL Cynlluniau a gwasgwch Enter.
6. Dewiswch Eitem 0 dan URL Cynlluniau a chlicio ddwywaith o dan y Gwerth colofn i ychwanegu a gwerth. Y gwerth yw ID eich bwndel gyda amzn- gwariant (ar gyfer example, amzn com.example.app). Gallwch ddod o hyd i'ch ID bwndel wedi'i restru fel Dynodwr bwndel yn y rhestr eiddo.

Ychwanegwch Eithriad Diogelwch Cludiant App ar gyfer Amazon i'ch Ap
Rhestr Eiddo

Gan ddechrau gyda iOS 9, mae Apple yn gorfodi App Transport Security (ATS) ar gyfer cysylltiadau diogel rhwng ap a web gwasanaethau. Nid yw'r endpoint (api.amazon.com) y Mewngofnodi gydag Amazon SDK yn rhyngweithio ag ef i gyfnewid gwybodaeth yn cydymffurfio ag ATS eto. Ychwanegwch eithriad ar gyfer api.amazon.com i alluogi cyfathrebu di-dor rhwng y SDK a gweinydd Amazon.

1. Gyda'ch prosiect ar agor, dewiswch y Yn cefnogi Files ffolder, yna dewiswch y -Info.plist file (lle yw enw eich prosiect). Dylai hyn agor y rhestr eiddo yn forediting:
   
2. Sicrhewch nad oes yr un o'r cofnodion Yna, o'r brif ddewislen, cliciwch Golygydd, a Ychwanegu Eitem. Rhowch neu dewiswch NSAppTransportSecurity a gwasg Ewch i mewn.
3. Ehangu NSAppTransportSecurity ac, o'r brif ddewislen, cliciwch Golygydd a Ychwanegu Eitem. Rhowch neu dewiswch Parthau NSException a gwasg Ewch i mewn.
4. Ehangu Parthau NSException ac, o'r brif ddewislen, cliciwch Golygydd a Ychwanegu Eitem. Rhowch amazon.com a gwasgwch Ewch i mewn.
5. Ehangu amazon.com ac, o'r brif ddewislen, cliciwch Golygydd a Ychwanegu Eitem.Rhowch NSExceptionRequiresForwardSecrecy a gwasg Ewch i mewn.
6. Dewiswch NSExceptionRequiresForwardSecrecy a chlicio ddwywaith o dan y Gwerth colofn i ychwanegu Dewiswch a Math of Boole ac a Gwerth of RHIF.

Ychwanegwch Mewngofnodi gyda Botwm Amazon i'ch Ap

Mae Mewngofnodi gydag Amazon yn darparu sawl botwm safonol y gallwch eu defnyddio i annog defnyddwyr i fewngofnodi o'ch app. Mae'r adran hon yn rhoi camau ar gyfer lawrlwytho Mewngofnodi swyddogol gyda delwedd Amazon a'i baru â UIButton iOS.

1. Ychwanegwch UIButton safonol i'ch app.
   Am sesiynau tiwtorial a gwybodaeth ar sut i ychwanegu botwm at ap, gweler Creu a Ffurfweddu View Gwrthrychau a Dechrau Datblygu iOS Apps Heddiw ar datblygwr.apple.com.
2. Ychwanegwch y Cyffwrdd y Tu Mewn digwyddiad ar gyfer y botwm i ddull a enwir arLoginButtonCliciwyd. Gadewch y gweithredu'n wag am nawr. Mae'r Creu a Ffurfweddu View Gwrthrychau a Dechrau Datblygu iOS Apps Heddiw mae dogfennau ar apple.com yn cynnwys camau ar ychwanegu digwyddiad botwm.
3. Dewiswch ddelwedd botwm.
   Ymgynghorwch â'n Mewngofnodi gydag Amazon Canllawiau Arddull am restr o fotymau y gallwch eu defnyddio yn eich app. Dadlwythwch gopi o'r LWA_for_iOS.zip file. Dewch o hyd i'ch botwm dewisol yn y cyfeirlyfrau 1x a 2xdirect a'u tynnu o'r sip. Tynnwch y fersiwn _Pressed o'ch botwm os ydych chi am ddangos y botwm mewn cyflwr Dethol.
4. Ychwanegwch y delweddau at eich prosiect.
   a. Yn Xcode, gyda'ch prosiect wedi'i lwytho, cliciwch File o'r brif ddewislen a dewis Ychwanegu Files i “brosiect”.
   b. Yn y dialog, dewiswch ddelwedd y botwm file(au) y gwnaethoch eu lawrlwytho a chlicio Ychwanegu.
   c. Dylai'r botymau nawr fod yn y prosiect o dan eich cyfeirlyfr prosiect. Symudwch nhw i'r Cefnogol Filesfolder.
5. Ychwanegwch y ddelwedd at eich botwm.
   Er mwyn galluogi'r ddelwedd ar gyfer eich botwm, gallwch addasu priodoledd y botwm neu ddefnyddio'r setImage: forState dull ar y UIButton gwrthrych. Dilynwch y camau hyn i addasu priodoledd delwedd eich botwm:
   a. Agorwch y bwrdd stori ar gyfer eich app.
   b. Dewiswch y botwm yn eich bwrdd stori trwy ei glicio neu ei ddewis o'r View Rheolydd Coeden olygfa.
   c. Yn y Cyfleustodau ffenestr, agorwch y Arolygydd Priodoleddau.
   
   d. Ar ben yr Arolygydd Priodoleddau, gosodwch y Math o botwm i'r System.
   e. Yn yr ail grŵp o leoliadau, dewiswch ddiofyn ar gyfer Config y Wladwriaeth.
   f. Yn yr ail grŵp o leoliadau, gwympwch y gosodiad Delwedd.
   g. Dewiswch y graffig botwm Mewngofnodi gydag Amazon y gwnaethoch ei ychwanegu at y prosiect. Peidiwch â dewis y fersiwn 2x: bydd yn cael ei lwytho'n awtomatig ar ddyfeisiau arddangos dwysedd uchel (Retina).
   h. Gosodwch yr un ddelwedd ar gyfer y gosodiad Cefndir.
   i. Os ydych chi am nodi fersiwn wedi'i wasgu o'r botwm, dewiswch Selected for State Config, a gosodwch y Ddelwedd i fersiwn _Pressed o'ch botwm.
   j. Ar y bwrdd stori, addaswch faint eich botwm i gynnwys y ddelwedd, os oes angen.

Defnyddio'r SDK ar gyfer iOS APIs

Yn yr adran hon, byddwch yn ychwanegu cod at eich prosiect i fewngofnodi defnyddiwr gyda Mewngofnodi gydag Amazon.
Gweler y pynciau canlynol:

• Trin y Botwm Mewngofnodi a Get Profile Data
• Gwiriwch am Mewngofnodi Defnyddwyr yn Startup
• Clir Awdurdodi Nodwch a Allgofnodi Defnyddiwr

Trin y Botwm Mewngofnodi a Get Profile Data

Mae'r adran hon yn esbonio sut i alw'r authorizeUserForScopes: dirprwy: a caelProfile: APIs i fewngofnodi defnyddiwr ac adfer ei profile data. Mae hyn yn cynnwys creu onLoginButtonClicked: gwrandäwr ar gyfer eich botwm Mewngofnodi gydag Amazon.

1. Ychwanegwch Mewngofnodi gydag Amazon i'ch prosiect iOS. Gweler Gosod y Mewngofnodi gyda Llyfrgell Amazon.
2. Mewngludo'r Mewngofnodi gydag Amazon API i'ch ffynhonnell file.
   I fewnforio'r Mewngofnodi gydag Amazon API, ychwanegwch y canlynol #datganiadau mewnforio i'ch ffynhonnell file:

   #import

3. Creu y Dosbarth AMZNAuthorizeUserDelegateclass i weithredu
   AIAuthenticationDelegator.
   Pryd authorizeUserForScopes: dirprwy: yn cwblhau, bydd yn galw'r caisDidSucceed: or caisDidFail: dull ar wrthrych sy'n gweithredu'r AIAuthenticationDelegator protocol.

   @interface AMZNAuthorizeUserDelegate: NSObject @end

   Am ragor o wybodaeth, gw Gweithio gyda Phrotocolau  ar datblygwr.apple.com.
4. Galwch authorizeUserForScopes: dirprwy: in onLoginButtonCliciwyd.
   Pe byddech chi'n dilyn y camau i mewn Ychwanegwch Mewngofnodi gyda Botwm Amazon i'ch Ap, dylech gael onLoginButtonClicked: dull wedi'i gysylltu â botwm Mewngofnodi gydag Amazon. Yn y dull hwnnw, ffoniwch authorizeUserForScopes: dirprwyo: i anogwch y defnyddiwr i fewngofnodi ac awdurdodi'ch cais.
   Bydd y dull hwn yn galluogi'r defnyddiwr i fewngofnodi a chydsynio i'r wybodaeth y gofynnwyd amdani mewn un o'r ffyrdd a ganlyn:
   1.) Yn newid i web view mewn cyd-destun diogel (os yw ap Siopa Amazon wedi'i osod ar y ddyfais)
   2.) Newid i Safari View Rheolwr (ar iOS 9 ac yn ddiweddarach)
   3.) Newid i borwr y system (ar iOS 8 ac yn gynharach)
   Mae'r cyd-destun diogel ar gyfer yr opsiwn cyntaf ar gael pan fydd ap Siopa Amazon wedi'i osod ar y ddyfais. Os yw'r defnyddiwr eisoes wedi mewngofnodi i ap Siopa Amazon, mae'r dudalen mewngofnodi wedi'i hepgor, gan arwain at a Arwyddo Sengl (SSO) profiad.

   Pan awdurdodir eich cais, caiff ei awdurdodi ar gyfer un neu fwy o setiau data a elwir yn sgopiau. Y paramedr cyntaf yw amrywiaeth o sgopiau sy'n cwmpasu'r data defnyddiwr rydych chi'n gofyn amdano gan Mewngofnodi gydag Amazon. Y tro cyntaf i ddefnyddiwr fewngofnodi i'ch app, bydd rhestr o'r data rydych chi'n gofyn amdani yn gofyn iddo a gofynnir iddo gael ei gymeradwyo. Ar hyn o bryd mae mewngofnodi gydag Amazon yn cefnogi tair sgop: profile, sy'n cynnwys enw'r defnyddiwr, cyfeiriad e-bost, ac id cyfrif Amazon; profile:ID Defnyddiwr, sy'n cynnwys id cyfrif Amazon yn unig; a Côd Post, sy'n cynnwys cod zip / post y defnyddiwr.
   Yr ail baramedr i authorizeUserForScopes: dirprwy: yn wrthrych sy'n gweithredu'r Protocol Cynrychiolwyr AIAaudentication, yn yr achos hwn enghraifft o'r AMZNAuthorizeUserDelegate dosbarth.

   - (IBAction) onLogInButtonClicked: (id) anfonwr { // Gwneud awdurdodiad galwad i SDK i gael tocyn mynediad diogel // ar gyfer y defnyddiwr. // Wrth wneud yr alwad gyntaf gallwch chi nodi'r isafswm sylfaenol // scopes sydd eu hangen. // Gofyn am y ddau sgop ar gyfer y defnyddiwr cyfredol. NSArray * requestScopes = [NSArray arrayWithObjects: @ ”profile”, @” Post_code ”, dim]; AMZNAuthorizeUserDelegate * dirprwy = [[AMZNAuthorizeUserDelegate dyraniad] initWithParentController: hunan]; [AIMobileLib awdurdodiUserForScopes: dirprwyo requestScopes: dirprwyo];

   Ychwanegwch bennawd gweithredu eich cynrychiolydd at y dosbarth yn galw
   authorizeUserForScopes :. Am gynample:

   #mewnforio “AMZNAuthorizeUserDelegate.h”

5. Creu a AMZNGetProfileCynrychiolydd.
   AMZNGetProfileCynadleddwyr ein henw ar gyfer dosbarth sy'n gweithredu'r
   Protocol Cynrychiolwyr AIAaudentication, a bydd yn prosesu canlyniad y caelProfile: galw. Fel authorizeUserForScopes: dirprwy :, getProfile: yn cefnogi'r caisDidSucceed: a caisDidFail: dulliau protocol. caisDidSucceed: yn derbyn Canlyniad API gwrthwynebu â profile data yn yr eiddo canlyniad. caisDidFail: yn derbyn AIGwall gwrthwynebu gyda gwybodaeth am y gwall yn yr eiddo gwall.
   I greu dosbarth cynrychiolwyr o ddatganiad dosbarth arferol, mewnforio
   AIAuthenticationDelegate.hand ychwanegwch y protocol at y datganiad ym mhennyn eich dosbarth file:

   #import @interface AMZNGetProfileCynrychiolydd: NSObject @end

    

6. Gweithredu requestDidSucceed: am eich AMZNAuthorizeUserDelegate. In requestDidSucceed :, galwad caelProfile: i adfer y cwsmer profile. caelProfile:, fel authorizeUserForScopes: dirprwy :, yn defnyddio'r protocol AIAuthenticationDelegate.
   

   - (gwag) caisDidSucceed: (APIResult *) apiResult { // Eich cod ar ôl i'r defnyddiwr awdurdodi cais am // scopes y gofynnwyd amdanynt. // Llwythwch newydd view rheolydd gyda'r defnyddiwr yn adnabod gwybodaeth // gan fod y defnyddiwr bellach wedi mewngofnodi'n llwyddiannus. AMZNGetProfileCynrychiolydd * dirprwy = [[[AMZNGetProfileAlloc cynadleddwr] initWithParentController:parentViewRheolwr] autorelease]; [AIMobileLib getProfile: dirprwyo]; }

   Ychwanegwch bennawd gweithredu eich cynrychiolydd at y dosbarth yn galw caelProfile:. Forexample:
   

   #mewnforio “AMZNGetProfileCynrychiolydd.h ”

7. Gweithredu caisDidSucceed: ar gyfer eich AMZNGetProfileCynrychiolydd.
   requestDidSucceed: wedi dwy brif dasg: adfer y profile data o'r Canlyniad API, ac i basio'r data i'r UI.
   I adfer y profile data o'r Canlyniad API, cyrchu'r eiddo canlyniad. Am caelProfile: ymateb, bydd yr eiddo hwnnw'n cynnwys geiriadur o werthoedd eiddo ar gyfer y defnyddiwr profile priodweddau. Mae'r profile eiddo yn enw, e-bost, a ID Defnyddiwr ar gyfer y profile cwmpas a
   cod_bost ar gyfer y cod_bost cwmpas.

   - (gwag) caisDidSucceed: (APIResult *) apiResult { // Cael profile cais wedi llwyddo. Dadbaciwch y profile gwybodaeth // a'i basio i'r rhiant view rheolydd NSString * name = [(NSDictionary *) apiResult.result objectForKey: @ ”enw”]; NSString * e-bost = [(NSDictionary *) apiResult.result objectForKey: @ ”e-bost”]; NSString * user_id = [(NSDictionary *) apiResult.result objectForKey: @ ”user_id”]; NSString * postal_code = [(NSDictionary *) apiResult.result objectForKey: @ ”post_code”]; // Trosglwyddo data i view rheolydd }

8. Gweithredu caisDidFail: ar gyfer eich AMZNGetProfileCynrychiolydd.
   caisDidFail: yn cynnwys an Gwall API gwrthrych sy'n cynnwys manylion am y gwall. dangosLogInPageis dull damcaniaethol a fyddai'n ailosod y prif view rheolydd i ddangos y botwm Mewngofnodi gydag Amazon.

   - (gwag) requestDidFail: (APIError *) errorResponse { // Cael Profile cais wedi methu am profile cwmpas. // Os cod gwall = kAIApplicationNotAuthorized, // caniatáu i'r defnyddiwr fewngofnodi eto. os (errorResponse.error.code == kAIApplicationNotAuthorized) { // Dangos botwm awdurdodi defnyddiwr. [rhiantViewDangosydd rheolwrLogInPage]; } arall { // Ymdrin â gwallau eraill [[[[UIAlertView dyrannu] initWithTitle: @ ”” neges: [NSString stringWithFormat: @ ”Digwyddodd gwall gyda'r neges:% @”, errorResponse.error.message] dirprwy: dim CanceButtonTitle: @ "OK" otherButtonTitles: dim] autorelease] sioe]; } }

9. Gweithredu requestDidFail: ar gyfer eich AMZNAuthorizeUserDelegate.
   

   - (gwag) requestDidFail: (APIError *) errorResponse { Neges NSString * = errorResponse.error.message; // Eich cod pan fydd yr awdurdodiad yn methu. [[[[UIAlertView dyrannu] initWithTitle: @ ”” neges: [NSString stringWithFormat: @ ”Methodd awdurdodiad defnyddiwr gyda'r neges:% @”, errorResponse.error.message] dirprwy: dim CanceButtonTitle: @ "OK" otherButtonTitles: dim] autorelease] sioe]; }

   10. Gweithredu cais: agoredURL: sourceApplication: anodiad: yn y dosbarth yn eich prosiect sy'n trin y UIACais Ddirprwywr protocol (yn ddiofyn hwn fydd y Dosbarth Dosbarth AppDelegate yn eich prosiect). Pan fydd yr app yn cyflwyno tudalen fewngofnodi Amazon, a bod y defnyddiwr yn cwblhau mewngofnodi, bydd yn ailgyfeirio i'r app gan ddefnyddio'r URL Cynlluniwch yr ap a gofrestrwyd yn gynharach. Trosglwyddir yr ailgyfeiriad hwnnw i cais: agoredURL: sourceApplication: anodiad :, sy'n dychwelyd OES os bydd y URL cafodd ei drin yn llwyddiannus. trinOpenURL: sourceApplication: yn swyddogaeth llyfrgell SDK a fydd yn trin Mewngofnodi gydag ailgyfeirio Amazon URLs i chi. Os trinOpenURL: sourceApplication: yn dychwelyd OES, yna y URL ei drin.

   - (BOOL) cais: (UIApplication *) cais agoredURL: (NSURL *)url sourceApplication: (NSString *) sourceApplication anodiad: (id) anodiad { // Pasio ymlaen y url i'r SDK i ddosrannu cod awdurdodi // o'r url. BOOL isRedirect SignInValidURL = [AIMobileLib handleOpenURL:url sourceAppli cation: sur ceApplicati on); os (! isValidRedirect Si gnlnURL) dychwelyd NA; // Efallai y bydd ap felly eisiau handlen e url dychwelyd OES; }

   NODYN: Nid yw'r dull hwn yn cael ei ystyried yn iOS 9 ond dylid ei gynnwys yn eich prosiect i gynnal cefnogaeth i ddefnyddwyr ar lwyfannau hŷn. Am fwy o wybodaeth ar cais: agoredURL: sourceApplication: anodiad :, gw Cyfeirnod Protocol UIApplicationDelegate ar datblygwr.apple.com.

Gwiriwch am Mewngofnodi Defnyddwyr yn Startup

Os yw defnyddiwr yn mewngofnodi i'ch app, yn cau'r app, ac yn ailgychwyn yr ap yn ddiweddarach, mae'r app yn dal i gael ei awdurdodi i adfer data. Nid yw'r defnyddiwr wedi'i allgofnodi'n awtomatig. Ar y cychwyn, gallwch ddangos i'r defnyddiwr ei fod wedi mewngofnodi os yw'ch app yn dal i gael ei awdurdodi. Mae'r adran hon yn esbonio sut i ddefnyddio
getAccessTokenForScopes: withOverrideParams: dirprwy: i weld a yw'r app wedi'i awdurdodi o hyd.

1. Creu a AMZNGetAccessTokenDelegator dosbarth. AmZNGetAccessTokenDelegateimplements yr AIAuthenticationDelegator protocol, a bydd yn prosesu canlyniad y
   getAccessTokenForScopes: withOverrideParams: dirprwy: galw. AIAuthenticationDelegator yn cynnwys dau ddull, caisDidSucceed: a requestDidFail :. requestDidSucceed: yn derbyn Canlyniad API gwrthwynebu gyda data tocyn, tra caisDidFail: yn derbyn Gwall API gwrthwynebu gyda gwybodaeth am y gwall.

   #import @interface AMZNGetAccessTokenDelegate: NSObject @diwedd

   Ychwanegwch bennawd gweithredu eich cynrychiolydd at y dosbarth yn galw
   getAccessTokenForScopes: withOverrideParams: dirprwy :. Forexample:

   #mewnforio “AMZNGetAccessTokenDelegate.h”

2. Wrth gychwyn app, ffoniwch
   getAccessTokenForScopes: withOverrideParams: dirprwy: i weld a yw'r cais yn dal i gael ei awdurdodi. getAccessTokenForScopes: withOverrideParams: dirprwy: yn adfer y tocyn mynediad amrwd y mae Mewngofnodi gydag Amazon yn ei ddefnyddio i gael mynediad at gwsmer profile. Os bydd y dull yn llwyddo, mae'r ap yn dal i gael ei awdurdodi a galwad i caelProfile: dylai lwyddo. getAccessTokenForScopes: withOverrideParams: dirprwy: yn defnyddio'r AIAuthenticationDelegator protocol yn yr un modd â authorizeUserForScopes: dirprwy :. Pasiwch y gwrthrych sy'n gweithredu'r protocol fel paramedr y cynadleddwr.

   - (gwag) checkIsUserSignedIn { AMZNGetAccessTokenDelegate * dirprwy = [[[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorelease]; NSArray * requestScopes = [NSArray arrayWithObjects: @ ”profile”, @” Post_code ”, dim]; [AIMobileLib getAccessTokenForScopes: requestScopes withOverrideParams: dim dirprwy: dirprwy]; }

3. Gweithredu caisDidSucceed: ar eich AMZNGetAccessTokenDelegator. caisDidSucceed: mae gan un dasg: galw caelProfile:. Mae'r cynample galwadau caelProfile: gan ddefnyddio'r un gwrandäwr a ddatganwyd gennych yn yr adran flaenorol (gweler camau 6-8).
   

   #mewnforio “AMZNGetProfileCynrychiolydd.h ” #import - (gwag) caisDidSucceed: (APIResult *) apiResult { // Mae eich cod i ddefnyddio tocyn mynediad yn mynd yma. // Gan fod gan y cais awdurdodiad ar gyfer ein sgopiau, gallwn // cael y defnyddiwr profile. AMZNGetProfileCynrychiolydd * dirprwy = [[[AMZNGetProfileDyraniad cynrychiolwyr] initWithParentController: rhiantViewRheolwr] autorelease]; [AIMobileLib getProfile: dirprwyo]; }

4. Gweithredu caisDidFail: ar eich AMZNGetAccessTokenDelegator.
   caisDidFail: yn cynnwys an Gwall API gwrthrych sy'n cynnwys manylion am y gwall. Os derbyniwch wall, gallwch ailosod y prif view rheolydd i ddangos y botwm Mewngofnodi gydag Amazon.

   - (gwag) requestDidFail: (APIError *) errorResponse { // Eich cod i drin methiant i adfer tocyn mynediad. // Os yw cod gwall = kAIApplicationNotAuthorized, caniatewch y defnyddiwr // i fewngofnodi eto. os (errorResponse.error.code == kAIApplicationNotAuthorized) { // Dangos Mewngofnodi gyda botwm Amazon. } arall { // Ymdrin â gwallau eraill [[[[UIAlertView dyrannu] initWithTitle: @ ”” neges: [NSString stringWithFormat: @ ”Digwyddodd gwall gyda'r neges:% @”, errorResponse.error.message] dirprwy: dim cancelButtonTitle:@”OK” otherButtonTitles:dim] autorelease] show]; } }

Wladwriaeth Awdurdodi Clir a aUser Allgofnodi

Mae'r WladwriaethAwdurdodi clir: bydd y dull yn clirio data awdurdodiad y defnyddiwr o'r AImobileLib storfa ddata leol. Bydd yn rhaid i ddefnyddiwr fewngofnodi eto er mwyn i'r ap adfer profile data. Defnyddiwch y dull hwn i allgofnodi defnyddiwr, neu i ddatrys problemau mewngofnodi yn yr app.

1. Datgan an Cynrychiolydd AMZNLogout. Mae hwn yn ddosbarth sy'n gweithredu'r
   AIAuthenticationProtocol. At ein dibenion, gallwn etifeddu'r dosbarth o NSO gwrthrych:
   

   #import @interface AMZNLogoutDelegate NSObject @diwedd

   Ychwanegwch bennawd gweithredu eich cynrychiolydd at y dosbarth yn galw clearAuthorizationState :. Am gynample:

   #mewnforio “AMZNLogoutDelegate.h”

2. Galwch clearAuthorizationState :.
   Pan fydd defnyddiwr wedi mewngofnodi'n llwyddiannus, gallwch ddarparu mecanwaith allgofnodi fel y gallant glirio ei ddata awdurdodi. Efallai y bydd eich mecanwaith yn hyperddolen, neu'n eitem ar y fwydlen, ond ar gyfer y senario hwn mae'r cynample bydd yn creu a dull allgofnodiButtonClicked am botwm allgofnodi.

   - (IBAction) logoutButtonClicked: (id) anfonwr { AMZNLogoutDelegate* dirprwy = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorelease]; [AimobileLib clearAuthorizationState:cynrychiolydd]; }

   Yr unig baramedr i glirAwdurdodiState yn an AIAuthenticationDelegator sy'n gweithredu caisDidSucceed: a requestDidFail :.

3. Gweithredu requestDidSucceed :. Gelwir y dull hwn pan fydd gwybodaeth y defnyddiwr yn cael ei chlirio. Yna dylech eu dangos fel rhai sydd wedi allgofnodi.
   

   - (gwag) caisDidSucceed: (APIResult *) apiResult { // Eich rhesymeg ychwanegol ar ôl awdurdodiad y defnyddiwr // state yn cael ei glirio. [[[UIAlertView dyrannu] initWithTitle: @ "" neges: @ "Defnyddiwr wedi mewngofnodi." cynrychiolydd:dim cansloButtonTitle:@”OK” otherButtonTeitlau:dim] sioe]; }

4. Gweithredu requestDidFail :. Gelwir y dull hwn os na ellir clirio gwybodaeth y defnyddiwr o'r storfa am ryw reswm. Yn yr achos hwnnw, ni ddylech eu dangos fel rhai sydd wedi allgofnodi.
   

   - (gwag) requestDidFail: (APIError *) errorResponse { // Eich rhesymeg ychwanegol ar ôl i'r SDK fethu â chlirio // cyflwr yr awdurdodiad. [[[[UIAlertView dyrannu] initWithTitle: @ ”” neges: [NSString stringWithFormat: @ ”Methodd Allgofnodi Defnyddiwr gyda'r neges:% @”, errorResponse.error.message] dirprwy: dim cancelButtonTitle:@”OK” otherButtonTitles:dim] autorelease] show]; }

Profwch eich Integreiddiad

Lansio'ch app mewn dyfais iOS neu efelychydd a chadarnhau y gallwch fewngofnodi gyda'ch tystlythyrau Amazon.com.

Nodyn: Wrth brofi ar efelychwyr iOS10, efallai y gwelwch fod y neges gwall APIKey ar gyfer y Cais yn annilys ar gyfer cais awdurdodiUserForScopes, neu God Gwall Anhysbys ar gyfer cais clearAuthorizationState. Hwn yw nam hysbys gydag Apple sy'n digwydd pan fydd y SDK yn ceisio cyrchu'r keychain. Hyd nes y bydd Apple yn datrys y nam, gallwch weithio o'i gwmpas trwy alluogi Rhannu Keychain ar gyfer eich app o dan y tab Galluoedd targed eich app. Mae'r byg hwn yn effeithio ar efelychwyr yn unig. Gallwch brofi ar ddyfeisiau iOS10 go iawn heb ddefnyddio unrhyw waith.

Mewngofnodi gydag Amazon Getting Started Guide ar gyfer iOS Fersiwn 2.1.2 - Dadlwythwch [optimized]
Mewngofnodi gydag Amazon Getting Started Guide ar gyfer iOS Fersiwn 2.1.2 - Lawrlwythwch

Cyfeiriadau

• Llawlyfr Defnyddiwr