Log masuk dengan Panduan Bermula Amazon untuk aplikasi Android

Log masuk dengan Amazon: Panduan Bermula untuk Android

Hak Cipta © 2017 Amazon.com, Inc., atau sekutunya. Hak cipta terpelihara.

Amazon dan logo Amazon adalah tanda dagang Amazon.com, Inc. atau sekutunya. Semua tanda dagangan lain yang tidak dimiliki oleh Amazon adalah hak milik pemiliknya masing-masing.

Pasang Alat Pembangun Android

Login dengan Amazon SDK untuk Android akan membantu anda menambahkan Login dengan Amazon ke aplikasi Android, Fire TV, dan Fire Tablet anda. Kami mengesyorkan anda menggunakan Login dengan Amazon SDK untuk Android dengan Android Studio. Untuk mengetahui cara memasang Android Studio dan menyiapkan Android SDK, lihat Dapatkan Android SDK di developer.android.com.

Untuk menggunakan Login dengan Amazon SDK untuk Android, aplikasi Android anda mesti memenuhi salah satu syarat minimum berikut:

• Versi SDK Minimum (minSdkVersion) Android 0 (API Level 11) atau lebih tinggi.
• Versi SDK Minimum (minSdkVersion) Android 2.2 (API Level 8) atau lebih tinggi dengan v4 Sokongan Android Perpustakaan.

Apabila Android SDK dipasang, cari Pengurus SDK aplikasi dalam pemasangan Android anda. Untuk mengembangkan Login dengan Amazon, anda mesti menggunakan SDK Manager untuk memasang syarat minimum SDK di atas. Lihat Menambah Pakej SDK di developer.android.com untuk maklumat lebih lanjut mengenai penggunaan SDK Manager.

Setelah memasang SDK, sediakan Peranti Maya Android (AVD) untuk menjalankan aplikasi anda. Lihat Mengurus Peranti Maya di developer.android.com untuk mendapatkan arahan mengenai penyediaan peranti maya.

Apabila persekitaran pembangunan anda disiapkan, anda boleh Pasang Log Masuk dengan Amazon SDK untuk Android or Jalankan Sample Aplikasi, seperti yang dinyatakan di bawah

Pasang Log Masuk dengan Amazon SDK untuk Android

Log masuk dengan Amazon SDK untuk Android terdapat dalam dua pakej. Yang pertama mengandungi pustaka Android dan dokumentasi sokongan. Yang kedua mengandungi sebagaiample aplikasi yang membolehkan pengguna masuk dan memaparkan pro merekafile data.

Sekiranya anda belum memasang SDK Android atau Alat Pembangunan Android, lihat Memasang Alat Pembangun Android bahagian di atas.

1. Muat turun zip dan ekstrak files ke direktori pada cakera keras anda. Anda mesti melihat a dokumen dan a lib subdirektori.
2. Buka docs / index.html kepada view Log masuk dengan Rujukan API Android Android.
3. Lihat Pasang Log Masuk dengan Perpustakaan Amazon untuk arahan mengenai cara menambahkan perpustakaan dan dokumentasi ke Android

Apabila Log Masuk dengan Amazon SDK untuk Android dipasang, anda boleh Buat Log Masuk Baru dengan Amazon Projek selepas awak Daftar dengan Log Masuk dengan Amazon.

Jalankan Sample Aplikasi

Untuk menjalankan sample aplikasi, import sampmasuk ke ruang kerja AndroidStudio.

1. Muat turun SampleLoginWithAmazonAppForAndroid-src.zip dan ekstrak files ke direktori di hard anda
2. Mulakan Android Studio dan pilih Buka projek Studio Android yang ada.
3. Semak imbas ke SampleLoginWithAmazonApp direktori yang diperoleh setelah mengeluarkan zip yang dimuat turun file dalam Langkah 1.
4. daripada bina menu, klik Buat Projek, dan tunggu projek selesai.
5. daripada Lari menu, klik Lari dan kemudian klik pada SampleLoginWithAmazonApp.
6. Pilih emulator atau peranti Android yang disambungkan dan klik Lari.

Daftar dengan Log Masuk dengan Amazon

Sebelum anda boleh menggunakan Log masuk dengan Amazon pada a webtapak atau dalam aplikasi mudah alih, anda mesti mendaftarkan aplikasi dengan Log masuk dengan Amazon. Aplikasi Log Masuk anda dengan Amazon ialah pendaftaran yang mengandungi maklumat asas tentang perniagaan anda dan maklumat tentang setiap perniagaan webtapak atau aplikasi mudah alih yang anda buat yang menyokong Log masuk dengan Amazon. Maklumat perniagaan ini dipaparkan kepada pengguna setiap kali mereka menggunakan Log masuk dengan Amazon pada anda weblaman web atau aplikasi mudah alih. Pengguna akan melihat nama aplikasi anda, logo anda, dan pautan ke dasar privasi anda. Langkah-langkah ini menunjukkan cara mendaftarkan aplikasi Android anda untuk digunakan dengan Login dengan Amazon.

Daftarkan Log Masuk Anda dengan Aplikasi Amazon

1. Pergi ke https://login.amazon.com.
2. Sekiranya anda telah mendaftar masuk dengan Amazon sebelumnya, klik Konsol Apl. Jika tidak, klik Daftar. Anda akan diarahkan ke Seller Central, yang mengendalikan pendaftaran aplikasi untuk Login dengan Jika ini pertama kali anda menggunakan Seller Central, anda akan diminta untuk membuat akaun Pusat Penjual.
3. klik Daftar Permohonan Baru. The Daftarkan Permohonan Anda borang akan muncul:
   a. Dalam Daftarkan Permohonan Anda borang, masukkan a Nama dan a Penerangan untuk permohonan anda.
   The Nama ialah nama yang dipaparkan pada skrin persetujuan apabila pengguna bersetuju untuk berkongsi maklumat dengan aplikasi anda. Nama ini digunakan untuk Android, iOS dan webversi laman web aplikasi anda. The Penerangan membantu anda membezakan setiap Login anda dengan aplikasi Amazon dan tidak dipaparkan kepada pengguna.
   b. Masukkan a Notis Privasi URL untuk permohonan anda.
   The Notis Privasi URL adalah lokasi dasar privasi syarikat atau aplikasi anda (misalnyaample, http://www.example.com/privacy.html). Pautan ini dipaparkan kepada pengguna di skrin persetujuan.
   c. Jika anda ingin menambah a Imej Logo untuk permohonan anda, klik Semak imbas dan cari imej yang berkenaan.
4. klik Jimat. s andaamppendaftaran le sepatutnya kelihatan seperti ini:
   
   Selepas tetapan aplikasi asas anda disimpan, anda boleh menambah tetapan untuk tertentu weblaman web dan aplikasi mudah alih yang akan menggunakan Login dengan akaun Amazon ini.

Tambahkan Tetapan Android ke Aplikasi anda

Untuk mendaftarkan Aplikasi Android, anda mempunyai pilihan untuk mendaftarkan aplikasi melalui Amazon Appstore (Tambahkan Aplikasi Android untuk Amazon Appstore) atau secara langsung dengan Log Masuk dengan Amazon (Tambahkan Android Apl tanpa Appstore). Apabila aplikasi anda didaftarkan, anda akan mendapat akses ke kunci API yang akan memberi aplikasi anda akses ke perkhidmatan kebenaran Login dengan Amazon.

Nota: Sekiranya anda berencana untuk menggunakan Pemesejan Peranti Amazon dalam aplikasi Android anda, hubungi lwa-sokongan@amazon.com dengan:

• Alamat e-mel akaun Amazon yang anda gunakan untuk mendaftar masuk
• Alamat e-mel akaun Amazon yang anda gunakan untuk mendaftar ke Amazon Appstore (jika berbeza).
• Nama pada akaun Pusat Penjual anda (di Pusat Penjual, klik Tetapan> Maklumat Akaun> Maklumat Penjual, dan gunakan Nama Paparan).
• Nama di akaun pembangun Amazon Appstore anda (di laman Pengedaran Aplikasi Mudah Alih, klik Tetapan> Pro Syarikatfile dan gunakan Nama Pemaju atau Nama Syarikat).

Tambahkan aplikasi Android untuk Amazon Appstore

Langkah-langkah berikut akan menambahkan aplikasi Amazon Appstore ke Login dengan akaun Amazon anda:

1. Dari skrin Aplikasi, klik Tetapan Android. Sekiranya anda sudah mempunyai aplikasi Android yang didaftarkan, cari Tambah Kekunci API butang dalam Tetapan Android pemilihan
   The Perincian Aplikasi Android borang akan muncul:
2. Pilih ya sebagai jawapan kepada soalan "Adakah aplikasi ini diedarkan melalui Amazon Appstore?"
3. Masukkan ke Label Aplikasi Android anda. Ini tidak semestinya nama rasmi aplikasi anda. Ini hanya mengenal pasti aplikasi Android tertentu di antara aplikasi dan weblaman web yang didaftarkan ke Log Masuk anda dengan Amazon
4. Tambah anda ID Appstore Amazon.
5. Sekiranya anda menandatangani aplikasi anda sendiri, tambahkan maklumat tandatangan sendiri. Ini akan membolehkan anda mendapatkan kunci API semasa pembangunan tanpa menggunakan Appstore secara langsung.
   a. Sekiranya aplikasi anda tidak ditandatangani melalui Amazon Appstore, pilih ya sebagai jawapan kepada soalan "Adakah aplikasi ini ditandatangani sendiri?"
   The Perincian Aplikasi Android borang akan berkembang
   
   b. Masukkan anda Nama Pakej.
   Ini mesti sepadan dengan nama pakej projek Android anda. Untuk menentukan nama pakej Projek Android anda, buka projek mengikut pilihan alat pembangun Android anda. Buka
   AndroidManifest.XML dalam Pakej Penjelajah dan pilih Manifest tab. Entri pertama ialah Pakej nama.
   c. Masukkan aplikasi Tandatangan.
   Ini adalah nilai hash SHA-256 yang digunakan untuk mengesahkan aplikasi anda. Tandatangan mestilah dalam bentuk 32 pasangan heksadesimal yang dipisahkan oleh titik dua (untuk contohample: 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). Lihat Tandatangan Aplikasi Android dan Kekunci API untuk langkah-langkah yang boleh anda gunakan untuk mengekstrak tandatangan dari projek anda.
   6. Klik Jimat.

Tambahkan Aplikasi Android tanpa Appstore

Sekiranya anda ingin mendaftarkan aplikasi Android anda tanpa menggunakan Amazon Appstore, anda boleh menggunakan langkah-langkah berikut untuk mendaftarkan Nama dan Tanda Pakej anda dengan Log Masuk dengan Amazon:

1. Dari skrin Aplikasi, klik Tetapan Android. Sekiranya anda sudah mempunyai aplikasi Android yang didaftarkan, cari Tambah Kekunci API butang dalam Tetapan Android The Perincian Aplikasi Android borang akan muncul:
   
2. Pilih Tidak sebagai jawapan kepada soalan "Adakah aplikasi ini diedarkan melalui Amazon Appstore?"
3. Masukkan ke Label daripada Android anda
   Ini tidak semestinya nama rasmi aplikasi anda. Ini hanya mengenal pasti aplikasi Android tertentu di antara aplikasi dan weblaman web yang telah anda daftarkan.
4. Masukkan anda Nama Pakej. Ini mesti sepadan dengan nama pakej projek Android anda.
   Untuk menentukan nama pakej Projek Android anda, buka projek mengikut pilihan alat pembangun Android anda. Buka AndroidManifest.XML dalam Pakej Penjelajah dan pilih Manifest tab. Entri pertama ialah Pakej nama.
5. Masukkan aplikasi Tandatangan.
   Ini adalah nilai hash SHA-256 yang digunakan untuk mengesahkan aplikasi anda. Tandatangan mestilah dalam bentuk 32 pasangan heksadesimal yang dipisahkan oleh titik dua (untuk contohample: 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). Lihat Tandatangan Aplikasi Android dan Kekunci API bahagian di bawah untuk langkah-langkah yang boleh anda gunakan untuk mengekstrak tandatangan dari projek anda.
6. klik Jimat.

Sekiranya versi aplikasi anda berbeza mempunyai tandatangan atau nama pakej yang berbeza, seperti untuk satu atau lebih versi ujian dan versi pengeluaran, setiap versi memerlukan Kunci API sendiri. Daripada Tetapan Android aplikasi anda, klik Tambah Kekunci API butang untuk membuat kunci tambahan untuk aplikasi anda (satu per versi).

Tandatangan Aplikasi Android dan Kekunci API

Tandatangan aplikasi adalah nilai hash SHA-256 yang diterapkan pada setiap aplikasi Android ketika ia dibina. Amazon menggunakan tandatangan aplikasi untuk membina Kunci API anda. Kunci API membolehkan perkhidmatan Amazon mengenali aplikasi anda. Sekiranya anda menggunakan Amazon Appstore untuk menandatangani aplikasi anda, kunci API diberikan secara automatik. Sekiranya anda tidak menggunakan Amazon Appstore, anda perlu menguruskan kunci API anda secara manual.

Tandatangan aplikasi disimpan di kedai kunci. Secara amnya, untuk aplikasi Android terdapat keystore debug dan keystore keluaran. Untuk mencari lokasi kedai kunci debug di Android Studio, buka bina menu, pilih Sunting Jenis Binaan, kemudian pergi ke Menandatangani tab, dan cari kedai kunci debug di Kedai File padang.

Kedai kunci pelepasan biasanya dibuat ketika anda mengeksport aplikasi Android anda untuk membuat APK yang ditandatangani file. Melalui proses eksport, jika anda membuat kedai kunci pelepasan baru, anda akan memilih lokasinya. Secara lalai, ia akan diletakkan di lokasi yang sama dengan KeyStore debug lalai anda.

Sekiranya anda telah mendaftarkan aplikasi anda menggunakan tandatangan debug semasa pengembangan, anda perlu menambahkan tetapan Android baru ke aplikasi anda apabila anda sudah siap untuk melepaskan aplikasi tersebut. Tetapan aplikasi baru mesti menggunakan tandatangan dari kedai kunci pelepasan.

Lihat Menandatangani Permohonan Anda di developer.android.com untuk maklumat lebih lanjut.

Tentukan Tandatangan Aplikasi Android

1. Sekiranya anda mempunyai APK yang ditandatangani file:
   a. Nyahzip APK file dan ekstrak CERT.RSA. (Anda boleh menamakan semula pelanjutan APK kepada ZIP jika perlu).
   b. Dari baris arahan, jalankan:

   keytool -printcert -file CERT.RSA

   Alat Kunci terletak di tong sampah direktori pemasangan Java anda.

2. Sekiranya anda mempunyai kedai kunci file:
   a. Dari baris arahan, jalankan:

   keytool -list -v -alias -kedai kuncifilenama>

   Alat kekunci terletak di tong sampah direktori pemasangan Java anda. Alias ​​adalah nama kunci yang digunakan untuk menandatangani aplikasi.
   b. Masukkan kata laluan untuk kekunci dan tekan Masuk.

3. Di bawah Cap Jari Sijil, menyalin SHA256 nilai.

Dapatkan Kunci API Android

Apabila anda telah mendaftarkan tetapan Android dan memberikan tandatangan aplikasi, anda boleh mendapatkan kunci API dari halaman pendaftaran untuk aplikasi Login dengan Amazon anda. Anda perlu meletakkan kunci API tersebut ke dalam file dalam projek Android anda. Sehingga anda melakukannya, aplikasi tidak akan dibenarkan untuk berkomunikasi dengan perkhidmatan kebenaran Login dengan Amazon.

1. Pergi ke https://login.amazon.com.
2. klik Konsol Apl.
3. Dalam Aplikasi kotak di sebelah kiri, pilih anda
4. Cari aplikasi Android anda di bawah Tetapan Android bahagian (Jika anda belum mendaftarkan aplikasi Android, lihat Tambahkan Aplikasi Android untuk Amazon Appstore).
5. klik Hasilkan Nilai Utama API. Tetingkap pop timbul akan memaparkan API anda Untuk menyalin kunci, klik Pilih Semua untuk memilih keseluruhan kunci.
   Nota: Nilai Kunci API didasarkan, sebahagiannya, pada masa ia dihasilkan. Oleh itu, Nilai Kunci API seterusnya yang anda hasilkan mungkin berbeza dari yang asal. Anda boleh menggunakan mana-mana Nilai Utama API ini dalam aplikasi anda kerana semuanya valid.
6. Lihat Tambahkan Kunci API Anda ke Projek Anda untuk arahan mengenai menambah kunci API ke Android anda

Buat Log Masuk dengan Projek Amazon

Di bahagian ini, anda akan belajar bagaimana membuat projek Android baru untuk Login dengan Amazon, mengkonfigurasi projek, dan menambahkan kod ke projek untuk log masuk pengguna dengan Login dengan Amazon. Kami akan menerangkan langkah-langkah untuk Android Studio, tetapi anda dapat menerapkan langkah-langkah serupa ke mana-mana alat pengembangan IDE atau Android pilihan anda.

Panduan ini memerlukan pemahaman mengenai Aktiviti - konsep utama pembangunan aplikasi Android. Ketahui lebih lanjut mengenai Aktiviti dan Pecahan Aktiviti di developer.android.com.

Buat Log Masuk Baru dengan Projek Amazon

Sekiranya anda belum mempunyai projek aplikasi untuk menggunakan Login dengan Amazon, ikuti arahan di bawah untuk membuatnya. Sekiranya anda mempunyai aplikasi yang ada, langkau ke Pasang Log Masuk dengan Perpustakaan Amazon.

1. Pelancaran Android
2. daripada File menu, pilih baru dan Projek.
3. Masukkan satu Nama Permohonan dan Nama Syarikat untuk anda
4. Masukkan ke Permohonan dan Nama Syarikat sepadan dengan nama pakej yang anda pilih semasa anda mendaftarkan aplikasi anda dengan Login dengan Amazon.
   Sekiranya anda belum mendaftarkan aplikasi anda, pilih a Nama Pakej dan kemudian ikuti arahan di Mendaftar dengan Log Masuk dengan Amazon bahagian selepas anda membuat projek anda. Sekiranya nama pakej aplikasi anda tidak sepadan dengan nama pakej yang didaftarkan, Log masuk dengan panggilan Amazon anda tidak akan berjaya.
5. Pilih a SDK Diperlukan Minimum API 11: Android 3.0 (Honeycomb) atau lebih tinggi, dan klik Seterusnya. Anda boleh menggunakan a SDK Diperlukan Minimum API 8: Android 2.2 (Froyo) atau lebih tinggi semasa menggunakan v4 Perpustakaan Sokongan Android.
6. Pilih jenis aktiviti yang ingin anda buat dan klik Seterusnya.
7. Isi butiran yang berkaitan dan klik Selesai.

Anda sekarang akan mempunyai projek baru di ruang kerja yang boleh anda gunakan untuk memanggil Login dengan Amazon.

Pasang Log Masuk dengan Perpustakaan Amazon

Sekiranya anda belum memuat turun Login dengan Amazon SDK untuk Android, lihat Pasang Log Masuk dengan Amazon SDK untuk Android.

1. Menggunakan file sistem pada komputer anda, cari log masuk-dengan-amazon-sdk.jar file dalam Log Masuk dengan Amazon SDK untuk Android. Salin ke papan keratan.
2. Dengan projek anda dibuka di Android Studio, buka Projek View.
3. Klik kanan pada direktori induk untuk projek / aplikasi anda di Projek View dan pilih tampal.
4. Klik kanan log masuk-dengan-amazon-sdk.jar dalam Projek View dan pilih Tambah Sebagai Perpustakaan.

Tetapkan Kebenaran Rangkaian untuk Aplikasi Anda

Agar aplikasi anda menggunakan Login dengan Amazon, aplikasi mesti mengakses Internet dan mengakses maklumat keadaan rangkaian. Aplikasi anda mesti menyatakan kebenaran ini dalam manifes Android anda, jika belum.

1. daripada Projek View, klik dua kali xml untuk membukanya.
2. Salin garis kod yang dipaparkan di bawah dan tampal ke dalam xml file, di luar blok aplikasi:
   

   Example:
   

Tambahkan Kunci API Anda ke Projek Anda

Apabila anda mendaftarkan aplikasi Android anda dengan Login dengan Amazon, anda diberi kunci API. Ini adalah pengecam yang akan digunakan oleh Pengurus Kebenaran Amazon untuk mengenal pasti aplikasi anda ke perkhidmatan kebenaran Masuk dengan Amazon. Sekiranya anda menggunakan Amazon Appstore untuk menandatangani aplikasi anda, Appstore akan memberikan kunci API secara automatik. Sekiranya anda tidak menggunakan Amazon Appstore, Amazon Authorization Manager memuatkan nilai ini pada waktu runtime dari api_key.txt file dalam aset direktori.

1. Sekiranya anda belum mempunyai Kunci API, ikuti arahan di Dapatkan Kunci API Android.
2. daripada Projek View di Android Studio, klik kanan folder aset, kemudian klik baru dan pilih File. Sekiranya anda tidak mempunyai folder aset, klik kanan direktori induk untuk projek anda, kemudian pilih baru, folder, Folder Aset.
3. Namakan file api_key.txt.
4. Anda kini harus mempunyai tetingkap editor untuk teks file bernama txt. Tambahkan kunci API anda ke teks file.
5. Dalam File menu, klik Jimat.

Nota: Sekiranya editor teks menambah watak tambahan ke api_key.txt anda file (seperti Tanda Pesanan Byte), anda mungkin melihat ERROR_ACCESS_DENIED ketika anda cuba menyambung ke perkhidmatan kebenaran Login dengan Amazon. Sekiranya ini berlaku, cuba hapus ruang depan atau belakang, umpan baris, atau watak yang mencurigakan. (Untuk bekasample, editor yang menggunakan Byte Order Mark mungkin menambahkan 0xEF 0xBB 0xBF atau urutan heksadesimal lain pada permulaan api_key.txt anda file). Anda juga boleh mencuba mendapatkan kunci API baru.

Tangani Perubahan Konfigurasi untuk Aktiviti Anda

Sekiranya pengguna mengubah orientasi layar atau mengubah keadaan papan kekunci peranti semasa mereka log masuk, ia akan memulakan semula aktiviti semasa. Mulakan semula ini akan menutup skrin masuk tanpa diduga. Untuk mengelakkan ini, anda harus menetapkan aktiviti yang menggunakan kaedah mengotorisasi untuk menangani perubahan konfigurasi tersebut secara manual. Ini akan mengelakkan aktiviti dimulakan semula.

1. In Pakej Penjelajah, klik dua kali xml.
2. Dalam Permohonan bahagian, cari aktiviti yang akan menangani Login dengan Amazon (forexample, Aktiviti utama),
3. Tambahkan atribut berikut untuk aktiviti yang anda lakukan di Langkah 2:
   

   android: configChanges = "papan kekunci | papan kekunci Tersembunyi | orientasi"

   Atau untuk API 13 atau lebih tinggi:

   android: configChanges = "keyboard | keyboardHidden | orientation | screenSize"

4. daripada File menu, klik Jimat

Sekarang, apabila perubahan keyboard atau orientasi peranti berlaku, Android akan memanggil kaedah onConfigurationChanged untuk aktiviti anda. Anda tidak perlu melaksanakan fungsi ini kecuali ada aspek perubahan konfigurasi yang ingin anda kendalikan untuk aplikasi anda.

Tambahkan WorkflowActivity ke Projek anda

Apabila pengguna mengklik butang Login dengan Amazon, API akan melancarkan a web penyemak imbas untuk menyampaikan halaman masuk dan persetujuan kepada pengguna. Agar aktiviti penyemak imbas ini berfungsi, anda mesti menambahkan WorkflowActivity ke manifes anda.

Sekiranya anda sebelum ini telah bergabung dengan Login dengan Amazon SDK atau anda mempunyai com.amazon.identity.auth.device.authorization.AuthorizationActivity activity yang dinyatakan dalam AndroidManifest.xml anda, ia mesti dikeluarkan dan diganti dengan WorkflowActivity.

1. In Pakej Penjelajah, klik dua kali AndroidMailfest.xml ..
2. Dalam Permohonan bahagian, tambahkan kod berikut.
   

   <aktiviti 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: skema = "amzn" />

   Nota: Sekiranya anda tidak menggunakan sistem build Gradle, ganti $ {applicationId} dengan nama pakej anda untuk aplikasi ini.

Tambahkan Log Masuk dengan Butang Amazon ke Aplikasi Anda

Log masuk dengan Amazon menyediakan beberapa butang standard yang boleh anda gunakan untuk meminta pengguna log masuk dari aplikasi anda. Bahagian ini memberikan langkah-langkah untuk memuat turun Login rasmi dengan gambar Amazon dan memasangkannya dengan Android ImageButton.

1. Tambahkan ImageButton standard ke aplikasi anda.
   Untuk maklumat lebih lanjut mengenai butang Android dan kelas ImageButton, lihat Butang di developer.android.com.

2. Berikan butang anda dalam Deklarasi XML butang, tetapkan atribut android: id ke @ + id / login_with_amazon. Untuk bekasample:
   

   android: id = "@ + id / login_with_amazon"

3. Pilih gambar butang.
   Rujuk Log Masuk kami dengan Amazon Garis Panduan Gaya untuk senarai butang yang boleh anda gunakan dalam aplikasi anda.
   Muat turun salinan LWA_Android.zip file. Ekstrak salinan butang pilihan anda untuk setiap kepadatan skrin yang disokong oleh aplikasi anda (xxhdpi, xhdpi, hdpi, mdpi, atau tvdpi). Untuk maklumat lebih lanjut mengenai menyokong banyak kepadatan skrin di Android, lihat Susun atur Alternatif dalam topik "Menyokong Pelbagai Skrin" di ondeveloper.android.com.
4. Salin gambar butang yang sesuai files kepada projek anda.
   Untuk setiap kepadatan skrin yang anda sokong (xhdpi, hdpi, mdpi, atau ldpi), salin butang yang dimuat turun ke res / boleh dilukis direktori untuk ketumpatan skrin itu.
5. Menyatakan gambar butang.
   Dalam deklarasi XML butang, tetapkan android: src atribut kepada nama butang yang telah anda pilih. Untuk bekasample:

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

6.  Muatkan aplikasi anda, dan sahkan bahawa butang sekarang mempunyai Log masuk dengan gambar Amazon.
   Anda harus mengesahkan bahawa butang dipaparkan dengan betul untuk setiap kepadatan skrin yang anda sokong

Gunakan SDK untuk API Android

Di bahagian ini, anda akan menambahkan kod ke projek anda untuk log masuk pengguna dengan Log Masuk dengan Amazon.

Tangani Butang Masuk dan Beri Kuasa kepada Pengguna

Bahagian ini menerangkan cara memanggil API yang dibenarkan untuk log masuk pengguna. Ini termasuk mewujudkan onClick pendengar untuk butang Login anda dengan Amazon di onCreate kaedah aplikasi anda.

1. Tambahkan Log Masuk dengan Amazon ke Android See anda Pasang Log Masuk dengan Perpustakaan Amazon.
2. Mulakan PermintaanKonteks.
   Anda perlu menyatakan a PermintaanKonteks ubah dan buat contoh baru kelas. Tempat terbaik untuk memulakan PermintaanKonteks berada dalam onCreate kaedah aktiviti atau pecahan Android anda. Untuk bekasample:

   Request peribadiContext requestContext; @Selamat dilindungi void onCreate (Bundle saveInstanceState) {super.onCreate (saveInstanceState); requestContext = RequestContext.create (ini); }

3. Buat satu AuthorizeListener.
   AuthorizeListener akan memproses hasil dari pengarang sah. Ia mengandungi tiga kaedah: onSuccess, onError, dan diBatal. Cipta AuthorizeListener antara muka selaras dengan a daftarPendaftar panggil di onCreate kaedah aktiviti atau pecahan Android anda.

   @Selamat dilindungi void onCreate (Bundle saveInstanceState) {super.onCreate (saveInstanceState); requestContext = RequestContext.create (ini);requestContext.registerListener (AuthorizeListener baru () { / * Kebenaran berjaya diselesaikan. * / @Selamat kekosongan awam onSuccess (hasil AuthorizeResult) { / * Aplikasi anda sekarang diizinkan untuk ruang lingkup yang diminta * / } / * Terdapat kesalahan semasa percubaan untuk mengizinkan aplikasi. * / @Selamat kekosongan awam onError (AuthError ae) { / * Maklumkan kesalahan pengguna kepada pengguna * / } / * Kebenaran dibatalkan sebelum dapat diselesaikan. * / @ Override pembatalan awam onCancel (Pembatalan Pembatalan Pengesahan) { / * Tetapkan semula UI ke keadaan siap masuk * / } }); }

   Nota: Sekiranya anda menggunakan serpihan dan menangkap rujukan ke View objek di anda AuthorizeListener pelaksanaan, membuat AuthorizeListener dalam onCreateView kaedah dan bukannya onCipta. Ini memastikan View rujukan objek ditetapkan semasa panggilan ke mengesahkanfinishes.

4. Laksanakan onSuccess, onError, dan diBatal untuk anda AuthorizeListener.
   Kerana proses pengesahan menyajikan skrin masuk (dan mungkin skrin persetujuan) kepada pengguna di a web penyemak imbas (atau a WebView), pengguna akan berpeluang untuk membatalkan log masuk atau pergi jauh. Sekiranya mereka secara jelas membatalkan proses log masuk, diBatal dipanggil, dan anda mahu menetapkan semula antara muka pengguna anda.
   Sekiranya pengguna menjauh dari skrin log masuk di penyemak imbas atau WebView, kemudian beralih kembali ke aplikasi anda, SDK tidak akan mengesan bahawa log masuk tidak selesai. Sekiranya anda mengesan aktiviti pengguna di aplikasi anda sebelum log masuk selesai, anda boleh menganggap mereka telah menjauh dari penyemak imbas dan bertindak balas dengan sewajarnya.
5. Panggil RequestContext.onResume.
   Untuk mengakomodasi siklus hidup aplikasi Android, laksanakan onResume kaedah dalam aktiviti atau pecahan anda. Ini akan mencetuskan semua pendengar yang mendaftar daftarPendaftar sekiranya aplikasi anda ditutup oleh sistem operasi sebelum pengguna menyelesaikan aliran kebenaran.

   @Selamat kekosongan dilindungi onResume () { super.onResume (); requestContext.onResume (); }

6. Panggil AuthorizationManager.membenarkan.
   Dalam onClick pengendali untuk butang Login dengan Amazon anda, panggil otorisasi untuk meminta pengguna untuk log masuk dan membenarkan aplikasi anda.
   Kaedah ini akan membolehkan pengguna untuk masuk dan memberikan persetujuan terhadap maklumat yang diminta dengan salah satu cara berikut:
   1. Beralih ke penyemak imbas sistem
   2. Beralih kepada WebView dalam konteks selamat (jika aplikasi Amazon Shopping dipasang ke peranti)
   Konteks selamat untuk pilihan kedua tersedia apabila aplikasi Amazon Shopping dipasang pada peranti. Peranti buatan Amazon yang menjalankan Fire OS (untuk bekasample Kindle Fire, Fire Phone, dan Fire TV) selalu menggunakan pilihan ini walaupun tidak ada aplikasi Amazon Shopping pada peranti. Oleh kerana itu, jika pengguna sudah masuk ke aplikasi Amazon Shopping, API ini akan melangkau halaman masuk, yang menuju ke Log Masuk Tunggal pengalaman untuk pengguna. Lihat Pengalaman Pelanggan di pelanggan-pengalaman-android aplikasi untuk mengetahui lebih lanjut. Apabila aplikasi anda disahkan, aplikasi tersebut akan dibenarkan untuk satu atau lebih kumpulan data yang dikenali sebagai skop. Skop merangkumi data pengguna yang anda minta dari Login dengan Amazon. Kali pertama pengguna log masuk ke aplikasi anda, mereka akan diberikan senarai data yang anda minta dan minta persetujuan. Log masuk dengan Amazon kini menyokong skop berikut:

   Nama skop	Penerangan
   profile	Memberi akses ke nama pengguna, alamat e-mel, dan ID akaun Amazon.
   profile:ID Pengguna	Memberi akses ke ID akaun Amazon pengguna sahaja.
   pos_kod	Memberi akses ke pos / pos kod pengguna pada file untuk akaun Amazon mereka.

   AuthorizationManager.membenarkan adalah panggilan tidak segerak, jadi anda tidak perlu menyekat utas UI atau membuat utas pekerja anda sendiri. Untuk memanggil membenarkan, lulus Permintaan Kebenaran objek yang boleh dibina dengan menggunakan AuthorizeRequest.Builder:
   

   @Selamat dilindungi void onCreate (Bundle saveInstanceState) {super.onCreate (saveInstanceState); / * Pengisytiharan onCreate sebelumnya dihilangkan * /// Cari butang dengan login_with_amazon ID // dan sediakan pengendali klik View loginButton = cariViewOlehId (R.id.login_with_amazon); loginButton.setOnClickListener (baru View.OnClickListener () { @Selamat kekosongan awam onClick (View v) {AuthorizationManager.authorize (baru AuthorizeRequest Pembina (requestContext) .addScopes (ProfileSkop.profile(), ProfileSkop.postalCode ()) .bangun ()); }); }

Ambil Pro Penggunafile Data

Bahagian ini menerangkan cara menggunakan API Pengguna untuk mendapatkan semula pro penggunafile data setelah mereka diberi kebenaran. Yang profile data yang dapat anda peroleh berdasarkan skop yang ditunjukkan dalam membenarkan: denganHandler: panggilan.

1. Panggil Pengguna.fetch.
   Pengguna.pengambilan mengembalikan pro penggunafile data kepada anda melalui Pendengar Ralat Auth> panggilan balik. Pendengar Ralat Auth> mengandungi dua kaedah: onSukses dan onError (ia tidak menyokong diBatal kerana tidak ada cara untuk membatalkan a Pengguna.pengambilan panggilan). onSukses menerima objek Pengguna dengan profile data, sementara onError menerima Ralat Auth objek dengan maklumat mengenai kesalahan. kemas kiniProfileData adalah bekasampfungsi yang dapat dilaksanakan oleh aplikasi anda untuk menampilkan profile data di antara muka pengguna
   Nota: User.getUserPostalCode hanya dikembalikan jika anda meminta ProfileSkop Skop.postalCode ().

Periksa Login Pengguna pada Permulaan

Sekiranya pengguna log masuk ke aplikasi anda, menutup aplikasi, dan menghidupkan semula aplikasinya kemudian, aplikasi masih diberi kuasa untuk mengambil data. Pengguna tidak log keluar secara automatik. Semasa memulakan, anda dapat menunjukkan kepada pengguna sebagai log masuk jika aplikasi anda masih dibenarkan. Bahagian ini menerangkan cara penggunaan getToken untuk mengetahui sama ada aplikasi itu masih dibenarkan.

1. Panggil getToken.
   Dalam Bermula kaedah aktiviti atau pecahan anda, hubungi getToken untuk mengetahui sama ada permohonan itu masih dibenarkan. getToken mengambil token capaian mentah bahawa Pengurus Kebenaran menggunakan untuk mengakses pro penggunafile. Sekiranya nilai token tidak kosong, maka aplikasinya masih dibenarkan dan anda boleh terus mengambil pro penggunafile data. getTokenrequires ruang lingkup yang sama yang anda minta dalam panggilan anda untuk memberi kebenaran.
   dapatkanTokensupport panggilan tak segerak dengan cara yang sama seperti Pengguna. Ambil, jadi anda tidak perlu menyekat utas UI atau membuat utas pekerja anda sendiri. Untuk memanggil getToken secara tidak segerak, lulus objek yang menyokong Pendengar antara muka sebagai parameter terakhir.
2. Menyatakan a Pendengar Ralat Auth>. Pelaksanaan anda terhadap Pendengar AuthError> antara muka memproses hasil dari getToken panggil. Pendengar mengandungi dua kaedah: onSukses dan onError (ia tidak menyokong diBatal kerana tidak ada cara untuk membatalkan a getToken panggilan).
3. Laksanakan onSukses dan onError untuk anda Pendengar . onSukses menerima Hasil Kuasa objek dengan token akses, sementara onError menerima Ralat Auth objek dengan maklumat mengenai kesalahan.
   

   @Selamat kekosongan dilindungi diStart () {super.onStart (); Skop [] skop = {ProfileSkop.profile(), ProfileSkop.postalCode ()}; AuthorizationManager.getToken (ini, ruang lingkup, baru Pendengar () {@Selamat kekosongan awam onSuccess (hasil AuthorizeResult) {if (result.getAccessToken ()! = null) { / * Pengguna dilog masuk * / } lain { / * Pengguna tidak dilog masuk * / } } @Selamat kekosongan awam onError (AuthError ae) { / * Pengguna tidak dilog masuk * / } }); }

Kosongkan Data Kebenaran dan Keluar Pengguna

Bahagian ini menerangkan cara menggunakan kaedah Log Keluar untuk mengeluarkan pengguna dari aplikasi anda. Pengguna perlu log masuk semula agar aplikasi mendapatkan profile data. Gunakan kaedah ini untuk log keluar pengguna, atau untuk menyelesaikan masalah masuk dalam aplikasi.

1. Laksanakan mekanisme log keluar.
   Apabila pengguna berjaya log masuk, anda harus menyediakan mekanisme logout supaya mereka dapat membersihkan pro merekafile data dan skop yang dibenarkan sebelum ini. Mekanisme anda mungkin adalah pautan, butang, atau item menu. Untuk bekas iniample, kita akan membuat kaedahClick untuk butang.
2. Panggil tanda keluar
   Panggil tanda keluar dalam pengendali logout anda untuk membuang data kebenaran pengguna (token akses, profile) dari kedai tempatan. tanda keluar mengambil konteks Android dan Pendengar Kesalahan Auth> hingga menangani kejayaan atau kegagalan.
3. Menyatakan Pendengar tanpa nama Ralat Auth>.
   Pelaksanaan Pendengar anda Ralat Auth> memproses hasil daripada tanda keluar panggil. Kelas tanpa nama berguna untuk menangkap pemboleh ubah dari ruang lingkup.
   Lihat Tangani Butang Masuk dan Beri Kuasa kepada Pengguna untuk sebuah examplesu menyatakan kelas pendengar.
4. Laksanakan onSukses dan onError untuk Pendengar anda Ralat Auth>.
   bila capaian Hasil anda harus mengemas kini UI anda untuk membuang rujukan kepada pengguna, dan menyediakan mekanisme log masuk yang pengguna boleh log masuk semula. Sekiranya tandaOutreturns ralat, anda boleh membiarkan pengguna mencuba log keluar lagi.

   @Selamat dilindungi void onCreate (Bundle saveInstanceState) {super.onCreate (saveInstanceState); / * Pengisytiharan onCreate sebelumnya dihilangkan * /// Cari butang dengan log keluar ID dan sediakan pengendali klik View logoutButton = cariViewOlehId (R.id.logout); logoutButton.setOnClickListener (baru View.OnClickListener () {@Selamat kekosongan awam onClick (View v) {AuthorizationManager.signOut (getApplicationContext (), baru Pendengar () {@ Override void onSuccess (Balasan tidak sah) { // Tetapkan keadaan log keluar di UI } @Selamat kekosongan awam onError (AuthError authError) { // Log kesilapan } }); } }); }

Log masuk dengan Panduan Bermula Amazon untuk aplikasi Android - Muat turun [dioptimumkan]
Log masuk dengan Panduan Bermula Amazon untuk aplikasi Android - Muat turun

Rujukan

• Manual Pengguna