A3L Authenticationサンプルアプリ
このページでは、A3L Authentication SDKを使用して作成されたサンプルアプリについて説明します。このアプリの目的は、A3L Authenticationとの統合方法を示すことです。このアプリを実行するにあたり、コードの記述は不要ですが、構成は設定する必要があります。このアプリは、Google Play対応デバイスとFire OSデバイスの両方にインストールできます。このアプリでGoogleアカウントにログインすると、詳細なプロフィールを取得できます。このアプリには、ログアウト機能とアクセスの取り消し機能も実装されています。
サンプルアプリプロジェクトのダウンロード
A3L Authentication SDKのダウンロードには、JavaとKotlinのサンプルアプリプロジェクトが含まれています。このSDKはSDKのダウンロードからダウンロードできます。このファイルには、サンプルアプリの構成・ビルドに使用できるAndroidプロジェクトが含まれています。
プロジェクトのビルド時に「SDK location not found」というエラーが発生した場合は、プロジェクトのルートにあるlocal.propertiesファイルに、Android SDKの場所を示す行を追加します。
例:
- Windowsの場合は、
sdk.dir=C:\\Users\\<ユーザー名>\\AppData\\Local\\Android\\sdk
という行を追加します。 - Macの場合は、
sdk.dir=/Users/<ユーザー名>/Library/Android/sdk
という行を追加します。
<ユーザー名>
は実際のユーザー名に置き換えてください。
サンプルアプリの設定
サンプルアプリを設定するには、以下の手順に従います。
-
Google APIコンソールから提供されるAndroidクライアントIDとOAuth 2.0クライアントIDを取得します(後者は必要に応じて)。IDの取得方法の詳細については、Google APIコンソールの設定を参照してください。
-
app/src/res/values/strings.xmlファイルを開き、
app_client_id
とserver_client_id
のプレースホルダー値を更新します。<string name="app_client_id">PREFIX</string> <string name="server_client_id">SERVER_CLIENT_ID</string>
PREFIX
をAndroidクライアントIDのプレフィックス(.apps.googleusercontent.com
の前のテキスト)に置き換え、SERVER_CLIENT_ID
をOAuth2.0クライアントIDに置き換えます。 -
アプリのbuild.gradleファイルを開きます。
appAuthRedirectScheme
のプレースホルダー値を更新します。defaultConfig { ----------------- manifestPlaceholders = [ 'appAuthRedirectScheme': 'com.googleusercontent.apps.<PREFIX>' ] ------------------ }
<PREFIX>
をAndroidクライアントIDのプレフィックス(.apps.googleusercontent.com
の前のテキスト)に置き換えます。
サンプルアプリのテスト
以下の手順に従ってサンプルアプリをテストします。
- 前のセクションの設定手順を完了したら、アプリをビルドします。
- Google Playサービスが有効になっているAndroidデバイス、またはFire OSデバイスにアプリをインストールします。
- アプリを起動します。アプリに「A3L Auth」というテキストと [Sign in with Google] ボタンが表示されます。
- [Sign in with Google] をクリックします。アプリからログインフローにリダイレクトされます。ログインフローは、アプリがインストールされたデバイスによって異なります。
- ログインすると、アプリに詳細なプロフィールと2つのボタン([Revoke Access] と [Sign Out])が表示されます。ボタンをクリックして機能を確認します。