Android アプリリンクを追加する

Android アプリリンクは、ユーザーを Android アプリの特定のコンテンツに直接誘導する HTTP URL です。Android アプリリンクはアプリへのトラフィックを増やし、よく使用されているコンテンツを把握するのに役立ちます。ユーザーにとっては、インストールしたアプリ内のコンテンツを共有したり、見つけたりするのが簡単になります。

Android アプリリンクのサポートを追加する方法は次のとおりです。

マニフェストでインテントフィルタを作成します。
アプリへのリンクを処理するコードをアプリのアクティビティに追加します。
デジタルアセットリンクを使ってアプリとウェブサイトを関連付けます。

後述のように、Android Studio 2.3 以降のアプリリンクアシスタントは、手順を追ったウィザードでこのプロセスを簡素化したものです。

アプリリンクの仕組みとメリットについて詳しくは、Android アプリリンクの処理をご覧ください。

インテントフィルタを追加する

Android Studio のアプリリンクアシスタントでは、マニフェスト内にインテントフィルタを作成し、ウェブサイトの既存の URL をアプリのアクティビティにマッピングすることができます。また、アプリリンクアシスタントでは、インテントを処理するために、対応する各アクティビティにテンプレートの Java コードを追加することもできます。

インテントフィルタと URL の処理を追加する方法は次のとおりです。

[Tools] > [App Links Assistant] を選択します。
[Open URL Mapping Editor] をクリックし、[URL Mapping] リストの下部にある [Add] をクリックして、新しい URL マッピングを追加します。
新しい URL マッピングの詳細を追加します。

図 1. サイトのリンク構造についての詳細を追加し、URL をアプリ内のアクティビティにマッピングします。
1. [Host] 欄にウェブサイトの URL を入力します。
2. マッピングする URL の path、pathPrefix、または pathPattern を追加します。たとえば、レシピ共有アプリで、すべてのレシピを同じアクティビティで提供しており、対応するウェブサイトのレシピがすべて同じ /recipe ディレクトリ内にある場合は、pathPrefix を使って /recipe と入力します。このようにすると、http://www.recipe-app.com/recipe/grilled-potato-salad という URL は次の手順で選択するアクティビティにマッピングされます。
3. [Activity] で、URL のユーザーの誘導先となるアクティビティを選択します。
4. [OK] をクリックします。
アプリリンクアシスタントで、URL マッピングに基づいてインテントフィルタが AndroidManifest.xml ファイルに追加され、[Preview] 欄でハイライト表示されます。変更を加える場合は、[Open AndroidManifest.xml] をクリックしてインテントフィルタを編集します（詳しくは、Android のインテントフィルタに関する説明をご覧ください）。
注: アプリを更新せずにさらにリンクをサポートするには、今後追加する予定のある URL に対応した URL マッピングを定義する必要があります。また、検索結果の対象となるように、アプリのホーム画面の URL も必ず含めてください。
URL マッピングが適切に機能するかどうか確認するには、[Check URL Mapping] 欄に URL を入力し、[Check Mapping] をクリックします。適切に機能する場合は、入力した URL が選択したアクティビティにマッピングされていることを示す成功のメッセージが表示されます。

アプリへのリンクを処理する

URL マッピングが適切に機能することを確認したら、作成したインテントを処理するロジックを追加します。

アプリリンクアシスタントで [Select Activity] をクリックします。
リストからアクティビティを選択し、[Insert Code] をクリックします。

アプリリンクアシスタントで、アクティビティの Java ファイルに次のようなコードが追加されます（注: 現在、アプリリンクアシスタントは Kotlin をサポートしていないため、このコードを手動で追加する必要があります）。

Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val appLinkIntent = intent
        val appLinkAction = appLinkIntent.action
        val appLinkData = appLinkIntent.data

    }

Java

    // ATTENTION: This was auto-generated to handle app links.
    Intent appLinkIntent = getIntent();
    String appLinkAction = appLinkIntent.getAction();
    Uri appLinkData = appLinkIntent.getData();

ただし、このコードはそのままでは十分ではありません。appLinkData の URI に基づいて、対応するコンテンツを表示するなどの処理を行う必要があります。たとえば、レシピ共有アプリの場合は、次のサンプルのようなコードになります。

Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
        handleIntent(intent)
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        handleIntent(intent)
    }

    private fun handleIntent(intent: Intent) {
        val appLinkAction = intent.action
        val appLinkData: Uri? = intent.data
        if (Intent.ACTION_VIEW == appLinkAction) {
            appLinkData?.lastPathSegment?.also { recipeId ->
                Uri.parse("content://com.recipe_app/recipe/")
                        .buildUpon()
                        .appendPath(recipeId)
                        .build().also { appData ->
                            showRecipe(appData)
                        }
            }
        }
    }

Java

    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      ...
      handleIntent(getIntent());
    }

    protected void onNewIntent(Intent intent) {
      super.onNewIntent(intent);
      handleIntent(intent);
    }

    private void handleIntent(Intent intent) {
        String appLinkAction = intent.getAction();
        Uri appLinkData = intent.getData();
        if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){
            String recipeId = appLinkData.getLastPathSegment();
            Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon()
                .appendPath(recipeId).build();
            showRecipe(appData);
        }
    }

アプリをウェブサイトに関連付ける

アプリに対する URL のサポートを設定すると、アプリリンクアシスタントではデジタルアセットリンクファイルが生成されます。このファイルを使ってウェブサイトをアプリに関連付けることができます。

デジタルアセットリンクファイルを使用する代わりに、Search Console でサイトとアプリを関連付けることもできます。

アプリリンクアシスタントを使ってアプリとウェブサイトを関連付けるには、アプリリンクアシスタントから [Open Digital Asset Links File Generator] をクリックし、次の手順に沿って進めます。

図 2. サイトとアプリに関する詳細を入力し、デジタルアセットリンクファイルを生成します。

サイトのドメインとアプリケーション ID を入力します。
デジタルアセットリンクファイルに Smart Lock for Passwords のサポートを含めるには、[Support sharing credentials between the app and the website] を選択し、サイトのログイン URL を入力します。これにより、デジタルアセットリンクファイルに delegate_permission/common.get_login_creds という文字列が追加され、アプリとウェブサイトでログイン認証情報を共有することが宣言されます。詳しくは、アプリで Smart Lock for Passwords をサポートする方法についてご確認ください。
署名設定を指定するか、キーストアファイルを選択します。アプリのリリースビルドかデバッグビルド用に正しい設定またはキーストアファイルを選択してください。実稼働向けビルドを設定する場合は、リリース設定を使用します。ビルドをテストする場合は、デバッグ設定を使用します。
[Generate Digital Asset Links file] をクリックします。
Android Studio でファイルが生成されたら、[Save file] をクリックしてファイルをダウンロードします。
assetlinks.json ファイルをサイトにアップロードします（https://<yoursite>/.well-known/assetlinks.json）。その際、すべてのユーザーに読み取りアクセスを許可します。
重要: デジタルアセットリンクファイルは暗号化された HTTPS プロトコルを介して検証されます。アプリのインテントフィルタに https が含まれているかどうかに関係なく、assetlinks.json ファイルが HTTPS 接続でアクセス可能であることを確認してください。
[Link and Verify] をクリックし、正しいデジタルアセットリンクファイルを正しい場所にアップロードしたことを確認します。

デジタルアセットリンクファイルを通じてウェブサイトをアプリと関連付ける方法について詳しくは、ウェブサイトの関連付けを宣言するをご覧ください。

アプリリンクをテストする

リンクから正しいアクティビティが開かれることを確認する手順は次のとおりです。

アプリリンクアシスタントで [Test App Links] をクリックします。
テストする URL を [URL] 欄に入力します（例: http://recipe-app.com/recipe/grilled-potato-salad）。

図 3. テスト対象の URL がアプリ内のアクティビティに正常にマッピングされている場合、アプリリンクアシスタントには成功のメッセージが表示され、アプリが開いて指定されたコンテンツが表示されます。

[Run Test] をクリックします。
URL マッピングが適切に設定されていないか存在しない場合は、[Test App Links] ウィンドウで URL の下にエラーメッセージが表示されます。URL マッピングが存在する場合は、曖昧さ回避のダイアログ（アプリ選択ツール）は表示されずに、デバイスまたはエミュレータでアプリの指定されたアクティビティが開きます。[App Link Testing] ウィンドウには成功のメッセージが表示されます。アプリを正常に起動できない場合は、Android Studio の [Run] ウィンドウにエラーメッセージが表示されます。

アプリリンクアシスタントから Android アプリリンクをテストするには、Android 6.0（API レベル 23）以降を実行するデバイスを接続するか、仮想デバイスを用意する必要があります。詳しくは、デバイスを接続する方法または AVD を作成する方法をご覧ください。

Firebase App Indexing を追加する

Android アプリリンクをアプリに追加すると、Firebase App Indexing のコードをアクティビティに追加して、Google 検索の追加機能（オートコンプリートの候補やアプリ内検索など）からアプリへの再アクセスを促すことができます。詳しくは、Firebase App Indexing のドキュメントで Firebase App Indexing についての説明をご覧ください。

Firebase App Indexing をアプリに追加するには、Android Studio で Firebase Assistant を使用して [App Indexing] セクションを展開し、手順に沿って操作します。

Android アプリリンクを追加する

インテント フィルタを追加する

アプリへのリンクを処理する

Kotlin

Java

Kotlin

Java

アプリをウェブサイトに関連付ける

アプリリンクをテストする

Firebase App Indexing を追加する

インテントフィルタを追加する