Crie links dinâmicos em um aplicativo Flutter

Você pode criar links dinâmicos curtos ou longos com a API Firebase Dynamic Links Builder. Esta API aceita um link dinâmico longo ou um objeto contendo parâmetros de link dinâmico e retorna URLs como nos exemplos a seguir:

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

Configure o Firebase e o SDK do Dynamic Links

Antes de criar links dinâmicos em seu aplicativo Android, você deve incluir o SDK do Firebase. Se seu aplicativo estiver configurado para receber links dinâmicos, você já concluiu essas etapas e pode pular 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 Flutter, execute o seguinte comando para instalar o plugin Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. Se você estiver criando um aplicativo Android, abra a página Configurações do projeto no console do Firebase e certifique-se de ter especificado sua chave de assinatura SHA-1. Se você usa App Links, especifique também 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 seus Dynamic Links, clique no botão Primeiros passos e siga as instruções.

      Se você já possui um domínio Dynamic Links, anote-o. Você precisa fornecer um domínio Dynamic Links ao criar Dynamic Links programaticamente.

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

      Consulte Permitir padrões de URL específicos .

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

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

O exemplo mínimo a seguir cria um link dinâmico longo para https://www.example.com/ que abre com com.example.app.android no Android e o aplicativo 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, passe o objeto DynamicLinkParameters para buildShortLink() . Construir o link curto requer uma chamada de rede. Por 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, links dinâmicos curtos são gerados com sufixos com apenas alguns caracteres. Embora isso torne os links mais compactos, também introduz a possibilidade de alguém adivinhar um link curto válido. Muitas vezes, não há mal nenhum se alguém fizer isso, porque o link leva a informações públicas.

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

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

Parâmetros de link dinâmico

Você pode usar a API Dynamic Link Builder para criar links dinâmicos com qualquer um dos parâmetros suportados. 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 parâmetros do Dynamic Link com os seguintes métodos:

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