
ガイドを始める
iOSアプリの場合


日报社(7月27日) Amazon.com のサイト、株式会社またはその関連会社。 スタッフ募集
Amazon および Amazonロゴは、Amazon の商標です。 Amazon.com のサイト代表取締役社長 またはその関連会社。 Amazonが保有する商標は、それぞれの所有者の財産です。


このガイドでは、Amazon SDK for iOS v3.0+ でログインしてiOSアプリにサインインする方法を紹介します。
このガイドを完了した後、Amazonの認証情報を使用してログインできるようにアプリでアマゾンボタンを使って作業している必要があります。 お客様がアプリ内でAmazonでログインする際に、ログインフローについて詳しく知りたい方は、「iOS アプリのカスタマーエクスペリエンス概要」をご覧ください。
トピックス

Amazon SDK for iOS でログインすると、Amazon からiOS アプリケーションにサインインできます。 SDKはXcode開発環境で利用する予定です。 SDK は、iOS 7.0以降で動作するアプリをサポートしています。ARMv7, ARMv6s, アーム64, i386, x86 64.
Mac App StoreからXcodeをインストールできます。 詳細は、開発者がXcode: What's Newを新規に表示するを参照してください。アップル.com.
Xcodeをインストールした後、iOS用のAmazon SDKでログインをインストールし、下記のようにサンプルアプリを実行できます。
iOS用Amazon SDKでログインすると、2つのパッケージが付属しています。 最初にiOSライブラリとサポートドキュメントが含まれています。 2 つは、ユーザーがログオンしてプロフィールデータを表示できるようにするサンプルアプリケーションを含みます。
まだXcodeをインストールしていない場合は、上記にインストールするXコードセクションの指示を参照してください。
iOS用Amazon SDKでログインすると、Amazonに登録した後にAmazonプロジェクトで新規登録ができます。
サンプルアプリケーションを実行するには、Xcode のサンプルを開きます。

アマゾンでログインをウェブサイトやモバイルアプリから利用する前に、Amazonでログインして登録してください。 Amazonアプリでログインすると、ビジネスに関する基本情報や各ウェブサイトの情報を含んだ登録やAmazonでログインをサポートするモバイルアプリに関する情報が記載されています。 当ウェブサイトやモバイルアプリでAmazonとログインして利用するたびに、利用者にこのビジネス情報が表示されます。 利用者は、お客様のアプリケーション名やロゴマーク、およびプライバシーポリシーへのリンクをご覧いただけます。 これらの手順は、Amazonでログインして使用するためにiOSアプリを登録する方法を示しています。

.. 申請書を登録するには、 お名前(必須) と、 コンテンツ 応募者様へ とりあえず
お名前(必須) 利用者が、お客様のアプリケーションに情報を共有することに同意したときに同意画面に表示されます。 お名前は、Android, iOS, Webサイトのバージョンのアプリケーションに適用されるものとします。 とりあえず コンテンツ Amazonアプリケーションでログインを区別し、ユーザーに表示されません。

. . エントリー 個人情報保護方針 応募者様へ
とりあえず 個人情報保護方針 会社のプライバシーポリシーまたはアプリケーションに関するポリシーの場所(例えば、 http://www.example.com/privacy.html). 同意画面にユーザーへリンクします。 . . 追加したいなら ロゴイメージ お使いのアプリケーションの場合、クリック ファイルの選択 該当するものを見つけ、
映像。 サイン入りや同意画面にロゴマークが表示され、ビジネス・ウェブサイトの表現ができます。 ロゴは50ピクセル以上の高さで、高さが50ピクセルまで縮小されます。ロゴの幅には制限はありません。 4. . クリック 保存する. . サンプル登録は、以下のとおりです。

基本設定を保存した後、Amazonアカウントでこのログインを使用する特定のウェブサイトやモバイルアプリの設定を追加することができます。
複数のバージョンのアプリが 1 つ以上のテスト バージョンやプロダクション バージョンなど、異なるバンドル ID を持っている場合、各バージョンでは独自の API キーが必要です。 から iOS の設定 アプリのクリック APIキーの追加 アプリのキーを追加(バージョン1回)作成するボタン。
基本設定を保存した後、Amazonでログインする特定のウェブサイトやモバイルアプリの設定を追加できます。
iOSアプリを登録するには、アプリケーションプロジェクト用のBundle IDrを指定する必要があります。 Amazonでログインすると、IDバンドルを使用してAPIキーを生成します。 API キーは、Amazon 認可サービスでログインにアプリアクセスを許可します。 これらの手順に従って、iOSアプリをアカウントに追加します。


2. . エントリー ラベル iOSアプリの お使いのアプリの公式名である必要はありません。 単にAmazonアプリケーションでログインに登録されたアプリやウェブサイトの中で、この特定のiOSアプリを識別します。 3. . サインアップ バンドルID. . これは、iOSプロジェクトのバンドル識別子に一致する必要があります。 バンドル識別子を決定するには、Xcodeでプロジェクトを開きます。 プロジェクトのためのプロパティリストを開きます(とりあえず、プロジェクト>-Info.plist) に プロジェクトナビゲーター. . とりあえず バンドル識別子 リスト内のプロパティの1つです。 4. . クリック 保存する.
複数のバージョンのアプリが 1 つ以上のテスト バージョンやプロダクション バージョンなど、異なるバンドル ID を持っている場合、各バージョンでは独自の API キーが必要です。 から iOS の設定 アプリのクリック APIキーの追加 アプリのキーを追加(バージョン1回)作成するボタン。
Bundle 識別子は、すべての iOS アプリに一意です。 Amazonでログインすると、Bundle IDを使用してAPIキーを構築します。 APIキーは、Amazon認可サービスでログインしてアプリを認識することができます。 iOSアプリのバンドル識別子を決定します
1. . Xcode でアプリプロジェクトを開きます。 2. . 開封する 情報プロパティリスト プロジェクト(とりあえず、プロジェクト>-Info.plist) に プロジェクトナビゲーター. . 3. . おすすめ バンドル識別子 プロパティのリストで。 iOS API キーの取得 iOS版を登録して、Bundle ID を提示すると、登録ページからAmazon アプリケーションでログインするための API キーを取得できます。 プロジェクトのプロパティリストに API キーを配置する必要があります。 お客様が行うまで、アプリはAmazon認可サービスでログインと通信する権限を付与しません。

2. . クリック アプリコンソール. . 3. . でん おすすめアプリ 箱は、あなたの適用をかちりと鳴らします。 4. . iOSアプリを以下で見つけます iOS の設定 セクション。 iOSアプリを既に登録していない場合は、iOS設定を追加してアプリケーションに追加してください。 5. . クリック API のキー価値を生成. . ポップアップウィンドウが API キーを表示します。 キーをコピーするには、クリックします 全て選択 キー全体を選択する。 注意:: API キー 値が生成される時間に、一部をベースとしています。 そのため、生成するAPIキー値が元のものと異なる可能性があります。 これらの API Key の値を、すべての有効であるように使用できます。 6. . iOS アプリに API キーを追加するための手順については、App プロパティリストに追加します。
このセクションでは、Amazonでログインするための新しいXcodeプロジェクトを作成し、プロジェクトの構成方法を学習します。
Amazonでログインをするためにアプリプロジェクトがまだない場合は、以下の手順に従って作成します。 既存のアプリをお持ちの方は、下記のAmazon Libraryセクションでログインをインストールしてください。
Amazonでログインを呼び出すために使用できる新しいプロジェクトがあります。
iOS用のAmazon SDKでログインがまだダウンロードされていない場合は、iOS用Amazon SDK に ログインをインストールしてください。
Amazonプロジェクトでログインすると、リンクする必要があります ログインAmazon.framework とりあえず セキュリティ・フレームワーク ライブラリ。 また、フレームワーク検索パスを設定してAmazonヘッダーでログインを見つける必要があります。

ログイン - amazon-sdk.a フレームワークフォルダから。 クリック 編集 メインメニューから選択 削除. . 6. . プロジェクトの名前をプロジェクト名で選択 プロジェクトナビゲーター. . とりあえず プロジェクトエディタ Xcode ワークスペースのエディタ領域に表示します。



さらに、1.0ライブラリパスに参照を外すことができます。 ヘッダー検索パス または 図書館検索パス.
Amazonでログインすると、APIキーが割り当てられます。 Amazon Mobile LibraryがAmazon認可サービスでログインにアプリケーションを識別するために使用するIDです。 Amazon Mobile Library は、アプリケーションの情報プロパティリストにある APIKey プロパティ値から実行時にこの値をロードします。


ユーザーがログインすると、Amazonのログインページが表示されます。 アプリがログインの確認を受け取り、WebページからアプリにリダイレクトできるようにURLスキームを追加する必要があります。 URL スキームは、次のように宣言する必要があります。 アマズン<bundleID> (例: amzn-com.example.app の使い方). 詳細については、URLスキームを使用して開発者のアプリと通信するを参照してください。アップル.com.


2. . エントリーのどれも選択されているか確認してください。 それから、メインメニューから、クリックします 編集者と アイテムを追加. . 入るか、または選択して下さい URL の型 プレス エントリー. . 3. . 拡大する URL の型 明らかにする アイテム 0. . 選択する アイテム 0 と、メインメニューから、[クリック] 編集者 とりあえず アイテムを追加. . 入るか、または選択して下さい URL の識別子 プレス エントリー. . 4. . 選択する アイテム 0 以下は URL の識別子 下のダブルクリック バリュー 値を追加するカラム。 値がバンドル ID です。 バンドルIDがリストされているのは、 バンドル識別子 プロパティリストに。 5. . 選択する アイテム 0 以下は URL の型 と、メインメニューから、[クリック] 編集者 とりあえず アイテムを追加. . 入るか、または選択して下さい URLスキーム プレス エントリー. . 6. . 選択する アイテム 0 以下は URLスキーム 下のダブルクリック バリュー 値を追加するカラム。 値がバンドル ID で、 アマズン- プリペンド(例えば、 amzn-com.example.app の使い方). バンドルIDがリストされているのは、 バンドル識別子 プロパティリストに。
Amazonでログインすると、ユーザーがアプリからログオンすることができるように使用できるいくつかの標準ボタンが提供されます。 このセクションでは、Amazon の公式ログインをダウンロードし、iOS UIButton とペアリングするための手順について説明します。

開発者。アップル.com ボタンイベントを追加する手順が含まれます。 3. . ボタン画像を選択します。 アプリで使用できるボタンのリストについては、Amazon Style ガイドラインにログインしてください。 コピーをダウンロード LWA for iOS.zip の使い方 ファイルの拡張子 1xと2xディレクトリの両方でお好みのボタンを見つけてzipから抽出します。 エキス プレス 選択された状態のボタンを表示したい場合は、ボタンのバージョン。 4. . 画像をプロジェクトに追加します。 .. Xcode では、プロジェクトがロードされるとクリックします コンテンツ メインメニューから選択 ファイルを追加
「プロジェクト」 ダイアログで、ダウンロードしたボタン画像ファイルを選択し、[クリック]をクリックします。 アクセサリー プロジェクトディレクトリの下のプロジェクトにボタンが置かれます。 それらを移動して
とりあえず 支持ファイル フォルダ。 5. . ボタンに画像を追加してください。 ボタンのイメージを有効にするには、ボタン属性を変更したり UIButtonオブジェクトに setImage:forState メソッドを使うことができます。 これらの手順に従って、ボタンのimage属性を変更します。
.. アプリのストーリーボードを開きます。 . . ストーリーボードのボタンをクリックするか、またはそれを選択してから選択してください プロフィール
コントローラーのシーン ツリー。 . . でん ユーティリティ ウィンドウ、開いた 属性インスペクター.

d. 。 一番上の 属性インスペクタ, セット 種類: ボタンから ソリューション 設定の2番目のグループで、選択します デフォルト のための ステート構成 設定の2番目のグループでは、ドロップダウン コンテンツ 設定。 . . プロジェクトに追加したAmazonボタングラフィックでログインを選択します。 選択しないでください
2x版:高密度表示(網膜)装置に自動的に荷を積まれます。 . . 同じイメージをセットする 背景: 設定。 ... ボタンの押されたバージョンを指定したい場合は、選択します 選択された のための ステート構成、およびセットを置いて下さい コンテンツ にほんご プレス ボタンの版。 . . ストーリーボードでは、必要に応じてボタンのサイズを調整してイメージを収容します。

このセクションでは、あなたのプロジェクトにコードを追加して、Amazonでログインしたユーザーにログインします。
アプリケーションを実装:openURL:options: プロジェクトのクラスで UIApplicationDelegate プロトコルを処理する。 デフォルトでは、これは AppDelegate クラスになります。 ユーザーがAmazonでログインを使用してアプリにログインすると、以前のAppプロパティリストに追加したURLスキームに基づいて、アマゾンのログイン画面に戻ります。 このリダイレクトを処理するには、URLが正常に処理されている場合はYESを返す application:openURL:options: メソッドを実装する必要があります。 Amazon SDK for iOS でログインすると、ライブラリ機能が提供され、Amazon ページから送信されたリダイレクトURLを処理する OpenURL:sourceApplication を処理します。 正常にSDKで処理されるURLが返されたらはいを返します。 アプリケーション内のこのメソッドを呼び出します:openURL:options: メソッド。 このメソッドを呼び出して、インポートする必要があります .
インポート @implementation AppDelegate - (BOOL) アプリケーション:(UIApplication *) アプリケーションの openURL:(NSURL *) URL オプション:( NSDictionary) *)オプション { 戻り値 [AMZNAuthorizationManagerハンドルOpenURL:url sourceApplication:options[UIApplicationOpenURLOptionsSourceアプリケーションキー]; } @end
このセクションでは、authorize:withHandler: API をユーザのログインに呼び出す方法について説明します。 これは、onLoginButtonClickedの作成を含みます: Amazonボタンでログインするためのリスナー。
#インポート

この方法は、次の方法で要求された情報にサインインし同意することを可能にします。
1. . 安全なコンテキストでWebビューに切り替える(Amazonショッピングアプリがデバイスにインストールされている場合)2。 Safariビューコントローラー(iOS 9以降)への切り替え 3. システムのブラウザ(iOS 8以降)に切り替えます。Amazonショッピングアプリがデバイスにインストールされている場合、最初のオプションの安全なコンテキストは利用できます。 Amazonショッピングアプリに既にユーザーがサインインしている場合、このAPIはページ内のサインをスキップし、 シングルサインオン(SSO) 体験する iOSアプリで顧客体験を把握して、もっと詳しく知る
最初に:withHandler をauthorizeするパラメータは、AMZNAuthorizeRequestオブジェクトで、 スコープ 申請書は、承認を要求しています。 スコープは、Amazonでログインをリクエストしたユーザーデータを網羅しています。 ユーザーがアプリにログインする際、リクエストしたデータの一覧を提示し承認を求める。
Amazonでログインすると、次のスコープがサポートされています。
プロフィール ユーザーの氏名、メールアドレス、AmazonアカウントIDにアクセスします。
プロフィール:user id ユーザーのAmazonアカウントIDのみにアクセスします。
郵便番号 Amazonアカウントのファイルにあるユーザのzip/postalコードへのアクセス権を与えます。
AMZNProfileScope で定義されたメソッドを使用してスコープオブジェクトを取得し、AMZNAuthorizeRequest オブジェクトに追加します。 詳細は、サンプルコードをご覧ください。
正規化の2番目のパラメータは、次のステップで説明するAMZNAuthorizationRequestHandlerです。
AMZNAuthorizationRequestHandler の第1引数は、AMZNauthorizeResultオブジェクトです。 ユーザが正常に承認された後、AMZNAuthorizeResultはユーザーのプロファイルデータにアクセスするために使用できるアクセストークンとユーザーのプロフィールのデータを含む AMZNUserオブジェクトが含まれます。
AMZNAuthorizationRequestHandler の2番目のパラメータは、userDidcancel というボリアンです。 このパラメータは、ユーザが真に設定されます。
AMZNAuthorizationRequestHandler の3番目のパラメーターは NSError オブジェクトです。

SDKや認証サーバーでログインと承認が失敗した場合、エラーの詳細が含まれています。
- (IBAction)onLogInButtonClicked:(id)sender { // 権限を付与するリクエストを作成します。 AMZNAuthorizeRequest *request = [[AMZN認証リクエスト割り当て]; 要求.scopes = [NSArray配列WithObject: // [AMZMProfileScope userID], [AMVNProfileスコーププロファイル], 「AMZDNProFileScoPE postalCode」)。 // Amazon SDKでログインに正規化コールをします。 [[AMZNAuthorizationManager sharedManager] は、:request withHandler:^(AMZNAAuthorizeResult *result, BOOL userDidCancel, NSError*error) { // SDKや認可サーバーからのエラーを処理します。 ユーザがログインをキャンセルしたときにエラーが発生した場合は、userDidCancel の{ //ハンドルエラーです。 認証が成功しました。 // アクセストークンとユーザープロファイルデータを取得します。 NSString *accessToken = result.token; AMZNUser *user= 結果.user; NSString *userID = ユーザ.usとりあえず、
ユーザーがログインしてアプリに承認される限り、ユーザーはいつでもユーザープロフィールデータを取得できます。 このセクションでは、現在認可されているユーザーに対して最も最新なユーザプロファイルデータを取得するためにAMZNUserクラスのfetch:メソッドを使用する方法を説明します。 取得できるプロファイルデータは、認証されたコールに示されているスコープに基づいています。

[AMZNUser fetch:^(AMZ Nuser、NSError *error) { if (error){ // SDKからのエラーやアプリに権限のないユーザが承認されていない場合。 ユーザID = ユーザ.us.///>//#/# /#=/##/ #/#;/#>/#:/#?#/>
ユーザーがアプリにログインすると、アプリを閉じて後でアプリを再始動すれば、データを取得できるのは許可されます。 ユーザが自動的にログアウトされない。 起動時に、アプリがまだ承認されていない場合、ユーザーがログインしたように表示することができます。 このセクションでは、authorize:withHandler の使用方法について説明します。このセクションはアプリがまだ承認されていないか確認します。


// 許可リクエストを作成する。 AMZNAuthorizeRequest *request = [[AMZN認証リクエスト割り当て] init;.scopes=[NSArray配列WithObject: // [AMZ NProfileScoultpe userID], [AMZHNProfileスコーププロファイル], 「AMZMNProファイルスコープ postalCode」); 要求。interactiveStrategy = AMZnInteractiveStategyNever; [[[AmZNProFileScopeプロフィール], (NAM) は、ユーザーを識別するエラーに対して通知します(エラーが確認できません) ユーザは、アプリの承認をしました。 // アクセストークンとユーザープロファイルデータを取得します。 NSString *accessToken = result.token; AMZNUser *user= 結果.user; NSString *userID = ユーザ.usとりあえず、
このセクションでは、AIMobileLib ローカルのデータストアと認証サーバーの両方からユーザーの認可データを消去するために signOut メソッドを使用する方法を説明します。 ユーザーは、プロファイルデータを取得するためにアプリのために再びログインする必要があります。 ユーザをログアウトしたり、アプリ内のログイン問題のトラブルシューティングを行うにはこのメソッドを使用します。


[[AMZNAuthorizationManager sharedManager] のsignOut:^(NSError * Nullable error) { if (!error){/SDKからのエラーやAmazon認可サーバーでログイン。 とりあえず
iOSデバイスまたはシミュレータでアプリを起動し、ログインできることを確認してください。 Amazon.com のサイト 資格情報。
注意:: iOS10シミュレータでテストする場合、エラーメッセージが表示されます。 アプリケーション用の APIKey は無効です。 authorizeUserForScopes リクエスト、または 未知のエラーコード 明確なAuthorizationStateリクエストの SDK がキーホルダーにアクセスしようとすると、Apple でよく知られているバグです。 Appleがバグを解決するまで、有効化することで回避策を実行できます。 Keychain の共有 アプリのアプリを 能力の発揮 アプリのターゲットタブ。 このバグはシミュレータにのみ影響します。 実際のiOS10デバイスで、任意の回避策を使用せずにテストできます。
この取扱説明書で参照されているリンク(メーカー、サポート、ダウンロード等)。
ユーザーまたはスタッフが通常1日以内に回答します。あなたの質問が次の人の助けにもなります。
最初の質問を投稿しましょう。他のユーザーや当チームが回答します。