Crea link dinamici in un'app Flutter

Puoi creare link dinamici brevi o lunghi con l'API Firebase Dynamic Links Builder. Questa API accetta un link dinamico lungo o un oggetto contenente i parametri del link dinamico e restituisce URL come i seguenti esempi:

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

Configura Firebase e l'SDK di Dynamic Links

Prima di poter creare Dynamic Links nella tua app per Android, devi includere l'SDK Firebase. Se la tua app è configurata per ricevere link dinamici, hai già completato questi passaggi e puoi saltare questa sezione.

1. Installa e inizializza gli SDK Firebase per Flutter, se non l'hai già fatto.

2. Dalla directory principale del progetto Flutter, esegui il seguente comando per installare il plug-in Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. Se stai creando un'app per Android, apri la pagina Impostazioni progetto della console Firebase e assicurati di aver specificato la chiave di firma SHA-1. Se utilizzi i link dell'app, specifica anche la chiave SHA-256.

4. Nella console Firebase, apri la sezione Link dinamici.

   1. Se non hai ancora configurato un dominio per i link dinamici, fai clic sul pulsante Inizia e segui le istruzioni.

      Se hai già un dominio di link dinamici, prendine nota. Devi fornire un dominio di link dinamici quando crei link dinamici a livello di programmazione.

   2. Consigliato: dal menu "Altro" (⋮), specifica i pattern URL consentiti nei link diretti e nei link di fallback. In questo modo, impedisci a terze parti non autorizzate di creare link dinamici che reindirizzano dal tuo dominio a siti che non controlli.

      Consulta la sezione Consenti pattern URL specifici.

Crea un link dinamico dai parametri

Per creare un link dinamico, crea un nuovo oggetto DynamicLinkParameters e passalo a buildLink() o buildShortLink().

Il seguente esempio minimo crea un link dinamico lungo a https://www.example.com/ che si apre con com.example.app.android su Android e l'app com.example.app.ios su 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);

Per creare un link dinamico breve, passa l'oggetto DynamicLinkParameters a buildShortLink(). La creazione del link breve richiede una chiamata di rete. Ad esempio:

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);

Per impostazione predefinita, i link dinamici brevi vengono generati con suffissi di pochi caratteri. Sebbene ciò renda i link più compatti, introduce anche la possibilità che qualcuno possa indovinare un link breve valido. Spesso, non ci sono problemi se qualcuno lo fa, perché il link rimanda a informazioni pubbliche.

Tuttavia, se i link brevi rimandano a informazioni specifiche dell'utente, devi creare link più lunghi con suffissi di 17 caratteri che rendano molto improbabile che qualcuno possa indovinare un link dinamico valido. Per farlo, passa ShortDynamicLinkType.unguessable al metodo buildShortLink():

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

Parametri dei link dinamici

Puoi utilizzare l'API Generatore di link dinamici per creare Dynamic Links con uno qualsiasi dei parametri supportati. Consulta il riferimento API.

L'esempio seguente crea un link dinamico con diversi parametri comuni impostati:

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);

Puoi impostare i parametri dei link dinamici con i seguenti metodi:

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