Crea Dynamic Links con C++

Puedes crear Dynamic Links cortos o largos con la API de Firebase Dynamic Links. La API usa varias estructuras de parámetros opcionales para compilar vínculos. Los vínculos cortos también se pueden crear a partir de un vínculo largo generado previamente. Firebase Dynamic Links genera una URL como la siguiente:

https://example.page.link/WXYZ

El SDK de C++ funciona con Android y con iOS; requiere configuración adicional en ambas plataformas.

Antes de comenzar

Android

  1. Si aún no conectas tu app al proyecto de Firebase, puedes hacerlo desde Firebase console.
  2. En Firebase console, abre la sección Dynamic Links.
  3. Si aún no has aceptado las Condiciones del Servicio ni configurado un dominio para los Dynamic Links, deberás hacerlo cuando el sistema lo solicite.

    Si ya tienes un dominio de Dynamic Links, anótalo. Deberás proporcionar un dominio para crear Dynamic Links de manera programática.

  4. Agrega Firebase a tu proyecto Android.
  5. Agrega la dependencia para Firebase Dynamic Links al archivo build.gradle de nivel de la app:
    dependencies {
     implementation 'com.google.firebase:firebase-dynamic-links:16.1.2'
    }
  6. Vincula las bibliotecas estáticas libapp.a y libdynamic_links.a desde el SDK de C++.

iOS

  1. Si aún no conectas tu app al proyecto de Firebase, puedes hacerlo desde Firebase console.
  2. En Firebase console, abre la sección Dynamic Links.
  3. Si aún no has aceptado las Condiciones del Servicio ni configurado un dominio para los Dynamic Links, deberás hacerlo cuando el sistema lo solicite.

    Si ya tienes un dominio de Dynamic Links, anótalo. Deberás proporcionar un dominio para crear Dynamic Links de manera programática.

  4. Agrega Firebase a tu proyecto de iOS.
  5. La biblioteca cliente C++ de Firebase Dynamic Links usa esquemas de URL personalizados en iOS a fin de procesar vínculos. Debes agregar estos esquemas a tu app para admitir la recepción de Dynamic Links:
    1. Para abrir la configuración de tu proyecto, haz doble clic en el nombre del proyecto en la vista de árbol a la izquierda. Selecciona tu app en la sección OBJETIVOS, haz clic en la pestaña Información y expande la sección Tipos de URL.
    2. Haz clic en el botón + y agrega un esquema de URL para tu ID de cliente invertido. A fin de obtener este valor, abre el archivo de configuración GoogleService-Info.plist y busca la clave REVERSED_CLIENT_ID. Copia el valor de esa clave y pégalo en el recuadro Esquemas de URL en la página de configuración. Deja los demás campos en blanco.
    3. Haz clic en el botón + y agrega un segundo esquema de URL. Este es idéntico al ID del paquete de tu app. Por ejemplo, si tu ID del paquete es com.example.ios, ingresa ese valor en el cuadro Esquemas de URL. Puedes encontrar el ID del paquete de tu app en la pestaña General de la configuración del proyecto (Identidad > Identificador de paquete).
  6. Incluye el siguiente pod en tu Podfile:
    pod 'Firebase/DynamicLinks'
  7. Ejecuta pod install.
  8. Agrega firebase.framework y firebase_dynamic_links.framework a tu proyecto de Xcode desde el SDK de C++.

Usa Firebase console

Visita Firebase console y sigue los pasos que se indican en el formulario para generar un Dynamic Link. Esta es la forma más sencilla de producirlos, ya sea para hacer pruebas o para que tu equipo de marketing cree fácilmente un vínculo que pueda usarse, por ejemplo, en publicaciones de medios sociales.

Uso de la API de Firebase Dynamic Links

Cómo crear e inicializar una app

Para poder crear Dynamic Links, deberás crear y también inicializar un objeto firebase::App.

Incluye el archivo de encabezado para firebase::App:

#include "firebase/app.h"

La siguiente parte cambia según tu plataforma:

Android

Para crear firebase::App, pasa el entorno de JNI y una referencia jobject a la actividad de Java como argumentos:

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

iOS

Crea firebase::App:

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

Cómo inicializar la biblioteca de Dynamic Links

Antes de crear un Dynamic Link, debes inicializar la biblioteca:

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

Cómo crear un Dynamic Link largo a partir de parámetros

Para crear un Dynamic Link, crea un objeto DynamicLinkComponents, configura cualquiera de los miembros opcionales de manera adicional y pásalo a dynamic_links::GetShortLink o dynamic_links::GetLongLink.

El siguiente ejemplo simple permite crear un Dynamic Link largo a https://www.example.com/ que abre com.example.android.package_name en tu app para Android y com.example.ios en la app para 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);

Cómo crear un Dynamic Link corto

Para crear un Dynamic Link corto, pasa un vínculo largo generado con anterioridad a GetShortLink o compila DynamicLinkComponents del modo que se indicó más arriba.

GetShortLink toma de forma opcional un parámetro de configuración DynamicLinkOptions adicional con PathLength, lo que te permite controlar cómo se generará el vínculo. Para generar un vínculo corto, se necesita enviar una solicitud de red al backend de Firebase, por lo que GetShortLink es asíncrono y da como resultado un Future<GeneratedLink>.

Por ejemplo:

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 tu programa tiene un bucle de actualización que se ejecuta con regularidad (por ejemplo, 30 o 60 veces por segundo), puedes verificar los resultados una vez por actualización:

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

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.