Soluciona problemas de vínculos de apps

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.

  • 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 en https://<your-domain>/.well-known/assetlinks.json y 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_fingerprints en assetlinks.json coincida 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 tu AndroidManifest.xml incluya android:autoVerify="true".
    • Verifica si hay redireccionamientos del servidor: Los redireccionamientos de http a https o de un dominio que no sea www a www pueden 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.

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.

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 que example.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.com a https://example.com
  • De example.com a www.example.com

Este comportamiento protege la seguridad de tu app.

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.

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.