Android uygulamaları için Amazon Başlangıç Kılavuzu ile oturum açın
Amazon ile Giriş: Android için Başlangıç Kılavuzu
Telif hakkı © 2017 Amazon.com, Inc. veya iştirakleri. Tüm hakları Saklıdır.
Amazon ve Amazon logosu, Amazon.com, Inc. veya iştiraklerinin ticari markalarıdır. Amazon'a ait olmayan diğer tüm ticari markalar, ilgili sahiplerinin mülkiyetindedir.
Android Geliştirici Araçlarını yükleyin
Android için Amazon SDK ile Oturum Açma, Android, Fire TV ve Fire Tablet uygulamalarınıza Amazon ile Oturum Açma eklemenize yardımcı olur. Android için Amazon SDK ile Giriş özelliğini Android Studio ile kullanmanızı öneririz. Android Studio'nun nasıl yükleneceği ve Android SDK kurulumunun nasıl yapılacağıyla ilgili adımlar için bkz. Android SDK'yı edinin developer.android.com adresinde.
Android için Amazon SDK ile Oturum Açma özelliğini kullanmak için Android uygulamanızın aşağıdaki minimum gereksinimlerden birini karşılaması gerekir:
- Android 0 (API Seviye 11) veya üzeri minimum SDK Sürümü (minSdkVersion).
- Android 2.2'nin (API Seviyesi 8) veya v4 ile daha yüksek minimum SDK Sürümü (minSdkVersion) Android Desteği Kütüphane.
Android SDK yüklendiğinde, SDK Yöneticisi Android kurulumunuzdaki uygulama. Amazon ile Oturum Açma için geliştirme yapmak üzere, yukarıdaki minimum SDK gereksinimlerini yüklemek üzere SDK Yöneticisini kullanmanız gerekir. Görmek SDK Paketleri Ekleme SDK Manager'ı kullanma hakkında daha fazla bilgi için developer.android.com adresinde.
SDK'yı kurduktan sonra, uygulamalarınızı çalıştırmak için bir Android Sanal Cihazı (AVD) kurun. Görmek Yönetmek Sanal Aygıtlar Bir sanal cihazı kurmaya ilişkin talimatlar için developer.android.com adresine bakın.
Geliştirme ortamınız kurulduğunda şunları yapabilirsiniz: Android için Amazon SDK ile Giriş Yapın or S'yi çalıştırınampuygulama, aşağıda açıklandığı gibi
Android için Amazon SDK ile Giriş Yapın
Android için Amazon SDK ile Oturum Açma, iki paket halinde gelir. İlki, Android kitaplığını ve destekleyici belgeleri içerir. İkinci olarak içerirampBir kullanıcının oturum açmasına ve profesyonellerini görüntülemesine izin veren le uygulamasıfile veri.
Android SDK veya Android Geliştirme Araçlarını henüz yüklemediyseniz, bkz. Kurulum Android Geliştirici Araçları Yukarıdaki bölüm.
- İndirmek fermuar ve çıkarın files sabit sürücünüzdeki bir dizine. bir görmelisin belgeler ve bir lib alt dizin.
- Açık docs / index.html ile view Amazon Android API Referansı ile Oturum Açın.
- Görmek Girişi Amazon Kitaplığı ile Kurun Kitaplığın ve belgelerin bir Android'e nasıl ekleneceğine ilişkin talimatlar için
Android için Amazon SDK ile Oturum Açma yüklendiğinde şunları yapabilirsiniz: Amazon ile Yeni Bir Giriş Oluşturun Proje Önden buyurun Amazon ile Giriş Yapın.
S'yi çalıştırınampuygulama
s çalıştırmak içinample uygulaması, s'yi içe aktarınampbir AndroidStudio çalışma alanına girin.
- İndirmek SampleLoginWithAmazonAppForAndroid-src.zip ve çıkarın files sabit diskinizdeki bir dizine
- Android Studio'yu başlatın ve seçin Mevcut bir Android Studioproject'i açın.
- Şuraya göz atın: SampleAmazonApp ile Giriş Yapın indirilen zip çıkarıldıktan sonra elde edilen dizin file 1. Adımda.
- Şuradan: İnşa etmek Menü, tıklayın Proje Yapve projenin aktarımı bitirmesini bekleyin.
- Şuradan: Koşmak Menü, tıklayın Koşmak ve ardından tıklayın SampleAmazonApp ile Giriş Yapın.
- Emülatörü veya bağlı Android cihazını seçin ve tıklayın Koşmak.
Amazon ile Giriş Yapın
Amazon ile Giriş Yap özelliğini kullanmadan önce websitede veya mobil uygulamada, Amazon ile Giriş Yap uygulamasına kaydolmanız gerekir. Amazon ile Giriş Yap uygulamanız, işletmeniz hakkında temel bilgileri ve her bir uygulama hakkında bilgi içeren kayıttır. webAmazon ile Giriş'i destekleyen oluşturduğunuz site veya mobil uygulama. Bu işletme bilgileri, kullanıcılar Amazon ile Giriş'i her kullandıklarında onlara gösterilir. website veya mobil uygulama. Kullanıcılar uygulamanızın adını, logonuzu ve gizlilik politikanızın bağlantısını göreceklerdir. Bu adımlar, Android uygulamanızı Login with Amazon ile kullanmak üzere nasıl kaydedeceğinizi gösterir.
Girişinizi Amazon Uygulaması ile Kaydedin
- Git https://login.amazon.com.
- Daha önce Amazon ile Oturum Açmak için kaydolduysanız, tıklayın Uygulama KonsoluAksi takdirde tıklayın Üye olmak. Eğer Seller Central'ı ilk kez kullanıyorsanız, sizden bir Seller Central hesabı oluşturmanız istenecek ve Oturum Açma için uygulama kaydını yöneten Seller Central'a yönlendirileceksiniz.
- Tıklamak Yeni Başvuru Kaydet. Başvurunuzu Kaydedin form görünecek:
a. İçinde Başvurunuzu Kaydedin form, bir girin İsim ve bir Tanım Başvurunuz için.
The İsim kullanıcılar uygulamanızla bilgi paylaşmayı kabul ettiğinde onay ekranında görüntülenen addır. Bu ad Android, iOS ve webuygulamanızın site sürümleri. NS Tanım Amazon uygulamaları ile her bir Oturum Açma işleminizi farklılaştırmanıza yardımcı olur ve kullanıcılara gösterilmez.
b. Bir girin Gizlilik Bildirimi URL Başvurunuz için.
The Gizlilik Bildirimi URL şirketinizin veya uygulamanızın gizlilik politikasının yeridir (örn.ampley, http://www.example.com/privacy.html). Bu bağlantı, kullanıcılara izin ekranında görüntülenir.
c. Eğer bir tane eklemek istiyorsanız Logo Görseli Başvurunuz için tıklayın Gözat ve uygulanabilir görseli bulun. - Tıklamak Kaydetmek. Senin s'inampKayıt buna benzer görünmelidir:
Temel uygulama ayarlarınız kaydedildikten sonra, belirli uygulamalar için ayarlar ekleyebilirsiniz. webAmazon hesabıyla bu Giriş'i kullanacak siteler ve mobil uygulamalar.
Uygulamanıza Android Ayarlarını Ekleyin
Bir Android Uygulamasına kaydolmak için, Amazon Uygulama Mağazası aracılığıyla bir uygulamayı kaydettirme seçeneğiniz vardır (Amazon Appstore için bir Android Uygulaması ekleyin) veya doğrudan Amazon ile Giriş ile (Android ekle Uygulama Appstore olmadan). Uygulamanız kaydedildiğinde, uygulamanıza Amazon ile Oturum Aç yetkilendirme hizmetine erişim izni verecek bir API anahtarına erişiminiz olacaktır.
Not: Android uygulamanızda Amazon Device Messaging'i kullanmayı planlıyorsanız, lütfen iletişime geçin Iwa-destek@amazon.com ile:
- Giriş yapmak için kullandığınız Amazon hesabının e-posta adresi
- Amazon Appstore'a kaydolmak için kullandığınız Amazon hesabının e-posta adresi (farklıysa).
- Seller Central hesabınızdaki ad (Seller Central'da, Ayarlar> Hesap Bilgileri> Satıcı Bilgilerive şunu kullanın Ekran adı).
- Amazon Appstore geliştirici hesabınızdaki ad (Mobil Uygulama Dağıtımı sitesinde, Ayarlar > Şirket Uzmanıfile ve kullan Geliştirici Adı veya Şirket Adı).
Amazon Appstore için bir Android uygulaması ekleyin
Aşağıdaki adımlar, Amazon ile Oturum Açma hesabınıza bir Amazon Appstore uygulaması ekleyecektir:
- Uygulama ekranından tıklayın Android Ayarları. Zaten kayıtlı bir Android uygulamanız varsa, şunu arayın: API Anahtarı Ekleyin düğmede Android Ayarları seçim
The Android Uygulama Ayrıntıları form görünecek: - Seçme Evet "Bu uygulama Amazon Appstore üzerinden mi dağıtılıyor?" sorusuna yanıt olarak
- Girin Etiket Android Uygulamanızın. Bu, uygulamanızın resmi adı olmak zorunda değildir. Bu belirli Android uygulamasını uygulamalar arasında tanımlar ve webAmazon ile Girişinize kayıtlı siteler
- Ekle Amazon Appstore Kimliği.
- Uygulamanızı kendi kendine imzaladıysanız, kendi kendine imzalama bilgilerini ekleyin. Bu, doğrudan Appstore'u kullanmadan geliştirme sırasında bir API anahtarı almanıza olanak tanır.
a. Uygulamanız Amazon Uygulama Mağazası üzerinden imzalanmıyorsa, şunu seçin: Evet "Bu uygulama kendinden imzalı mı?" sorusuna yanıt olarak
The Android Uygulama Ayrıntıları form genişleyecek
b. Girin Paket ismi.
Bu, Android projenizin paket adıyla eşleşmelidir. Android Projenizin paket adını belirlemek için, seçtiğiniz Android geliştirici aracında projeyi açın. Açık
AndroidManifest.XML Paket Gezgini'nde ve Tezahür etmek sekmesi. İlk giriş, Paket isim.
c. Uygulamayı girin İmza.
Bu, uygulamanızı doğrulamak için kullanılan bir SHA-256 karma değeridir. İmza, iki nokta üst üste ile ayrılmış 32 onaltılık çift biçiminde olmalıdır (örn.amptarih: 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). Görmek Android Uygulama İmzaları ve API Anahtarları Projenizden imzayı çıkarmak için kullanabileceğiniz adımlar için.
6. Tıklayın Kaydetmek.
Appstore olmadan bir Android Uygulaması ekleyin
Android uygulamanızı Amazon Appstore'u kullanmadan kaydettirmek isterseniz, Paket Adınızı ve İmzanızı Amazon ile Oturum Açarak kaydetmek için aşağıdaki adımları kullanabilirsiniz:
- Uygulama ekranından tıklayın Android Ayarları. Zaten kayıtlı bir Android uygulamanız varsa, şunu arayın: API Anahtarı Ekleyin düğmede Android Ayarları The Android Uygulama Ayrıntıları form görünecek:
- Seçme HAYIR "Bu uygulama Amazon Appstore üzerinden mi dağıtılıyor?" sorusuna yanıt olarak
- Girin Etiket Androidinizin
Bu, uygulamanızın resmi adı olmak zorunda değildir. Uygulamalar arasında bu belirli Android uygulamasını tanımlar ve webKayıt olduğunuz siteler. - Girin Paket Adı. Bu, Android projenizin paket adıyla eşleşmelidir.
Android Projenizin paket adını belirlemek için, seçtiğiniz Android geliştirici aracında projeyi açın. Açık AndroidManifest.XML Paket Gezgini'nde ve Tezahür etmek sekmesi. İlk giriş, Paket isim. - Uygulamayı girin İmza.
Bu, uygulamanızı doğrulamak için kullanılan bir SHA-256 karma değeridir. İmza, iki nokta üst üste ile ayrılmış 32 onaltılık çift biçiminde olmalıdır (örn.amptarih: 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). Bakın Android Uygulama İmzaları ve API Anahtarları Projenizden imzayı çıkarmak için kullanabileceğiniz adımlar için aşağıdaki bölüm. - Tıklamak Kaydetmek.
Uygulamanızın farklı sürümleri, bir veya daha fazla test sürümü ve bir üretim sürümü gibi farklı imzalara veya paket adlarına sahipse, her sürümün kendi API Anahtarı olması gerekir. İtibaren Android Ayarları uygulamanızın API Anahtarı Ekleyin uygulamanız için ek anahtarlar oluşturmak için düğme (her sürüm için bir tane).
Android Uygulama İmzaları ve API Anahtarları
Uygulama imzası, oluşturulduğunda her Android uygulamasına uygulanan bir SHA-256 hash değeridir. Amazon, API Anahtarınızı oluşturmak için uygulama imzasını kullanır. API Anahtarı, Amazon hizmetlerinin uygulamanızı tanımasını sağlar. Uygulamanızı imzalamak için Amazon Appstore'u kullanırsanız, API anahtarı otomatik olarak sağlanır. Amazon Appstore'u kullanmıyorsanız, API anahtarınızı manuel olarak yönetmeniz gerekecektir.
Uygulama imzaları bir anahtar deposunda saklanır. Genel olarak, Android uygulamaları için bir hata ayıklama anahtar deposu ve bir yayın anahtar deposu vardır. Android Studio'da hata ayıklama anahtar deposunun konumunu bulmak için İnşa etmek menü, seç Düzenlemek Yapı Türleri, sonra şuraya git İmzalama sekmesi ve hata ayıklama anahtar deposunu bulun. Mağaza File alan.
İmzalı bir APK oluşturmak için Android uygulamanızı dışa aktardığınızda normalde bir sürüm anahtar deposu oluşturulur. file. Dışa aktarma işlemi boyunca, yeni bir sürüm anahtar deposu oluşturuyorsanız, konumunu seçeceksiniz. Varsayılan olarak, varsayılan hata ayıklama KeyStore'unuzla aynı konuma yerleştirilecektir.
Geliştirme sırasında hata ayıklama imzasını kullanarak uygulamanızı kaydettirdiyseniz, uygulamayı yayınlamaya hazır olduğunuzda uygulamanıza yeni bir Android ayarı eklemeniz gerekecektir. Yeni uygulama ayarı, sürüm anahtar deposundaki imzayı kullanmalıdır.
Görmek Uygulamalarınızı İmzalama daha fazla bilgi için developer.android.com adresinde.
Android Uygulama İmzasını Belirleyin
- İmzalı bir APK'nız varsa file:
a. APK'nın sıkıştırmasını açın file ve CERT.RSA'yı çıkarın. (Gerekirse APK uzantısını ZIP olarak yeniden adlandırabilirsiniz).
b. Komut satırından şunu çalıştırın:tuş takımı -printcert -file SERT.RSA Anahtar araçlar içinde yer alan çöp kutusu Java kurulumunuzun dizini.
- Bir anahtar deponuz varsa file:
a. Komut satırından şunu çalıştırın:keytool -list -v -alias -anahtar deposufileisim> Anahtar aleti içinde yer almaktadır çöp kutusu Java kurulumunuzun dizini. Diğer ad, uygulamayı imzalamak için kullanılan anahtarın adıdır.
b. Anahtarın şifresini girin ve tuşuna basın. Girmek. - Altında Sertifika Parmak İzleri, kopyala SHA256 değer.
Android API Anahtarını alın
Bir Android ayarı kaydettiğinizde ve bir uygulama imzası sağladığınızda, Amazon ile Oturum Açma uygulamanızın kayıt sayfasından API anahtarını alabilirsiniz. Bu API anahtarını bir file Android projenizde. Bunu yapana kadar, uygulama Amazon ile Oturum Açma yetkilendirme hizmetiyle iletişim kurma yetkisine sahip olmayacaktır.
- Git https://login.amazon.com.
- Tıklamak Uygulama Konsolu.
- İçinde Uygulamalar soldaki kutunuzu seçin
- Android uygulamanızı şurada bulun: Android Ayarları bölümü (Henüz bir Android uygulaması kaydettirmediyseniz, bkz. Amazon Appstore için bir Android Uygulaması ekleyin).
- Tıklamak API Anahtar Değeri Oluşturun. Bir açılır pencere API'nizi görüntüleyecektir Anahtarı kopyalamak için, Tümünü Seç anahtarın tamamını seçmek için.
Not: API Anahtar Değeri, kısmen üretildiği zamana dayanır. Bu nedenle, oluşturduğunuz sonraki API Anahtar Değerleri orijinalinden farklı olabilir. Bu API Anahtar Değerlerinden herhangi birini uygulamanızda kullanabilirsiniz, çünkü hepsi geçerli. - Görmek API Anahtarınızı Projenize Ekleyin API anahtarını Android cihazınıza eklemeye ilişkin talimatlar için
Amazon Projesi ile Oturum Açın
Bu bölümde, Amazon ile Oturum Açma için yeni bir Android projesi oluşturmayı, projeyi yapılandırmayı ve Amazon ile Oturum Aç ile bir kullanıcıyla oturum açmak için projeye kod eklemeyi öğreneceksiniz. Android Studio için adımları açıklayacağız, ancak seçtiğiniz herhangi bir IDE veya Android geliştirme aracına benzer adımlar uygulayabilirsiniz.
Bu kılavuz, aşağıdakilerin anlaşılmasını gerektirir Aktiviteler - Android uygulama geliştirmenin temel bir kavramı. Hakkında daha fazla öğren Aktiviteler Ve Etkinlik Parçaları developer.android.com adresinde.
Amazon Project ile Yeni Bir Oturum Açın
Login with Amazon'u kullanmak için henüz bir uygulama projeniz yoksa, bir tane oluşturmak için aşağıdaki talimatları izleyin. Mevcut bir uygulamanız varsa, atlayın Girişi Amazon Kitaplığı ile Kurun.
- Öğle yemeği Android
- Şuradan: File menü, seç Yeni Ve Proje.
- Bir girin Uygulama Adı Ve Firma Adı senin için
- Girin Başvuru Ve Firma Adı Amazon ile Oturum Aç'a uygulamanızı kaydettirdiğinizde seçtiğiniz paket adına karşılık gelir.
Henüz uygulamanızı kaydetmediyseniz, bir Paket Adı ve ardından içindeki talimatları izleyin. Amazon ile Giriş Yaparak Kayıt Olma projenizi oluşturduktan sonra bölümü. Uygulamanızın paket adı kayıtlı paket adıyla eşleşmiyorsa, Amazon ile Oturum Açma çağrılarınız başarılı olmayacaktır. - Birini seçin Minimum Gerekli SDK API 11: Android 3.0 (Honeycomb) veya üstü ve tıklayın Sonraki. Alternatif olarak bir Minimum Gerekli SDK API 8: Android 2.2 (Froyo) veya v4 kullanırken Android Destek Kitaplığı.
- Oluşturmak istediğiniz aktivite türünü seçin ve tıklayın Sonraki.
- İlgili ayrıntıları doldurun ve tıklayın Sona ermek.
Artık çalışma alanınızda Amazon ile Oturum Aç'ı çağırmak için kullanabileceğiniz yeni bir projeniz olacak.
Girişi Amazon Kitaplığı ile Kurun
Android için Amazon SDK ile Oturum Açma'yı henüz indirmediyseniz, bkz. Girişi ile yükleyin Android için Amazon SDK.
- Kullanımı file bilgisayarınızdaki sistemi bulun amazon-sdk.jar ile giriş file Android için Amazon SDK ile Giriş içinde. Panoya kopyalayın.
- Projeniz Android Studio'da açıkken, Proje View.
- Projeniz / uygulamanız için ana dizine sağ tıklayın. Proje View ve seç Yapıştır.
- Sağ tıklama amazon-sdk.jar ile giriş içinde Proje View ve seç Kitaplık Olarak Ekle.
Uygulamanız için Ağ İzinlerini Ayarlayın
Uygulamanızın Amazon ile Oturum Açma özelliğini kullanabilmesi için İnternet'e ve ağ durumu bilgilerine erişmesi gerekir. Henüz yapmadıysa, uygulamanız Android bildiriminizde bu izinleri vermelidir.
- Şuradan: Proje View, açmak için xml'ye çift tıklayın.
- Aşağıda görüntülenen kod satırlarını kopyalayın ve bunları xml file, uygulama bloğunun dışında:
Examptarih:
API Anahtarınızı Projenize Ekleyin
Android uygulamanızı Amazon ile Oturum Açma ile kaydettirdiğinizde, size bir API anahtarı atanır. Bu, Amazon Yetkilendirme Yöneticisinin uygulamanızı Amazon ile Oturum Açma yetkilendirme hizmetine tanıtmak için kullanacağı bir tanımlayıcıdır. Uygulamanızı imzalamak için Amazon Appstore'u kullanıyorsanız, Appstore API anahtarını otomatik olarak sağlayacaktır. Amazon Appstore'u kullanmıyorsanız Amazon Authorization Manager bu değeri çalışma zamanında şuradan yükler: api_anahtarı.txt file içinde varlıklar dizin.
- Henüz API Anahtarınıza sahip değilseniz, içindeki talimatları izleyin. Android API Anahtarını alın.
- Şuradan: Proje View Android Studio'da, varlıklar klasörünü sağ tıklayın ve ardından Yeni ve seç File. Varlıklar klasörünüz yoksa, projeniz için ana dizini sağ tıklayın ve ardından Yeni, Dosya, Varlıklar Klasörü.
- Adını koy file api_anahtarı.txt.
- Artık bir metin için bir düzenleyici pencereniz olmalıdır. file adlandırılmış txt. API anahtarınızı metne ekleyin file.
- İçinde File Menü, tıklayın Kaydetmek.
Not: Bir metin düzenleyici, api_key.txt dosyanıza fazladan karakterler eklerse file (Bayt Sırası İşareti gibi), Amazon ile Oturum Açma yetkilendirme hizmetine bağlanmaya çalıştığınızda ERROR_ACCESS_DENIED mesajını görebilirsiniz. Böyle bir durumda, baştaki veya sondaki boşlukları, satır beslemelerini veya şüpheli karakterleri kaldırmayı deneyin. (Örneğinample, Bayt Sırası İşareti kullanan bir düzenleyici, api_key.txt dosyanızın başına 0xEF 0xBB 0xBF veya başka onaltılık diziler ekleyebilir file). Ayrıca yeni bir API anahtarı almayı da deneyebilirsiniz.
Etkinliğiniz için Yapılandırma Değişikliklerini Yönetin
Bir kullanıcı oturum açarken ekran yönünü değiştirirse veya aygıtın klavye durumunu değiştirirse, mevcut etkinliğin yeniden başlatılmasını isteyecektir. Bu yeniden başlatma, giriş ekranını beklenmedik şekilde kapatacaktır. Bunu önlemek için, bu yapılandırma değişikliklerini manuel olarak işlemek için yetkilendirme yöntemini kullanan etkinliği ayarlamalısınız. Bu, aktivitenin yeniden başlatılmasını önleyecektir.
- In Paket Kaşif, çift tıklayın xml.
- İçinde Başvuru bölümünde, Amazon ile Oturum Açma işlemini gerçekleştirecek etkinliği bulun (forexampley, Ana aktivite),
- 2. Adımda bulduğunuz aktiviteye aşağıdaki özelliği ekleyin:
android: configChanges = ”klavye | keyboardHidden | yön” Veya API 13 veya üstü için:
android: configChanges = ”keyboard | keyboardHidden | orientation | screenSize” - Şuradan: File Menü, tıklayın Kaydetmek
Şimdi, bir klavye veya cihaz yönü değişikliği gerçekleştiğinde, Android, etkinliğiniz için onConfigurationChanged yöntemini çağıracaktır. Uygulamanız için işlemek istediğiniz bu yapılandırma değişikliklerinin bir yönü olmadığı sürece bu işlevi uygulamanıza gerek yoktur.
Projenize bir WorkflowActivity ekleyin
Kullanıcı Amazon ile Giriş Yap düğmesini tıkladığında, API bir web kullanıcıya bir oturum açma ve izin sayfası sunmak için tarayıcı. Bu tarayıcı etkinliğinin çalışması için WorkflowActivity'yi bildiriminize eklemeniz gerekir.
Daha önce Amazon SDK ile Oturum Açma ile entegre ettiyseniz veya AndroidManifest.xml dosyanızda bildirilen com.amazon.identity.auth.device.authorization.AuthorizationActivity etkinliğiniz varsa, kaldırılmalı ve WorkflowActivity ile değiştirilmelidir.
- In Paket Kaşif, çift tıklayın AndroidMailfest.xml ..
- İçinde Başvuru bölümüne aşağıdaki kodu ekleyin.
<activity 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” />
<veri
android: host = ”$ {applicationId}” android: şema = ”amzn” />
Not: Gradle derleme sistemini kullanmıyorsanız, $ {applicationId} yerine bu uygulama için paket adınızı yazın.
Amazon ile Oturum Açma, kullanıcılardan uygulamanızdan oturum açmalarını istemek için kullanabileceğiniz birkaç standart düğme sağlar. Bu bölüm, resmi bir Amazon ile Oturum Açma görüntüsünü indirmek ve bunu bir Android ImageButton ile eşleştirmek için adımlar sunar.
- Uygulamanıza standart bir ImageButton ekleyin.
Android düğmeleri ve ImageButton sınıfı hakkında daha fazla bilgi için bkz. Düğmeler developer.android.com adresinde.
- Düğmenize bir a verin Düğme XML bildiriminde, android:id niteliğini @+id/login_with_amazon olarak ayarlayın. eski içinamptarih:
android: id = ”@ + id / login_with_amazon” - Bir düğme resmi seçin.
Amazon ile Oturum Açmamıza Danışın Stil Yönergeleri uygulamanızda kullanabileceğiniz düğmelerin listesi için.
Bir kopyasını indirin LWA_Android.zip file. Uygulamanızın desteklediği her ekran yoğunluğu (xxhdpi, xhdpi, hdpi, mdpi veya tvdpi) için tercih ettiğiniz düğmenin bir kopyasını çıkarın. Android'de birden çok ekran yoğunluğunu destekleme hakkında daha fazla bilgi için bkz. Alternatif Düzenler ondeveloper.android.com "Birden Çok Ekranı Destekleme" başlığında. - Uygun düğme görüntüsünü kopyalayın fileProjenize teşekkürler.
Desteklediğiniz her ekran yoğunluğu için (xhdpi, hdpi, mdpi veya ldpi), indirilen düğmeyi res / çekilebilir o ekran yoğunluğu için dizin. - Düğme resmini bildirin.
Düğme XML bildiriminde, android: src Seçtiğiniz düğmenin adına atfedilir. eski içinamptarih:android: src = ”@ drawable / btnlwa_gold_loginwithamazon.png” - Uygulamanızı yükleyin ve düğmenin artık bir Amazon ile Oturum Aç görüntüsüne sahip olduğunu doğrulayın.
Desteklediğiniz her ekran yoğunluğu için düğmenin düzgün görüntülendiğini doğrulamalısınız
Android API'leri için SDK'yı kullanın
Bu bölümde, Amazon ile Oturum Aç ile bir kullanıcıyla oturum açmak için projenize kod ekleyeceksiniz.
Bu bölüm, bir kullanıcının oturum açması için yetkilendirme API'sinin nasıl çağrılacağını açıklar. Bu, bir Tıklandığında Amazon ile Oturum Açma düğmeniz için dinleyici Oluşturulduğunda uygulamanızın yöntemi.
- Android cihazınıza Amazon ile Giriş Yapın Girişi Amazon Kitaplığı ile Kurun.
- Başlat Talep Bağlam.
Bir beyan etmeniz gerekecek İstekBağlam değişken ve sınıfın yeni bir örneğini oluşturun. Başlatmak için en iyi yer İstekBağlam içindedir Oluşturulduğunda Android etkinliğinizin veya parçanızın yöntemi. eski içinamptarih:özel RequestContext requestContext;
@Override
korumalı void onCreate (Bundle SavedInstanceState) {super.onCreate (SavedInstanceState); requestContext = RequestContext.create (bu);
} - Bir tane oluştur YetkilendirDinleyici.
YetkilendirDinleyici sonucunu işleyecek yetkilendirme. Üç yöntem içerir: Başarıda, Hatada, Ve onİptal. Oluştur YetkilendirDinleyici ile aynı hizada arayüz kayıt Dinleyici aramak Oluşturulduğunda Android etkinliğinizin veya parçanızın yöntemi.@Override
korumalı void onCreate (Bundle SavedInstanceState) {super.onCreate (SavedInstanceState); requestContext = RequestContext.create (bu);requestContext.registerListener (new AuthorizeListener () {
/ * Yetkilendirme başarıyla tamamlandı. * /
@Override
public void onSuccess (AuthorizeResult sonucu) {
/ * Uygulamanız artık istenen kapsamlar için yetkilendirildi * /
}
/ * Uygulamayı yetkilendirme girişimi sırasında bir hata oluştu. * /
@Override
public void onError (AuthError ae) {
/ * Kullanıcıyı hatadan haberdar edin * /
}
/ * Yetkilendirme tamamlanamadan iptal edildi. * / @Override
public void onCancel (AuthCancellation iptali) {
/ * Kullanıcı arayüzünü oturum açmaya hazır duruma sıfırlayın * /
}
});
}Not: Bir parça kullanıyorsanız ve referansları yakalarsanız View içindeki nesneler YetkilendirDinleyici uygulama, oluşturma YetkilendirDinleyici içinde OluşturulduğundaView yerine yöntem Oluştur. Bu, şunları sağlar: View çağrıldığında nesne referansları ayarlanır. yetkilendirir.
- Uygulamak Başarıda, Hatada, Ve onİptal senin için YetkilendirDinleyici.
Yetkilendirme süreci, kullanıcıya bir oturum açma ekranı (ve muhtemelen bir izin ekranı) sunduğundan, web tarayıcı (veya WebView), kullanıcı oturum açmayı iptal etme veya uzaklaşma fırsatına sahip olacaktır. Oturum açma işlemini açıkça iptal ederlerse, onİptal çağrılır ve kullanıcı arayüzünüzü sıfırlamak isteyeceksiniz.
Kullanıcı tarayıcıda oturum açma ekranından uzaklaşırsa veya WebView, ardından uygulamanıza geri döner, SDK, oturum açma işleminin tamamlanmadığını algılamaz. Giriş tamamlanmadan önce uygulamanızda kullanıcı etkinliği tespit ederseniz, kullanıcının tarayıcıdan uzaklaştığını varsayabilir ve buna göre tepki verebilirsiniz. - Arama requestContext.onResume.
Android uygulama yaşam döngüsüne uyum sağlamak için, özgeçmişte faaliyet veya parçanızdaki yöntem. Bu, ile kayıtlı tüm dinleyicileri tetikleyecek kayıt Dinleyici Kullanıcı bir yetkilendirme akışını tamamlamadan önce uygulamanızın işletim sistemi tarafından kapatılması durumunda.@Override
korumalı void onResume () {
super.onResume ();
requestContext.onResume ();
} - Arama AuthorizationManager.yetkilendirme.
İçinde Tıklandığında Amazon ile Oturum Aç düğmeniz için işleyici, kullanıcıdan oturum açmasını ve uygulamanızı yetkilendirmesini istemek için yetkilendirmeyi arayın.
Bu yöntem, kullanıcının aşağıdaki yollardan biriyle oturum açmasını ve istenen bilgilere izin vermesini sağlayacaktır:
1. Sistem tarayıcısına geçer
2. Anahtarlar WebView güvenli bir bağlamda (cihazda Amazon Shopping uygulaması yüklüyse)
İkinci seçeneğin güvenli bağlamı, cihaza Amazon Shopping uygulaması yüklendiğinde kullanılabilir. Fire OS çalıştıran Amazon tarafından oluşturulan cihazlar (örn.ampKindle Fire, Fire Phone ve Fire TV) cihazda Amazon Shopping uygulaması olmasa bile her zaman bu seçeneği kullanın. Bu nedenle, kullanıcı Amazon Shopping uygulamasında zaten oturum açmışsa bu API, oturum açma sayfasını atlayarak bir Tek Oturum Açma kullanıcı için deneyim. Müşteri Deneyimini şurada görün: müşteri-deneyim-android Daha fazla bilgi edinmek için uygulamalar. Uygulamanız yetkilendirildiğinde, olarak bilinen bir veya daha fazla veri seti için yetkilendirilmiştir. kapsamlar. Kapsam, Login with Amazon'dan talep ettiğiniz kullanıcı verilerini kapsar. Bir kullanıcı, uygulamanızda ilk kez oturum açtığında, talep ettiğiniz ve onayınız istenen verilerin bir listesiyle birlikte sunulur. Amazon ile oturum açma şu anda aşağıdaki kapsamları desteklemektedir:Kapsam adı Tanım profesyonelfile Kullanıcının adına, e-posta adresine ve Amazon hesap kimliğine erişim sağlar. profesyonelfile:Kullanıcı kimliği Yalnızca kullanıcının Amazon hesap kimliğine erişim sağlar. Posta Kodu üzerinde kullanıcının posta/posta koduna erişim sağlar. file Amazon hesapları için. YetkilendirmeManager.yetkilendirme zaman uyumsuz bir çağrıdır, bu nedenle UI iş parçacığını engellemeniz veya kendi iş parçacığınızı oluşturmanız gerekmez. Yetkilendirmeyi çağırmak için İsteği Yetkilendir kullanılarak oluşturulabilen nesne Yetkilendirmeİsteği.Oluşturucu:
@Override
korumalı void onCreate (Bundle SavedInstanceState) {super.onCreate (SavedInstanceState);
/ * Önceki onCreate bildirimleri atlandı * /// login_with_amazon kimliğine sahip düğmeyi bulun
// ve bir tıklama işleyici ayarlayın
View loginButton = bulViewById(R.id.login_with_amazon); loginButton.setOnClickListener(yeni View.TıklamaDinleyicisi() {
@Override
herkese açık geçersiz onClick(View v) { AuthorizationManager.authorize(yeni AuthorizeRequest)
Oluşturucu(requestContext).addScopes(ProfileKapsam.profile(), ProfesyonelfileKapsam.postaKodu())
.inşa etmek());
});
}
Kullanıcı Profesyonelini Getirfile Veri
Bu bölüm, bir kullanıcının profesyonelini almak için Kullanıcı API'sinin nasıl kullanılacağını açıklar.file yetkilendirildikten sonra veriler. Profesyonelfile alabileceğiniz veriler, aşağıda belirtilen kapsama dayalıdır. authorize: withHandler: Arama.
- Arama Kullanıcı.getir.
kullanıcı.getir kullanıcının profesyonelini döndürürfile Dinleyici aracılığıyla size veri AuthError> geri çağırmak. Dinleyici AuthError> iki yöntem içerir: Başarı üzerine Ve onError (desteklemiyor onİptal çünkü iptal etmenin bir yolu yok kullanıcı.getir aramak). Başarı üzerine pro ile bir Kullanıcı nesnesi alırfile veri, süre onError alır Yetki Hatası hata hakkında bilgi içeren nesne. güncellemeProfileVeri eski sevgiliampuygulamanızın pro'yu görüntülemek için uygulayabileceği bir işlevin le'sifile kullanıcı arayüzündeki veriler
Not: User.getUserPostalCode yalnızca Pro'yu talep ettiğinizde döndürülür.fileScope.postalCode() kapsamı.
Başlangıçta Kullanıcı Girişini Kontrol Edin
Bir kullanıcı uygulamanızda oturum açarsa, uygulamayı kapatır ve daha sonra uygulamayı yeniden başlatırsa, uygulamaya yine de veri alma yetkisi verilir. Kullanıcı otomatik olarak çıkış yapmaz. Başlangıçta, uygulamanız hala yetkilendirilmişse kullanıcıyı oturum açmış olarak gösterebilirsiniz. Bu bölüm nasıl kullanılacağını açıklar Token Al uygulamanın hala yetkili olup olmadığını görmek için.
- Arama Token Al.
İçinde onStart Aktivitenizin veya parçanızın yöntemi, arayın Token Al uygulamanın hala yetkili olup olmadığını görmek için. Token Al ham erişim belirtecini alır. Yetkilendirme Yöneticisi bir kullanıcı uzmanına erişmek için kullanırfile. Belirteç değeri boş değilse, uygulama hala yetkilidir ve kullanıcı profesyonelini almaya devam edebilirsiniz.file veri. getTokengerektirir yetkilendirme çağrınızda talep ettiğiniz kapsamların aynısı.
getTokendestekleri aynı şekilde eşzamansız çağrılar kullanıcı.getir, böylece UI iş parçacığını engellemenize veya kendi iş parçacığınızı oluşturmanıza gerek kalmaz. Aramak Token Al eşzamansız olarak, Dinleyici son parametre olarak arayüz. - Bir beyan et Dinleyici AuthError>. Uygulamanız Dinleyici AuthError> arayüzü, Token Al aramak. Dinleyici iki yöntem içerir: Başarı üzerine Ve onError (desteklemiyor onİptal çünkü iptal etmenin bir yolu yok Token Al aramak).
- Uygulamak Başarı üzerine ve sizin için onError Dinleyici . onSuccess alır Sonucu Yetkilendir erişim belirteci olan nesne, onError alır Yetki Hatası hata hakkında bilgi içeren nesne.
@Override
korumalı void onStart () {super.onStart ();
Kapsam[] kapsamları = { ProfesyonelfileKapsam.profile(), ProfesyonelfileScope.postalCode() }; AuthorizationManager.getToken(bu, kapsamlar, yeni
Dinleyici () {@Override
public void onSuccess (AuthorizeResult sonucu) {if (result.getAccessToken ()! = null) {
/ * Kullanıcı oturum açtı * /
} başka {
/ * Kullanıcı oturum açmamış * /
}
}
@Override
public void onError (AuthError ae) {
/ * Kullanıcı oturum açmamış * /
}
});
}
Bu bölüm, kullanıcının uygulamanızda oturumunu kapatmak için Oturumu Kapat yönteminin nasıl kullanılacağını açıklar. Uygulamanın pro'yu alması için kullanıcının tekrar giriş yapması gerekecekfile veri. Bir kullanıcının oturumunu kapatmak veya uygulamadaki oturum açma sorunlarını gidermek için bu yöntemi kullanın.
- Bir çıkış mekanizması uygulayın.
Bir kullanıcı başarıyla oturum açtığında, profesyonellerini temizleyebilmeleri için bir oturum kapatma mekanizması sağlamalısınız.file veriler ve önceden yetkilendirilmiş kapsamlar. Mekanizmanız bir köprü, düğme veya bir menü öğesi olabilir. Bu eski içinample, bir oluşturacağız tıklama yönteminde bir düğme için. - Arama oturumu Kapat.
Arama oturumu Kapat Bir kullanıcının yetkilendirme verilerini (erişim belirteçleri, profesyonelfile) yerel mağazadan. oturumu Kapat bir Android bağlamı ve bir Dinleyici alır AuthError> için başarı veya başarısızlıkla başa çıkın. - Anonim bir Dinleyici bildirin AuthError>.
Dinleyici uygulamanız AuthError> sonucunu işler oturumu Kapat aramak. Anonim sınıflar, değişkenleri kapsayan kapsamdan yakalamak için kullanışlıdır.
Görmek Oturum Açma Düğmesini Kullanın ve Kullanıcıyı Yetkilendirin bir için exampizin ver dinleyici sınıfları bildirir. - Uygulamak Başarı üzerine Ve onError Dinleyiciniz için AuthError>.
Ne zaman Işareti Başarılı Kullanıcı referanslarını kaldırmak için kullanıcı arayüzünüzü güncellemeniz ve kullanıcıların tekrar oturum açmak için kullanabilecekleri bir giriş mekanizması sağlamanız gerekir. Eğer işaretÇıkışlar bir hata oluştuğunda, kullanıcının tekrar oturumu kapatmasına izin verebilirsiniz.@Override
korumalı void onCreate (Bundle SavedInstanceState) {super.onCreate (SavedInstanceState);
/ * Önceki onCreate bildirimleri atlandı * /// Çıkış kimliğine sahip düğmeyi bulun ve bir tıklama işleyici ayarlayın View logoutButton = bulViewById(R.id.logout); logoutButton.setOnClickListener(yeni View.TıklamaDinleyicisi() {@Override
herkese açık geçersiz onClick(View v) { AuthorizationManager.signOut(getApplicationContext(), yeni
Dinleyici () {@Override
public void onSuccess (Void response) {
// Kullanıcı arayüzünde oturum kapalı durumunu ayarla
}
@Override
public void onError (AuthError authError) {
// Hatayı günlüğe kaydedin
}});
}
});
}
Android uygulamaları için Amazon Başlangıç Kılavuzu ile oturum açın - İndir [optimize edilmiş]
Android uygulamaları için Amazon Başlangıç Kılavuzu ile oturum açın - İndirmek
