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

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

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

FirebaseとDynamicLinksSDKを設定する

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

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

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

   flutter pub add firebase_dynamic_links
   

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

4. Firebaseコンソールで、[ダイナミックリンク]セクションを開きます。

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

      すでにダイナミックリンクドメインをお持ちの場合は、それに注意してください。プログラムでダイナミックリンクを作成する場合は、ダイナミックリンクドメインを提供する必要があります。

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

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

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

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

次の最小限の例では、 https://www.example.com/ //www.example.com/への長い動的リンクを作成します。このリンクはAndroidの場合はcom.example.app.androidで、iOSの場合はアプリcom.example.app.iosで開きます。

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を使用して、サポートされているパラメーターのいずれかを使用して動的リンクを作成できます。 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);

ダイナミックリンクパラメータは、次の方法で設定できます。

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