AndroidアプリにLINEログインを組み込む

このトピックでは、LINEログインの実装方法として、既存のAndroidアプリにLINE SDK for Androidを組み込む方法について説明します。LINEログインの機能を簡単に確認するには、LINEログインのAndroid向けのLINEログインサンプルアプリを利用できます。詳しくは、「サンプルアプリを試してみる」を参照してください。

前提条件

LINE SDK for Androidをビルドして使用するには、以下が必要です。

• プロバイダーおよびLINEログインのチャネルを作成する。どちらもLINE Developersコンソールで作成できます。
• minSdkVersionを24以降（Android 7.0以降）に設定する。

以前のバージョンからのアップグレードについて

LINE SDK v4.x以前と最新バージョンの主な違いは以下のとおりです。

• ログインを開始するときに、スコープを指定して、アプリが取得するユーザー情報の種類を明らかにする必要があります。
• ログイン時にOPENID_CONNECTスコープを指定すると、ユーザー情報を安全に検証するためのIDトークンを取得できます。

LINE SDKに依存性を追加する

LINE SDK for Androidを組み込むには、必要なライブラリをプロジェクトにインポートし、以下の手順に従ってプロジェクトのAndroidマニフェストファイルを設定します。

ライブラリをプロジェクトにインポートする

モジュールレベルのbuild.gradleファイルに、LINE SDKの依存性を追加します。

repositories {
   ...
   mavenCentral()
}

dependencies {
    ...
    implementation 'com.linecorp.linesdk:linesdk:latest.release'
    ...
}

Androidのコンパイルオプションを追加する

Java 1.8のサポートを有効にします。前述のbuild.gradleファイルに以下の行を追加します。

android {
...
  compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
...
}

Androidマニフェストファイルを設定する

アプリがインターネットに接続する必要があることを明示するために、AndroidManifest.xmlファイルにINTERNET権限を追加します。

<uses-permission android:name="android.permission.INTERNET"/>

アプリをチャネルにリンクする

アプリをLINEログインのチャネルにリンクするために、LINE Developersコンソールのチャネル設定にある［LINEログイン設定］タブの［ネイティブアプリ］を有効にして、以下の項目を入力します。

• パッケージ名：必須。Google Playストアを起動するためのアプリケーションのパッケージ名です。
• パッケージの署名：省略可能。複数の署名を指定するには、改行で区切ります。
• Android URLスキーム：省略可能。アプリを起動するためのカスタムURLスキームです。

パッケージの署名を設定する

パッケージの署名は、アプリとLINEアプリ間の認証処理を強化するために重要です。パッケージの署名には、デバッグパッケージ署名と、リリースパッケージ署名があります。これらは、SHA-1形式のキーハッシュに関連しています。

デバッグパッケージ署名

デバッグパッケージ署名は、アプリの実行またはデバッグ時に、Android Studioによって自動生成されるデバッグ証明書から生成されます。

# macOSの場合
keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore -storepass android -keypass android | openssl sha1

# Windowsの場合
keytool -exportcert -alias androiddebugkey -keystore %USERPROFILE%\.android\debug.keystore -storepass android -keypass android | openssl sha1

リリースパッケージ署名

リリースパッケージ署名は、ストアにアプリをリリースする際に使用するリリース証明書から生成されます。<RELEASE_KEY_ALIAS>と<RELEASE_KEY_PATH>は、実際の値に置き換えてください。

keytool -exportcert -alias <RELEASE_KEY_ALIAS> -keystore <RELEASE_KEY_PATH> | openssl sha1

Google Play Consoleを使用してリリースキーハッシュを取得する

Play アプリ署名を使用している場合は、ターミナルでリリースキーハッシュを生成するのではなく、Google Play Consoleから取得したSHA-1証明書フィンガープリントを使用してください。詳しくは、『Play Console ヘルプ』の「Play アプリ署名を使用する」を参照してください。

Google Play Consoleで、［設定］ > ［アプリ署名］に移動し、SHA-1証明書フィンガープリントの値をコピーします。

LINEログインボタンを追加する

ユーザーがAndroidアプリにログインできるようにするために、LINEロゴがついたログインボタンを作成できます。ユーザーはこのボタンを使ってログインできます。

ログインを実行するには2つの方法があります。

• LINE SDKに組み込まれているログインボタンを使う
• カスタマイズしたログインボタンを使う

LINE SDKに組み込まれているログインボタンを使う

LINE SDKには定義済みのログインボタンが備わっています。ユーザーが簡単にアプリにログインできるように、以下の手順に従って、アプリのユーザーインターフェイスにログインボタンを追加できます。

1. レイアウトXMLファイルにログインボタンを追加します。
   xml

   <com.linecorp.linesdk.widget.LoginButton
       android:id="@+id/line_login_btn"
       android:layout_width="match_parent"
       android:layout_height="wrap_content" />
   

2. アクティビティまたはフラグメント内のビューに必要なパラメータを設定し、リスナーを割り当てます。
   java

   import java.util.Arrays;
   
   // A delegate for delegating the login result to the internal login handler.
   private LoginDelegate loginDelegate = LoginDelegate.Factory.create();
   
   LoginButton loginButton = rootView.findViewById(R.id.line_login_btn);
   
   // if the button is inside a Fragment, this function should be called.
   loginButton.setFragment(this);
   
   loginButton.setChannelId(channelIdEditText.getText().toString());
   
   // configure whether login process should be done by Line App, or inside WebView.
   loginButton.enableLineAppAuthentication(true);
   
   // set up required scopes and nonce.
   loginButton.setAuthenticationParams(new LineAuthenticationParams.Builder()
           .scopes(Arrays.asList(Scope.PROFILE))
           // .nonce("<a randomly-generated string>") // nonce can be used to improve security
           .build()
   );
   loginButton.setLoginDelegate(loginDelegate);
   loginButton.addLoginListener(new LoginListener() {
       @Override
       public void onLoginSuccess(@NonNull LineLoginResult result) {
           Toast.makeText(getContext(), "Login success", Toast.LENGTH_SHORT).show();
       }
   
       @Override
       public void onLoginFailure(@Nullable LineLoginResult result) {
           Toast.makeText(getContext(), "Login failure", Toast.LENGTH_SHORT).show();
       }
   });
   

   ---

   全33行を表示

カスタマイズしたログインボタンを使う

デフォルトのログインボタンを使う代わりに、コードを使ってユーザーインターフェイスとログインプロセスをカスタマイズすることもできます。

画像をダウンロードしてプロジェクトに追加する

LINEログインボタンの画像セットには、iOS、Android、デスクトップアプリ用の画像が含まれます。Android向けの画像セットには、複数の画面密度とさまざまな状態のボタンの画像が用意されています。ここでは、Androidフォルダー内の「通常時」と「押下時」のログインボタン画像を使用した例を紹介します。

1. LINEログインのボタン画像をダウンロードし、抽出します。
2. 各画面密度にあわせて、「通常時」と「押下時」のログインボタンをdrawableフォルダーに追加します。

画像を設定する

画像を使用する前に、ログインボタンのテキストを追加する必要があります。各言語で推奨されるテキストについては、「LINEログインボタンデザインガイドライン」を参照してください。また、LINEアイコンを歪みなく引き伸ばせるようにするために、画像内で引き伸ばせる部分を定義する必要があります。

1. 各画像に対して9-patchファイルを作成し、ログインボタンテキストの伸縮する部分を定義します。
2. アプリのログイン画面に、望ましいログインボタンテキストと共に、クリックできるテキストビューとしてボタンを追加します。
3. ドローアブルフォルダーにselector XMLファイルを追加して、テキストビューの状態に対応する画像を定義します。

ログインアクティビティを開始する

ユーザーがログインボタンをタップすると、アプリはgetLoginIntent()を呼び出してログインインテントを取得し、ログインアクティビティを開始します。このメソッドに、コンテキストとチャネルIDを渡す必要があります。ユーザーがデバイスにLINEをインストール済みの場合、LINEが開き、ユーザーのLINE認証情報の入力なしでログインが実行されます。ユーザーがデバイスにLINEをインストールしていない場合、ブラウザでLINEログイン画面が開きます。ユーザーは、この画面にLINE認証情報（メールアドレスとパスワード）を入力します。

1. ボタンのタップを待機するon-clickリスナーを設定します。
2. onClickのコールバックでLineLoginApiのgetLoginIntent()メソッドを呼び出して、ログインインテントを取得してログインアクティビティを開始します。
3. startActivityForResult()を呼び出してログインインテントとリクエストコードをパラメータとして渡し、認証プロセスを開始します。リクエストコードとは、リクエストを識別するための整数です。

以下は、ユーザーがログインボタンをタップしたときにログインアクティビティを開始する方法の例です。

private static final int REQUEST_CODE = 1;
...

final TextView loginButton = (TextView) findViewById(R.id.login_button);
loginButton.setOnClickListener(new View.OnClickListener() {

    public void onClick(View view) {
        try {
            // App-to-app login
            Intent loginIntent = LineLoginApi.getLoginIntent(
              view.getContext(),
              Constants.CHANNEL_ID,
              new LineAuthenticationParams.Builder()
                .scopes(Arrays.asList(Scope.PROFILE))
                        // .nonce("<a randomly-generated string>") // nonce can be used to improve security
                .build());
            startActivityForResult(loginIntent, REQUEST_CODE);
        }
        catch(Exception e) {
            Log.e("ERROR", e.toString());
        }
    }
});

ログイン結果を処理する

ユーザーのログインが完了すると、ログイン結果がアクティビティのonActivityResult()メソッドに返されます。アプリはログイン結果を処理するために、このメソッドをオーバーライドする必要があります。

LineLoginResultオブジェクトのgetResponseCode()メソッドを使用して、LINEログインが成功したかどうかを判定します。ログインに成功した場合、getResponseCode()がSUCCESSを返します。それ以外の値が返った場合は、ログインに失敗したことを意味します。発生したエラーの種類を判別するには、「エラーを制御する」を参照してください。

アプリによるログイン結果の処理方法については、以下を参考にしてください。

public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode != REQUEST_CODE) {
        Log.e("ERROR", "Unsupported Request");
        return;
    }

    LineLoginResult result = LineLoginApi.getLoginResultFromIntent(data);

    switch (result.getResponseCode()) {

        case SUCCESS:
            // Login successful
            String accessToken = result.getLineCredential().getAccessToken().getTokenString();

            Intent transitionIntent = new Intent(this, PostLoginActivity.class);
            transitionIntent.putExtra("line_profile", result.getLineProfile());
            transitionIntent.putExtra("line_credential", result.getLineCredential());
            startActivity(transitionIntent);
            break;

        case CANCEL:
            // Login canceled by user
            Log.e("ERROR", "LINE Login Canceled by user.");
            break;

        default:
            // Login canceled due to other error
            Log.e("ERROR", "Login FAILED!");
            Log.e("ERROR", result.getErrorData().toString());
    }
}

アクセストークンを取得する

ログイン結果には、ユーザーのアクセストークンが入ったLineCredential()オブジェクトが含まれています。上の例に示すとおり、以下のコードを使用してアクセストークンを取得できます。

String accessToken = result.getLineCredential().getAccessToken().getTokenString();

ログイン直後にユーザープロフィールを取得する

ユーザーがログインすると、LINE SDKによって自動的にユーザーのプロフィール情報が取得されます。ユーザーのプロフィール情報には、表示名、ユーザーID、ステータスメッセージ、およびプロフィールメディアのURLが含まれます。LineLoginResultオブジェクトのgetLineProfile()メソッドを呼び出して、この情報にアクセスします。以下のコードは、上の例から引用したものです。ログイン結果からユーザーのプロフィール情報を取得し、インテントに渡す方法を説明しています。

transitionIntent.putExtra("display_name", result.getLineProfile().getDisplayName());
transitionIntent.putExtra("status_message", result.getLineProfile().getStatusMessage());
transitionIntent.putExtra("user_id", result.getLineProfile().getUserId());
transitionIntent.putExtra("picture_url", result.getLineProfile().getPictureUrl().toString());

ユーザーIDは各プロバイダーに対してのみ一意です。1人のLINEユーザーは、プロバイダーごとに異なるユーザーIDを持ちます。ユーザーIDでは、異なるプロバイダーを横断してユーザーを識別できません。

ユーザー情報をバックエンドサーバーで利用する

通常、バックエンドサーバーでユーザーを識別するために、ユーザーIDや表示名のような、ユーザーのLINEアカウントに登録されている情報を使用します。そのような情報をアプリからバックエンドサーバーに送信する際は、情報を平文で送信するのではなく、アプリで取得したアクセストークンを送信してください。信頼できる情報を安全に送受信するために、アクセストークンを利用してください。バックエンドサーバーでアクセストークンの正当性を検証したり、ユーザー情報をLINEプラットフォームのサーバーから取得したりできます。

アクセストークンの取得方法について詳しくは、「アクセストークンを取得する」を参照してください。

バックエンドサーバーで利用するAPIについては、以下を参照してください。

• アクセストークンの有効性を検証する
• ユーザープロフィールを取得する

LineApiClientインターフェイスを使用する

LineApiClientインターフェイスのメソッドを呼び出して、SDKを使用します。これを行うには、lineApiClientのスタティック変数を作成して初期化する必要があります。

1. さまざまなメソッドを呼び出すオブジェクトのスタティック変数を作成します。
   java

   private static LineApiClient lineApiClient;
   

2. アクティビティのonCreate()メソッドで、lineApiClient変数を以下のとおりに初期化します。初期化にはチャネルIDとコンテキストが必要です。
   java

   LineApiClientBuilder apiClientBuilder = new LineApiClientBuilder(getApplicationContext(), "your channel id here");
   lineApiClient = apiClientBuilder.build();