Crie links dinâmicos com C++

Você pode criar links dinâmicos curtos ou longos com a API Firebase Dynamic Links. A API usa várias estruturas de parâmetros opcionais para construir links. Links curtos também podem ser criados a partir de um link longo gerado anteriormente. O Firebase Dynamic Links gera um URL como este:

https://example.page.link/WXYZ

O SDK C++ funciona para Android e iOS, com algumas configurações adicionais necessárias para cada plataforma.d

Antes de você começar

Antes de usar o Firebase Dynamic Links , você precisa:

• Registre seu projeto C++ e configure-o para usar o Firebase.

  Se o seu projeto C++ já usa o Firebase, ele já está registrado e configurado para o Firebase.

• Adicione o SDK do Firebase para C++ ao seu projeto C++.

Observe que adicionar o Firebase ao seu projeto C++ envolve tarefas no console do Firebase e no seu projeto C++ aberto (por exemplo, você baixa os arquivos de configuração do Firebase do console e os move para o seu projeto C++).

Usar o console do Firebase

Se você deseja gerar um único link dinâmico, seja para fins de teste ou para que sua equipe de marketing crie facilmente um link que possa ser usado em algo como uma postagem em mídia social, a maneira mais simples seria visitar o console do Firebase e criar um manualmente seguindo o passo a passo.

Domínios personalizados

Você pode ter maior controle sobre a marca do seu link dinâmico usando seu próprio domínio em vez de um subdomínio goo.gl ou page.link . Siga estas instruções para configurar um domínio personalizado para o seu projeto.

Usando a API Firebase Dynamic Links

Crie e inicialize o aplicativo

Antes de criar links dinâmicos, você precisará criar e inicializar um objeto firebase::App .

Inclua o arquivo de cabeçalho para firebase::App :

#include "firebase/app.h"

A próxima parte varia dependendo da sua plataforma:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

Inicializar biblioteca do Dynamic Links

Antes de criar um Dynamic Link, você deve primeiro inicializar a biblioteca Dynamic Links:

::firebase::dynamic_links::Initialize(app, null);

Criando um link dinâmico longo a partir de parâmetros

Para criar um link dinâmico, crie um objeto DynamicLinkComponents, definindo qualquer um dos membros opcionais para configuração adicional e transmitindo-o para dynamic_links::GetShortLink ou dynamic_links::GetLongLink .

O exemplo mínimo a seguir cria um link dinâmico longo para https://www.example.com/ que abre com seu aplicativo Android com.example.android.package_name e aplicativo iOS com.example.ios:

firebase::dynamic_links::IOSParameters ios_parameters("com.example.ios");

firebase::dynamic_links::AndroidParameters android_parameters(
    "com.example.android.package_name");

firebase::dynamic_links::DynamicLinkComponents components(
    "https://www.example.com/", "example.page.link");
components.android_parameters = &android_parameters;
components.ios_parameters = &ios_parameters;

firebase::dynamic_links::GeneratedDynamicLink long_link =
    firebase::dynamic_links::GetLongLink(components);

Criando um link dinâmico curto

Para criar um link dinâmico curto, passe um link longo gerado anteriormente para GetShortLink ou crie DynamicLinkComponents da mesma forma que acima.

GetShortLink opcionalmente usa um parâmetro de configuração DynamicLinkOptions extra com PathLength ; isso permite controlar como o link deve ser gerado. A geração de um link curto requer uma solicitação de rede ao back-end do Firebase, portanto GetShortLink é assíncrono, retornando um Future<GeneratedLink> .

Por exemplo:

firebase::dynamic_links::DynamicLinkOptions short_link_options;
short_link_options.path_length = firebase::dynamic_links::kPathLengthShort;

firebase::Future<firebase::dynamic_links::GeneratedDynamicLink> result =
    firebase::dynamic_links::GetShortLink(components, short_link_options);

Se o seu programa tiver um loop de atualização executado regularmente (digamos, 30 ou 60 vezes por segundo), você poderá verificar os resultados uma vez por atualização:

if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::dynamic_links::kErrorCodeSuccess) {
    firebase::dynamic_links::GeneratedDynamicLink link = *result.result();
    printf("Create short link succeeded: %s\n", link.url.c_str());
  } else {
    printf("Created short link failed with error '%s'\n",
           result.error_message());
  }
}