Flutterアプリでダイナミックリンクを作成する

Firebase Dynamic Links Builder API を使用して、短いダイナミック リンクまたは長いダイナミック リンクを作成できます。この API は、長いダイナミック リンクまたはダイナミック リンク パラメータを含むオブジェクトのいずれかを受け入れ、次の例のような URL を返します。

https://example.com/link/WXYZ
https://example.page.link/WXYZ

Firebase と Dynamic Links SDK を設定する

Android アプリで Dynamic Links を作成する前に、Firebase SDK を含める必要があります。アプリが Dynamic Links を受信するように設定されている場合、これらの手順は既に完了しているため、このセクションをスキップできます。

1. Flutter 用の Firebase SDK をまだインストールしていない場合は、インストールして初期化します。

2. Flutter プロジェクトのルート ディレクトリから、次のコマンドを実行して Dynamic Links プラグインをインストールします。

   flutter pub add firebase_dynamic_links
   

3. Android アプリを構築している場合は、Firebase コンソールの [プロジェクト設定] ページを開き、SHA-1 署名キーを指定していることを確認してください。アプリ リンクを使用する場合は、SHA-256 キーも指定します。

4. Firebase コンソールで、 Dynamic Linksセクションを開きます。

   1. Dynamic Links のドメインをまだ設定していない場合は、[開始する] ボタンをクリックしてプロンプトに従います。

      Dynamic Links ドメインをすでにお持ちの場合は、メモしておいてください。プログラムで Dynamic Links を作成する場合は、Dynamic Links ドメインを指定する必要があります。

   2. 推奨: [その他] (⋮) メニューから、ディープ リンクとフォールバック リンクで許可される URL パターンを指定します。そうすることで、ドメインから管理していないサイトにリダイレクトする Dynamic Links を権限のない第三者が作成するのを防ぐことができます。

      特定の URL パターンを許可するを参照してください。

パラメータから動的リンクを作成する

ダイナミック リンクを作成するには、新しいDynamicLinkParametersオブジェクトを作成し、それをbuildLink()またはbuildShortLink()に渡します。

次の最小限の例では、Android ではcom.example.app.androidで、iOS ではアプリcom.example.app.iosで開くhttps://www.example.com/への長いダイナミック リンクを作成します。

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

短いダイナミック リンクを作成するには、DynamicLinkParameters オブジェクトをDynamicLinkParameters buildShortLink()に渡します。短縮リンクを構築するには、ネットワーク呼び出しが必要です。例えば：

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

デフォルトでは、数文字のサフィックスを持つ短いダイナミック リンクが生成されます。これによりリンクはよりコンパクトになりますが、誰かが有効な短いリンクを推測できる可能性も生じます。リンクは公開情報につながるため、多くの場合、誰かがそうしたとしても害はありません。

ただし、短いリンクがユーザー固有の情報につながる場合は、誰かが有効なダイナミック リンクを推測できる可能性が非常に低くなるように、17 文字のサフィックスを付けた長いリンクを作成する必要があります。これを行うには、 ShortDynamicLinkType.unguessableをbuildShortLink()メソッドに渡します。

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

動的リンク パラメータ

Dynamic Link Builder API を使用して、サポートされている任意のパラメーターを使用して Dynamic Links を作成できます。 API リファレンスを参照してください。

次の例では、いくつかの共通パラメーター セットを使用してダイナミック リンクを作成します。

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

次の方法で Dynamic Link パラメータを設定できます。

https://example.com/link
https://example.page.link