İOS üçün Amazon Başlanğıc Bələdçisi ilə daxil olun
Amazon ilə Giriş: iOS üçün Başlanğıc Bələdçisi
Müəlliflik hüququ © 2016 Amazon.com, Inc. və ya onun filialları. Bütün hüquqlar qorunur.
Amazon və Amazon loqosu Amazon.com, Inc və ya onun filiallarının ticarət nişanlarıdır. Amazon-a məxsus olmayan bütün digər ticarət nişanları müvafiq sahiblərinin mülkiyyətidir.
İOS üçün Başlama
Bu təlimatda Amazon tətbiqetməsini iOS tətbiqinizə necə əlavə edəcəyinizi göstərəcəyik. Bu təlimatı tamamladıqdan sonra istifadəçilərin Amazon etimadnamələri ilə daxil olmasına icazə vermək üçün tətbiqinizdə Amazon ilə işləyən bir giriş olmalıdır.
Xcode quraşdırılır
İOS üçün Amazon SDK ilə Giriş, Amazon tətbiqini iOS tətbiqinizə əlavə etməyiniz üçün Amazon tərəfindən təmin edilir. SDK-nın Xcode inkişaf mühiti ilə istifadəsi nəzərdə tutulur. SDK, iOS 7.0 və sonrasında ARMv7, ARMv7s, ARM64, i386 və andx86_64 istifadə edərək işləyən tətbiqləri dəstəkləyir.
Xcode'u Mac App Store'dan yükləyə bilərsiniz. Daha çox məlumat üçün baxın Xcode: Yeniliklər developer.apple.com saytında.
Xcode quraşdırıldıqdan sonra edə bilərsiniz İOS üçün Amazon SDK ilə Giriş qurun və S-ni işə salınample tətbiqi, aşağıda təsvir olunduğu kimi.
İOS üçün Amazon SDK ilə Giriş qurun
İOS üçün Amazon SDK ilə giriş iki paketdə gəlir. Birincisində iOS kitabxanası və dəstəkləyici sənədlər var. İkincisi kimi ehtiva edirampbir istifadəçinin daxil olmasına imkan verən le tətbiqi və view onların profile data.
Əgər hələ Xcode quraşdırmamışsınızsa, içindəki təlimatlara baxın Xcode quraşdırın yuxarıdakı bölmə.
- Yüklə GirişAmazonSDKForiOS.zip ilə və çıxarın filesabit diskinizdəki bir qovluğa gedin.
Görməlisiniz a GirişAmazon.framework ilə daxil olun qovluq. Burada Amazon kitabxanası ilə giriş var.
Zipin ən üst səviyyəsində a Giriş ilə Amazon.doc qovluq qurun. Bu API sənədlərini ehtiva edir. - Bax Amazon Kitabxanası ilə Giriş qurun kitabxananı iOS layihəsinə əlavə etmək üçün təlimatlar üçün.
İOS üçün Amazon SDK ilə Giriş qurulduqda edə bilərsiniz Amazon Layihəsi ilə Yeni Giriş Yaradın sonra Amazon ilə Giriş ilə qeydiyyatdan keçin.
S-ni işə salınample tətbiqi
S -ni işə salmaq üçünample tətbiqi, s açınampXcode -da.
- Yüklə SampleLoginWithAmazonAppForiOS.zip və kopyalayın
SampleLoginWithAmazonAppForiOS qovluğunu Sənədlər qovluğuna daxil edin. - Xcode başladın. Xcode -a xoş gəldiniz informasiya qutusu açılırsa, Digərini Aç düyməsini basın. Əks təqdirdə, əsas menyudan vurun File və Aç seçin.
- Sənədlər qovluğunu seçin və seçin
SampleLoginWithAmazonAppForiOS/LoginWithAmazonSample/ LoginWithAmazonSample.xcodeproj. basın Açıq. - Sample layihəsi indi yüklənməlidir. Tamamlandıqda seçin Məhsul əsas menyudan seçin və seçin Qaç
Amazon ilə Giriş ilə qeydiyyatdan keçin
Amazon ilə Login istifadə etməzdən əvvəl a websaytda və ya mobil proqramda siz Amazon ilə Login ilə tətbiqi qeydiyyatdan keçirməlisiniz. Amazon tətbiqi ilə Girişiniz biznesiniz haqqında əsas məlumatları və hər biri haqqında məlumatları ehtiva edən qeydiyyatdır webAmazon ilə Girişi dəstəkləyən sayt və ya yaratdığınız mobil proqram. Bu biznes məlumatı istifadəçilərə Amazon ilə Login funksiyasından hər dəfə istifadə etdikdə göstərilir websayt və ya mobil tətbiq. İstifadəçilər tətbiqinizin adını, loqotipinizi və məxfilik siyasətinizə bir keçid görəcəklər. Bu addımlar, Amazon tətbiqi ilə Girişin necə qeydiyyata alınacağını və bu hesaba iOS tətbiqinin necə əlavə olunacağını göstərir.
Aşağıdakı mövzulara baxın
- Girişinizi Amazon tətbiqi ilə qeydiyyatdan keçirin
- Bir Təhlükəsizlik Pro -ya bir iOS Tətbiqi əlavə edinfile
- iOS Paket ID və API Açarları
o iOS Tətbiqi üçün Bir Paket Tanıtıcısını təyin edin
o iOS API Açarını əldə edin
Girişinizi Amazon tətbiqi ilə qeydiyyatdan keçirin
- gedin https://login.amazon.com.
- Əvvəllər Amazon ilə Giriş üçün qeydiyyatdan keçmisinizsə, vurun Tətbiq Konsolu. Əks halda, vurun Qeydiyyatdan keçin.
Amazon ilə Giriş üçün müraciət qeydiyyatını həyata keçirən Satıcı Mərkəzi istiqamətinə yönəldiləcəksiniz. Seller Central-dan ilk dəfə istifadə edirsinizsə, sizdən Satıcı Mərkəzi hesabı qurmağınız istənəcəkdir. - klikləyin Yeni Tətbiqi Qeydiyyatdan Keçin. The Müraciətinizi Qeydiyyatdan Keçin forma görünəcək:
a. Müraciət formanızı qeyd edin, bir ad və a yazın Təsvir ərizəniz üçün.
The ad istifadəçilər proqramınızla məlumat paylaşmağa razı olduqda razılıq ekranında göstərilən addır. Bu ad Android, iOS və webtətbiqinizin sayt versiyaları.
b. Məxfilik bildirişi daxil edin URL ərizəniz üçün.
Məxfilik Bildirişi URL şirkətinizin və ya tətbiqinizin məxfilik siyasətinin yerləşdiyi yerdir (məsample, http: //www.example.com/privacy.html). Bu link istifadəçilərə razılıq ekranında göstərilir.
c. Əlavə etmək istəyirsinizsə, a Logo Şəkli tətbiqiniz üçün klikləyin Gözdən keçirin və müvafiq təsviri tapın.
Bu logo işinizi təmsil etmək üçün giriş və razılıq ekranında göstərilir webSayt. Logo 50 pikseldən daha yüksək olarsa 50 pikseldən kiçiləcək; loqotipin enində heç bir məhdudiyyət yoxdur. - klikləyin Saxla. Sizin sampQeydiyyat buna bənzər görünməlidir:
Əsas proqram parametrləriniz saxlandıqdan sonra xüsusi parametrlər əlavə edə bilərsiniz webAmazon hesabında bu Girişdən istifadə edəcək saytlar və mobil tətbiqlər.
Tətbiqinizin fərqli versiyalarında bir və ya daha çox test versiyası və istehsal versiyası kimi fərqli paket kimlikləri varsa, hər versiya öz API Açarını tələb edir. Etibarən iOS Parametrləri tətbiqinizin düyməsini vurun API açarı əlavə edin tətbiqiniz üçün əlavə düymələr yaratmaq üçün düyməni (versiya başına bir).
Bir Təhlükəsizlik Pro -ya bir iOS Tətbiqi əlavə edinfile
Əsas proqram parametrləriniz saxlandıqdan sonra xüsusi parametrlər əlavə edə bilərsiniz webAmazon hesabında bu Girişdən istifadə edəcək saytlar və mobil tətbiqlər.
Bir iOS Tətbiqini qeyd etmək üçün tətbiq layihəsi üçün Bundle identifikatorunu göstərməlisiniz. Amazon ilə giriş API açarı yaratmaq üçün paket identifikatorundan istifadə edəcəkdir. API açarı tətbiqinizə Amazon avtorizasiya xidməti ilə Giriş hüququnu verəcəkdir. Hesabınıza bir iOS tətbiqi əlavə etmək üçün bu addımları izləyin:
- Tətbiq ekranından vurun iOS parametrləri. Zaten qeydiyyata alınmış bir iOS tətbiqiniz varsa, axtarın API açarı əlavə edin -dəki düymə iOS Parametrləri bölmə.
The iOS tətbiqi Ətraflı məlumat forması görünəcək:
- daxil edin Etiket iOS Tətbiqinizdən. Bunun tətbiqinizin rəsmi adı olması lazım deyil. Sadəcə tətbiqlər arasında bu xüsusi iOS tətbiqini müəyyən edir webAmazon tətbiqi ilə Girişdə qeydiyyatdan keçmiş saytlar.
- Daxil edin Bundle ID. Bu, iOS layihənizin paket identifikatoruna uyğun olmalıdır. Paket identifikatorunuzu müəyyənləşdirmək üçün layihəni Xcode-da açın. Layihə üçün xassələr siyahısını açın ( -İnfo.plist) Layihə naviqatoru. Paket identifikatoru siyahıdakı xüsusiyyətlərdən biridir.
- klikləyin Saxla.
iOS Paket ID və API Açarları
Paket identifikatoru hər iOS tətbiqetmə üçün unikaldır. Amazon ilə giriş API Açarınızı qurmaq üçün Bundle ID istifadə edir. API Açarı, Amazon ilə təsdiqləmə xidməti ilə Girişinizi tətbiqinizi tanımaq üçün imkan verir.
Bir iOS Tətbiqi üçün Bir Paket Tanımlayıcısı təyin edin
- Xcode-da tətbiq layihənizi açın.
- açın Məlumat əmlak siyahısı layihə üçün ( -İnfo.plist) ildə Layihə naviqatoru.
- Tapın Paket identifikatoru xüsusiyyətlər siyahısında.
Bir iOS API Açarını alın
Bir iOS versiyasını qeyd etdikdən və bir Paket Kimliği təqdim etdikdən sonra API açarını Amazon tətbiqi ilə Giriş üçün qeyd səhifəsindən ala bilərsiniz. Bu API açarını layihənizin əmlak siyahısına yerləşdirməlisiniz. Bunu etməyinizə qədər tətbiqin Amazon ilə təsdiqləmə xidməti ilə Giriş ilə əlaqə qurma səlahiyyəti olmayacaq.
1. gedin https://login.amazon.com.
2. Klikləyin Tətbiq Konsolu.
3. Bu Proqramlar qutusuna tətbiqinizi vurun.
4. altında iOS tətbiqinizi tapın iOS Parametrləri bölmə. Bir iOS tətbiqini hələ qeydiyyatdan keçirməmisinizsə baxın Bir Təhlükəsizlik Pro -ya bir iOS Tətbiqi əlavə edinfile.
5. Klikləyin API Açar Dəyəri Yaradın. Açılan bir pəncərə API açarınızı göstərəcəkdir. Düyməni kopyalamaq üçün vurun Hamısını seçin bütün açarı seçmək üçün.
Qeyd: API Açar Dəyəri qismən yaradıldığı zamana əsaslanır. Beləliklə, yaratdığınız sonrakı API Açar Dəyəri (lər) orijinaldan fərqli ola bilər. Hamısı etibarlı olduğundan tətbiqinizdə bu API Açar Dəyərlərindən hər hansı birini istifadə edə bilərsiniz.
6. Bax API Açarınızı Tətbiq Mülkiyyət Siyahınıza əlavə edin iOS tətbiqinizə API açarı əlavə etmək üçün təlimatlar üçün
Amazon Layihəsi ilə Giriş yaratmaq
Bu bölmədə Amazon ilə Giriş üçün yeni bir Xcode layihəsi yaratmağı və layihəni necə quracağınızı öyrənəcəksiniz.
Aşağıdakı mövzulara baxın:
- Amazon Layihəsi ilə Yeni Giriş Yaradın
- Amazon Kitabxanası ilə Giriş qurun
- API Açarınızı Tətbiq Mülkiyyət Siyahınıza əlavə edin
- əlavə et URL Tətbiqinizin əmlak siyahısına sxem
- Tətbiqinizə Amazon üçün Tətbiq Nəqliyyat Təhlükəsizliyi İstisnası əlavə edin Əmlak siyahısı
QEYD: Bu yeni addım hazırda iOS 9 SDK-da inkişaf edərkən tələb olunur - Tətbiqinizə Amazon Düyməsi ilə Giriş əlavə edin
Amazon Layihəsi ilə Yeni Giriş Yaradın
Amazon ilə Login istifadə etmək üçün hələ bir tətbiq layihəniz yoxdursa, birini yaratmaq üçün aşağıdakı təlimatları izləyin. Mövcud bir tətbiqiniz varsa, aşağıdakı Amazon Kitabxanası ilə Giriş Quraşdır bölməsinə keçin.
- Başlayın Xcode.
- Sizə bir Xcode-a xoş gəlmisiniz dialoq, seçin Yeni Xcode Layihəsi Yaradın.
Əks təqdirdə File menyu, seçin Yeni və Layihə. - Yaratmaq istədiyiniz layihə növünü seçin və vurun Sonrakı.
- Daxil edin a Məhsulun adı və a Şirkət identifikatoru. Sizin Paket İdentifikatoru, və klikləyin Sonrakı.
- Layihənizi saxlayacaq bir yer seçin və vurun Yaradın.
İndi Amazon ilə Giriş zəng etmək üçün istifadə edə biləcəyiniz yeni bir layihəniz olacaq.
Amazon Kitabxanası ilə Giriş qurun
Hələ iOS üçün Amazon SDK ilə Giriş yükləməmisinizsə, baxın İOS üçün Amazon SDK ilə Giriş qurun.
Amazon ilə giriş layihəsi ilə əlaqələndirilməlidir GirişAmazon.framework ilə daxil olun və Təhlükəsizlik.framework kitabxanalar. Amazon başlıqları ilə Girişi tapmaq üçün çərçivə axtarış yolunu da konfiqurasiya etməlisiniz
- Xcode-da layihəniz açıq olduqda, seçin Çərçivələr qovluğu vurun File əsas menyudan seçin və seçin əlavə et Files üçün "Layihə".
- Dialoqdan seçin GirişAmazon.framework ilə daxil olun və basın Əlavə et.
Giriş ilə Amazon 1.0 kitabxanasından istifadə etdinizsə, çərçivə qovluğundan amazon ilə giriş sdk qovluğunu və giriş ilə amazon-sdk.a girişini silin. Basın Redaktə et əsas menyudan seçin və seçin Sil. - Layihənizin adını Layihə naviqatoru.
The Layihə redaktoru Xcode iş sahəsinin redaktor sahəsində görünəcək. - Layihə adınızı altına vurun Hədəflər, və seçin Mərhələlər qurun. Link Binary-ı Kitabxanalarla genişləndirin və kitabxana əlavə etmək üçün artı işarəsini vurun.
- Axtarış qutusuna daxil edin Təhlükəsizlik.framework. seçin Təhlükəsizlik.framework andclick əlavə et.
- Axtarış qutusuna daxil edin SafariServices.framework. seçin SafariServices.framework və klikləyin əlavə et.
- Axtarış qutusuna daxil edin CoreGraphics.framework. seçin CoreGraphics.framework və klikləyin əlavə et
- seçin Quraşdırma Parametrləri. Hamısını vurun view bütün parametrlər.
- Altında Yolları axtarın, təmin edin GirişAmazon.framework ilə daxil olun qovluğu Çərçivə Axtarış Yolları.
məsələnample:
Giriş ilə Amazon 1.0 kitabxanasından istifadə etdinizsə, içindəki 1.0 kitabxana yoluna istinadları silə bilərsiniz Başlıq axtarış yolları or Kitabxana Axtarış Yolları. - Əsas menyudan üzərinə klikləyin Məhsul və seçin qurmaq. Quruluş uğurla başa çatmalıdır.
Layihənizi hazırlamadan əvvəl, Girişlə Amazon 1.0 kitabxanasından istifadə edirsinizsə, dəyişdirin #idxal "AIMobileLib.h", #idxal "AIAuthenticationDelegate.h", or #import "AIError.h" mənbənizdə files ilə #import
.
Giriş ilə Amazon.h eyni anda Amazon başlıqları ilə bütün Girişləri əhatə edir.
API Açarınızı Tətbiq Mülkiyyət Siyahınıza əlavə edin
İOS tətbiqinizi Amazon ilə Giriş ilə qeydiyyatdan keçirtdiyiniz zaman sizə bir API açarı verilir. Bu, Amazon Mobil Kitabxanasının tətbiqinizi Amazon avtorizasiya xidməti ilə Giriş üçün müəyyənləşdirmək üçün istifadə edəcəyi bir identifikatordur. Amazon Mobil Kitabxanası bu dəyəri tətbiqetmənizin Məlumat Əmlak Siyahısındakı API Açar əmlak dəyərindən iş vaxtında yükləyir.
- Layihəniz açıq olduqda, seçin dəstəkləyən Files qovluğu seçin, sonra seçin -İnfo.plist file (harada layihənizin adıdır). Bu tənzimləmə üçün əmlak siyahısını açmalıdır:
- Girişlərdən heç birinin seçilmədiyinə əmin olun. Sonra əsas menyudan vurun redaktor, və Maddə əlavə edin. Daxil edin APİKey və basın Daxil edin.
- Altında iki dəfə vurun Dəyər dəyər əlavə etmək üçün sütun. API Açarınızı dəyər kimi yapışdırın.
əlavə et URL Tətbiqinizin əmlak siyahısına sxem
İstifadəçi daxil olduqda, onlara Amazon giriş səhifəsi təqdim olunacaq. Tətbiqinizin giriş təsdiqini alması üçün a əlavə etməlisiniz URL belə bir sxem web səhifə yenidən tətbiqinizə yönləndirilə bilər. The URL sxem elan edilməlidir amzn- (məsample, amzncom.exeample.app). Daha çox məlumat üçün baxın İstifadə URL Tətbiqlərlə əlaqə qurma sxemləri developer.apple.com saytında.
- Layihəniz açıq olduqda, seçin dəstəkləyən Files qovluğu seçin, sonra seçin -İnfo.plist file (harada layihənizin adıdır). Bu tənzimləmə üçün əmlak siyahısını açmalıdır:
- Girişlərdən heç birinin seçilmədiyinə əmin olun. Sonra əsas menyudan vurun redaktor, və Maddə əlavə edin. Daxil edin və ya seçin URL növləri və basın Daxil edin.
- Genişləndirin URL növləri aşkar etmək Maddə 0. seçin Maddə 0 və əsas menyudan Redaktor vurun və Maddə əlavə edin. Daxil edin və ya seçin URL Tanımlayıcı və basın Daxil edin.
- seçin Maddə 0 altında URL İdentifikator və dəyər əlavə etmək üçün Dəyər sütununun altına cüt vurun. Dəyər sizin paket kimliyinizdir. Paket kimliyinizi əmlak siyahısında Bundle identifikatoru kimi tapa bilərsiniz.
- seçin Maddə 0 altında URL növləri və əsas menyudan vurun redaktor və Maddə əlavə edin. Daxil edin və ya seçin URL Sxemlər və Enter düyməsini basın.
- seçin Maddə 0 altında URL Sxemlər və altında cüt vurun Dəyər əlavə etmək üçün sütun dəyər. Dəyər ilə paket paketinizdir amzn- əvvəlcədən hazırlanmış (məsələnample, amzn com.example.app). Paket kimliyinizi siyahıda tapa bilərsiniz Paket identifikatoru əmlak siyahısında.
Tətbiqinizə Amazon üçün Tətbiq Nəqliyyat Təhlükəsizliyi İstisnası əlavə edin
Əmlak siyahısı
İOS 9 -dan başlayaraq, Apple bir tətbiq ilə etibarlı əlaqələr üçün App Transport Security (ATS) tətbiq edir web xidmətlər. Məlumat mübadiləsi üçün Amazon SDK ilə əlaqə qurma son nöqtəsi (api.amazon.com) hələ ATS -ə uyğun gəlmir. SDK ilə Amazon serveri arasında fasiləsiz bir əlaqə yaratmaq üçün api.amazon.com üçün bir istisna əlavə edin.
- Layihəniz açıq olduqda, seçin dəstəkləyən Files qovluğu seçin, sonra seçin -İnfo.plist file (harada layihənizin adıdır). Bu, forediting əmlak siyahısını açmalıdır:
- Girişlərdən heç birinin olmadığından əmin olun, sonra əsas menyudan vurun redaktor, və Element əlavə edin. Daxil edin və ya seçin NSAppTransportSecurity və basın Daxil edin.
- Genişləndirin NSAppTransportSecurity və əsas menyudan vurun redaktor və Element əlavə edin. Daxil edin və ya seçin NSExceptionDomains və basın Daxil edin.
- Genişləndirin NSExceptionDomains və əsas menyudan vurun redaktor və Element əlavə edin. Amazon.com daxil edin və basın Daxil edin.
- Genişləndirin amazon.com və əsas menyudan vurun redaktor və Element əlavə edin.Giriş NSExceptionForwardSecrecy tələb edir və basın Daxil edin.
- seçin NSExceptionForwardSecrecy tələb edir və altında cüt vurun Dəyər bir seçin a əlavə etmək üçün sütun Növ of Boolean və a Dəyər of YOX.
Amazon ilə giriş istifadəçilərə tətbiqinizdən daxil olmağı təklif etmək üçün istifadə edə biləcəyiniz bir neçə standart düyməni təqdim edir. Bu bölmədə Amazon şəkli ilə rəsmi Giriş yükləmək və iOS UIButton ilə qoşmaq üçün addımlar verilir.
- Tətbiqinizə standart UIButton əlavə edin.
Tətbiqlərə bir düymə əlavə etmək barədə təlimatlar və məlumat üçün baxın Yaratmaq və konfiqurasiya etmək View Obyektlər və Bu gün iOS proqramlarını inkişaf etdirməyə başlayın developer.apple.com saytında. - əlavə edin İçəriyə toxunun adlı bir metodu düymə üçün hadisə onLoginButtonClicked. Tətbiqi hələlik boş buraxın. The Yaradır və Konfiqurasiya edilir View Obyektlər və Bu gün iOS proqramlarını inkişaf etdirməyə başlayın apple.com-dakı sənədlər bir düymə hadisəsi əlavə etmə addımlarını əhatə edir.
- Bir düymə şəkli seçin.
Amazon ilə girişimizə müraciət edin Stil Təlimatları tətbiqinizdə istifadə edə biləcəyiniz düymələrin siyahısı üçün. Nüsxəsini yükləyin LWA_for_iOS.zip file. İstədiyiniz düyməni həm 1x, həm də 2x dizinlərində tapın və onları zipdən çıxarın. Düyməni Seçilmiş vəziyyətdə göstərmək istəyirsinizsə, düymənizin _Sıxılmış versiyasını çıxarın. - Şəkillərinizi layihənizə əlavə edin.
a. Xcode'da, layihəniz yükləndikdə, vurun File əsas menyudan seçin və seçin əlavə et Files "layihə".
b. Dialoqda düymə şəklini seçin fileyüklədiyiniz və vurduğunuz (lar) ı əlavə et.
c. Düymələr artıq layihə qovluğunuzdakı layihədə olmalıdır. Onları dəstəkləyən tərəfə aparın Fileqovluq. - Şəkli düymənizə əlavə edin.
Düyməniz üçün görüntüyü aktivləşdirmək üçün düymə atributunu dəyişdirə və ya istifadə edə bilərsiniz setImage: forState üsulu UI düyməsi obyekt. Düyməniz üçün şəkil atributunu dəyişdirmək üçün bu addımları izləyin:
a. Tətbiqiniz üçün hekayəni açın.
b. Hekayə lövhənizdəki düyməni basaraq və ya seçərək seçin View Nəzarətçi Səhnə ağacı.
c. ildə Kommunal xidmətlər pəncərəni açın Xüsusiyyətlər müfəttişi.
d. Xüsusiyyət müfəttişinin yuxarı hissəsində, Düymənin növünü Sistemə qoyun.
e. İkinci parametr qrupunda, Dövlət Konfiqurasiyası üçün Varsayılan seçin.
f. İkinci parametr qrupunda, Təsvir parametrini açın.
g. Layihəyə əlavə etdiyiniz Amazon ilə Giriş düyməsini seçin. 2x versiyasını seçməyin: avtomatik olaraq yüksək sıxlıqlı ekran (Retina) cihazlarına yüklənəcəkdir.
h. Fon ayarı üçün eyni şəkli seçin.
i. Düymənin basılmış bir versiyasını təyin etmək istəyirsinizsə, Dövlət Konfiqurasiyası üçün Seçili seçin və şəkli düymənizin _Press versiyasına ayarlayın.
j. Stolüstü lövhədə, lazım olduqda şəkli yerləşdirmək üçün düymənizin ölçüsünü tənzimləyin.
İOS API-ləri üçün SDK-dan istifadə
Bu hissədə, Amazon ilə Giriş ilə bir istifadəçi daxil etmək üçün layihənizə kod əlavə edəcəksiniz.
Aşağıdakı mövzulara baxın:
- Giriş düyməsini idarə edin və Pro əldə edinfile Data
- Başlanğıcda istifadəçi girişini yoxlayın
- Avtorizasiya vəziyyətini silin və bir istifadəçidən çıxın
Bu bölmədə necə zəng ediləcəyi izah olunur authorizeUserForScopes: nümayəndə: və getProfile: API bir istifadəçiyə daxil olmaq və onun peşəkarlarını əldə etməkfile məlumatlar. Buraya bir yaratmaq daxildir onLoginButtonClicked: dinləyici Amazon düyməsiylə girişiniz üçün.
- İOS layihənizə Amazon ilə Giriş əlavə edin. Amazon Kitabxanası ilə Giriş qurma bölməsinə baxın.
- Amazon API ilə Girişi mənbənizə idxal edin file.
Girişi Amazon API ilə idxal etmək üçün aşağıdakıları əlavə edin #idxal bəyannamələri mənbəyinizə file:# idxal - yaradın AMZNAuthorizeUserDelegateclass həyata keçirmək
AIA Doğrulama nümayəndəsi.
Nə vaxt authorizeUserForScopes: nümayəndə: tamamlayır, çağıracaq xahiş etdim: or requestDidFail: həyata keçirən bir obyekt üzərində metod AIA Doğrulama nümayəndəsi protokol.@interface AMZNAuthorizeUserDelegate: NSObject @ son Ətraflı məlumat üçün bax Protokollarla işləmək developer.apple.com saytında.
- Zəng edin authorizeUserForScopes: nümayəndə: in onLoginButtonClicked.
İçindəki addımları təqib etsəniz Tətbiqinizə Amazon Düyməsi ilə Giriş əlavə edin, bir olmalıdır onLoginButtonClicked: metod Amazon düyməsinə giriş ilə əlaqələndirilir. Bu metodda zəng edin authorizeUserForScopes: nümayəndə: üçün istifadəçiyə daxil olmağı və tətbiqinizə icazə verməsini istəyin.
Bu metod istifadəçiyə aşağıdakı yollardan biri ilə daxil olmuş və tələb olunan məlumatlara razılıq verməsini təmin edəcəkdir:
1.) -a keçir web view etibarlı bir kontekstdə (Amazon Shopping tətbiqi cihaza quraşdırılıbsa)
2.) Safari -yə keçir View Nəzarətçi (iOS 9 və daha sonra)
3.) Sistem brauzerinə keçir (iOS 8 və əvvəllər)
İlk seçim üçün etibarlı kontekst, Amazon Alışveriş tətbiqi cihaza quraşdırıldıqda mövcuddur. İstifadəçi artıq Amazon Alışveriş tətbiqetməsində oturubsa, giriş səhifəsi atlanaraq a Tək Giriş (SSO) təcrübə.Tətbiqiniz icazə verildikdə, əhatə dairəsi olaraq bilinən bir və ya daha çox məlumat dəsti üçün icazə verilir. Birinci parametr, Amazon ilə Girişdən tələb etdiyiniz istifadəçi məlumatlarını əhatə edən bir sıra sahələrdir. Bir istifadəçi tətbiqinizə ilk dəfə daxil olduqda, tələb etdiyiniz və təsdiq istənən məlumatların siyahısı təqdim olunacaq. Amazon ilə giriş hazırda üç sahəni dəstəkləyir: profile, istifadəçinin adı, e-poçt ünvanı və Amazon hesabı id; profile:İstifadəçi adı, yalnız Amazon hesab idini ehtiva edən; və Poçt kodu, istifadəçinin poçt / poçt kodunu ehtiva edən.
Üçün ikinci parametr authorizeUserForScopes: nümayəndə: həyata keçirən bir obyektdir AIAauthenticationDelegateprotocol, bu vəziyyətdə AMZNAuthorizeUserDelegate sinif.- (IBAction) onLogInButtonClicked: (id) göndərən {
// Təhlükəsiz giriş işarəsi əldə etmək üçün SDK-ya icazə verin
// istifadəçi üçün.
// İlk zəng edərkən minimum əsas göstəricini təyin edə bilərsiniz
// əhatə dairələri lazımdır.// Mövcud istifadəçi üçün hər iki sahənin istənilməsi.
NSArray * requestScopes =
[NSArray arrayWithObjects:@”profile”, @” Poçt_kodu ”, sıfır];AMZNAuthorizeUserDelegate * delegate =
[AIMobileLib authorizeUserForScopes: requestScopes delegate: delegate];
[[AMZNAuthorizeUserDelegate ayır] initWithParentController: özünü];Nümayəndə tətbiqetmə başlığını sinif çağırışına əlavə edin
authorizeUserForScopes :. məsələnample:#import "AMZNAuthorizeUserDelegate.h" - yaradın AMZNGetProfileNümayəndə.
AMZNGetProfileNümayəndələr həyata keçirən bir sinif üçün adımız
AIAauthenticationDelegateprotocol, və nəticəsini işləyəcək getProfile: zəng edin. Kimi authorizeUserForScopes: delegate :, getProfile: dəstəkləyir xahiş etdim: və requestDidFail: protokol metodları. xahiş etdim: alır APINəticə pro ilə obyektfile nəticə xüsusiyyətindəki məlumatlar. requestDidFail: alır AI səhv səhv xüsusiyyətindəki səhv barədə məlumatı olan obyekt.
Normal sinif bəyannaməsindən nümayəndə sinfi yaratmaq üçün idxal edin
AIA DoğrulamaDelegate.hand sinif başlığınızdakı protokolu bəyannaməyə əlavə edin file:#idxal @interfeysi AMZNGetProfileNümayəndə: NSObject @end - Həyata keçirmək requestDidSucceed: üçün sənin AMZNAuthorizeUserDelegate. In xahiş etdim: zəng edin getProfile: müştəri pro almaq üçünfile. getProfile:, kimi authorizeUserForScopes: delegate :, AIAuthenticationDelegate protokolundan istifadə edir.
- (etibarsız) requestDidSucceed: (APIResult *) apiResult {
// İstifadəçi müraciət üçün icazə verdikdən sonra kodunuz
// tələb olunan miqyaslar.// Yeni yükləyin view istifadəçi məlumatları olan nəzarətçi
// istifadəçi artıq uğurla daxil olduğu üçün.AMZNGetProfileNümayəndə* nümayəndə =
[[[AMZNGetProfileNümayəndələrin ayrılması] initWithParentController:parentViewNəzarətçi] avtomatik buraxılış];
[AIMobileLib getProfile: nümayəndə];
}Nümayəndə tətbiqetmə başlığını sinif çağırışına əlavə edin getProfile:. Forexample:
#idxal "AMZNGetProfileNümayəndə.h ” - Həyata keçirmək xahiş etdim: sizin üçün AMZNGetProfileNümayəndə.
requestDidSucceed: var iki əsas vəzifə: pro almaqfile dan məlumatlar Nəticə, və məlumatları istifadəçi interfeysinə ötürmək.
Pro almaq üçünfile dan məlumatlar Nəticə, nəticə xüsusiyyətinə daxil olmaq. Üçün getProfile:cavab, bu mülkiyyət, istifadəçi pro üçün əmlak dəyərləri lüğətini ehtiva edirfile xassələri. Profile xassələrdir ad, e-poçt, və user_id pro üçünfile əhatə dairəsi və
poçt kodu üçün poçt kodu əhatə dairəsi.- (etibarsız) requestDidSucceed: (APIResult *) apiResult {
// Pro əldə edinfile istəyi yerinə yetirildi. Pro paketini açınfile məlumat
// və valideynə ötürün view nəzarətçiNSString * name = [(NSDictionary *) apiResult.result
objectForKey: @ ”ad”];
NSString * email = [(NSDictionary *) apiResult.result
objectForKey: @ ”email”];
NSString * user_id = [(NSDictionary *) apiResult.result
objectForKey: @ ”user_id”];
NSString * poçt_kodu = [(NSDictionary *) apiResult.result
objectForKey: @ ”poçt_kodu”];// Məlumatları ötürün view nəzarətçi
} - Həyata keçirmək requestDidFail: sizin üçün AMZNGetProfileNümayəndə.
requestDidFail: daxildir API xətası səhv haqqında təfərrüatları olan obyekt. ShowLogInPageis əsas sıfırlanacaq hipotetik bir üsul view Amazon düyməsini basaraq Giriş düyməsini göstərin.- (void) requestDidFail: (APIError *) errorResponse {
// Pro əldə edinfile pro üçün tələb uğursuz oldufile əhatə dairəsi.
// Əgər səhv kodu = kAIApplicationNotAuthorizedsə,
// istifadəçinin yenidən daxil olmasına icazə verin.
əgər (errorResponse.error.code == kAIApplicationNotAutmissions) {
// İstifadəçi düyməsini göstər.
[valideynViewNəzarətçi showLogInPage];
}
başqa {
// Digər səhvləri idarə edin
[[[[UIAlertView ayırın] initWithTitle:@”” mesajı: [NSString
stringWithFormat: @ ”Xətr baş verdi:% @”,
errorResponse.error.message] nümayəndə: sıfır
cancelButtonTitle: @ ”OK” otherButtonTitles: nil] autorelease] show];
}
} - Həyata keçirmək requestDidFail: üçün sənin AMZNAuthorizeUserDelegate.
- (void) requestDidFail: (APIError *) errorResponse {
NSString * message = errorResponse.error.message;
// Avtorizasiya uğursuz olduqda kodunuz. [[[[UIAlertView ayırın] initWithTitle:@”” mesajı: [NSString
stringWithFormat: @ ”İstifadəçi təsdiqlənməsi mesajı ilə uğursuz oldu:% @”, errorResponse.error.message] nümayəndə: nil
cancelButtonTitle: @ ”OK” otherButtonTitles: nil] autorelease] show];
}10. Tətbiq edin tətbiq: açıqURL: mənbəƏrizə: şərh: layihəsini idarə edən sinifdə UIApplication nümayəndə protokol (varsayılan olaraq bu olacaq AppDelegateclass layihənizdə). Tətbiq Amazon giriş səhifəsini təqdim etdikdə və istifadəçi girişini tamamladıqda, istifadə edərək tətbiqə yönləndiriləcək URL Tətbiqi əvvəlcədən qeydiyyatdan keçirin. Bu yönləndirmə keçir tətbiq: açıqURL: mənbəƏrizə: qeyd:, qayıdır HƏ əgər URL uğurla idarə olundu. idarə açınURL: mənbəƏrizə: Amazon yönləndirməsi ilə Girişi idarə edəcək bir SDK kitabxana funksiyasıdır URLsenin ucun. Əgər idarə açınURL: sourceApplication: qaytarır YES, sonra URL idarə olundu.
- (BOOL) tətbiqetmə: (UIApplication *) tətbiq
açıqURL: (NSURL *)url
sourceApplication: (NSString *) sourceApplication
izahat: (id) izahat
{
// ötürün url avtorizasiya kodunu təhlil etmək üçün SDK-ya // url.
BOOL isValidRedirectSignIn -dirURL =
[AIMobileLib sapıAçıqURL:url
sourceAppli cation: sour ceApplicati on);
əgər (! isValidRedirect Si gnlnURL)
geri qayıt;
// Tətbiq e-ni idarə etmək istəyə bilər url qayıt EVET;
}QEYD: Bu metod iOS 9-da ləğv edilmişdir, lakin köhnə platformalarda istifadəçilər üçün dəstəyi qorumaq üçün layihənizə daxil edilməlidir. Daha çox məlumat üçün tətbiq: açıqURL: mənbəƏrizə: qeyd:, bax UIApplicationDelegate Protocol Reference developer.apple.com saytında.
Başlanğıcda istifadəçi girişini yoxlayın
Bir istifadəçi tətbiqinizə daxil olarsa, tətbiqi bağlayır və tətbiqi daha sonra yenidən başladırsa, tətbiq hələ məlumat əldə etmək səlahiyyətinə malikdir. İstifadəçi avtomatik olaraq çıxmır. Başlanğıcda, tətbiqiniz hələ də icazə verildiyi təqdirdə istifadəçini girişdə göstərə bilərsiniz. Bu bölmə necə istifadə ediləcəyini izah edir
getAccessTokenForScopes: withOverrideParams: nümayəndə: tətbiqin hələ də səlahiyyətli olub olmadığını görmək.
- yaradın AMZNGetAccessTokenDelegate sinif. AMZNGetAccessTokenDellegateimmissions the AIA Doğrulama nümayəndəsi protokolu və nəticəsini işləyəcək
getAccessTokenForScopes: withOverrideParams: nümayəndə: zəng edin. AIA Doğrulama nümayəndəsi iki metoddan ibarətdir, xahiş etdim: və requestDidFail :. xahiş etdim: alır APINəticə jeton məlumatları ilə obyekt, while requestDidFail: alır API xətası səhv barədə məlumatı olan obyekt.# idxal @ interfeys AMZNGetAccessTokenDelegate: NSObject
@end
Nümayəndə tətbiqetmə başlığını sinif çağırışına əlavə edin
getAccessTokenForScopes: withOverrideParams: nümayəndə :. Forexample:#import "AMZNGetAccessTokenDelegate.h" - Tətbiq başlanğıcında zəng edin
getAccessTokenForScopes: withOverrideParams: nümayəndə: tətbiqin hələ də səlahiyyətli olub olmadığını görmək. getAccessTokenForScopes: withOverrideParams: nümayəndə: Amazon ilə girişin bir müştəri pro -ya daxil olmaq üçün istifadə etdiyi xam giriş simvolunu alırfile. Metod müvəffəqiyyətli olarsa, tətbiqə hələ də icazə verilir və zəng edilir getProfile: uğur qazanmalıdır. getAccessTokenForScopes: withOverrideParams: nümayəndə: istifadə edir AIA Doğrulama nümayəndəsi eyni qaydada protokol authorizeUserForScopes: nümayəndə :. Protokolu həyata keçirən obyekti nümayəndə parametri kimi ötürün.- (etibarsız) checkIsUserSignedIn {
AMZNGetAccessTokenDelegate * delegate =
[[[AMZNGetAccessTokenDelegate alloc] initWithParentController:self] autorelease];
NSArray * requestScopes =
[NSArray arrayWithObjects:@”profile”, @” Poçt_kodu ”, sıfır]; [AIMobileLib getAccessTokenForScopes: requestScopes withOverrideParams: nil delegate: delegate];
} - Həyata keçirmək xahiş etdim: sənin üzərində AMZNGetAccessTokenDelegate. xahiş etdim: bir tapşırıq var: zəng etmək getProfile:. Bu keçmişampzənglər getProfile: əvvəlki hissədə elan etdiyiniz eyni dinləyicidən istifadə edərək (bax: addımlar 6-8).
#idxal "AMZNGetProfileNümayəndə.h ”
# idxal- (etibarsız) requestDidSucceed: (APIResult *) apiResult {
// Giriş işarəsini istifadə etmək üçün kodunuz buraya daxil olur.// Tətbiqin əhatə dairələrimiz üçün icazəsi olduğundan, edə bilərik
[AIMobileLib getProfile: nümayəndə];
// istifadəçi pro əldə edinfile.
AMZNGetProfileNümayəndə* nümayəndə = [[[AMZNGetProfileNümayəndəlik] initWithParentController: valideynViewNəzarətçi] avtomatik buraxılış];
} - Həyata keçirmək requestDidFail: sənin üzərində AMZNGetAccessTokenDelegate.
requestDidFail: daxildir API xətası səhv haqqında təfərrüatları ehtiva edən obyekt. Bir səhv alsanız, əsas sıfırlaya bilərsiniz view Amazon düyməsini basaraq Giriş düyməsini göstərin.- (void) requestDidFail: (APIError *) errorResponse {
// Giriş nişanının alınmaması üçün kodunuz.
// Hata kodu = kAIApplicationNotAuthorizedsə, istifadəçiyə icazə verin
// yenidən daxil olmaq üçün.
əgər (errorResponse.error.code == kAIApplicationNotAutmissions) {
// Giriş düyməsini Amazon düyməsini göstərin.
}
başqa {
// Digər səhvləri idarə edin
[[[[UIAlertView ayırın] initWithTitle:@”” mesajı: [NSString
stringWithFormat: @ ”Mesajda xəta baş verdi:% @”, errorResponse.error.message] nümayəndə: nil
cancelButtonTitle:@”OK” otherButtonTitles:nil] autorelease] show];
}
}
The clearAuthorizationState: metod istifadəçinin icazə məlumatlarını AIMobileLib yerli məlumat mağazası. Tətbiqin pro əldə etməsi üçün bir istifadəçi yenidən daxil olmalıdırfile məlumatlar. Bir istifadəçini çıxarmaq və ya tətbiqdəki giriş problemlərini həll etmək üçün bu üsuldan istifadə edin.
- Bəyan et AMZNLoqoutDelegate Bu tətbiq edən bir sinifdir
AIA authenticationDelegateprotocol. Məqsədlərimiz üçün sinifdən miras ala bilərik NSOobyekt:
# idxal @ interfeys AMZNLogoutDelegate NSObject
@end
Nümayəndə tətbiqetmə başlığını sinif çağırışına əlavə edin clearAuthorizationState :. məsələnample:
#import "AMZNLogoutDelegate.h" - Zəng edin clearAuthorizationState :.
İstifadəçi uğurla daxil olduqda, icazə məlumatlarını silmək üçün bir çıxış mexanizmi təmin edə bilərsiniz. Mexanizminiz bir köprü və ya bir menyu ola bilər, ancaq bu ssenari üçün köhnəample yaradacaq çıxış düyməsini basın çıxış düyməsinə görə.- (IBAction) çıxışıButtonClicked: (id) göndərən {
AMZNLogoutDelegate* nümayəndə = [[[AMZNLogoutDelegate alloc] initWithParentController:self] autorelease]; [AIMobileLib clearAuthorizationState:nümayəndə];
}Üçün yeganə parametr aydınAuthorizationState bir AIA Doğrulama nümayəndəsi həyata keçirən xahiş etdim: və requestDidFail :.
- Həyata keçirmək requestDidSucceed :. Bu metod istifadəçinin məlumatları təmizləndikdə çağırılacaq. Sonra onları çıxdığınız kimi göstərməlisiniz.
- (etibarsız) requestDidSucceed: (APIResult *) apiResult {
// İstifadəçi icazəsindən sonra əlavə məntiqiniz
// vəziyyət təmizləndi.
[[[UIAlertView ayır] initWithTitle:@”” mesajı:@”İstifadəçi Çıxdı.”
delegate:nil cancelButtonTitle:@”OK” otherButtonTitles:nil] göstər];
} - Həyata keçirmək requestDidFail :. İstifadəçi məlumatları nədənsə önbellekten silinə bilmirsə, bu üsul çağırılacaq. Bu vəziyyətdə, onları çıxdıqları kimi göstərməməlisiniz.
- (void) requestDidFail: (APIError *) errorResponse {
// SDK-dan sonra əlavə məntiqiniz silinə bilmədi
// icazə vəziyyəti. [[[[UIAlertView ayırın] initWithTitle:@”” mesajı: [NSString
stringWithFormat: @ ”İstifadəçi Çıxışı mesajı ilə uğursuz oldu:% @”,
errorResponse.error.message] nümayəndə: sıfır
cancelButtonTitle:@”OK” otherButtonTitles:nil] autorelease] show];
}
İnteqrasiyanı sınayın
Tətbiqinizi bir iOS cihazında və ya simulyatorda başladın və Amazon.com etimadnamənizlə daxil ola biləcəyinizi təsdiq edin.
Qeyd: İOS10 simulyatorlarında sınaqdan keçirərkən, tətbiq üçün APIKey səhv mesajının bir authorizeUserForScopes tələbi üçün etibarsız olduğunu və ya bir clearAuthorizationState istəyi üçün Naməlum Xəta Kodunu görə bilərsiniz. Bu Apple ilə bilinən bir səhv SDK-nın açar dəstinə daxil olmağa çalışdığı zaman baş verir. Apple bu problemi həll edənə qədər tətbiqinizin hədəfindəki Qabiliyyətlər nişanı altında tətbiqiniz üçün Anahtarlık Paylaşımını aktivləşdirərək bununla məşğul ola bilərsiniz. Bu səhv yalnız simulyatorlara təsir göstərir. Heç bir keçid yolu tapmadan həqiqi iOS10 cihazlarında test edə bilərsiniz.
Amazon Versiyası 2.1.2 üçün Başlanğıc Kılavuzu ilə giriş - Endirin [optimize]
Amazon Versiyası 2.1.2 üçün Başlanğıc Kılavuzu ilə giriş - Yüklə