Universal Links en iOS y App Links en Android permiten a los usuarios acceder directamente a tu app desde un enlace, omitiendo el navegador. Esto es especialmente útil para mejorar la experiencia de usuario y mantener el contexto desde una página web hasta la app. En esta guía, repasaremos el proceso de configurar estos deep links para una app de Next.js usando Capacitor. Para atribución y deferred deep links, @capgo/capacitor-appsflyer puede dirigir las campañas de instalación a la pantalla correcta de la app.
Configurar deep links no requiere mucho code, pero sí implica cierta configuración. Al final de esta guía, podrás hacer clic en un enlace como https://www.capgo.app/details/22 y tu app se abrirá en la página correcta si está instalada.
Configuración de Deep Links en Next.js
Primero, crearemos una nueva app de Next.js y una página de detalles para pruebas:
npx create-next-app@latest capgoLinks
cd capgoLinks
mkdir pages/details
touch pages/details/[id].js
npm run build
npx cap add ios
npx cap add android
Asegúrate de que tu bundle ID esté configurado correctamente en el archivo capacitor.config.json archivo, ya que es fundamental para la configuración:
{
"appId": "com.capgo.deeplinks",
"appName": "capgoLinks",
"webDir": "out",
"bundledWebRuntime": false
}
Para el enrutamiento, Next.js usa enrutamiento basado en archivos, así que al crear un archivo en pages/details/[id].js, ya hemos configurado nuestra ruta comodín.
En pages/details/[id].js, podemos obtener el ID de la URL usando el router integrado de Next.js:
import { useRouter } from 'next/router'
function DetailsPage() {
const router = useRouter()
const { id } = router.query
return (
<div>
<p>My ID: {id}</p>
</div>
)
}
export default DetailsPage
Ahora, manejemos el appUrlOpen evento con Capacitor. Este evento se dispara cuando la app se abre mediante un esquema de URL personalizado. Añade un listener en el pages/_app.js archivo:
import { useEffect } from 'react'
import { App } from '@capacitor/app'
function MyApp({ Component, pageProps }) {
useEffect(() => {
App.addListener('appUrlOpen', (event) => {
const slug = event.url.split('.app').pop()
if (slug)
window.location.href = slug
})
}, [])
return <Component {...pageProps} />
}
export default MyApp
Este code escucha el appUrlOpen evento y navega a la ruta correspondiente dentro de tu app de Next.js.
Configuración de iOS
Para iOS, necesitarás un app ID con Associated Domains habilitado. Crea un apple-app-site-association archivo con el siguiente contenido, reemplazando YOURTEAMID y com.your.bundleid con tu ID de equipo e ID de paquete reales:
{
"applinks": {
"apps": [],
"details": [
{
"appID": "YOURTEAMID.com.your.bundleid",
"paths": ["*"]
}
]
}
}
Sube este archivo a la .well-known directorio en tu dominio, haciéndolo accesible en https://www.capgo.app/.well-known/apple-app-site-association.
En Xcode, añade el dominio a los entitlements de tu app usando el formato applinks:capgo.app.
Configuración de Android
Para App Links de Android, sigue estos pasos:
- Genera un archivo keystore si no tienes uno.
- Obtén la huella SHA256 del keystore.
- Crea un assetlinks.json archivo con el nombre de tu paquete y la huella SHA256.
- Sube este archivo a la
.well-knowndirectorio en tu dominio.
En tu AndroidManifest.xml, añade un intent-filter al activity elemento que gestione los deep links:
<activity ...>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" android:host="capgo.app" />
</intent-filter>
</activity>
Después de subir el assetlinks.json archivo, puedes verificarlo con la herramienta Digital Asset Links de Google. Si todo está configurado correctamente, verás una marca de verificación verde.
Para compilar y firmar tu app, usa los siguientes comandos:
cd android
./gradlew assembleRelease
cd ..
jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore my-release-key.keystore android/app/build/outputs/apk/release/app-release-unsigned.apk alias_name
zipalign -v 4 android/app/build/outputs/apk/release/app-release-unsigned.apk capgo.apk
adb install capgo.apk
Esto instalará la app firmada en tu dispositivo Android conectado.
Capacitor Configuración para ajustes del proyecto nativo
Para automatizar los ajustes del proyecto nativo, considera usar el paquete Capacitor configure. Instálalo en tu proyecto:
npm install @capacitor/configure
Crea un capacitor.config.yaml archivo en la raíz de tu proyecto:
vars:
BUNDLE_ID: com.capgo.deeplinks
PACKAGE_NAME: com.capgo.deeplinks
platforms:
ios:
targets:
App:
bundleId: $BUNDLE_ID
entitlements:
- com.apple.developer.associated-domains: ['applinks:capgo.app']
android:
packageName: $PACKAGE_NAME
Ejecuta la herramienta de configuración con esta config:
npx cap-config run capacitor.config.yaml
Esto aplicará los ajustes especificados en el archivo YAML a tus proyectos nativos.
Conclusión
Configurar deep links con Capacitor en una app de Next.js requiere configurar tu dominio y los ajustes del proyecto tanto para iOS como para Android. Aunque el proceso requiere atención al detalle, es más ágil que los métodos antiguos y no necesita plugins adicionales. Asegúrate de que los archivos de verificación de dominio se sirvan correctamente y verifícalos con las herramientas de cada plataforma. Una vez configurado, tu app se abrirá sin problemas desde enlaces web, ofreciendo una transición fluida para tus usuarios de la web a la app.
Continúa con Cómo integrar Universal Links en Next.js con Capacitor
Si estás usando Cómo integrar Universal Links en Next.js con Capacitor para planificar el trabajo con plugins nativos, conéctalo con Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo en Alternativas a plugins de Ionic Enterprise, y Native Builds de Capgo para el flujo de trabajo del producto en Capgo Native Builds.