Android App Links 2026: tutorial de verificación
Un Android App Link es el único mecanismo de enlace profundo que Google acepta como prueba de propiedad: tu app declara un host HTTPS que está dispuesta a gestionar, publica una declaración de Digital Asset Links en ese host y Android verifica que ambos coinciden antes de abrir tu app en lugar del navegador. Dos elementos deciden el resultado: un archivo /.well-known/assetlinks.json que tú controlas y la huella de firma SHA-256 que contiene, y la mayoría de los fallos se deben a que uno de los dos está ligeramente mal, no a nada exótico.
Este tutorial sigue el orden en que el trabajo ocurre realmente: declarar el filtro de intents autoVerify, publicar la lista de declaraciones assetlinks.json, elegir la huella correcta cuando Play App Signing vuelve a firmar tu compilación, instalar y leer el estado de verificación, diagnosticar los fallos habituales en producción, diseñar un mecanismo de reserva que no engañe a los usuarios y mantener viva la verificación de enlaces de app a través de rotaciones de claves y cambios de dominio. La regla que subyace a todo: la verificación es una promesa de que el dominio y la app tienen el mismo propietario, así que la única forma legítima de superarla es ser realmente dueño de ambos.
1. Qué demuestra un enlace verificado y qué no
Se confunden tres ideas, y separarlas evita la mayoría de las malas decisiones de diseño.
- Un enlace profundo es cualquier intento de abrir una pantalla dentro de tu app. Puede provenir de un esquema personalizado como
myapp://product/42, que cualquier app del dispositivo puede registrar, de modo que una app maliciosa puede reclamar el mismo esquema y recibir la URL en tu lugar. - An App Link is an HTTPS URL —
https://shop.example.com/product/42— that Android has verified you are entitled to handle, because that host publishes a statement naming your package and your signing certificate. The user sees a normal web URL, the browser can always open it, and only one app can win the verification. - Un fallback web es la misma URL abierta en un navegador cuando tu app no está instalada. Una estrategia de enlaces bien construida hace que las tres piezas concuerden, de modo que la URL resuelva al contenido deseado tanto si la app está presente como si no.
Lo que la verificación no hace: no demuestra que la app esté instalada, no te otorga ningún derecho sobre el contenido del dominio y no sustituye a la autenticación. Si una pantalla muestra datos de la cuenta, la comprobación del token en el servidor sigue siendo lo que los protege. La verificación solo responde «¿puede esta app abrir enlaces de este host?», nada más.
Una consecuencia práctica: conserva los esquemas personalizados como máximo para traspasos internos y nunca dependas de ellos para restablecer contraseñas o redirigir pagos, porque la propiedad del esquema no es exigible.
2. Paso 1: declara los filtros de intent autoVerify en el manifiesto
Empieza en AndroidManifest.xml. El filtro debe ser un filtro https con android:autoVerify="true", y necesita la acción VIEW además de las categorías DEFAULT y BROWSABLE:
<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="shop.example.com" /> </intent-filter>
Detalles que deciden si esto funciona en la práctica:
- Un filtro por host. La verificación se evalúa por host, y la indicación de Google es un
<intent-filter>independiente para cada dominio. Agrupar cinco hosts en un solo filtro hace que un único host defectuoso contamine a los demás. - Los hosts son literales.
android:hostno acepta comodines. Llega a los subdominios con filtros separados y acota el rango conandroid:path,android:pathPrefixoandroid:pathPatternpara que la app no reclame URLs que no puede mostrar. httpno es verificable. Solohttpsparticipa en la verificación automática. Mantener un filtrohttpsolo genera avisos duplicados del selector.- Declara solo lo que enrutas. Un filtro que coincide con todo el host mientras la app gestiona tres rutas envía todas las demás URL a una pantalla en blanco, y ese comportamiento aparece en las reseñas de la tienda mucho antes que en tu panel de fallos.
Si tu app gestiona tanto un dominio de marketing como un dominio de app, decide a conciencia cuál es el canónico para compartir. Cada host que añadas es un archivo que publicar y un certificado que mantener sincronizado.
3. Paso 2 — publica /.well-known/assetlinks.json
La lista de extractos está en una única ruta, sobre HTTPS y sin redirecciones delante:
https://shop.example.com/.well-known/assetlinks.json
El cuerpo es un arreglo JSON de declaraciones. Para una app normal que gestiona todas las URL del host, una declaración es suficiente:
[{ "relation": ["delegate_permission/common.handle_all_urls"], "target": { "namespace": "android_app", "package_name": "com.example.shop", "sha256_cert_fingerprints": [ "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5" ] } }]
Varios paquetes, o un solo paquete con múltiples certificados, simplemente añaden más declaraciones al mismo arreglo. Los detalles de la publicación importan tanto como el contenido:
- Tipo de contenido. Sírvelo como
application/json. Algunas versiones de Android y algunas configuraciones de CDN en el edge son estrictas con esto. - Sin redirecciones. Un
301o un302delante del archivo hace que la obtención falle, y el fallo es silencioso en el dispositivo. Es el error de alojamiento más común: una regla global del sitio como "forzar HTTPS" o "eliminar la barra final" lo rompe sin avisar. - Sin autenticación ni muro antibots. El verificador de Google descarga el archivo de forma anónima. Un desafío de WAF o un bloqueo geográfico devuelve una página de error HTML donde se espera JSON.
- JSON válido, sin comentarios. Una coma final o un comentario
//suelto invalida todo el archivo y todas las declaraciones que contiene.
Before you debug anything on the device, fetch the file the way the verifier would: curl -sI https://shop.example.com/.well-known/assetlinks.json should show 200 and no Location header, and the body should parse. Google publishes a statement list generator and tester that will validate the structure and the fingerprint format for you — use it before shipping.
4. Paso 3 — usar la huella que el dispositivo realmente ve
Aquí es donde falla la mayoría de las verificaciones, y la razón es Play App Signing. Al inscribirte, Google conserva la clave de firma de la app y vuelve a firmar cada artefacto que entrega. Por tanto, el certificado instalado en el dispositivo del usuario es el certificado de firma de la app, no la clave de carga que tienes en tu máquina de compilación.
- Las instalaciones de Play necesitan el certificado SHA-256 de la clave de firma de la app, que encontrarás en Play Console en Integridad de la app → Firma de la app (el bloque "Certificado de la clave de firma de la app").
- Las compilaciones locales y las instaladas por sideload se firman con tu clave de carga o de depuración y necesitan esa huella; léela con
keytool -list -v -keystore <keystore>y copia la línea SHA-256. - Incluye ambos. Declarar el certificado de firma de la app y el certificado de carga en el mismo array
sha256_cert_fingerprintses normal y esperado; permite que las instalaciones de Play verifiquen mientras tus compilaciones de QA siguen funcionando.
Otras dos trampas en la misma área. Si usas un almacén de claves de depuración, su huella es específica de la máquina que lo generó: sirve para tus propias pruebas, pero es inútil en el archivo publicado. Y si alguna vez usas la actualización de clave de Play, el certificado cambia: la lista de declaraciones debe actualizarse antes de que se implemente la actualización, o los enlaces se romperán para las instalaciones nuevas mientras las antiguas siguen funcionando.
Copia las huellas del panel en lugar de volver a escribirlas. Un solo par de dígitos hexadecimales intercambiado produce un archivo que es JSON válido, se sirve con 200 y aun así falla la verificación sin ningún mensaje de error en ninguna parte.
5. Paso 4 — instalar y leer el estado real de verificación
La verificación se intenta al instalar la app y de nuevo tras las actualizaciones, así que necesitas la app instalada desde el canal que estás probando: una instalación de pruebas internas de Play se comporta de forma distinta a un adb install de una compilación firmada para subida.
En Android 12 y versiones posteriores, consulta directamente a la plataforma:
adb shell pm get-app-links com.example.shop
Obtienes un informe por dominio: el dominio, si el usuario lo ha aprobado y el estado de verificación: verified cuando la lista de declaraciones coincide, denied o legacy_failure cuando no. En versiones anteriores, el equivalente es un volcado de los registros de verificación de dominios:
adb shell dumpsys package d
Si un host aparece como denegado y acabas de corregir el archivo, fuerza un intento nuevo en lugar de reinstalar a ciegas:
adb shell pm set-app-links --package com.example.shop --domain shop.example.com all
Después, prueba el flujo que realiza un usuario. Un enlace escrito en un navegador, un enlace pulsado en un cliente de correo y un enlace dentro de otra app no siempre se resuelven igual, y solo uno de ellos puede pasar por el selector. Revisa también la pantalla Abrir de forma predeterminada de la app en los ajustes del sistema: un usuario puede desactivar un enlace verificado, y tu código debe seguir funcionando sin romperse.
6. Paso 5: diagnostica los fallos con los que realmente te vas a encontrar
Casi todos los fallos en producción encajan en uno de cinco grupos. Revísalos en este orden; cada uno lleva segundos.
- Huella incorrecta. El archivo se analiza, el host es correcto y el certificado de la declaración es la clave de carga mientras que el dispositivo tiene la compilación firmada por Play. Compara la huella de la consola carácter por carácter con la del archivo.
- Redirección o tipo de contenido incorrecto.
curl -sImuestra un3xx,text/htmlo una página de error en caché de la CDN. Corrige el encabezado, purga la caché y vuelve a verificar. - Discrepancia de nombre del paquete o host. Un ID de aplicación cambiado para una compilación de marca blanca, o un filtro que aún incluye un host de staging que ya no sirve el archivo. Busca en el manifiesto todos los hosts y confirma que cada uno tenga una declaración activa.
- La verificación nunca se ejecutó. La instalación se hizo sin conexión, o la app no se ha abierto nunca desde que se instaló. Abre la app una vez con conexión y vuelve a ejecutar
pm get-app-links. - Anulación por el usuario. El dominio se desactivó en la configuración, a veces meses antes, a veces por una herramienta de migración de un fabricante.
pm set-app-links … alllo restablece para pruebas; con los usuarios reales, la solución es educar, no forzar.
Incluye una prueba de humo de una línea en tu lista de verificación de la versión: obtén el archivo, analízalo y comprueba que la huella digital coincide con la que muestra la consola en ese momento. Un cambio de dominio o una actualización de clave que se salte esa comprobación es exactamente cómo una configuración de enlaces que funcionaba muere en silencio.
7. Paso 6 — crea un mecanismo de respaldo que diga la verdad
Los App Links convierten la app en el controlador preferido, no en el único. Diseña primero el lado web, porque es el caso que siempre existe.
- La URL debe mostrarse sin la app. Un enlace para compartir que solo funciona con la app instalada es un enlace roto, y además rompe a los rastreadores que lo indexan.
- Detecta y luego ofrece; no secuestres. Un pequeño banner con "Abrir en la app" y un enlace a la tienda convierte mejor que una redirección automática que atrapa a los usuarios que quieren deliberadamente el navegador.
- Mantén la ruta del enlace profundo idéntica a la ruta web. Si la app muestra
/product/42, la página web en esa misma ruta debería mostrar el mismo producto; la tabla de correspondencias que evitas crear es la que fallará el próximo trimestre. - Gestiona el caso de la instalación pendiente. El enlace profundo diferido —cuando un usuario nuevo instala y aterriza en el elemento compartido— requiere un mecanismo del lado del servidor o basado en el referrer de instalación. Firebase Dynamic Links, la herramienta que usaba la mayoría de los equipos para esto, se retiró, así que planifica con la Install Referrer API o un equivalente propio en lugar de dar por hecho un servicio alojado.
Y resiste la tentación de hacer invisible la verificación. Si la app no puede renderizar una URL, dejar que el navegador se encargue es mejor resultado que una pantalla de «no encontrado» dentro de la app, y mantiene intacto el SEO del dominio.
8. Mantener la verificación activa entre versiones y dominios
La verificación no es una configuración única. Es un acuerdo permanente entre tres piezas móviles: el manifiesto, el archivo publicado y el certificado con el que la tienda firma realmente. Cualquier cosa que toque una de ellas es un punto de la lista de verificación de la versión.
- Actualización de clave o nueva firma. Actualiza
assetlinks.jsoncon el nuevo certificado y publícalo antes del despliegue; luego mantén el antiguo en la lista hasta que la versión anterior se retire por completo. - Cambio de dominio. Publica primero las declaraciones en el nuevo host y aplica después el cambio del manifiesto. Un filtro que apunta a un host sin archivo deja los enlaces fuera de servicio de inmediato.
- Dominios de marca y regionales. Cada host es una declaración propia y un archivo propio. Automatiza el despliegue para que un nuevo dominio regional no pueda publicarse sin él.
- Comprobaciones de propiedad. El archivo es una declaración pública de que controlas el dominio. Publícalo solo para dominios que tu organización posea y opere, y nunca alojes la declaración de un tercero en su nombre: ese es justo el patrón que busca la detección de abusos, y pone en riesgo tanto el dominio como la cuenta de la app.
Guarda los filtros del manifiesto, la plantilla JSON publicada y las huellas actuales en un solo lugar, generados a partir de una única fuente de verdad. Cuando son tres ediciones manuales separadas, se desincronizan en dos ciclos de publicación.
9. Dónde encaja KappS
Trabajamos en el lado operativo del lanzamiento: mantener cuentas, versiones y registros de la tienda en un estado que resista la revisión de la plataforma —preparando y enviando material conforme, nunca eludiendo una comprobación. En la verificación de enlaces, eso suele significar:
- Higiene de la versión. Certificados e ID de aplicación coherentes entre la consola, la compilación y la lista de declaraciones publicada, para que la huella que ve el dispositivo sea la que documentaste.
- Preparación de la cuenta. Verificación de desarrollador, perfil de pagos e información fiscal alineados con la entidad legal detrás de la cuenta, para que un lanzamiento no se detenga por una revisión ajena.
- Revisión del dominio y del alojamiento. Comprobar que la ruta well-known sirve realmente JSON sin redirecciones, sin desafío del WAF y sin una página de error en caché delante.
Lo que no hacemos: publicar declaraciones para dominios que un cliente no posee, falsificar una huella digital ni ayudar a una app a reclamar un host sobre el que no tiene derecho. La verificación existe precisamente para proteger a los usuarios de eso, y no es un servicio que ofrezcamos.
Fuentes (documentación oficial): Android Developers — Verify Android App Links; Add Android App Links; Digital Asset Links specification; Play Console Help — App signing key certificate and key upgrade; Android Developers — Adb shell pm commands for app links.
¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.
Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.
← Volver a editar