En esta guía, se describen los problemas habituales y cómo solucionarlos. También puedes usar las herramientas de solución de problemas de la página Vínculos directos de Play Console o el Asistente de vínculos de apps de Android Studio. Para obtener más información, consulta Herramientas para desarrolladores de vínculos de apps.
El vínculo de la app se abre en el navegador en lugar de en la app
- Problema: Haces clic en un vínculo que debería abrir tu app, pero se abre en un navegador web o muestra un diálogo de desambiguación.
- Solución:
- Revisa
assetlinks.json: Asegúrate de que el archivo sea un JSON válido, que se pueda acceder a él enhttps://<your-domain>/.well-known/assetlinks.jsony que se publique a través de HTTPS sin redireccionamientos. Usa un validador en línea. - Verifica la huella digital SHA-256: Comprueba que
sha256_cert_fingerprintsenassetlinks.jsoncoincida exactamente con la huella digital de la clave de firma de la versión de tu app (usa la de Play Console si usas la firma de apps de Play). La firma debe estar en mayúsculas. - Verifica
autoVerify: Asegúrate de que el<intent-filter>en tuAndroidManifest.xmlincluyaandroid:autoVerify="true". - Verifica si hay redireccionamientos del servidor: Los redireccionamientos de
httpahttpso de un dominio que no sea www awwwpueden hacer que falle la verificación. - Fuerza otra verificación: Ejecuta los comandos de ADB en la guía para probar los vínculos de apps y obtener un resultado de verificación nuevo.
- Diagnostica la resolución de vínculos (Android 17 y versiones posteriores): Ejecuta
adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>"para inspeccionar qué apps candidatas, filtros de intents de manifiesto y reglas de App Links dinámicos coinciden con la URL. Para obtener más detalles, consulta Diagnostica la resolución de vínculos con la marca debug-link.
- Revisa
Las reglas dinámicas en Android 15 y versiones posteriores no se actualizan
- Problema: Actualizaste las reglas en tu archivo
assetlinks.json, pero la app no controla los vínculos nuevos. - Solución:
- Fuerza otra verificación: La forma más confiable de probar los cambios es forzar una nueva recuperación con
adb shell pm verify-app-links --re-verify <your-package-name>. - Verifica si hay errores de escritura: Revisa cuidadosamente los comparadores de patrones en tus reglas para detectar errores de sintaxis.
- Verifica las reglas de filtro del manifiesto: Revisa las reglas de filtro de intents en el manifiesto de la app para asegurarte de que no se filtre la ruta del vínculo. Si se filtra el vínculo, haz que el filtro de intents en el manifiesto de la app sea menos restrictivo.
- Diagnostica las reglas de coincidencia (Android 17 y versiones posteriores): Ejecuta
adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>"para inspeccionar qué reglas se evaluaron y determinar si una regla de exclusión (allow = 1) impidió que se abriera la app. Consulta Diagnostica la resolución de vínculos con la marca debug-link.
- Fuerza otra verificación: La forma más confiable de probar los cambios es forzar una nueva recuperación con
Cómo corregir errores comunes de implementación
Si no puedes verificar tus Android App Links, comprueba si se producen los siguientes errores
comunes. En esta sección, se usa example.com como nombre de dominio de marcador de posición. Cuando
realices estas verificaciones, sustituye example.com por el nombre de dominio real
de tu servidor.
- Configuración incorrecta del filtro de intents
- Verifica si incluyes una URL que no pertenece a tu app en un elemento
<intent-filter>. - Configuración incorrecta del servidor
Verifica la configuración de JSON de tu servidor y asegúrate de que el valor de SHA sea correcto.
Además, verifica que
example.com.(con el punto final) entregue el mismo contenido queexample.com.- Redireccionamientos del servidor
El sistema no verifica ningún Android App Link para tu app si configuras un redireccionamiento como el siguiente:
- De
http://example.comahttps://example.com - De
example.comawww.example.com
Este comportamiento protege la seguridad de tu app.
- De
- Solidez del servidor
Verifica si tus apps cliente pueden conectarse al servidor.
- Vínculos no verificables
Para realizar pruebas, puedes agregar vínculos no verificables de forma intencional. Ten en cuenta que, en Android 11 y versiones anteriores, estos vínculos hacen que el sistema no verifique todos los Android App Links de tu app.
- Firma incorrecta en assetlinks.json
Verifica que tu firma sea correcta y coincida con la que se usó para firmar tu app. Entre los errores comunes, se incluyen los siguientes:
- Firmar la app con un certificado de depuración y tener solo la firma de lanzamiento en
assetlinks.json - Tener una firma en minúsculas en
assetlinks.json. La firma debe estar en mayúsculas. - Si usas la firma de apps de Play, asegúrate de usar la firma que Google utiliza para firmar cada una de tus versiones. Puedes verificar estos detalles, incluido un fragmento de JSON completo, siguiendo las instrucciones para declarar asociaciones de sitios web.
- Firmar la app con un certificado de depuración y tener solo la firma de lanzamiento en
Cómo capturar un informe de errores
En el caso de problemas complejos que son difíciles de reproducir, captura un informe de errores y analízalo. Esto puede proporcionar información valiosa sobre el proceso de verificación y cualquier error a nivel del sistema.