Cunnettatevi cù Amazon Guida introduttiva per app iOS
Cunnette vi cù Amazon: Guida introduttiva per iOS
Copyright © 2017 Amazon.com, Inc., o i so affiliati. Tutti i diritti riservati. Amazon è u logu Amazon sò marche di Amazon.com, Inc. o di i so affiliati. Tutti l'altri marchi chì ùn sò micca di Amazon sò pruprietà di i so rispettivi pruprietari.
Introduzione
In questa guida vi mostreremu cumu aghjunghje Login cù Amazon à a vostra app iOS, aduprendu u Login with Amazon SDK per iOS v3.0 +.
Dopu avè cumplettatu sta guida duverete avè un Login di cunnessione cù u buttone Amazon in a vostra app chì permette à l'utilizatori di cunnettassi cù e so credenziali Amazon. Per amparà di più nantu à u flussu di login i vostri clienti sperimenteranu quandu usanu Login cù Amazon in a vostra app, per piacè vedi u nostru Esperienza di u Cliente Overview per app iOS.
Installa iOS Developer Tools
Installa XCode
U login cun Amazon SDK per iOS hè furnitu da Amazon per aiutà à aghjunghje Login cun Amazon à a vostra applicazione iOS. U SDK hè destinatu à esse adupratu cù l'ambiente di sviluppu Xcode. U SDK supporta l'applicazioni in esecuzione in iOS 7.0 è più tardi cù ARMv7, ARMv7s, ARM64, i386, andx86_64.
Pudete installà Xcode da u Mac App Store. Per più infurmazione, vedi Xcode: Novità on developer.apple.com.
Dopu chì Xcode hè installatu, pudete Installa u Login cun Amazon SDK per iOS è Corri a Sampl'App, cum'è discrittu quì sottu.
Installa u Login cun Amazon SDK per iOS
U login cun Amazon SDK per iOS vene in dui pacchetti. U primu cuntene a biblioteca iOS è a documentazione di supportu. U secondu cuntene cum'èampl'applicazione chì permette à un utilizatore di cunnettà si è view u so profile dati.
Se ùn avete micca installatu Xcode, vedi l'istruzzioni in u Installa Xcode sezione sopra.
- Scaricate LoginWithAmazonSDKForiOS.zip è estrae u files à un annuariu in u vostru discu duru.
Duvete vede un annuariu LoginWithAmazon.framework. Questu cuntene u login cù a biblioteca Amazon.
À u livellu superiore di u zip hè un LoginWithAmazon.docset annuariu. Questu cuntene a documentazione API. - Vede Installà l'Accessu cù Amazon Library per struzzioni nantu à cumu aghjunghje a biblioteca à un prughjettu iOS.
Quandu u Login cun Amazon SDK per iOS hè installatu, pudete Crea un Novu Login cù u Prughjettu Amazon dopu à tè Registrazione cù Login cù Amazon.
Corri a Sampl'App
Per fà corre u sampl'applicazione, apre u sample in Xcode.
- Scaricate SampleLoginWithAmazonAppForiOS.zip è copià u
SampleLoginWithAmazonAppForiOS annuariu in u vostru cartulare Documenti. - Principià Xcode. Se u dialogu di Benvenutu à Xcode apparisce, fate cliccà Apri Altru. Altrimenti, cliccate nantu à u menu principale File è selezziunate Open.
- Sceglite u cartulare Documenti, è selezziunate
SampleLoginWithAmazonAppForiOS / LoginWithAmazonSample /
LoginWithAmazonSample.xcodeproj. Cliccate Apertu. - U sampU prugettu duverebbe avà caricà. Quandu hè finitu, sceglite Pruduttu da u menu principale, è selezziunate Corri.
Registrazione cù Login cù Amazon
Prima di pudè aduprà Login cù Amazon nantu à a websitu o in una app mobile, duvete registrà una applicazione cù Login cù Amazon. U vostru login cù l'applicazione Amazon hè a registrazione chì cuntene infurmazioni basi nantu à a vostra attività, è infurmazioni nantu à ognunu websitu o app mobile chì create chì supporta u login cù Amazon. Questa infurmazione cummerciale hè visualizata à l'utilizatori ogni volta chì utilizanu Login cù Amazon in u vostru websitu o app mobile. L'utilizatori vedenu u nome di a vostra applicazione, u vostru logu, è un ligame per a vostra pulitica di privacy. Queste tappe dimostranu cumu registrà a vostra app iOS per aduprà cun Login cù Amazon.
Registrate u vostru Connessione cù l'Applicazione Amazon
- Andà à https://login.amazon.com.
- Se avete firmatu per Login cù Amazon prima, cliccate App Console. Altrimenti, cliccate Firma. Sarete redirigitu à Seller Central, chì gestisce a registrazione di l'applicazione per Accedi cù Amazon. S'ellu hè a prima volta cù Seller Central, vi sarà dumandatu di creà un account Seller Central.
- Cliccate Registrate una nova applicazione. U Registrate a vostra Applicazione Cumpariscerà a forma:
a. In u Registru A vostra forma di candidatura, inserite a Nome è a Descrizzione per a vostra dumanda. U Nome hè u nome affissatu nantu à a pantalla di accunsentu quandu l'utilizatori accettanu di sparte infurmazioni cù a vostra applicazione. Stu nome hè appiicatu à Android, iOS è webversioni di u situ di a vostra dumanda.
U Descrizzione vi aiuta à distingue ognuna di e vostre Connessione cù l'applicazioni Amazon è ùn hè micca visualizata à l'utilizatori.
b. Entre a Avvisu di privacy URL per a vostra applicazione.
L'Informazioni di Privacità URL hè a situazione di a politica di riservatezza di a vostra impresa o di l'applicazione (per esample, http://www.example.com/privacy.html). Stu ligame hè visualizatu à l'utilizatori nantu à a pantalla di accunsentu.
c. Se vulete aghjunghje a Logo Image per a vostra applicazione, cliccate Sceglite File è localizza l'imaghjini applicabili.
Stu logò hè visualizatu nantu à u screnu di cunnessione è d'accunsentu per raprisentà a vostra impresa o websitu.
U logò serà ridottu à 50 pixel d'altezza se hè più altu di 50 pixel; ùn ci hè limitazione nantu à a larghezza di u logò. - Cliccate Salvà. U vostru sampa registrazione deve esse simile à questu:
Dopu chì i vostri paràmetri di l'applicazione di basa sò salvati, pudete aghjunghje paràmetri per specifichi websiti è app mobile chì utilizeranu questu Login cun account Amazon.
Se diverse versioni di a vostra app anu ID di fasciu sfarente, cume per una o più versioni di prova è una versione di produzione, ogni versione richiede a so Chjave API. Da a Configurazione iOS di a vostra app, cliccate nantu à Aggiungi Chiave API buttone per creà chjavi addiziunali per a vostra app (una per versione).
Aghjustate iOS Settings à a vostra Applicazione
Dopu chì i vostri paràmetri di l'applicazione di basa sò salvati, pudete aghjunghje paràmetri per specifichi websiti è app mobile chì utilizeranu Login cù Amazon.
Per registrà una App iOS, duvete specificà l'identificatore Bundle per u prughjettu di l'applicazione. U login cun Amazon utilizarà l'ID di bundle per generà una chjave API. A chjave API darà l'accessu à a vostra app per u login cù u serviziu d'autorizazione Amazon. Seguitate ste tappe per aghjunghje una app iOS à u vostru contu:
- Da u Applicazione schermu, cliccate Impostazioni iOS. Se avete dighjà una app iOS registrata, cercate u Aghjunghje Chjave API buttone in u Settings iOS sezione.
U Dettagli di Applicazione iOS Cumpariscerà a forma:
- Entre in Etichetta di a vostra App iOS.
Questu ùn deve micca esse u nome ufficiale di a vostra app. Identifica simpliciamente questa app iOS particulare trà l'applicazioni è websiti arregistrati in u vostru Connessione cù l'applicazione Amazon. - Entre u vostru ID Bundle. Questu deve currisponde à l'identificatore di u pacchettu di u vostru prughjettu iOS. Per determinà u vostru identificatore di bundle, aprite u prugettu in Xcode. Apri a lista di pruprietà per u prugettu (-Info.plist) in u Navigatore di Prughjettu. U Identificatore di bundle hè una di e pruprietà di a lista.
- Cliccate Salvà.
Se diverse versioni di a vostra app anu ID di bundle differenti, cum'è per una o più versioni di prova è una versione di produzione, ogni versione richiede a so Chjave API. Da a Configurazione iOS di a vostra app, fate un clic nantu à u buttone Add API Key per creà chjave addiziunali per a vostra app (una per versione).
ID iOS Bundle è Chjave API
L'identificatore Bundle hè unicu per ogni app iOS. U login cun Amazon utilizza u Bundle ID per custruisce
a vostra Chjave API. A Chjave API permette à u login cù u serviziu d'autorizazione Amazon di ricunnosce a vostra app.
Determinate un Identificatore Bundle per una App iOS
1. Aprite u vostru prughjettu di app in Xcode.
2. Aprite u Proprietà d'infurmazione Lista per u prugettu (-Info.plist) in u Prughjettivu Navigatore.
3. Truvate Identificatore di bundle in a lista di e pruprietà.
Recupera una Chjave API iOS
Dopu avè registratu una versione iOS è furnitu un ID Bundle, pudete recuperà a chjave API da a pagina di registrazione per u vostru Login cù l'applicazione Amazon. Duvete mette quella chjave API in a lista di pruprietà di u vostru prugettu. Finu à quandu, l'app ùn serà micca autorizata à cumunicà cù u login cù u serviziu d'autorizazione Amazon.
- Andà à https://login.amazon.com.
- Cliccate App Console.
- In u Apps scatula, cliccate nantu à a vostra applicazione.
- Truvate a vostra app iOS sottu u Settings iOS sezione.
Se ùn avete micca digià registratu una app per iOS, vedi Aghjustate iOS Settings à una Applicazione. - Cliccate Generate u valore di chjave API. Una finestra popup vi mostrarà a vostra chjave API. Per cupià a chjave, cliccate Selezziunà tuttu per selezziunà a chjave sana.
Nota: U Valore Chjave API si basa, in parte, nantu à u tempu chì hè generatu. Cusì, u Valore (i) Chjave API sussegwenti chì generate pò differisce da l'uriginale. Pudete aduprà qualsiasi di questi Valori Chjave API in a vostra app perchè sò tutti validi. - Vede Aghjunghjite a vostra Chjave API à u vostru Lista di Proprietà App per istruzzioni nantu à l'aggiunta di a chjave API à a vostra app iOS
Crea un Login cù Amazon Project
In questa sezione, amparerai à creà un novu prughjettu Xcode per Accedi cù Amazon è cunfigurà u prugettu.
Crea un Novu Login cù u Prughjettu Amazon
Se ùn avete micca ancu un prughjettu di app per aduprà Login cù Amazon, seguitate e istruzioni sottu per creà unu. Se avete una app esistente, saltate à u Installa u Login cù Amazon Library sezione sottu.
- Lanciari Xcode.
- Se vi sò presentati cun un Benvenutu à Xcode dialogu, selezziunà Crià un Novu Prughjettu Xcode.
Altrimenti, da u File menu, selezziunà Novu è Prughjettu. - Sceglite u tippu di prughjettu chì vulete creà è cliccate Dopu.
- Entre a Nome di u produttu è a Identificatore di Cumpagnia. Nota a vostra Identificatore di Bundle, è cliccate Next.
- Sceglite un locu induve almacenà u vostru prughjettu è cliccate Crià.
Avete avà un novu prughjettu chì pudete aduprà per chjamà Login cù Amazon.
Installa u Login cù Amazon Library
Se ùn avete micca scaricatu l'Accessu cù Amazon SDK per iOS, vedi Installa u Login cun Amazon SDK per iOS.
Un Prughjettu Connessione cù Amazon deve ligà u LoginWithAmazon.framework è Sicurezza.cadratura librerie. Averete ancu bisognu di cunfigurà u percorsu di ricerca di quadru per truvà l'Accessu cù l'intestazione di Amazon.
- Se u vostru prugettu ùn hà micca un cartulare Frameworks, cliccate cù u dirittu nantu à u nome di u prugettu in u Navigatore
pane in Xcode, dopu cliccate Novu Gruppu. - Nome u novu gruppu Quadri.
- Selezziunà u Frameworks cartulare è cliccate File da u menu principale.
- Selezziunà Add Files à Prughjettu.
- In u dialogu, selezziunate LoginWithAmazon.framework è cliccate Add.
Se avete usatu u login cù a libreria Amazon 1.0, sguassate u login-cun-amazon-sdk annuariu è login-cun-amazon-sdk.a da u cartulare Frameworks. Cliccate Modificà da u menu principale è selezziunate Sguassà. - Sceglite u nome di u vostru prugettu in u Navigatore di u Prughjettu.
U Editor Editor Cumpariscerà in l'area di l'editore di u spaziu di travagliu Xcode. - Cliccate nantu à u vostru nome di prughjettu sottu Obiettivi, è selezziunate Custruisce Fasi. Espandi Link Binariu cù Biblioteche è cliccate nantu à u segnu più per aghjunghje una biblioteca.
- In a casella di ricerca, entre Sicurezza.cadratura. Selezziunà Security.framework è cliccate Add.
- In a casella di ricerca, entre SafariServices.framework. Selezziunà SafariServices.framework è cliccate Add.
- Selezziunate Impostazioni di Custruita. Cliccate Tutti à view tutti i paràmetri.
- Sottu Percorsi di ricerca, assicuratevi chì u LoginWithAmazon.framework U repertoriu hè in Percorsi di Ricerca Framework.
Per esampLe:
- Prima di custruisce u vostru prughjettu, se avete usatu u login cù a libreria Amazon 1.0, rimpiazzate #import "AIMobileLib.h", #import "AIAuthenticationDelegate.h", è #import "AIError.h" in a vostra fonte files cù una sola #importazione
. U LoginWithAmazon.hline include tutte e Login cù e intestazioni di Amazon in una volta.
Inoltre, pudete eliminà ogni riferenza à u percorsu di a libreria 1.0 in u Percorsi di Ricerca di Intestazione o Percorsi di Ricerca di Bibliuteca.
13. Da u menu principale, cliccate Pruduttu è selezziunate Custruì. A custruzzioni duveria compie cù successu.
Aghjunghjite a Vostra Chjave API à a Vostra Lista di Proprietà App
Quandu si registra a vostra applicazione iOS cù Login cù Amazon, vi hè assignata una chjave API. Questu hè un identificatore chì a Libreria Mobile Amazon utilizarà per identificà a vostra applicazione à u login cù u serviziu d'autorizazione Amazon. A Biblioteca Mobile Amazon carica questu valore in runtime da u valore di a pruprietà APIKey in a Lista di pruprietà d'infurmazioni di a vostra applicazione.
- Cù u vostru prugettu apertu, selezziunate u U sustegnu Files cartulare, dopu selezziunate u -Info.plist file (induve hè u nome di u vostru prugettu). Questu averebbe apre u listinu di pruprietà per edità:
- Assicuratevi chì nessuna di e entrate sia selezionata. Dopu, da u menu principale, fate cliccà Editor, è Aghjunghje Articulu. Entre APIKey è pressu Entre.
- Doppiu cliccà sottu u Valore colonna per aghjunghje un valore. Incolla a vostra Chjave API cum'è valore.
Aghjunghjite a URL Schema per a vostra Lista di Proprietà App
Quandu l'utilizatore accede, saranu presentati cù una pagina di login di Amazon. Per chì a vostra app ricevi cunferma di u so login, duvete aghjunghje un URL schema per chì u web pagina pò redirige di novu à a vostra app. U URL schema deve esse dichjaratu cum'è amzn- (per esample, amzncom.example.app). Per più infurmazione, vedi Utilizendu URL Schemi per Cumunicà cù l'Apps nantu à developer.apple.com.
- Cù u vostru prugettu apertu, selezziunate u Supporting Filecartulare s, dopu selezziunate u -Info.plist file (induve hè u nome di u vostru prugettu). Questu averebbe apre u listinu di pruprietà per edità:
- Assicuratevi chì nessuna di e entrate sia selezionata. Dopu, da u menu principale, fate cliccà Editor, è Aghjunghje Articulu. Entre o selezziunate URL tippi è pressu Entre.
- Espandi URL tippi per revelà Articulu 0. Selezziunà Articulu 0 è, da u menu principale, cliccate Editore è Aghjunghje Articulu. Entre o selezziunate URL Identificatore è pressu Entre.
- Selezziunà Articulu 0 sottu URL Identificatore è fate doppiu cliccà sottu à u Valore colonna per aghjunghje un valore. U valore hè u vostru ID bundle. Pudete truvà u vostru ID bundle listatu cum'è Identificatore di bundle in a lista di pruprietà.
- Selezziunà Articulu 0 sottu URL tippi è, da u menu principale, cliccate Editore è Add Item. Entre o selezziunate URL Schemi è preme Enter.
- Selezziunà Articulu 0 sottu URL Schemi è fate doppiu cliccà sottu à a colonna Valore per aghjunghje un valore. U valore hè u vostru ID bundle cù amzn- prepended (per esample, amzn com.example.app). Pudete truvà u vostru ID bundle listatu cum'è Identificatore di bundle in a lista di pruprietà.
U login cun Amazon furnisce parechji buttoni standard chì pudete aduprà per invità l'utilizatori à accede da a vostra app.
Questa sezzione dà passi per scaricà un Login ufficiale cù a maghjina Amazon è l'abbinamentu cù un iOS UIButton.
- Aghjunghje un standard UIButton à a vostra app.
Per tutoriali è informazioni nantu à cume aghjunghje un buttone à una app, vedi Creazione è Configurazione View Oggetti è Iniziate a Sviluppà Apps iOS oghje nantu à developer.apple.com. - Aghjunghjite u Ritocca Dentru avvenimentu per u buttone per un metudu chjamatu
onLoginButtonCliccatu. Lascià l'implementazione viota per avà. U Creazione è Configurazione View Oggetti è Iniziate a Sviluppà Apps iOS oghje I documenti nantu à developer.apple.com includenu passi per aghjunghje un avvenimentu di buttone. - Sceglite una maghjina di buttone.
Cunsultate u nostru Connessione cù e Linee Guida di Stile Amazon per un elencu di buttoni chì pudete aduprà in a vostra app. Scaricate una copia di u LWA_for_iOS.zip file. Truvate u vostru buttone preferitu in i direttori 1x è 2x è estratti da u zip. Estrae a versione _Pressata di u vostru buttone se vulete mustrà u buttone in un Statu Sceltu. - Aghjunghjite l'imaghjini à u vostru prugettu.
a. In Xcode, cù u vostru prughjettu caricatu, cliccate File da u menu principale è selezziunate Aggiungi Files per "prughjettà".
b. In u dialogu, selezziunate l'imagine di u buttone file(s) chì avete scaricatu è cliccate Aggiungi.
c. I buttoni devenu avà esse in u prugettu sottu u vostru cartulare di prughjettu. Spustalli à u Supporting Filecartulare s. - Aghjunghjite l'imagine à u vostru buttone.
Per attivà l'immagine per u vostru buttone, pudete mudificà l'attributu di u buttone o aduprà u setImage: perStatu metudu nantu à u UIButton ughjettu. Seguitate ste tappe per mudificà l'attributu di l'immagine per u vostru buttone:
a. Apri u storyboard per a vostra app.
b. Sceglite u buttone in u vostru storyboard cliccendu nantu à ellu o selezziunatu da u View Scena di u Controllore arbre.
c. In u Utilità finestra, apre u Ispettore di Attributi.
d. In cima di u Ispettore di Attributi, stabilisce u Tipu di buttone à Sistema.
e. In u secondu gruppu di impostazioni, selezziunate Default per Cunfigurazione di Statu.
f. In u secondu gruppu di paràmetri, abbandunate u Image paràmetru.
g. Sceglite u login cù u buttone graficu Amazon chì avete aghjuntu à u prugettu. Ùn selezziunate micca a versione 2x: serà caricata automaticamente nantu à dispositivi di visualizazione à alta densità (Retina).
h. Impostate a stessa maghjina per u Sfondate paràmetru.
i. Se vulete specificà una versione pressata di u buttone, selezziunate Scelta per Cunfigurazione di Statu, è mette u Image à u _Presu versione di u vostru buttone.
j. Nantu à u storyboard, aghjustate a dimensione di u vostru buttone per adattà l'imagine, se necessariu.
In questa sezione, aghjunghje u codice à u vostru prughjettu per firmà in un utilizatore cù Login cù Amazon.
Aduprate u SDK per iOS API
In questa sezione, aghjunghje u codice à u vostru prughjettu per firmà in un utilizatore cù Login cù Amazon.
Cunnette vi u Delegatu App
Implementa dumanda: apertaURL: opzioni: in a classe di u vostru prughjettu chì gestisce u UUIApplicationDelegate protocolu. Per difettu, questu serà u AppDelegate classa. Quandu un utilizatore accede cù successu à a vostra app aduprendu Login cù Amazon, saranu ridiretti da a schermata di login di Amazon torna à a vostra app basata annantu à u URL Schema avete aghjuntu à a vostra Lista di Proprietà App prima. Per gestisce sta redirect, duvete implementà u dumanda: apertaURL: opzioni: metudu, chì restituisce IÈ sì u URL hè trattatu cù successu.
U login cun Amazon SDK per iOS furnisce una funzione di biblioteca, manicuOpenURL: sourceApplication: chì gestisce qualsiasi redirect URL mandatu da e pagine Amazon. Ritorna SI sì u URL hè trattatu cù successu da u SDK. Chjamate stu metudu in u dumanda: apertaURL: opzioni: metudu.
Per invucà stu metudu, duverete impurtà .
| impurtazione @implementazione AppDelegate - Applicazione (BOOL): applicazione (UIApplication *) apertaURL: (NSURL *) url opzioni: (NSDictionaryURLOptionsKey, id> *) options { restituisce [AMZNAuthorizationManager handleOpenURL:url sourceApplication: opzioni [UIApplicationOpenURLOpzioniSourceApplicationKey]]; } @fine |
Sta sezzione spiega cumu chjamà l'autorizà: withHandler: API per accede à un utilizatore. Ciò include a creazione di un onLoginButtonClicked: ascoltatore per u vostru Login cù u buttone Amazon.
- Aghjunghjite Login cù Amazon à u vostru prugettu iOS. Vede Installa u Login cù Amazon Library.
- Impurtate u Login cù Amazon API à a vostra surghjente file.
Per impurtà u Login cù Amazon API, aghjunghje i seguenti #impurtanza à a vostra surghjente file:#impurtanza - Chjama autorizà: withHandler: in onLoginButtonCliccatu. Se avete seguitu i passi in Add a Login with Amazon Button à a vostra App, duvete avè un onLoginButtonClicked: metudu ligatu à un Login cù u buttone Amazon. In quellu metudu, chjamate autorizà: withHandler: per invità l'utente à accede è autorizà a vostra applicazione.
Stu metudu permetterà à l'utilizatore di firmà è accunsentì à l'infurmazioni richieste in unu di i modi seguenti:
- Cambia à web view in un cuntestu sicuru (se l'app Amazon Shopping hè installata à u dispositivu)
- Passa à Safari View Controller (in iOS 9 è più tardi)
- Passa à u navigatore di u sistema (in iOS 8 è precedenti)
U cuntestu sicuru per a prima opzione hè dispunibule quandu l'app Amazon Shopping hè installata à u dispositivu. Se l'utilizatore hè dighjà cunnessu à l'applicazione Amazon Shopping, sta API salterà a pagina di cunnessione, cunducendu à una Unica Sign-On (SSO) sperienza. Vede l'esperienza di u cliente-ios [PDF] per amparà di più.
U primu parametru per autorizà: withHandler: hè un AMZNAuthorizeRequest ogettu chì indica per chì scopu a vostra applicazione dumanda l'autorizazione. A scopu abbraccia i dati di l'utente chì state dumandendu da Login cù Amazon. A prima volta chì un utilizatore accede à a vostra app, saranu presentati cun un elencu di i dati chì state dumandendu è dumandatu l'approvazione.
U login cun Amazon supporta attualmente i seguenti scopi:Nome di portata Descrizzione profile Dà accessu à u nome di l'utilizatore, l'indirizzu email, è l'ID di contu Amazon. profile: user_id Dà accessu à l'ID di u contu Amazon di l'utilizatore solu. codice postale Dà accessu à u codice postale / codice postale di l'utente file per u so contu Amazon. Aduprate i metudi definiti in AMZNProfileScopu pè ottene un oggettu di scopu è aghjunghje lu in u vostru AMZNAuthorizeRequest ughjettu. Vede u sample code quì sottu per i dettagli.
U secondu parametru da autorizà: cùHandler: hè AMZNAuthorizationRequestHandler, descrittu in u passu prossimu. - Crea un AMZNAuthorizationRequestHandler ughjettu di bloccu. AMZNAuthorizationRequestHandler prucessa u risultatu di u autorizà: withHandler: chjamà. Per amparà di più nantu à i blocchi object-c, vedi U travagliu cù Blocks nantu à developer.apple.com.
U primu parametru di AMZNAuthorizationRequestHandler hè un AMZNAuthorizeResult ughjettu. Dopu chì un utilizatore hè autorizatu cù successu, AMZNAuthorizeResult cuntene un gettone d'accessu chì pò esse adupratu per accede à u prufessiunale di un utilizatorefile dati, è un AMZNUser ogettu, chì cuntene u pro di l'utilizatorefile data.U secondu paràmetru di AMZNAuthorizationRequestHandler hè un Boolean chjamatu userDidcancel. Stu parametru serà impostatu à veru se l'utente:
1. Chiude u Safari View Controller durante u login è l'autorizazione (in iOS 9 è più tardi)
2. Chiude u web view in l'app Amazon Shopping
3. Annulla u login o rifiuta l'autorizazione
U terzu parametru di AMZNAuthorizationRequestHandler hè un NSError ughjettu chì cuntene i dettagli d'errore se u login è l'autorizazione fiascanu per via di u SDK o di u servitore d'auturizazione- (IBAction) onLogInButtonClicked: (id) mittente {
// Custruisce una dumanda d'autorizazione.
AMZNAuthorizeRequest * request = [[AMZNAuthorizeRequest alloc] init];
request.scopes = [NSArray arrayWithObjects:
// [AMZNProfileScope userID],
[AMZNProfileScope profile],
[AMZNProfileScope postalCode]]; // Fate una chjamata Autorizà à l'Accessu cù Amazon SDK.
[[AMZNAuthorizationManager sharedManager] auturizà: dumanda
withHandler: ^ (AMZNAuthorizeResult * result, BOOL
userDidCancel, NSError * errore) {
if (errore) {
// Gestisce l'errori da u SDK o da u servitore d'autorizazione.
} altru sì (userDidCancel) {
// Gestisce l'errori causati quandu l'utente cancella u login.
} altru {
// L'autenticazione hè stata riesciuta.
// Uttene u gettone d'accessu è l'utente profile dati.
NSString * accessToken = result.token;
AMZNUser * user = result.user;
NSString * userID = user.userID;
}
}];
}
Fetch Utente Profile Dati
Sempre chì un utilizatore sia cunnessu è autorizatu à a vostra app, pudete piglià u so utilizatore profile dati in ogni mumentu.
Questa sezione spiega cumu aduprà u piglià: metudu di u AMZNUser classa per recuperà l'utente più aggiornatu profile dati per l'utilizatori chì sò attualmente autorizati. U profile i dati chì pudete recuperà sò basati nantu à u scopu indicatu in u autorizà chjama.
- Chjama AMZNU ricercà l'utilizatori:.
Stu metudu pigliarà profile dati via un AMZNUserFetchRequestHandler ughjettu di bloccu. U primu parametru per AMZNUserRequestHandler hè un AMZNUser ughjettu. U AMZNUser oggettu pò cumprendi a ID d'utilizatore, nome, email, è codice postale, secondu u scopu dumandatu.[AMZNUser fetch: ^ (AMZNUser * utilizatore, errore NSError *) {
if (errore) {
// Errore da u SDK, o nisun utilizatore hà autorizatu à l'app.
} altru si (utilizatore) {
NSString * userID = user.userID;
// NSString * nome = user.name;
// NSString * email = user.email;
// NSString * postalCode = user.postalCode;
}
}];
Verificate u login di l'Usuariu à u Startup
Se un utilizatore accede à a vostra app, chjude l'app, è riavvia l'app dopu, l'applicazione hè sempre autorizata à recuperà dati. L'utilizatore ùn hè micca disconnettu automaticamente. À l'iniziu, pudete mostrà l'utilizatore cum'è cunnessu se a vostra app hè sempre autorizata. Questa sezione spiega cumu aduprà autorizà: withHandler: per vede se l'app hè sempre autorizata.
- Crea un AMZNAuthorizeRequest oghjettate è specificate scopi chì indicanu i dati di l'utilizatore chì a vostra applicazione dumanda l'autorizazione. Per saperne di più infurmazioni nantu à i scopi, vedi Mantene u Pulsante di cunnessione è Get Profile Dati.
- Set AMZNAuthorizeRequest.strategia interattiva à AMZNInteractiveStrategyNever. AMZNAuthorizeRequest sustegnu parechje strategie per incuraghjà l'accessu di l'utente:
- AMZNInteractiveStrategyAuto (predeterminatu): U SDK cerca una cuncessione d'autorizazione almacenata lucalmente da a precedente autorizà: withHandler: risposte. Se unu hè dispunibule, validu, è cuntene tutti i scopi dumandati, u SDK restituverà una risposta riescita via AMZNAuthorizationRequestHandler, è ùn invitarà micca l'utilizatore à accede. Inutili, l'utilizatore serà invistitu à accede.
- AMZNInteractiveStrategySempre: U SDK invitarà sempre l'utente à cunnettassi indipendentemente da s'elli sò stati prima autorizati à aduprà l'app. Quandu l'utilizatore hè dumandatu, u SDK eliminerà tutte e sovvenzioni d'autorizazione in cache lucale per l'app.
- AMZNInteractiveStrategyNever: U SDK cerca una cuncessione d'autorizazione salvata lucalmente da a precedente autorizà: withHandler risposte. Se unu hè dispunibule, validu, è cuntene tutti i scopi richiesti, u SDK restituverà un AMZNAuthorizeResult ughjettu chì cuntene un gettone d'accessu è un utilizatore profile dati.
Altrimenti, tornerà un NSError oghjettu via AMZNAuthorizationRequestHandler.// Custruisce una dumanda d'autorizazione.
AMZNAuthorizeRequest * request = [[AMZNAuthorizeRequest alloc] init];
request.scopes = [NSArray arrayWithObjects:
// [AMZNProfileScope userID],
[AMZNProfileScope profile],
[AMZNProfileScope postalCode]]; request.interactiveStrategy = AMZNInteractiveStrategyNever; [[AMZNAuthorizationManager sharedManager] authorize: request
withHandler: ^ (AMZNAuthorizeResult * result, BOOL
userDidCancel, NSError * errore) {
if (errore) {
// Errore da u SDK, indicendu chì l'utilizatore ùn era micca prima
autorizatu à a vostra app per i scopi dumandati.
} altru {
// L'utilizatore era previamente autorizatu à a vostra app.
// Uttene u gettone d'accessu è l'utente profile dati.
NSString * accessToken = result.token;
AMZNUser * user = result.user;
NSString * userID = user.userID;
}
}];
Questa sezione spiega cumu aduprà u sorte metudu per cancellà i dati di autorizazione di l'utente da entrambi i AIMobileLib magazinu di dati lucali, è u servitore d'auturizazione. L'utilizatore duverà cunnettassi dinò per chì l'applicazione recuperi profile dati. Aduprate stu metudu per disconnettà un utilizatore, o per risolve i prublemi di login in l'app.
- Implementà un meccanisimu di disconnessione.
Quandu un utilizatore hà cunnisciutu l'accessu, duvete furnisce un mecanismu di disconnessione per pudè cancellà u so profile dati è scopi previamente autorizati. U vostru meccanisimu pò esse un hyperlink, un buttone, o una voce di menu. - Chjama sorte:.
Chjama sorte: in u vostru gestore di logout per rimuovere i dati di autorizazione di un utilizatore (gettoni d'accessu, profile) da u magazinu lucale, è u so statu di autentificazione da u servitore. U paràmetru di ingressu à sorte hè un AMZNAuthorizationRequestHandler ughjettu di bloccu. U bloccu deve rilevà è gestisce NSError oggetti, chì sò restituiti quandu sorte: fiasca.[[AMZNAuthorizationManager sharedManager] signOut: ^ (NSError * _Nullable
errore) {
if (! errore) {
// errore da u SDK o Login cù u servitore d'autorizazione Amazon.
}
}];
Pruvate a vostra Integrazione
Lanciate a vostra app in un dispositivu iOS o simulatore è cunfirmate chì pudete accede cù e vostre credenziali Amazon.com.
Nota: Quandu pruvate nantu à i simulatori iOS10, pudete vede u missaghju di errore APIKey per l'Applicazione hè invalida per un autorizà UserForScopes dumanda, o Codice d'errore scunnisciutu per un clearAuthorizationState dumanda. Questu hè un bug cunnisciutu cù Apple chì accade quandu u SDK prova à accede à u portachiavi. Finu chì Apple ùn risolve u bug, pudete travaglià intornu ad ellu attivendu Spartera di Portachiavi per a vostra app sottu u Capacità tab di u target di a vostra app. Stu bug impatta solu simulatori. Pudete pruvà nantu à i dispositivi iOS10 attuali senza aduprà alcuna soluzione.
Cunnettatevi cù Amazon Guida introduttiva per app iOS - Scaricate [ottimizatu]
Cunnettatevi cù Amazon Guida introduttiva per app iOS - Scaricate
