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 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 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 archivo 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 provocar que falle la verificación.
    • Fuerza otra verificación: Ejecuta los comandos de ADB en la guía de Prueba los vínculos de aplicaciones para obtener un resultado de verificación nuevo.

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.

Cómo corregir errores comunes de implementación

Si no puedes verificar tus vínculos de la app para Android, verifica 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 pertenece a tu app en un elemento <intent-filter>.
Configuración incorrecta del servidor

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

También verifica que example.com. (con el punto final) muestre 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.

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 vínculos de 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. Los errores comunes 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 usa para firmar cada una de tus versiones. Puedes verificar estos detalles, incluido un fragmento de código JSON completo, siguiendo las instrucciones para declarar asociaciones de sitios web.