Soluciona problemas de vínculos de apps

En esta guía, se describen los problemas comunes y cómo solucionarlos. También puedes usar las herramientas de solución de problemas en la página Vínculos directos de Play Console o el Asistente de App Links de Android Studio. Para obtener más información, consulta Herramientas para desarrolladores de App Links.

  • 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:
    • Verifica 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 entregue 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 <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 Prueba de App Links para obtener un resultado de verificación nuevo.

Las reglas dinámicas en Android 15 o 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 tus 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 de acceso del vínculo. Si se filtra el vínculo, haz que el filtro de intents en el manifiesto de la app sea menos restrictivo.

Corrige errores comunes de implementación

Si no puedes verificar tus Android App Links, busca 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, reemplaza example.com por el nombre de dominio real de tu servidor.

Configuración incorrecta del filtro de intents
Comprueba si incluyes una URL que no es de tu propiedad en un <intent-filter> elemento.
Configuración incorrecta del servidor

Verifica la configuración JSON de tu servidor y asegúrate de que el valor SHA sea correcto.

Además, verifica que example.com. (con el punto final) publique 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:

  • http://example.com a https://example.com
  • example.com a www.example.com

Este comportamiento protege la seguridad de tu app.

Robustez del servidor

Verifica si tus apps cliente pueden conectarse a tu servidor.

Vínculos no verificables

Para fines de prueba, es posible que agregues intencionalmente vínculos no verificables. 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 firma que se usó para firmar tu app. Los errores comunes incluyen los siguientes:

  • Firmar la app con un certificado de depuración y solo tener la firma de lanzamiento en assetlinks.json
  • Tener una firma en minúscula 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 usa Google para firmar cada una de tus versiones. Para verificar estos detalles, incluido un fragmento de JSON completo, sigue las instrucciones para declarar asociaciones de sitios web.

Captura un informe de errores

Para 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.