Android tətbiqetmələri üçün Amazon Başlanğıc Kılavuzu ilə daxil olun

Amazon ilə Giriş: Android üçün Başlanğıc Bələdçisi

Müəlliflik hüququ © 2017 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.

Android Developer Alətlərini quraşdırın

Android üçün Amazon SDK ilə Giriş, Android, Fire TV və Fire Tablet tətbiqetmələrinizə Amazon ilə Giriş əlavə etməyinizə kömək edəcəkdir. Android Studio ilə Android üçün Amazon SDK ilə Girişdən istifadə etməyinizi məsləhət görürük. Android Studio-nun necə qurulacağı və Android SDK-nın qurulmasına dair addımlar üçün baxın Android SDK əldə edin developer.android.com saytında.

Android üçün Amazon SDK ilə Girişdən istifadə etmək üçün Android tətbiqetiniz bu minimum tələblərdən birini təmin etməlidir:

• Minimum SDK Versiyası (minSdkVersion) Android 0 (API Səviyyə 11) və ya daha yüksək.
• V2.2 ilə Android 8 (API Səviyyə 4) və ya daha yüksək olan minimum SDK Versiyası (minSdkVersion) Android Dəstəyi Kitabxana.

Android SDK quraşdırıldıqda SDK Meneceri Android quraşdırma tətbiq. Amazon ilə Giriş üçün inkişaf etdirmək üçün yuxarıdakı minimum SDK tələblərini yükləmək üçün SDK Menecerindən istifadə etməlisiniz. Görmək SDK Paketləri əlavə olunur SDK Manager-dən istifadə haqqında daha çox məlumat üçün developer.android.com saytında.

SDK-nı quraşdırdıqdan sonra tətbiqlərinizi çalıştırmaq üçün Android Virtual Cihazı (AVD) quraşdırın. Görmək İdarəetmə Virtual Cihazlar virtual cihaz qurmaq üçün təlimatlar üçün developer.android.com saytında.

İnkişaf mühitiniz qurulduqda edə bilərsiniz Android üçün Amazon SDK ilə Giriş qurun or S-ni işə salınample tətbiqi, aşağıda göstərildiyi kimi

Android üçün Amazon SDK ilə Giriş qurun

Android üçün Amazon SDK ilə Giriş iki paketdə gəlir. Birincisində Android kitabxanası və dəstəkləyici sənədlər var. İkincisi kimi ehtiva edirampBir istifadəçiyə daxil olmağa imkan verən və öz prolarını göstərən le proqramıfile data.

Android SDK və ya Android İnkişaf Vasitələrini hələ yükləməmisinizsə, baxın Quraşdırılır Android Developer Alətləri yuxarıdakı bölmə.

1. Yüklə zip və çıxarın filesabit diskinizdəki bir qovluğa gedin. A görməlisiniz sənədlər və a lib alt kataloq.
2. Açıq docs / index.html üçün view Amazon Android API İstinadı ilə Giriş.
3. Bax Amazon Kitabxanası ilə Giriş qurun kitabxananı və sənədləri bir Android-ə əlavə etmək üçün təlimatlar üçün

Android üçün Amazon SDK ilə Giriş qurulduqda edə bilərsiniz Amazon ilə yeni bir giriş yaradın Layihə səndən sonra Amazon ilə Giriş ilə qeydiyyatdan keçin.

S-ni işə salınample tətbiqi

S -ni işə salmaq üçünample tətbiqi, s idxal edinampbir AndroidStudio iş sahəsinə daxil olun.

1. Yüklə SampleLoginWithAmazonAppForAndroid-src.zip və çıxarın fileçətin bir qovluğa
2. Android Studio'yu başladın və seçin Mövcud bir Android Studio layihəsini açın.
3. -Ə baxın SampleLoginWithAmazonApp yüklənmiş zip çıxarıldıqdan sonra əldə edilən kataloq file 1-cu addımda.
4. From qurmaq menyu, klikləyin Layihə etməkvə layihənin bilinqi bitirməsini gözləyin.
5. From Qaç menyu, klikləyin Qaç və sonra üzərinə klikləyin SampleLoginWithAmazonApp.
6. Emulatoru və ya qoşulmuş Android cihazını seçin və vurun 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ətbiqetməsində istifadə etmək üçün Android tətbiqinizi necə qeydiyyatdan keçirəcəyinizi göstərir.

Girişinizi Amazon tətbiqi ilə qeydiyyatdan keçirin

1. gedin https://login.amazon.com.
2. Əvvəllər Amazon ilə Giriş üçün qeydiyyatdan keçmisinizsə, vurun Tətbiq Konsolu. Əks halda, klikləyin Qeydiyyatdan keçin. Giriş ilə müraciət qeydiyyatını aparan Satıcı Mərkəzi istiqamətinə yönəldiləcəksiniz. Əgər ilk dəfə Satıcı Mərkəzi istifadə edirsinizsə, bir Satıcı Mərkəzi hesabı qurmağınız istənəcəkdir.
3. klikləyin Yeni Tətbiqi Qeydiyyatdan Keçin. The Müraciətinizi Qeydiyyatdan Keçin forma görünəcək:
   a. ildə Müraciətinizi Qeydiyyatdan Keçin forma daxil edin a ad və a 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ı. The Təsvir hər bir girişinizi Amazon tətbiqetmələri ilə fərqləndirməyə kömək edir və istifadəçilərə göstərilmir.
   b. Daxil edin a Məxfilik Bildirişi URL ərizəniz üçün.
   The 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.
4. 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ətbiqinizə Android Ayarları əlavə edin

Bir Android Tətbiqi qeydiyyatdan keçirmək üçün bir tətbiqin Amazon Appstore'dan qeydiyyatdan keçmə seçiminiz var (Amazon Appstore üçün Android Tətbiqi əlavə edin) və ya birbaşa Amazon ilə Giriş ilə (Android əlavə edin Tətbiq Appstore olmadan). Tətbiqiniz qeydə alındıqda, tətbiqinizə Amazon avtorizasiya xidməti ilə Giriş-çıxış imkanı verən bir API açarına sahib olacaqsınız.

Qeyd: Android cihazınızda Amazon Cihaz Mesajlaşma istifadə etməyi planlaşdırırsınızsa, əlaqə saxlayın lva-support@amazon.com ilə:

• Giriş üçün qeydiyyatdan keçdiyiniz Amazon hesabının e-poçt ünvanı
• Amazon Appstore'a qeydiyyatdan keçdiyiniz Amazon hesabının e-poçt ünvanı (fərqli olduqda).
• Satıcı Mərkəzi hesabınızdakı ad (Mərkəzi Satıcıda vurun Ayarlar> Hesab Məlumatı> Satıcı haqqında məlumat, və istifadə edin Görünən Adı).
• Amazon Appstore geliştirici hesabınızdakı ad (Mobile App Distribution saytında vurun Ayarlar> Şirkət Profile və istifadə edin Geliştirici Adı və ya Şirkət Adı).

Amazon Appstore üçün bir Android tətbiqi əlavə edin

Aşağıdakı addımlar Amazon hesabı ilə Girişinizə bir Amazon Appstore tətbiqetməsi əlavə edəcək:

1. Tətbiq ekranından vurun Android Parametrləri. Əgər onsuz da qeydiyyatdan keçmiş bir Android tətbiqiniz varsa, axtarın API açarı əlavə edin -dəki düymə Android Parametrləri seçim
   The Android Tətbiqi Təfərrüatları forma görünəcək:
2. seçin Bəli “Bu tətbiqet Amazon Appstore vasitəsilə paylanır?” sualına cavab olaraq
3. daxil edin Etiket Android Tətbiqinizdən. Bunun tətbiqinizin rəsmi adı olması lazım deyil. Sadəcə tətbiqlər arasında bu xüsusi Android tətbiqini müəyyən edir webAmazon ilə Girişdə qeydiyyatdan keçmiş saytlar
4. Özünüzü əlavə edin Amazon Appstore ID.
5. Tətbiqinizi özünüz imzalamısınızsa, öz imzanızı əlavə edin. Bu, Appstore-dan birbaşa istifadə etmədən inkişaf zamanı bir API açarı əldə etməyə imkan verəcəkdir.
   a. Tətbiqiniz Amazon Appstore vasitəsilə imzalanmırsa seçin Bəli “Bu tətbiq öz-özünə imzalıdır?” sualına cavab olaraq
   The Android Tətbiqi Təfərrüatları forma genişlənəcəkdir
   
   b. Daxil edin Paket adı.
   Bu, Android layihənizin paket adı ilə uyğun olmalıdır. Android Layihənizin paket adını müəyyənləşdirmək üçün seçdiyiniz Android geliştirici vasitəsi ilə layihəni açın. Açıq
   AndroidManifest.XML Package Explorer-də seçin və Manifest nişan. İlk giriş Paket ad.
   c. Tətbiqi daxil edin İmza.
   Bu, tətbiqinizi yoxlamaq üçün istifadə olunan SHA-256 hash dəyəridir. İmza, iki nöqtə ilə ayrılmış 32 onaltılıq cüt şəklində olmalıdır (məsample: 01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef). Bax Android Tətbiq İmzaları və API Açarları addımlar üçün imzanı layihənizdən çıxarmaq üçün istifadə edə bilərsiniz.
   6. Klikləyin Saxla.

Appstore olmadan bir Android Tətbiqi əlavə edin

Android tətbiqinizi Amazon Appstore istifadə etmədən qeydiyyatdan keçirmək istəyirsinizsə, Paket Adınızı və İmzanı Amazon ilə Giriş ilə qeyd etmək üçün aşağıdakı addımlardan istifadə edə bilərsiniz:

1. Tətbiq ekranından vurun Android Parametrləri. Əgər onsuz da qeydiyyatdan keçmiş bir Android tətbiqiniz varsa, axtarın API açarı əlavə edin -dəki düymə Android Parametrləri The Android Tətbiqi Təfərrüatları forma görünəcək:
   
2. seçin yox “Bu tətbiqet Amazon Appstore vasitəsilə paylanır?” sualına cavab olaraq
3. daxil edin Etiket sizin Android
   Bunun tətbiqinizin rəsmi adı olması lazım deyil. Sadəcə tətbiqlər arasında bu xüsusi Android tətbiqini müəyyən edir webqeydiyyatdan keçdiyiniz saytlar.
4. Daxil edin Paket Adı. Bu, Android layihənizin paket adı ilə uyğun olmalıdır.
   Android Layihənizin paket adını müəyyənləşdirmək üçün seçdiyiniz Android geliştirici vasitəsi ilə layihəni açın. Açıq AndroidManifest.XML Package Explorer-də seçin və Manifest nişan. İlk giriş Paket ad.
5. Tətbiqi daxil edin İmza.
   Bu, tətbiqinizi yoxlamaq üçün istifadə olunan SHA-256 hash dəyəridir. İmza, iki nöqtə ilə ayrılmış 32 onaltılıq cüt şəklində olmalıdır (məsample: 01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd: ef). Baxın Android Tətbiq İmzaları və API Açarları Layihənizdən imza çıxarmaq üçün istifadə edə biləcəyiniz addımlar üçün aşağıdakı bölmə.
6. klikləyin Saxla.

Tətbiqinizin fərqli versiyalarında bir və ya daha çox test versiyası və istehsal versiyası kimi fərqli imza və ya paket adları varsa, hər versiya öz API Açarını tələb edir. Etibarən Android 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).

Android Tətbiq İmzaları və API Açarları

Tətbiq imzası, hər Android tətbiqinə qurulduqda tətbiq olunan bir SHA-256 hash dəyəridir. Amazon API Açarınızı qurmaq üçün tətbiqetmə imzasından istifadə edir. API Açarı, Amazon xidmətlərinin tətbiqinizi tanımasına imkan verir. Tətbiqinizi imzalamaq üçün Amazon Appstore-dan istifadə edirsinizsə, API açarı avtomatik olaraq verilir. Amazon Appstore'dan istifadə etmirsinizsə, API açarınızı əl ilə idarə etməlisiniz.

Tətbiq imzaları bir mağazada saxlanılır. Ümumiyyətlə, Android tətbiqetmələrində bir debug keystore və bir buraxılış keystore var. Android Studio-da ayıklama açarı mağazasının yerini tapmaq üçün qurmaq menyu, seçin Redaktə et Qurma növləri, sonra gedin İmzalama nişanı vurun və .dakı ayıklama anbarını tapın Mağaza File sahə.

İmzalı bir APK yaratmaq üçün Android tətbiqinizi ixrac edərkən bir açar anbarı adətən yaradılır file. İxrac prosesi ilə yeni bir buraxılış açar mağazası yaradırsınızsa, onun yerini seçəcəksiniz. Varsayılan olaraq, KeyStore defolt debugunuzla eyni yerə yerləşdiriləcək.

İnkişaf zamanı hata ayıklama imzasını istifadə edərək tətbiqinizi qeydiyyatdan keçirdinizsə, tətbiqetməni buraxmağa hazır olduğunuz zaman tətbiqinizə yeni bir Android ayarı əlavə etməlisiniz. Yeni tətbiq ayarı, buraxılış anbarından imzanı istifadə etməlidir.

Bax Müraciətlərinizin imzalanması Daha çox məlumat üçün developer.android.com saytında.

Android Tətbiq İmzasını təyin edin

1. İmzalı bir APK varsa file:
   a. APK faylını açın file və CERT.RSA çıxarın. (Gerekirse APK uzantısının adını ZIP olaraq dəyişə bilərsiniz).
   b. Komanda xəttindən çalıştırın:

   keytool -printcert -file CERT.RSA

   Açar alətlər -də yerləşir bin Java quraşdırma qovluğu.

2. Bir açar mağazanız varsa file:
   a. Komanda xəttindən çalıştırın:

   keytool -list -v -alyasiyalar -mağazafileadı>

   Açar aləti -də yerləşir bin Java quraşdırmanın qovluğu. Takma ad, tətbiqi imzalamaq üçün istifadə olunan açarın adıdır.
   b. Düymənin şifrəsini daxil edin və basın Daxil edin.
3. Altında Sertifikat barmaq izləri, kopyalayın SHA256 dəyər.

Android API Açarını əldə edin

Bir Android ayarı qeydiyyatdan keçdikdən və bir tətbiq imzası verdikdən sonra, Amazon tətbiqi ilə daxil olmaq üçün qeydiyyat səhifəsindən API açarını ala bilərsiniz. Bu API açarını a -ya yerləşdirməlisiniz file Android layihənizdə. Bunu etməyincə, tətbiqin Amazon icazə xidməti ilə Giriş ilə əlaqə qurmaq səlahiyyəti olmayacaq.

1. gedin https://login.amazon.com.
2. klikləyin Tətbiq Konsolu.
3. ildə Tətbiqlər solda qutusunu seçin
4. Altında Android tətbiqinizi tapın Android Parametrləri bölmə (Hələ bir Android tətbiqini qeydiyyatdan keçirməmisinizsə baxın Amazon Appstore üçün Android Tətbiqi əlavə edin).
5. klikləyin API Açar Dəyəri Yaradın. Açılır bir pəncərə API'nizi göstərəcək Açarı 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ı Layihənizə əlavə edin API düyməsini Android-ə əlavə etmək üçün təlimatlar üçün

Amazon Layihəsi ilə Giriş yaradın

Bu bölmədə Amazon ilə Giriş üçün yeni bir Android layihəsi yaratmağı, layihəni konfiqurasiya etməyi və Amazon ilə Giriş ilə bir istifadəçi daxil etmək üçün layihəyə kod əlavə etməyi öyrənəcəksiniz. Android Studio üçün addımları izah edəcəyik, ancaq seçdiyiniz hər hansı bir IDE və ya Android inkişaf vasitəsinə oxşar addımlar tətbiq edə bilərsiniz.

Bu təlimatda bir anlayış tələb olunur Fəaliyyətlər - Android tətbiqetmə inkişafının əsas konsepsiyası. Haqqında daha çox öyrən Fəaliyyətlər və Fəaliyyət fraqmentləri developer.android.com saytında.

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, keçin Amazon Kitabxanası ilə Giriş qurun.

1. Başlayın Android
2. From File menyu, seçin Yeni və Layihə.
3. Daxil edin Tətbiq adı və Şirkət Adı sizin üçün
4. daxil edin Ərizə və Şirkət Adı Tətbiqinizi Amazon ilə Giriş ilə qeydiyyatdan keçirdiyiniz zaman seçdiyiniz paket adına uyğun gəlir.
   Tətbiqinizi hələ qeydiyyatdan keçirməmisinizsə, seçin Paket Adı və sonradakı təlimatları izləyin Amazon ilə Giriş ilə qeydiyyatdan keçin Layihənizi yaratdıqdan sonra bölmə. Tətbiqinizin paket adı qeydiyyatdan keçmiş paket adı ilə uyğun gəlmirsə, Amazon zəngləri ilə Girişiniz uğurlu olmayacaq.
5. a seçin Minimum tələb olunan SDK API 11: Android 3.0 (PETEK) və ya daha yüksək versiyanı seçin və vurun Sonrakı. Alternativ olaraq a Minimum tələb olunan SDK API 8: v2.2 istifadə edərkən Android 4 (Froyo) və ya daha yüksək versiyası Android Dəstək Kitabxanası.
6. Yaratmaq istədiyiniz fəaliyyət növünü seçin və vurun Sonrakı.
7. Müvafiq təfərrüatları doldurun və vurun Bitir.

İndi iş yerinizdə Amazon ilə Giriş zəng etmək üçün istifadə edə biləcəyiniz yeni bir layihəniz olacaq.

Amazon Kitabxanası ilə Giriş qurun

Android üçün Amazon SDK ilə Girişi hələ yükləməmisinizsə, baxın Girişi ilə quraşdırın Android üçün Amazon SDK.

1. istifadə edərək file kompüterinizdəki sistemi tapın amazon-sdk.jar ilə giriş file Android üçün Amazon SDK ilə Giriş daxilində. Panoya kopyalayın.
2. Layihəniz Android Studio-da açıq olduqda Layihə View.
3. Layihəniz / tətbiqiniz üçün ana qovluğuna sağ vurun Layihə View və seçin Yapışdırın.
4. Sağ klikləyin amazon-sdk.jar ilə giriş ildə Layihə View və seçin Kitabxana kimi əlavə edin.

Tətbiqiniz üçün Şəbəkə İcazələrini təyin edin

Tətbiqinizin Amazon ilə Girişdən istifadə etməsi üçün İnternetə girməli və şəbəkə vəziyyəti məlumatlarını əldə etməlidir. Tətbiqiniz bu icazələri onsuz da Android manifestinizdə təsdiqləməlidir.

1. From Layihə View, açmaq üçün xml düyməsini iki dəfə vurun.
2. Aşağıda göstərilən kod sətirlərini kopyalayın və bunlara yapışdırın xml file, tətbiq blokunun xaricində:
   

   Example:
   

API Açarınızı Layihənizə əlavə edin

Android tətbiqinizi Amazon ilə Giriş ilə qeydiyyatdan keçirtdiyiniz zaman sizə bir API açarı verilir. Bu, Amazon Yetkilendirme Menecerinin Amazon ilə giriş xidmətinə giriş üçün tətbiqinizi müəyyənləşdirmək üçün istifadə edəcəyi bir identifikatordur. Tətbiqinizi imzalamaq üçün Amazon Appstore-dan istifadə edirsinizsə, Appstore API açarını avtomatik təmin edəcəkdir. Amazon Appstore'dan istifadə etmirsinizsə, Amazon Yetkilendirme Meneceri bu dəyəri işləmə vaxtı yükləyir api_key.txt file ildə aktivlər kataloq.

1. API açarınız hələ yoxdursa, içindəki təlimatları izləyin Android API Açarını əldə edin.
2. From Layihə View Android Studio-da, aktivlər qovluğuna sağ vurun, sonra vurun Yeni və seçin File. Varlıq qovluğunuz yoxdursa, layihəniz üçün ana qovluğu sağ vurun, sonra seçin Yeni, Qovluq, Aktivlər Qovluğu.
3. adlandırın file api_key.txt.
4. İndi mətn üçün redaktor pəncərəniz olmalıdır file adlı txt. Mətnə API açarınızı əlavə edin file.
5. ildə File menyu, klikləyin Saxla.

Qeyd: Mətn redaktoru api_key.txt -ə əlavə simvollar əlavə edərsə file (məsələn, Bayt Sifariş İşarəti), Amazon icazə xidməti ilə Girişə qoşulmağa çalışdığınızda ERROR_ACCESS_DENIED görə bilərsiniz. Bu baş verərsə, hər hansı bir aparıcı və ya arxada qalan boşluqları, sətir məlumatlarını və ya şübhəli simvolları silməyə çalışın. (Məsələnample, Byte Sifariş İşarəti istifadə edən bir redaktor, api_key.txt faylınızın başlanğıcına 0xEF 0xBB 0xBF və ya digər onaltılıq ardıcıllıqları əlavə edə bilər. file). Yeni bir API açarı almağa da cəhd edə bilərsiniz.

Fəaliyyətiniz üçün Konfiqurasiya Dəyişikliklərini idarə edin

Bir istifadəçi giriş zamanı ekran istiqamətini dəyişdirirsə və ya cihazın klaviatura vəziyyətini dəyişirsə, bu cari fəaliyyətin yenidən başlamasını təklif edəcəkdir. Bu yenidən başlama giriş ekranını gözlənilmədən rədd edəcəkdir. Bunun qarşısını almaq üçün bu konfiqurasiya dəyişikliklərini əl ilə idarə etmək üçün icazə metodundan istifadə edən fəaliyyəti təyin etməlisiniz. Bu fəaliyyətin yenidən başlamasının qarşısını alacaq.

1. In Paket Explorer, iki dəfə klikləyin xml.
2. ildə Ərizə bölməsində, Amazon ilə girişi idarə edəcək fəaliyyətini tapın (forexample, Əsas fəaliyyət),
3. Addım 2-də yerləşdiyiniz fəaliyyətə aşağıdakı atributu əlavə edin:
   

   android: configChanges = ”klaviatura | keyboardHidden | oriyentasiya”

   Və ya API 13 və ya daha yüksək üçün:

   android: configChanges = ”klaviatura | keyboardHidden | orientation | screenSize”

4. From File menyu, klikləyin Saxla

İndi, bir klaviatura və ya cihaz yönümlü dəyişiklik olduqda, Android fəaliyyətiniz üçün onConfigurationChanged metodunu çağıracaq. Tətbiqiniz üçün idarə etmək istədiyiniz bu konfiqurasiya dəyişikliklərinin bir tərəfi olmadığı təqdirdə bu funksiyanı həyata keçirməyə ehtiyac yoxdur.

Layihənizə WorkflowActivity əlavə edin

İstifadəçi Amazon ilə Giriş düyməsini tıkladıqda, API bir web Giriş və razılıq səhifəsini istifadəçiyə təqdim etmək üçün brauzer. Bu brauzer fəaliyyətinin işləməsi üçün manifestinizə WorkflowActivity əlavə etməlisiniz.

Əvvəllər Amazon SDK ilə Giriş ilə inteqrasiya etmisinizsə və ya Android.Manifest.xml-də elan edilmiş com.amazon.identity.auth.device.authorization.AuthorizationActivity fəaliyyətiniz varsa, çıxarılmalı və WorkflowActivity ilə əvəz olunmalıdır.

1. In Paket Explorer, iki dəfə klikləyin AndroidMailfest.xml ..
2. ildə Ərizə bölməsinə aşağıdakı kodu əlavə edin.
   

   <fəaliyyət android:name= “Com.amazon.identity.auth.device.workflow.WorkflowActivity” android: theme = ”@ android: style / Theme.NoDisplay” android: allowTaskReparenting = ”true” android: launchMode = ”singleTask”> <action android:name=”android.intent.action.VIEW” /> <data android: host = ”$ {applicationId}” android: sche = ”amzn” />

   Qeyd: Gradle build sistemindən istifadə etmirsinizsə, bu tətbiq üçün paket adınızı $ {applicationId} ilə əvəz edin.

Tətbiqinizə Amazon Düyməsi ilə Giriş əlavə edin

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ə Amazon şəkli ilə rəsmi bir Giriş yükləmək və Android ImageButton ilə qoşmaq üçün addımlar verir.

1. Tətbiqinizə standart bir ImageButton əlavə edin.
   Android düymələri və ImageButton sinfi haqqında daha çox məlumat üçün baxın Düymələr developer.android.com saytında.

2. Düyməyinizə bir düymə verin XML bəyannaməsində android: id atributunu @+id/login_with_amazon olaraq təyin edin. Məsələnample:
   

   android: id = ”@ + id / login_with_amazon”

3. 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_Android.zip file. Tətbiqinizin dəstəklədiyi hər bir ekran sıxlığı üçün (xxhdpi, xhdpi, hdpi, mdpi və ya tvdpi) seçdiyiniz düymənin surətini çıxarın. Android -də birdən çox ekran sıxlığının dəstəklənməsi haqqında daha çox məlumat üçün baxın Alternativ Layouts ondeveloper.android.com saytında "Birdən çox Ekranın dəstəklənməsi" mövzusunda.
4. Uyğun düymə şəklini kopyalayın files layihənizə.
   Dəstəklədiyiniz hər ekran sıxlığı üçün (xhdpi, hdpi, mdpi və ya ldpi) yüklənmiş düyməni kopyalayın. res / drawable bu ekran sıxlığı üçün qovluq.
5. Düymə şəklini elan edin.
   Düymə XML bildirişində Android: src seçdiyiniz düymənin adına atfedin. Məsələnample:

   android: src = ”@ drawable / btnlwa_gold_loginwithamazon.png”

6.  Tətbiqinizi yükləyin və düymənin artıq Amazon şəkli ilə bir Giriş olduğuna əmin olun.
   Dəstəklədiyiniz hər bir ekran sıxlığı üçün düymənin düzgün göstərildiyini yoxlamalısınız

Android API üçün SDK istifadə edin

Bu hissədə, Amazon ilə Giriş ilə bir istifadəçi daxil etmək üçün layihənizə kod əlavə edəcəksiniz.

Giriş düyməsini idarə edin və istifadəçiyə icazə verin

Bu bölmə bir istifadəçiyə giriş üçün icazə API'sinin necə çağırılacağını izah edir. Buraya bir onClick ilə Amazon düyməsinə Giriş üçün dinləyici onCreate tətbiqinizin metodu.

1. Android Baxışınıza Amazon ilə Giriş əlavə edin Amazon Kitabxanası ilə Giriş qurun.
2. Başla İstək Konteksti.
   A elan etməlisiniz İstək Konteksti dəyişən və yeni bir sinif nümunəsi yaradın. Başlanğıc üçün ən yaxşı yer İstək Konteksti içərisindədir onCreate Android fəaliyyətinizin və ya fraqmentinizin üsulu. Məsələnample:

   Şəxsi RequestContext requestContext; @Oride qorunan boşluq onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); requestContext = RequestContext.create (bu); }

3. yaradın Avtorizasiya Listen.
   Avtorizasiya Listen nəticəsini işləyəcək səlahiyyətli çağırış. Üç metoddan ibarətdir: onSuccess, on Error, və ləğv et. yaradın Avtorizasiya Listen interfeys a ilə qeyd dinləyici zəng edin onCreate Android fəaliyyətinizin və ya fraqmentinizin metodu.

   @Oride qorunan boşluq onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); requestContext = RequestContext.create (bu);requestContext.registerListener (yeni AuthorizeListener () { / * Avtorizasiya uğurla başa çatdı. * / @Oride ümumi boşluq onSuccess (AuthorizeResult result) { / * Tətbiqiniz artıq tələb olunan sahələr üçün səlahiyyətlidir * / } / * Tətbiqə icazə vermə cəhdi zamanı bir səhv baş verdi. * / @Oride ictimai boşluq onError (AuthError ae) { / * Səhv barədə istifadəçiyə məlumat verin * / } / * İcazə tamamlanmadan ləğv edildi. * / @ Override ümumi boşluq onCancel (AuthCancellation ləğvi) { / * İstifadəçi interfeysini girişə hazır vəziyyətə gətirin * / } }); }

   Qeyd: Bir parça istifadə edirsinizsə və istinadlar çəkirsinizsə View daxilinizdəki obyektlər Avtorizasiya Listen həyata keçirmək, yaratmaq Avtorizasiya Listen ildə onCreateView metod əvəzinə Yaradın. Bu təmin edir View zəng edildikdə obyekt istinadları təyin olunur icazə verir.
4. Həyata keçirmək onSuccess, on Error, və ləğv et sizin üçün Avtorizasiya Listen.
   Çünki avtorizasiya prosesi istifadəçiyə giriş ekranı (və bəlkə də razılıq ekranı) təqdim edir web brauzer (və ya WebView), istifadəçi girişi ləğv etmək və ya uzaqlaşmaq imkanı əldə edəcək. Giriş prosesini açıq şəkildə ləğv etsələr, ləğv et adlanır və istifadəçi interfeysinizi yenidən qurmaq istəyəcəksiniz.
   İstifadəçi brauzerdəki giriş ekranından uzaqlaşsa və ya WebView, sonra tətbiqinizə qayıdır, SDK girişin tamamlanmadığını aşkar etməyəcək. Giriş tamamlanmadan əvvəl tətbiqinizdə istifadəçi fəaliyyətini aşkar etsəniz, brauzerdən uzaqlaşdıqlarını və buna uyğun reaksiya verdiklərini düşünə bilərsiniz.
5. Zəng edin RequestContext.onResume.
   Android tətbiqetmə ömrünü uyğunlaşdırmaq üçün onResume fəaliyyətinizdə və ya fraqmentinizdə metod. Bu qeydiyyatdan keçmiş bütün dinləyiciləri tetikler qeyd dinləyici istifadəçi bir icazə axını tamamlamadan əvvəl tətbiqinizin əməliyyat sistemi tərəfindən bağlanması halında.

   @Oride qorunan boşluq onResume () { super.onResume (); requestContext.onResume (); }

6. Zəng edin AuthorizationManager.authorize.
   ildə onClick Amazon düyməsiylə girişiniz üçün işləyici, istifadəçiyə müraciət etməyinizi və tətbiqinizi təsdiqləməsini istəmək üçün avtorizasiya çağırın.
   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. Sistem brauzerinə keçir
   2. -a keçir WebView etibarlı bir kontekstdə (Amazon Shopping tətbiqi cihaza quraşdırılıbsa)
   İkinci seçim üçün etibarlı kontekst, Amazon Shopping tətbiqi cihaza quraşdırıldıqda mövcuddur. Amazon tərəfindən Fire OS ilə işləyən qurğular (məsələnample Kindle Fire, Fire Phone və Fire TV) cihazda Amazon Alqı -satqı proqramı olmasa belə həmişə bu seçimdən istifadə edin. Buna görə, istifadəçi artıq Amazon Shopping tətbiqinə daxil olarsa, bu API giriş səhifəsini atlayacaq və Tək Giriş istifadəçi üçün təcrübə. Müştəri Təcrübəsinə baxın müştəri təcrübəsi-android daha çox öyrənmək üçün tətbiqlər. Tətbiqinizə icazə verildikdə, kimi tanınan bir və ya daha çox məlumat dəsti üçün icazə verilir əhatə dairələri. Amazon ilə Girişdən tələb etdiyiniz istifadəçi məlumatlarını əhatə edir. Bir istifadəçi tətbiqinizə ilk dəfə daxil olduqda, tələb etdiyiniz və təsdiqlənməsi istənən məlumatların siyahısı təqdim olunacaq. Amazon ilə giriş hazırda aşağıdakı sahələri dəstəkləyir:

   Sahə adı	Təsvir
   profile	İstifadəçinin adına, e-poçt adresinə və Amazon hesabı kimliyinə giriş imkanı verir.
   profile:İstifadəçi adı	Yalnız istifadəçinin Amazon hesab kimliyinə giriş imkanı verir.
   poçt kodu	İstifadəçinin poçt/poçt koduna giriş imkanı verir file Amazon hesabları üçün.

   AuthorizationManager.authorize asinxron bir çağırışdır, buna görə də istifadəçi interfeysini bloklamaq və ya özünüzə məxsus bir işçi mövzu yaratmaq məcburiyyətində deyilsiniz. Avtorizasiya etmək üçün zəng vurun İcazə verin istifadə edərək tikilə bilən obyekt Səlahiyyət verin.Builder:
   

   @Oride qorunan boşluq onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); / * Əvvəlki onCreate bəyannamələri buraxıldı * /// login_with_amazon ID ilə düyməni tapın // və bir klik işləyicisi qurun View loginButton = tapViewById (R.id.login_with_amazon); loginButton.setOnClickListener (yeni View.OnClickListener () { @Oride ictimai boşluq onClick (View v) {AuthorizationManager.authorize (yeni AuthorizeRequest Builder (requestContext) .addScopes (ProfileScope.profile(), ProfileScope.postalCode ()) .build ()); }); }

İstifadəçi Pro alınfile Data

Bu bölmə, istifadəçinin pro -nı əldə etmək üçün User API -dən necə istifadə olunacağını izah edirfile məlumat verildikdən sonra. Profile əldə edə biləcəyiniz məlumatlar sənəddə göstərilən sahəyə əsaslanır icazə verin: withHandler: zəng edin.

1. Zəng edin İstifadəçi.fetch.
   İstifadəçi.fetch istifadəçi pro qaytarırfile Dinləyici vasitəsi ilə sizə məlumat verir AuthError> geri zəng et. Dinləyici AuthError> iki metoddan ibarətdir: onUğur və onError (dəstəkləmir ləğv et çünki ləğv etməyin yolu yoxdur İstifadəçi.fetch zəng edin). onUğur pro ilə bir İstifadəçi obyekti alırfile məlumatlar isə onError alır Müəllif xətası səhv barədə məlumatı olan obyekt. updateProfileData keçmişdiramptətbiqinizi göstərmək üçün tətbiq edə biləcəyiniz bir funksiyafile istifadəçi interfeysindəki məlumatlar
   Qeyd: User.getUserPostalCode yalnız Pro tələb etdiyiniz halda geri qaytarılırfileScope.postalCode () əhatə dairəsi.

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 getToken tətbiqin hələ də səlahiyyətli olub olmadığını görmək.

1. Zəng edin getToken.
   ildə Başlayın fəaliyyətinizin və ya fraqmentinizin metodu, zəng edin getToken tətbiqin hələ də səlahiyyətli olub olmadığını görmək. getToken xam giriş işarəsini alır Authorization Manager istifadəçi pro -ya daxil olmaq üçün istifadə edirfile. Token dəyəri sıfır deyilsə, tətbiq hələ də səlahiyyətlidir və istifadəçi pro almağa davam edə bilərsinizfile data. getToken tələb edir icazə vermək üçün etdiyiniz zəngdə tələb etdiyiniz eyni miqyaslar.
   getTokensupports eyni qaydada asinxron zənglər İstifadəçi.fetch, beləliklə, istifadəçi interfeysini bloklamaq və ya özünüzü işçi bir mövzu yaratmaq məcburiyyətində deyilsiniz. Zəng etmək getToken asynchronically, dəstəkləyən bir obyekt keçir Dinləyici son parametr kimi interfeys.
2. Bəyan edin a Dinləyici AuthError>. Sizin tətbiqetməyiniz Dinləyici AuthError> interfeysi nəticəsini işləyir getToken zəng edin. Dinləyici iki metoddan ibarətdir: onUğur və onError (dəstəkləmir ləğv et çünki ləğv etməyin yolu yoxdur getToken zəng edin).
3. Həyata keçirmək onUğur və onError sizin üçün Dinləyici . onUğur alır Nəticəni təsdiqləyin bir giriş işarəsi olan obyekt onError alır Müəllif xətası səhv barədə məlumatı olan obyekt.
   

   @Oride qorunan boşluq onStart () {super.onStart (); Kapsam [] sahələri = {ProfileScope.profile(), ProfileScope.postalCode ()}; AuthorizationManager.getToken (bu, əhatə dairəsi, yeni Dinləyici () {@Oride public void onSuccess (AuthorizeResult result) {if (result.getAccessToken ()! = null) { / * İstifadəçi daxil olub * / } başqa { / * İstifadəçi daxil deyil * / } } @Oride ictimai boşluq onError (AuthError ae) { / * İstifadəçi daxil deyil * / } }); }

Avtorizasiya məlumatlarını silin və bir istifadəçidən çıxın

Bu bölmə, istifadəçini tətbiqinizdən çıxarmaq üçün Çıxış metodundan necə istifadə edəcəyinizi izah edir. Tətbiqin pro əldə etməsi üçün istifadəçi yenidən daxil olmalı olacaqfile məlumatlar. Bir istifadəçini çıxarmaq və ya tətbiqdəki giriş problemlərini həll etmək üçün bu üsuldan istifadə edin.

1. Bir çıxış mexanizmi tətbiq edin.
   İstifadəçi uğurla daxil olduqda, pro -sini təmizləyə bilməsi üçün bir çıxış mexanizmi təqdim etməlisinizfile məlumatlar və əvvəllər icazə verilən sahələr. Mexanizminiz köprü, düymə və ya menyu elementi ola bilər. Bunun üçün keçmişample, biz bir yaradacağıq onClickmethod bir düymə üçün.
2. Zəng edin çıxış.
   Zəng edin çıxış istifadəçi icazə məlumatlarını (giriş nişanları, profile) yerli mağazadan. çıxış bir Android kontekstini və bir Dinləyicini alır AuthError> üçün müvəffəqiyyət və ya uğursuzluqla məşğul olmaq.
3. Anonim bir Dinləyici elan edin AuthError>.
   Dinləyicinin tətbiqi AuthError> nəticəsini işləyir çıxış zəng edin. Anonim siniflər, əhatə dairəsindən dəyişənlərin alınması üçün faydalıdır.
   Bax Giriş düyməsini idarə edin və istifadəçiyə icazə verin üçün exampqoy dinləyici dərsləri elan edir.
4. Həyata keçirmək onUğur və onError Dinləyiciniz üçün AuthError>.
   Nə vaxt imzaladı istifadəçiyə istinadları silmək üçün istifadəçi interfeysinizi yeniləməlisiniz və istifadəçilər yenidən giriş etmək üçün istifadə mexanizmi təmin etməlisiniz. Əgər işarəsi Çıxışlar bir səhv, istifadəçinin yenidən çıxmağa çalışmasına icazə verə bilərsiniz.

   @Oride qorunan boşluq onCreate (Bundle savedInstanceState) {super.onCreate (savedInstanceState); / * Əvvəlki onCreate bəyannamələri buraxıldı * /// Çıxış identifikatoru ilə düyməni tapın və bir klik işləyicisi qurun View logoutButton = tapViewById (R.id.logout); logoutButton.setOnClickListener (yeni View.OnClickListener () {@Oride ictimai boşluq onClick (View v) {AuthorizationManager.signOut (getApplicationContext (), yeni Dinləyici () {@Override public void onSuccess (Boş cavab) { // UI-də çıxmış vəziyyəti təyin edin } @Oride ictimai boşluq onError (AuthError authError) { // Xətaya daxil olun } }); } }); }

Android tətbiqetmələri üçün Amazon Başlanğıc Kılavuzu ilə daxil olun - Endirin [optimize]
Android tətbiqetmələri üçün Amazon Başlanğıc Kılavuzu ilə daxil olun - Yüklə

İstinadlar

• İstifadəçi təlimatı