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 parametri di link dinamico e restituisce URL come gli esempi riportati di seguito:

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

Configura Firebase e l'SDK di Dynamic Links

Prima di poter creare link dinamici nella tua app per Android, devi includere l'SDK Firebase. Se la tua app è configurata per ricevere i 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 ancora 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 Link per app, specifica anche la chiave SHA-256.

4. Nella console Firebase, apri la sezione Dynamic Links.

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

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

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

Creare 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 con 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 questo renda i link più compatti, introduce anche la possibilità che qualcuno possa indovinare un link breve valido. Spesso, non c'è nessun male se qualcuno lo fa, perché il link rimanda a informazioni pubbliche.

Tuttavia, se i tuoi link brevi rimandano a informazioni specifiche per l'utente, devi creare link più lunghi con suffissi di 17 caratteri che rendono 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 di Dynamic Link

Puoi utilizzare l'API Dynamic Link Builder per creare collegamenti dinamici 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 di Dynamic Link con i seguenti metodi:

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