Dynamic Links からアプリリンクとユニバーサルリンクに移行する

この移行ガイドでは、アプリリンクとユニバーサルリンクを使用する方法を説明し、必要に応じて Firebase Hosting を使用してアプリサイトの関連ファイルをホストします。

この移行は、次の Firebase Dynamic Links 機能を置き換えるものです。

機能	Firebase Dynamic Links	アプリリンク / ユニバーサルリンク
リンクを 1 回クリックするだけで、ユーザーをデバイスに合ったストアに誘導する		^★
遅延ディープリンクを使用して、アプリをダウンロードしインストールした後、ユーザーにプロセスの継続を提供する		^★
アプリ内のディープリンクコンテンツを利用し、ユーザーにコンテクスト体験を提供する（すでにインストールされている場合）
ダイナミックリンクのクリックイベントに関連する分析データを提供する
短縮リンク URL を作成する機能を提供する

このガイドでサポートされていない移行に関する他の Firebase Dynamic Links 機能を引き続き使用する必要がある場合は、Dynamic Links の非推奨に関するよくある質問ドキュメントの他の移行シナリオをご覧ください。

次のような Firebase Dynamic Links があるとします。

ダイナミックリンクの例
リンク名	Example.com へようこそ
ディープリンク	`https://example.web.app/welcome`
Android アプリ	`com.example.android`
Apple アプリ	`com.example.ios`
長いダイナミックリンク	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
短いダイナミックリンク	`https://example.page.link/m9Mm`

この移行ガイドの目的は、Firebase Dynamic Links を次のように置き換えることです。

https://example.page.link/m9Mm

置き換え後は、次のようなアプリリンク / ユニバーサルリンクになります。

https://your-project-domain.web.app/welcome

アプリリンク / ユニバーサルリンクのディープリンクでは、ユーザーに次のものが提供されます。

アプリがインストール済みの場合にアプリを開くためにクリックできるディープリンク
続きのユーザージャーニー（アプリを開いたときにアプリの特定部分に移動）

ただし、アプリリンク / ユニバーサルリンクのディープリンクでは、（Firebase Dynamic Links が以前行っていた）ユーザーに対する次の動作は提供されません。

アプリをダウンロードとインストールを行うために、ユーザーをデバイスに合ったストアへ誘導する
初めてアプリを起動してインストールした後、ユーザージャーニーの続きを提供する

これらのアプリリンク / ユニバーサルリンクのの動作や機能は、上の表に示した Firebase Dynamic Links とは異なることに注意してください。

始める前に

Firebase Dynamic Links は、アプリのインストール後にディープリンク機能を提供するために、アプリリンク（Android の場合）とユニバーサルリンク（iOS の場合）を独自の基盤となる実装で利用します。

このガイドでは、Firebase Hosting を使用して独自のアプリリンクとユニバーサルリンクを作成し、Firebase Dynamic Links から新しいアプリリンク / ユニバーサルリンクの移行ソリューションに移行しながら、Firebase Dynamic Links の機能の一部を置き換える方法について説明します。

移行を完了するには、次の情報が必要です。

移行する Firebase Dynamic Links
ダイナミックリンクに含まれるディープリンク URL パラメータ
以前の Firebase Dynamic Links ドメインを置き換える際に使用するドメイン（該当するドメインがある場合）

Dynamic Links メタデータのエクスポートガイドは、既存のリンクメタデータをエクスポートし、上記の情報を取得するために使用します。

移行手順の概要

Firebase Hosting を使用して、アプリリンク / ユニバーサルリンク構成ファイルをホストする新しいドメイン（まだ使用していない場合）をプロビジョニングします。
アプリリンク / ユニバーサルリンクの構成ファイルを作成してホスティングドメインでホストします。
Firebase Dynamic Links で使用されるディープリンクスキーマに一致する新しいアプリリンク / ユニバーサルリンクを作成します。
ディープリンクを受け取るために、Android / iOS アプリとアプリコードを更新します。
アプリリンクとユニバーサルリンクのインテグレーションをテストします。
公開または共有する Firebase Dynamic Links をアプリリンクとユニバーサルリンクに置き換えます。

最初の手順は、アプリリンクとユニバーサルリンクの両方の移行フローで共通です。残りの内容はプラットフォームによって異なるため、最初に移行するプラットフォームに応じて、以下のガイドの該当するセクションに進んでください。

Android アプリリンクの移行手順
iOS でのユニバーサルリンクの移行手順

新しいドメインをプロビジョニングして、Firebase Hosting を使用してアプリリンク / ユニバーサルリンクの構成ファイルをホストする

ドメインを選択する

まず、アプリリンク / ユニバーサルリンクに使用するドメインを選択します。このドメインは、ユーザーと共有する新しいリンクに使用されます。

Firebase Hosting を使用する場合、your-project-domain.web.app または your-project-domain.firebaseapp.com 形式のプロジェクトサブドメインは無料で自動的にプロビジョニングされます。Firebase Hosting の有無にかかわらず、必要に応じてカスタムドメインを使用してアプリリンク / ユニバーサルリンク構成ファイルをホストすることもできます。

Firebase Hosting の設定

次に、Firebase Hosting インスタンスをセットアップして設定する必要があります。

Firebase Hosting インスタンスの設定が完了すると、必要に応じて your-project-domain.web.app のようなドメイン、すなわちカスタムドメインが作成されています。

Android アプリリンクの移行手順

アプリリンクの構成ファイルを作成して新しいホスティングドメインでホストする

アプリリンクを使用するには、リンクで使用されるドメインとアプリの間に安全な関連付けを確立するための構成ファイルをホストする必要があります。アプリリンクの場合、これは assetlinks.json ファイルです。

assetlinks.json ファイルを作成してホストする手順

assetlinks.json ファイルを使用すると、App Links に使用するウェブドメインのコンテンツを扱える承認済みアプリのリストを提供できます。assetlinks.json ファイル自体は、ウェブドメインのルート（/.well-known）でホストする必要があります。

以下の手順に沿って構成を完了します。

Firebase Hosting ルートディレクトリの public フォルダの下に .well-known フォルダを作成します。
.well-known フォルダの下に assetlinks.json という名前のファイルを作成します。
以下の内容を、各フィールドの意味に注意して assetlinks.json ファイルにコピーします。
```
[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.android",
    "sha256_cert_fingerprints":
      ["01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF"]
  }
}]
```
- namespace - 提供するアプリケーションの名前。
- package_name - アプリの build.gradle ファイルで宣言されている applicationId を指します。
- sha256_cert_fingerprints - アプリの署名に使用するキーストアファイルの SHA256 フィンガープリントを指します。
Android Studio が使用する debug.keystore ファイルは、デバッグ目的で sha256_cert_fingerprints レコードを生成するために使用できます。このファイルは、Mac と Linux では /Users/<username>/.android/debug.keystore、Windows では C:\Users\<username>\.android\debug.keystore にあります。

keytool を使用してこのキーストアから SHA256 値を取得できます。

この方法の完全な手順については、アプリリンクに関するドキュメントのこちらのセクションをご覧ください。

別の方法としては、Android Studio の App Links Assistant を使用して assetlinks.json ファイルの内容を生成し、アプリリンクを処理するようにアプリを構成することもできます。

ホスティング用にファイルをインデックス化するために firebase.json ファイルを更新します。

"headers": [
  {
    "source": "/.well-known/assetlinks.json",
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ]
  }
]

assetlinks.json ファイルは用意したので、firebase deploy を実行して変更をホストします。

上記の deploy コマンドを実行するには、Firebase CLI をインストールする必要があります。
```
firebase deploy --only hosting
```
https://your-project-domain.web.app/.well-known/assetlinks.json にアクセスして assetlinks.json ファイルを確認します。

Firebase Dynamic Links で使用されるディープリンクスキーマに一致する新しいアプリリンクを作成する

このステップでは、アプリリンク用に作成した新しいドメインと一致する通常のディープリンク URL を使用して、Firebase Dynamic Links のディープリンクを再作成します。

たとえば、次の Firebase Dynamic Linksがあるとします。

ダイナミックリンクの例
リンク名	Example.com へようこそ
ディープリンク	`https://example.web.app/welcome`
Android アプリ	`com.example.android`
Apple アプリ	`com.example.ios`
長いダイナミックリンク	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
短いダイナミックリンク	`https://example.page.link/m9Mm`

この場合は、ディープリンクパラメータ（https://example.web.app/welcome）を抽出し、アプリのアプリリンクパラメータとして使用します。

注: Firebase Dynamic Links を最初に作成したときに、自分が所有していないドメイン（例: example.com/welcome）を使用するディープリンクパラメータを作成している可能性があります。Firebase Dynamic Links ではこれをサポートしていましたが、この移行では、使用する予定のディープリンクは、所有しており Firebase Hosting で構成したドメインを使用するように変更する必要があります。Firebase Dynamic Links で使用するディープリンク URL パラメータに、すでに所有しているドメインを使用すると、時間を大幅に節約でき、作成する必要がある受信アプリリンクを処理するようにアプリがすでに構成されている可能性があります。

アプリリンクやユニバーサルリンクを使用して、移行する Firebase Dynamic Links ごとにこのプロセスを繰り返し、使用したディープリンクスキーマを複製します。

たとえば、次の Firebase Dynamic Links のショートリンク、ディープリンクパラメータ、移行されたディープリンク値をご覧ください。

ショートリンク	ディープリンクパラメータ	移行済みのディープリンク
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

次に、移行済みの新しいディープリンクによって公開または共有された Firebase Dynamic Links のインスタンスを、ユーザーが以前の Firebase Dynamic Links ではなく、これらのアプリリンクをクリックできるように置き換える必要があります。

ディープリンクを受け取るために Android アプリとアプリコードを更新する

ドメインを選択してディープリンクスキーマを選択し、Firebase Dynamic Links をアプリリンクに移行した後は、Android アプリとアプリケーションコードを更新して新しいディープリンクを受け取ります。

ディープリンクを処理するようにアプリを構成する方法については、こちらのアプリリンクに関するドキュメントか、Android Studio ガイドに従うことをおすすめしますが、主な手順は次のとおりです。

それぞれのディープリンクを処理するアクティビティを特定する
そのアクティビティ用のインテントフィルタをAndroidManifest.xml ファイルに追加する
アクティビティのアプリケーションコードでディープリンクを受信する

たとえば、MainActivity を使用してディープリンクの一部を処理するとします。そのためには、AndroidManifest.xml ファイルの MainActivity に次のインテントフィルタを追加する必要があります。

<activity android:name=".MainActivity"
   android:exported="true">
   <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:host="example.web.app" android:scheme="http"
           android:pathPrefix="/welcome" />
       <data android:host="example.web.app" android:scheme="https"
           android:pathPrefix="/welcome" />
   </intent-filter>
</activity>

このステップでは、wxample.web.app ドメインからのディープリンクの処理先として /welcome パスプレフィックスを含む MainActivity を指定します。また、android:autoVerify="true" 属性も指定する必要があります。これにより、アプリをこの特定の種類のリンクのデフォルトハンドラに指定できます。

最後に、MainActivity にコードを追加してディープリンクデータを取得し、それを使用してアプリのディープリンクエクスペリエンスを推進する必要があります。これは、Firebase Dynamic Links と統合したときにアプリ内ですでにコーディングされているロジックに似ています。

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)

  val  data: Uri? = intent?.data

  val toast = Toast.makeText(this, data, duration)
  toast.show()
}

アプリリンクのテスト

作成したアプリリンクは、アプリを実機または Android Emulator で実行することによりテストできます。

アプリリンク用に構成したドメインを使用してクリック可能なリンクを作成し、そのリンクをクリックして、それがアプリで開かれ、目的のアクティビティに移動することを確認します。

別の方法としては、Android Studio のアプリリンクアシスタントを使ってアプリリンクのインテグレーションをテストすることもできます。すなわち、アプリリンク URL に次のコマンドを使用し、それが一致するアクティビティを正しく起動することを確認します。

adb shell am start -a android.intent.action.VIEW -d <your_deep_link_url>

公開または共有する Firebase Dynamic Links をアプリリンクに置き換える

移行の最終ステップは、公開または共有する Firebase Dynamic Links を可能な限りアプリリンクに置き換え、その後もアプリリンクを使用し続けることです。

この手順は Firebase Dynamic Links を公開する場所と方法によって異なりますが、どのリンクが存在するのかを追跡できるように、既存の Firebase Dynamic Links メタデータをエクスポートすることができます。Dynamic Links メタデータのエクスポートガイドをご覧ください。

iOS でのユニバーサルリンクの移行手順

新しいホスティングドメインでユニバーサルリンク構成ファイルを作成しホストする

ユニバーサルリンクを使用するには、リンクで使用されるドメインとアプリの間に安全な関連付けを確立するための構成ファイルをホストする必要があります。ユニバーサルリンクの場合、これは apple-app-site-association ファイル（AASA ファイルとも呼ばれます）です。

apple-app-site-association ファイルを作成してホストする手順

AASA ファイルを使用すると、ユニバーサルリンクに使用するウェブドメインのコンテンツを扱える承認済みアプリのリストを提供できます。AASA ファイル自体は、ウェブドメインのルート（/.well-known）でホストする必要があります。

以下の手順に沿って構成を完了します。

Firebase Hosting ルートディレクトリの public フォルダに「.well-known」フォルダを作成します。
「.well-known」フォルダに「apple-app-site-associationapple-app-site-association」という名前のファイルを作成します。
次の内容を、各フィールドの意味に注意して apple-app-site-association ファイルにコピーします。
```
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appId": "$TEAM_ID.com.firebase.UniversalLinks",
        "paths": [
          "NOT /_/*",
          "/*"
        ]
      }
    ]
  }
}
```
- $TEAM_ID.BundleId - リンクを処理する権限を持つアプリケーションの完全修飾名

ホスティング用にファイルをインデックス化するために firebase.json ファイルを更新します。

"headers": [
  {
    "source": "/.well-known/apple-app-site-association",
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ]
  }
]

AASA ファイルが用意できたので、変更をホストするように firebase deploy を行います。
https://your-project-domain.web.app/.well-known/app-app-site-association にアクセスして、AASA ファイルを確認します。

Firebase Dynamic Links で使用されるディープリンクスキーマに一致する新しいユニバーサルリンクを作成する

このステップでは、ユニバーサルリンク用に作成した新しいドメインと一致する通常のディープリンク URL を使用して、Firebase Dynamic Links のディープリンクを再作成します。

たとえば、次の Firebase Dynamic Linksがあるとします。

ダイナミックリンクの例
リンク名	Example.com へようこそ
ディープリンク	`https://example.web.app/welcome`
Android アプリ	`com.example.android`
Apple アプリ	`com.example.ios`
長いダイナミックリンク	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
短いダイナミックリンク	`https://example.page.link/m9Mm`

この場合は、ディープリンクパラメータ（https://example.web.app/welcome）を抽出し、アプリのユニバーサルリンクパラメータとして使用します。

注: Firebase Dynamic Links を最初に作成したときに、自分が所有していないドメイン（例: example.com/welcome）を使用するディープリンクパラメータを作成している可能性があります。Firebase Dynamic Links ではこれをサポートしていましたが、この移行では、使用する予定のディープリンクは、所有しており Firebase Hosting で構成したドメインを使用するように変更する必要があります。Firebase Dynamic Links で使用するディープリンク URL パラメータに、すでに所有しているドメインを使用すると、時間を大幅に節約でき、作成する必要がある受信ユニバーサルリンクを処理するようにアプリがすでに構成されている可能性があります。

たとえば、次の Firebase Dynamic Links のショートリンク、ディープリンクパラメータ、移行されたディープリンク値をご覧ください。

ショートリンク	ディープリンクパラメータ	移行済みのディープリンク
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

次に、移行済みの新しいディープリンクによって公開または共有された Firebase Dynamic Links のインスタンスを、ユーザーが以前の Firebase Dynamic Links ではなく、これらのユニバーサルリンクをクリックできるように置き換える必要があります。

ディープリンクを受け取るために iOS アプリとアプリコードを更新する

ドメインを選択してディープリンクスキーマを選択し、Firebase Dynamic Links をユニバーサルリンクに移行した後は、iOS アプリとアプリケーションコードを更新して新しいディープリンクを受け取ります。

ディープリンクを処理するためのアプリの設定については、こちらのユニバーサルリンクに関するドキュメントの全文を確認することをおすすめしますが、主な手順は以下のとおりです。

プロジェクト構成を更新して、新しく作成したドメインのディープリンクをアプリが処理できるようにします。
アプリケーションコードでディープリンクを受け取る

プロジェクト構成を更新してアプリがディープリンクを処理できるようにするには、apple-app-site-associate ファイルをホストするために使用する予定のドメインの xCode で、関連するドメインをドメインに追加する必要があります。

これは、次のように行います。

Xcode を開く
ファイルナビゲータでプロジェクトを選択する
プロジェクト設定の [Signing & Capabilities] タブに移動する
[関連ドメイン] セクションまで下に移動する
[+] ボタンをクリックして、「applinks:」の形式でプロジェクトにドメインを追加する

最後に、受信ディープリンクを受け取ることができるようにアプリケーションコードを更新する必要があります。

これを行うには、まず、ユニバーサルリンクに応答するように次のコードを追加することで、AppDelegate.swift ファイルを更新します。

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  AppDelegate.showReceivedUrl(userActivity: userActivity);
  return true
}

static func showReceivedUrl(userActivity: NSUserActivity) {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    print(url.absoluteString)
}

上記のコードは、ユニバーサルリンクのコールバックメソッドをオーバーライドし、ディープリンク URL（存在する場合）をログに記録します。

ユーザーがユニバーサルリンクをクリックした時点ですでにアプリが開いている場合、SceneDelegate 内のユニバーサルリンクコールバックが呼び出されるため、SceneDelegate クラスからも同じ showReceivedUrl メソッドを呼び出します。

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

ユニバーサルリンクのテスト

作成したユニバーサルリンクは、アプリを実機またはシミュレータで実行することによりテストできます。

ユニバーサルリンク用に構成したドメインを使用してクリック可能なリンクを作成し、そのリンクをクリックして、それがアプリで開かれ、目的の画面に移動することを確認します。

スマートアプリバナーのサポート

ユーザーに Firebase Dynamic Links と同様のエクスペリエンスを提供する方法として、スマートアプリバナーの使用を強くおすすめします。

スマートアプリバナーを使用すると、アプリがまだデバイスにインストールされていない場合、ユーザーは App Store にリダイレクトされ、そこでアプリの一覧が表示されます。また、オプションとして、アプリがダウンロードされインストールされた後にアプリに渡すパラメータを構成して、ユーザージャーニーの続きをユーザーに提供することもできます。アプリがすでにインストールされている場合は、このパラメータをアプリに渡すことでアプリが開き、ユーザーがクリックしたスマートアプリバナーに基づいて適切なコンテンツに移動できるようになります。

公開または共有する Firebase Dynamic Links をアプリリンクに置き換える

移行の最終ステップは、公開または共有する Firebase Dynamic Links を可能な限りユニバーサルリンクに置き換え、その後もユニバーサルリンクを使用し続けることです。

このステップは、Firebase Dynamic Links を公開する場所と方法によって異なります。

既存の Firebase Dynamic Links の移行を追跡できるように、Firebase Dynamic Links の短縮リンクメタデータをエクスポートする方法に関するガイドを公開する予定です。詳細については、Dynamic Links の非推奨に関するよくある質問のドキュメントをご覧ください。

Dynamic Links からアプリリンクとユニバーサル リンクに移行する

始める前に

移行手順の概要

新しいドメインをプロビジョニングして、Firebase Hosting を使用してアプリリンク / ユニバーサル リンクの構成ファイルをホストする

ドメインを選択する

Firebase Hosting の設定

Android アプリリンクの移行手順

アプリリンクの構成ファイルを作成して新しいホスティング ドメインでホストする

assetlinks.json ファイルを作成してホストする手順

Firebase Dynamic Links で使用されるディープリンク スキーマに一致する新しいアプリリンクを作成する

ディープリンクを受け取るために Android アプリとアプリコードを更新する

アプリリンクのテスト

公開または共有する Firebase Dynamic Links をアプリリンクに置き換える

iOS でのユニバーサル リンクの移行手順

新しいホスティング ドメインでユニバーサル リンク構成ファイルを作成しホストする

apple-app-site-association ファイルを作成してホストする手順

Firebase Dynamic Links で使用されるディープリンク スキーマに一致する新しいユニバーサル リンクを作成する

ディープリンクを受け取るために iOS アプリとアプリコードを更新する

ユニバーサル リンクのテスト

スマートアプリ バナーのサポート

公開または共有する Firebase Dynamic Links をアプリリンクに置き換える

Dynamic Links からアプリリンクとユニバーサルリンクに移行する

新しいドメインをプロビジョニングして、Firebase Hosting を使用してアプリリンク / ユニバーサルリンクの構成ファイルをホストする

アプリリンクの構成ファイルを作成して新しいホスティングドメインでホストする

Firebase Dynamic Links で使用されるディープリンクスキーマに一致する新しいアプリリンクを作成する

iOS でのユニバーサルリンクの移行手順

新しいホスティングドメインでユニバーサルリンク構成ファイルを作成しホストする

Firebase Dynamic Links で使用されるディープリンクスキーマに一致する新しいユニバーサルリンクを作成する

ユニバーサルリンクのテスト

スマートアプリバナーのサポート