Solucionar problemas

Cuando desarrolles Acciones en apps, es posible que encuentres problemas con los parámetros de configuración o la herramienta de pruebas de Acciones en apps. En esta página, se describen algunos problemas comunes y sus soluciones.

General

Error: "No se encontró ninguna aplicación para abrir la URL" en una notificación de aviso

Verifica la urlTemplate de entrega en tu actions.xml para asegurarte de que esté configurada correctamente. Si usas URLs de App Links, asegúrate de poder activar la URL de forma manual con ACTION_VIEW y la URL. Si usas URLs basadas en intents, asegúrate de que tu actividad esté configurada correctamente para comenzar a usar los parámetros proporcionados.

Error: "No se instaló la app"

Este error puede significar que el <intent-filter> del archivo AndroidManifest.xml no filtra el vínculo directo que especificaste en el actions.xml. Asegúrate de verificar esto antes de informar un error.

Error: "Se encontró una referencia de conjunto de entidades que no contenía un ID de conjuntos de entidades ni un filtro de URL" (en Android Studio)

Esta condición se debe a un problema de linter conocido para la etiqueta <entity-set-reference>. Puedes ignorar este mensaje. Como solución alternativa, puedes inhabilitar la comprobación de lint para esta etiqueta agregándole el atributo tools:ignore="ValidActionsXml".

El siguiente es un ejemplo de una referencia de conjunto de entidades con una comprobación de lint inhabilitada: 

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

Error: "La ubicación no es válida" para el documento de esquema de acciones cuando se sube el APK

Es posible que la carga de tu APK falle si usas una herramienta de ofuscación u optimización que afecte los recursos del APK de lanzamiento. Las herramientas como ProGuard que evitan los archivos de recursos no causan este problema.

Para resolverlo, inhabilita la herramienta del archivo actions.xml de tu app (por ejemplo, usa una lista de entidades permitidas).

Error: "Un APK o Android App Bundle activo contiene un archivo actions.xml. Para continuar, acepta las Condiciones del Servicio de Actions on Google" (en Google Play Console)

Es posible que veas este error cuando creas una versión de la app en Play Console. Para aceptar las Condiciones del Servicio de Actions on Google, sigue estos pasos:

  1. Selecciona tu app en Play Console.
  2. Ve a Configuración > Configuración avanzada.
  3. Haz clic en la pestaña Actions on Google.
  4. Marca la casilla Integrar mis servicios con acciones en las apps mediante Actions on Google y sigue las instrucciones.

El botón "Aceptar" del formulario de las Condiciones del Servicio de Play está inhabilitado

Esto puede significar que el usuario que accedió no tiene el nivel de acceso requerido para aceptar las condiciones. Asegúrate de que el administrador del perfil de Play Console realice el primer envío.

Herramienta de prueba de Acciones en apps

Antes de probar cualquiera de las siguientes soluciones, actualiza la instalación de la herramienta de prueba de Acciones en apps a la versión más reciente.

El complemento de la herramienta de prueba de Acciones en apps no puede encontrar mi archivo actions.xml.

Asegúrate de haber agregado la etiqueta <meta-data> correcta en el archivo AndroidManifest.xml.

Mi vista previa de Acciones en apps no coincide con mi archivo actions.xml actual

La vista previa no se actualiza de forma dinámica con el contenido del archivo actions.xml. Después de cambiar manualmente el archivo actions.xml o cambiar las variantes de compilación en Android Studio, guarda el archivo actions.xml y haz clic en Actualizar vista previa en la herramienta de prueba.

El complemento de la herramienta de prueba de Acciones en apps dejó de funcionar o genera errores

Primero, asegúrate de haber actualizado Android Studio a la versión más reciente. Si se produce un error 403, es posible que también estés ejecutando el complemento en un paquete en el que no tienes permisos para ejecutarlo.

Si el error persiste, informa un error y envía los siguientes detalles a Google:

  • Detalles del diálogo de error.
  • Registros de Android Studio. Ve a Help > Show Log in Finder. Muestra la ubicación de idea.log en tu Finder. Busca la opción "Submit Actions Request Body:" en el archivo de registro y pega las respuestas del servidor (debería haber dos resultados para las acciones).

La herramienta de prueba de Acciones en apps genera un problema de tipo UnknownHostException u otros errores de red

La herramienta de prueba de Acciones en apps crea una vista previa de tus Acciones en apps, lo que te permite probar las integraciones de Asistente de Google con una sola Cuenta de Google. Para crear estas vistas previas, la herramienta de prueba requiere una conexión a Internet activa y, si es necesario, acceso de proxy a los dominios de Google.

Para resolver los inconvenientes de red cuando ejecutas la herramienta de prueba, verifica los siguientes problemas comunes:

  • Asegúrate de tener una conexión a Internet activa antes de generar las vistas previas.

  • Si tu conexión a Internet está activa y tu red local usa un servidor proxy, verifica lo siguiente:

    • Verifica la configuración del proxy de IDE. Para obtener más información, consulta las instrucciones de configuración de proxy para Android Studio o IntelliJ.
    • Si tu proxy requiere una lista de control de acceso (LCA), actualiza la LCA para permitir este patrón de URL: https://actions.googleapis.com/**.

Cuando se invoca la Acción en la app con el complemento de prueba, Asistente dice "Lo siento, no pude encontrar eso"

Según tu configuración, esta respuesta puede aparecer por diferentes motivos. Prueba con los siguientes pasos:

  1. Accede a Android Studio, Play Console y tu dispositivo de prueba con la misma Cuenta de Google.
  2. Habilita la sincronización de datos del dispositivo.
  3. Establece el idioma de Asistente de Google y del dispositivo en en-US.
  4. Verifica que el nombre del paquete de la aplicación en Google Play Console coincida con el nombre del paquete en la aplicación de prueba.
  5. En la definición urlTemplate de entrega de tu archivo actions.xml, asegúrate de que los valores android:host y android:scheme coincidan con lo que se declaró en el archivo AndroidManifest.
  6. Quita todas las instalaciones anteriores de la app del dispositivo de prueba y, luego, instala una compilación nueva.
  7. Borra la vista previa de la herramienta de prueba de Acciones en apps y vuelve a crear una vista previa.
  8. Revisa la herramienta Logcat para ver las fallas relacionadas con la entrega de Asistente de Google. Deberías ver que se inició un intent en tu app.
  9. Habilita el parámetro "App info for your devices" para la cuenta.
  10. Abre Asistente de Google y asegúrate de haber completado el proceso de configuración (por lo general, el progreso de la configuración aparece como una barra azul en la parte inferior de la pantalla, pero puede variar en algunos casos).
  11. Cuando uses Asistente de Google para activar una Acción en la app, asegúrate de que el nombre de la invocación coincida con la vista previa que creó la herramienta de prueba de Acciones en apps.
  12. Utiliza la entrada de texto en lugar de la voz para evitar errores de transcripción.
  13. Configura tu compilación de prueba para que applicationId coincida exactamente con un APK o un AAB que se subió a Google Play Console. Ten en cuenta que las propiedades opcionales applicationIdSuffix pueden cambiar el applicationId final de las compilaciones para determinadas variantes de producto y de compilación. En este ejemplo, el applicationId para la variante de producto ficticia es com.example.android.architecture.blueprints.master.mock, en lugar de com.example.android.architecture.blueprints.
  14. Configura tu vista previa para que use un nombre de invocación único. Usa una palabra única que reduzca las probabilidades de colisión con otras apps.
  15. Para aislar problemas cuando solucionas problemas de una base de código que se puede compartir, intenta ejecutar la app de fitness de Acciones en apps de ejemplo. Asegúrate de que la app de fitness funcione de extremo a extremo. Luego, agrega funciones adicionales a esta app para ver si puedes replicar los problemas.
  16. Si usas cuentas de G Suite, asegúrate de que el administrador haya activado Asistente de Google. Recomendamos crear una cuenta de prueba que no sea de G Suite como solución alternativa y configurarla como un verificador con licencia a través de Play Store. Desde esa cuenta, los verificadores deberían poder crear vistas previas para su app y probarlas con esa cuenta en su dispositivo de forma correcta.
  17. Si descargaste Asistente de Google como una app separada, prueba forzar la detención en tu dispositivo. Por lo general, puedes hacerlo con la app de Configuración del teléfono.
  18. Si ninguno de estos pasos funciona, informa un problema en la Herramienta de seguimiento de errores de la Acción en la app.