バージョン: v9

ユニバーサルリンクとアプリリンクによるディープリンク

プラットフォーム: iOS, Android

ユニバーサルリンク（iOS）とアプリリンク（Android）は、ユーザーをネイティブアプリ内の特定のコンテンツに直接誘導する機能を提供します（一般的にはディープリンクとして知られています）。

ユーザーがディープリンクをタップまたはクリックすると、デバイスの Web ブラウザや Web サイトを経由せずに、ユーザーは直接アプリに移動します。アプリがインストールされていない場合は、ユーザーはウェブサイトに誘導されます。ユーザーが Web サイトに直接移動した場合、ユーザーは Web サイトに留まります。このように、ディープリンクは、ウェブ、iOS、Android 向けに構築されたクロスプラットフォームのアプリにとって、優れた機能となっています。

メリット

安全。ユニバーサル/アプリリンクでは、HTTPS URL を使用してお客様が所有するウェブサイトのドメインにリンクするため、他のアプリがお客様のリンクを使用できないことが保証されます。
シームレスな体験。1 つの URL がウェブサイトとアプリの両方で機能するため、ユーザーはエラーなく目的のコンテンツに正常にアクセスできます。
エンゲージメントの向上。リンクは、メールクライアントや検索エンジンの検索結果などから開くことができます。

デモビデオ

ここでは、実際にどのように見えるかを説明します。この例では、ユーザーはネイティブアプリをインストールしています。メールに記載されたアプリのリンクをタップすると、アプリ自体に直接アクセスできます。まず、ルートリンクをタップすると（https://beerswift.app）、アプリのメインページに移動します。次に、ディープリンクをタップすると（https://beerswift.app/tabs/tab3）、Tab3のページが表示されます。

前提条件

設定済みの Capacitor app があること。
iOS の場合、Apple Developer Program に登録していること。

例示のため、ウェブアプリのリンクとして https://beerswift.app を使用します。

Capacitor App API によるディープリンクルーティング

ディープリンクがクリックされた後にネイティブアプリが開かれた場合、モバイル OS は自動的にユーザーをどこに誘導すればよいかを知りません。これは、アプリの起動時に Capacitor App API を使用して、アプリ自体に実装する必要があります。

Web サイトとアプリのパスが一致しない場合は、より高度な URL パターンマッチングを実装する必要があります（例は本ガイドを参照）。モバイルアプリとウェブアプリが同じコードベースを使用している場合は、同じ URL にリダイレクトするだけなので、非常に簡単です。以下の例はこれを前提としています。

Angular

ルーティングはapp.component.tsで実装する必要があります。まず、AngularからNgZoneとRouterをインポートし、次にCapacitorからAppをインポートします：

import { Component, NgZone } from '@angular/core';
import { Router } from '@angular/router';
import { App, URLOpenListenerEvent } from '@capacitor/app';

次に、コンストラクタにRouterとNgZoneを追加します：

constructor(private router: Router, private zone: NgZone) {
    this.initializeApp();
}

最後に、appUrlOpenイベントをリッスンし、ディープリンクが見つかったときにリダイレクトします：

initializeApp() {
    App.addListener('appUrlOpen', (event: URLOpenListenerEvent) => {
        this.zone.run(() => {
            // Example url: https://beerswift.app/tabs/tab2
            // slug = /tabs/tab2
            const slug = event.url.split(".app").pop();
            if (slug) {
                this.router.navigateByUrl(slug);
            }
            // If no match, do nothing - let regular routing
            // logic take over
        });
    });
}

React

Reactにはさまざまなオプションがあります。1つのアプローチは、App APIリスナー機能を新しいコンポーネントにラップし、App.tsx内に追加することです。まずAppUrlListener.tsxを作成し、次にReact RouterのuseHistoryフックとCapacitor App APIをインポートします：

import React, { useEffect } from 'react';
import { useHistory } from 'react-router-dom';
import { App, URLOpenListenerEvent } from '@capacitor/app';

次に、AppUrlListenerコンポーネントを定義し、appUrlOpenイベントをリッスンして、ディープリンクが見つかったときにリダイレクトします：

const AppUrlListener: React.FC<any> = () => {
  let history = useHistory();
  useEffect(() => {
    App.addListener('appUrlOpen', (event: URLOpenListenerEvent) => {
      // Example url: https://beerswift.app/tabs/tab2
      // slug = /tabs/tab2
      const slug = event.url.split('.app').pop();
      if (slug) {
        history.push(slug);
      }
      // If no match, do nothing - let regular routing
      // logic take over
    });
  }, []);

  return null;
};

export default AppUrlListener;

App.tsxで、新しいコンポーネントをインポートします：

import AppUrlListener from './pages/AppUrlListener';

次に、IonReactRouter内（またはアプリがブートストラップされる場所、Historyフックが利用可能であることを確認してください）に追加します：

const App: React.FC = () => {
  return (
    <IonApp>
      <IonReactRouter>
        <AppUrlListener></AppUrlListener>
        <IonRouterOutlet>
          <Route path="/home" component={Home} exact={true} />
          <Route exact path="/" render={() => <Redirect to="/home" />} />
        </IonRouterOutlet>
      </IonReactRouter>
    </IonApp>
  );
};

Vue

VueJSは、Vueにネイティブに統合されるVue Routerと呼ばれるファーストパーティのルーティングシステムを提供しています。Vue Routerでディープリンクを設定するには、すべてのルートを設定するために使用したファイル（通常はroutes.jsまたは類似のファイル）から始めます。

まず、VueとVueRouterと一緒に、プラグインからCapacitorのAppをインポートします。

import { App, URLOpenListenerEvent } from '@capacitor/app';
import Vue from 'vue';
import VueRouter from 'vue-router';

次に、Vue Routerを使用してルートを設定します（詳細はVue Routerの入門を参照）。

const router = new VueRouter({
  routes: [],
});

#を扱う必要がないように、mode: historyを使用することをお勧めします。

Vue RouterをVueに登録し、使用していることをVueに伝えます：

const VueApp = new Vue({
  router,
}).$mount('#app');

最後に、ディープリンク用にアプリを登録する必要があります。そのためには、Capacitor AppのappUrlOpenイベントにイベントリスナーを追加します。Capacitorがこれを検出し、Vue Routerに渡して要求されたページにナビゲートします。

App.addListener('appUrlOpen', function (event: URLOpenListenerEvent) {
  // Example url: https://beerswift.app/tabs/tabs2
  // slug = /tabs/tabs2
  const slug = event.url.split('.app').pop();

  // We only push to the route if there is a slug present
  if (slug) {
    router.push({
      path: slug,
    });
  }
});

サイトアソシエーションファイルの作成

AppleとGoogleがディープリンクでアプリを開くことを許可するためには、Webサイトとアプリの間に双方向の関連付けを作成する必要があります。それぞれ1つのファイルを作成し、ウェブサイトの .well-known フォルダ内に、https://beerswift.app/.well-known/ のように配置する必要があります。

iOSとAndroidの設定の詳細については、こちらをご覧ください。

iOSの設定

iOS の設定には、サイトアソシエーションファイルの作成と、ネイティブアプリがアプリドメインを認識するための設定が含まれます。

Apple Developer Program に登録されている必要があります。

サイトアソシエーションファイルの作成

まず、Apple Developer siteにログインします。Certificates, Identifiers, & Profiles」セクションに移動し、アプリの識別子を選択します。Team IDとBundle IDをメモし、Capabilitiesで "Associated Domains "をトグルし、保存します。

iOS Identifier Config

次に、サイトアソシエーションファイル（apple-app-site-association）を作成します。

注意: JSONファイルであるにもかかわらず、拡張子を付けて保存しないでください。

以下に、apple-app-site-associationファイルの例を示します。TEAMID.BUNDLEIDは必ず自分の ID に置き換えてください（例:8L65AZE66A.com.netkosoft.beerswift` ）。

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAMID.BUNDLEID",
        "paths": ["*"]
      }
    ]
  }
}

次に、ファイルをあなたのウェブサイト（HTTPSでホストされている）にアップロードし、Appleのツールこちらを使って正しく設定されていることを確認します。URLは次のような形式である必要があります: https://beerswift.app/.well-known/apple-app-site-association

Androidの設定

Android では、サイトアソシエーションファイルの作成と、ネイティブアプリがインテントフィルタを使用してアプリリンクを認識するように設定します。

サイトアソシエーションファイルの作成

サイトアソシエーションファイルには、Android の証明書の SHA256 フィンガープリントが必要です。

持っていない場合は、証明書を作成します:

keytool -genkey -v -keystore KEY-NAME.keystore -alias ALIAS -keyalg RSA -keysize 2048 -validity 10000

既存の（または新しく作成した）鍵ストア証明書を使用して、keytoolコマンドを使用して鍵ストアの詳細を一覧表示します。

keytool -list -v -keystore my-release-key.keystore

SHA256フィンガープリントが出力されます。

Keytool output

次に、Googleの Asset Links tool を使用して、Site Associationファイルを作成します。ウェブサイトのドメイン、アプリのパッケージ名、SHA256フィンガープリントを記入し、[Generate statement]をクリックします。

Android Identifier Config

JSON出力を .well-known/assetlinks.json の下にある新しいローカルファイルにコピーします。

// assetlinks.json
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.netkosoft.beerswift",
      "sha256_cert_fingerprints": ["43:12:D4:27:D7:C4:14..."]
    }
  }
]

ファイルをウェブサイト（HTTPSでホストされている）にデプロイし、Asset Linkツールの "Test statement "ボタンをクリックして検証します。正しく設定されていれば、Successメッセージが表示されます。

Success! Host [website] grants app deep linking to [app package].

インテント・フィルタの追加

最後のステップは、着信リンクを認識するようにAndroidアプリを設定することです。そのためには、AndroidManifest.xml の <activity> 要素内に add a new Intent Filter を追加します。

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="beerswift.app" />
</intent-filter>

Activityの完成形は以下のような感じです。

<activity
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale"
    android:name="com.netkosoft.beerswift.MainActivity"
    android:label="@string/title_activity_main"
    android:theme="@style/AppTheme.NoActionBarLaunch"
    android:launchMode="singleTask">

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https" android:host="beerswift.app" />
    </intent-filter>
</activity>

ウェブサイトの構成

ウェブサイトの構成は、使用するツールやバックエンドによって異なります。いくつかの提案は以下の通りです。

Angular

関連ファイルを src/.well-known の下に配置します。次に、これらのファイルをそのままデプロイするようにビルドプロセスを設定します（Apple/Googleが正しく読めることを保証します）。angular.json を開き、architect => assets の下に、新しいエントリーを配列に追加する。

{
  "glob": "**/*",
  "input": "src/.well-known",
  "output": ".well-known/"
}

サイトをビルドしてデプロイします。

NuxtJS

関連ファイルを static/.well-known 配下に配置します。追加手順は必要なく、サイトをビルドしてデプロイするだけです。

React

関連ファイルを public/.well-known 配下に配置します。追加の手順は必要なく、単にサイトをビルドしてデプロイするだけです。

WordPress

WordPressの手順については、こちらを参照してください。

検証

ウェブサイトとネイティブアプリが正しく設定されていることを確認するために、ウェブサイトはサイトアソシエーションファイルをホストする必要がありますが、アプリはアプリストアに存在する必要はありません。

デバイスをコンピューターに接続し、ネイティブアプリをビルドしてデプロイし、Webサイトのリンクをタップしてテストします。ネイティブアプリが開けば、すべての手順が正しく実装されています。

リソース

Branch.io: What is Deep Linking?
Android: App Links
iOS: Universal Links
iOS: Supporting Universal Links in Your App

ユニバーサルリンクとアプリリンクによるディープリンク

デモビデオ

前提条件

Capacitor App API によるディープリンクルーティング

Angular

React

Vue

サイトアソシエーションファイルの作成

iOSの設定

サイトアソシエーションファイルの作成

関連するドメインの追加

Androidの設定

サイトアソシエーションファイルの作成

インテント・フィルタの追加

ウェブサイトの構成

Angular

NuxtJS

React

WordPress

検証

リソース

Contents

デモビデオ​

前提条件​

Capacitor App API によるディープリンクルーティング​

Angular​

React​

Vue​

サイトアソシエーションファイルの作成​

iOSの設定​

サイトアソシエーションファイルの作成​

関連するドメインの追加​

Androidの設定​

サイトアソシエーションファイルの作成​

インテント・フィルタの追加​

ウェブサイトの構成​

Angular​

NuxtJS​

React​

WordPress​

検証​

リソース​

Contents

デモビデオ

前提条件

Capacitor App API によるディープリンクルーティング

Angular

React

Vue

サイトアソシエーションファイルの作成

iOSの設定

サイトアソシエーションファイルの作成

関連するドメインの追加

Androidの設定

サイトアソシエーションファイルの作成

インテント・フィルタの追加

ウェブサイトの構成

Angular

NuxtJS

React

WordPress

検証

リソース