Créer des liens dynamiques avec C++

Vous pouvez créer des liens dynamiques courts ou longs avec l'API.Dynamic LinksFirebase Dynamic Links L'API accepte plusieurs structures de paramètres facultatifs pour créer des liens. Vous pouvez également créer des liens courts à partir d'un lien long généré précédemment. Firebase Dynamic Links génère une URL comme celle-ci :

https://example.page.link/WXYZ

Le SDK C++ fonctionne à la fois pour Android et iOS, mais une configuration supplémentaire est requise pour chaque plate-forme.

Avant de commencer

Avant de pouvoir utiliser Firebase Dynamic Links, vous devez :

• enregistrer votre projet C++ et le configurer pour qu'il utilise Firebase ;

  Si votre projet C++ utilise déjà Firebase, il est déjà enregistré et configuré pour Firebase.

• ajouter le Firebase C++ SDK à votre projet C++.

Notez que l'ajout de Firebase à votre projet C++ implique des tâches à la fois dans la Firebase console et dans votre projet C++ ouvert (par exemple, vous téléchargez les fichiers de configuration Firebase depuis la console, puis vous les déplacez dans votre projet C++).

Utiliser la Firebase console

Si vous souhaitez générer un seul Dynamic Link, à des fins de test ou pour que votre équipe marketing puisse facilement créer un lien à utiliser dans un post sur les réseaux sociaux, par exemple, le plus simple serait d'accéder à la Firebase console et de le créer manuellement en suivant le formulaire pas à pas.

Domaines personnalisés

Vous pouvez mieux contrôler l'image de marque de votre Dynamic Link en utilisant votre propre domaine au lieu d'un goo.gl ou page.link sous-domaine. Suivez ces instructions pour configurer un domaine personnalisé pour votre projet.

Utiliser l'API Firebase Dynamic Links

Créer et initialiser une application

Avant de pouvoir créer Dynamic Links, vous devez créer et initialiser un firebase::App objet.

Incluez le fichier d'en-tête pour firebase::App :

#include "firebase/app.h"

La partie suivante varie en fonction de votre plate-forme :

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

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

Initialiser la bibliothèque Dynamic Links

Avant de créer un Dynamic Link, vous devez d'abord initialiser la bibliothèque Dynamic Links :

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

Créer un long Dynamic Link à partir de paramètres

Pour créer un lien dynamique, créez un objet DynamicLinkComponents, définissez l'un des membres facultatifs pour une configuration supplémentaire et transmettez-le à dynamic_links::GetShortLink ou dynamic_links::GetLongLink.

L'exemple minimal suivant crée un lien dynamique long vers https://www.example.com/ qui s'ouvre avec votre application Android com.example.android.package_name et votre application 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);

Créer un lien dynamique court Dynamic Link

Pour créer un lien dynamique court, transmettez un lien long généré précédemment à GetShortLink ou créez DynamicLinkComponents de la même manière que ci-dessus.

GetShortLink accepte éventuellement un paramètre de configuration DynamicLinkOptions supplémentaire avec PathLength, ce qui vous permet de contrôler la façon dont le lien doit être généré. La génération d'un lien court nécessite une requête réseau auprès du backend Firebase . GetShortLink est donc asynchrone et renvoie un Future<GeneratedLink>.

Exemple :

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

Si votre programme comporte une boucle de mise à jour qui s'exécute régulièrement (par exemple, 30 ou 60 fois par seconde), vous pouvez vérifier les résultats une fois par mise à jour :

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