Crear enlaces dinámicos en una aplicación Flutter

Puedes crear enlaces dinámicos cortos o largos con la API de Firebase Dynamic Links Builder. Esta API acepta un enlace dinámico largo o un objeto que contiene parámetros de enlace dinámico y devuelve URL como los siguientes ejemplos:

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

Antes de poder crear vínculos dinámicos en su aplicación de Android, debe incluir el SDK de Firebase. Si su aplicación está configurada para recibir enlaces dinámicos, ya completó estos pasos y puede omitir esta sección.

  1. Instala e inicializa los SDK de Firebase para Flutter si aún no lo has hecho.

  2. Desde el directorio raíz de su proyecto Flutter, ejecute el siguiente comando para instalar el complemento Dynamic Links:

    flutter pub add firebase_dynamic_links
    
  3. Si está creando una aplicación para Android, abra la página de configuración del proyecto de Firebase console y asegúrese de haber especificado su clave de firma SHA-1. Si utiliza App Links, especifique también su clave SHA-256.

  4. En Firebase console, abre la sección Enlaces dinámicos .

    1. Si aún no ha configurado un dominio para sus Dynamic Links, haga clic en el botón Comenzar y siga las instrucciones.

      Si ya tienes un dominio de Dynamic Links, toma nota. Debe proporcionar un dominio de Dynamic Links cuando crea Dynamic Links mediante programación.

    2. Recomendado : en el menú "Más" (⋮), especifique los patrones de URL permitidos en sus enlaces profundos y enlaces alternativos. Al hacerlo, evita que partes no autorizadas creen vínculos dinámicos que redireccionen desde su dominio a sitios que no controla.

      Consulte Permitir patrones de URL específicos .

Para crear un vínculo dinámico, cree un nuevo objeto DynamicLinkParameters y páselo a buildLink() o buildShortLink() .

El siguiente ejemplo mínimo crea un enlace dinámico largo a https://www.example.com/ que se abre con com.example.app.android en Android y la aplicación com.example.app.ios en 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);

Para crear un vínculo dinámico corto, pase el objeto DynamicLinkParameters a buildShortLink() . Para crear el enlace corto se requiere una llamada de red. Por ejemplo:

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

De forma predeterminada, los enlaces dinámicos cortos se generan con sufijos que tienen solo unos pocos caracteres. Aunque esto hace que los enlaces sean más compactos, también introduce la posibilidad de que alguien pueda adivinar un enlace corto válido. A menudo, no hay ningún daño si alguien lo hace, porque el enlace conduce a información pública.

Sin embargo, si sus enlaces cortos conducen a información específica del usuario, debe crear enlaces más largos con sufijos de 17 caracteres que hagan muy poco probable que alguien pueda adivinar un enlace dinámico válido. Para hacerlo, pase ShortDynamicLinkType.unguessable al método buildShortLink() :

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

Puede utilizar la API Dynamic Link Builder para crear enlaces dinámicos con cualquiera de los parámetros admitidos. Consulte la referencia de API .

El siguiente ejemplo crea un vínculo dinámico con varios parámetros comunes establecidos:

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

Puede configurar los parámetros de Dynamic Link con los siguientes métodos:

Parámetros de enlace dinámico
establecerEnlace El enlace que se abrirá su aplicación. Especifique una URL que su aplicación pueda manejar, generalmente el contenido o la carga útil de la aplicación, lo que inicia la lógica específica de la aplicación (como acreditar al usuario un cupón o mostrar una pantalla de bienvenida). Este enlace debe ser una URL con buen formato, estar codificada correctamente, usar HTTP o HTTPS y no puede ser otro enlace dinámico.
setDomainUriPrefix Su prefijo de URL de enlace dinámico, que puede encontrar en Firebase console. Un dominio de Dynamic Link se parece a los siguientes ejemplos:
https://example.com/link
https://example.page.link
AndroidParámetros
setFallbackUrl El enlace para abrir cuando la aplicación no está instalada. Especifique esto para hacer algo más que instalar su aplicación desde Play Store cuando la aplicación no esté instalada, como abrir la versión web móvil del contenido o mostrar una página promocional para su aplicación.
establecerVersiónMínima El código de versión de la versión mínima de su aplicación que puede abrir el enlace. Si la aplicación instalada es una versión anterior, el usuario es llevado a Play Store para actualizar la aplicación.
IosParámetros
establecerAppStoreId El ID de la App Store de tu aplicación, que se utiliza para enviar a los usuarios a la App Store cuando la aplicación no está instalada.
setFallbackUrl El enlace para abrir cuando la aplicación no está instalada. Especifique esto para hacer algo más que instalar su aplicación desde App Store cuando la aplicación no esté instalada, como abrir la versión web móvil del contenido o mostrar una página promocional para su aplicación.
establecerEsquemaPersonalizado El esquema de URL personalizado de su aplicación, si se define como algo distinto al ID del paquete de su aplicación
setIpadFallbackUrl El enlace para abrir en iPads cuando la aplicación no está instalada. Especifique esto para hacer algo más que instalar su aplicación desde App Store cuando la aplicación no esté instalada, como abrir la versión web del contenido o mostrar una página promocional para su aplicación.
setIpadBundleId El ID del paquete de la aplicación de iOS que se usará en iPads para abrir el enlace. La aplicación debe estar conectada a su proyecto desde la página Descripción general de Firebase console.
establecerVersiónMínima El número de versión de la versión mínima de su aplicación que puede abrir el enlace. Esta marca se pasa a su aplicación cuando se abre y su aplicación debe decidir qué hacer con ella.
Parámetros de información de navegación
setForcedRedirectEnabled Si se establece en '1', omita la página de vista previa de la aplicación cuando se abra el enlace dinámico y, en su lugar, redirija a la aplicación o tienda. La página de vista previa de la aplicación (habilitada de forma predeterminada) puede enviar a los usuarios de manera más confiable al destino más apropiado cuando abren Dynamic Links en las aplicaciones; sin embargo, si espera que un vínculo dinámico se abra solo en aplicaciones que pueden abrir vínculos dinámicos de manera confiable sin esta página, puede desactivarlo con este parámetro. Este parámetro afectará el comportamiento del Dynamic Link solo en iOS.
Parámetros de metaetiqueta social
establecer título El título que se utilizará cuando el enlace dinámico se comparte en una publicación social.
conjuntoDescripción La descripción que se utilizará cuando el enlace dinámico se comparte en una publicación social.
establecerUrlImagen La URL de una imagen relacionada con este enlace. La imagen debe tener al menos 300x200 px y menos de 300 KB.
Parámetros de GoogleAnalytics
establecer fuente
conjuntoMedio
establecercampaña
establecer término
establecer contenido
Parámetros de análisis de Google Play. Estos parámetros (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`) se pasan a Play Store y se agregan a la carga útil del enlace.
ItunesConnectAnalyticsParámetros
establecerProviderToken
establecerAffiliateToken
establecerCampaignToken
Parámetros de análisis de iTunes Connect. Estos parámetros (`pt`, `at`, `ct`) se pasan a la App Store.