Criar Dynamic Links em um app Flutter

Crie Dynamic Links curtos ou longos com a API Firebase Dynamic Links Builder. Essa API aceita um link dinâmico longo ou um objeto com parâmetros correspondentes e retorna URLs, como no exemplo a seguir:

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

Configurar o Firebase e o SDK do Dynamic Links

Antes de criar Dynamic Links no seu app Android, é necessário incluir o SDK do Firebase. Caso seu app esteja configurado para receber links dinâmicos, você já concluiu essas etapas e pode ignorar esta seção.

1. Instale e inicialize os SDKs do Firebase para Flutter, caso ainda não tenha feito isso.

2. No diretório raiz do seu projeto do Flutter, execute o comando a seguir para instalar o plug-in de Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. Se você estiver criando um app Android, abra a página Configurações do projeto no Console do Firebase e verifique se a chave de assinatura SHA-1 foi especificada. Se você usa links de apps, também precisa especificar sua chave SHA-256.

4. No Console do Firebase, abra a seção Dynamic Links.

   1. Se você ainda não configurou um domínio para o Dynamic Links, clique no botão Primeiros passos e siga as instruções.

      Se você já tem um domínio do Dynamic Links, anote-o. Você precisa fornecer um domínio do Dynamic Links ao criar links dinâmicos de maneira programática.

   2. Recomendado: no menu "Mais" (⋮), especifique os padrões de URL permitidos nos seus links diretos e substitutos. Ao fazer isso, você evita que pessoas não autorizadas criem links dinâmicos que redirecionam para sites que você não controla partindo do seu domínio.

      Consulte Permitir padrões de URL específicos.

Criar um link dinâmico a partir de parâmetros

Para criar um link dinâmico, crie um novo objeto DynamicLinkParameters e transmita-o para buildLink() ou buildShortLink().

O exemplo mínimo a seguir cria um link dinâmico longo para https://www.example.com/, que é aberto com com.example.app.android no Android e com o app com.example.app.ios no 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 criar um link dinâmico curto, transmita o objeto DynamicLinkParameters para buildShortLink(). A criação do link curto requer uma chamada de rede. Exemplo:

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

Por padrão, os links dinâmicos curtos são gerados com sufixos que tem apenas alguns caracteres. Embora isso torne os links mais compactos, também apresenta a possibilidade de alguém conseguir adivinhar um link curto válido. Muitas vezes, não há danos se alguém fizer isso, porque o link leva a informações públicas.

No entanto, caso seus links curtos levem a informações específicas do usuário, crie links mais longos com sufixos de 17 caracteres, que tornam muito improvável que alguém consiga adivinhar um link dinâmico válido. Para fazer isso, transmita ShortDynamicLinkType.unguessable para o método buildShortLink():

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

Parâmetros de link dinâmico

É possível usar a API Dynamic Link Builder para criar Dynamic Links com qualquer um dos parâmetros aceitos. Consulte a referência da API.

O exemplo a seguir cria um link dinâmico com vários parâmetros comuns definidos:

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

Você pode definir os parâmetros de link dinâmico com os seguintes métodos:

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