A continuación, se describen los comportamientos que puede encontrarse cuando utiliza AppStudio y que tienen alternativas o acciones conocidas que puede realizar para subsanar el problema.
Para informar u obtener más información sobre los errores en AppStudio, visite Soporte.
Instalación y configuración
- Cuando hago doble clic en el archivo de Linux .run, se carga Ubuntu Software Center y aparece un mensaje de error. ¿Por qué?
- ArcGIS AppStudio o se inicia y aparece un mensaje de error que indica que falta el archivo api-ms-win-crt-runtime-l1-1-0.dll.
- ArcGIS AppStudio no funciona en mi lugar de trabajo, pero sí funciona en línea.
- La consola de AppStudio no recibe los registros de la consola.
- Mi aplicación de ArcGIS Runtime se bloquea en Windows.
- No puedo crear un dispositivo virtual Android para probar mi aplicación.
- Tengo instalado Android Studio, pero AppStudio no lo reconoce.
- El texto a voz se expresa en árabe en iOS 14.
- La aplicación AppStudio 5.0 no se inicia en Ubuntu.
- El cuadro de diálogo de inicio de sesión de AppStudio aparece como una pantalla blanca en Ubuntu 22.04.
Configurar y ampliar aplicaciones
- Mi aplicación Quick Report existente no se ejecutará y aparecerá el mensaje de error: No se puede asignar a la propiedad onComposeError inexistente.
- No puedo identificar una capa de escena en la aplicación de plantilla 3D Scene Viewer.
- Mis consultas SQL fallan e informan que la tabla de base de datos está ahora bloqueada o que la conexión sigue en uso.
- Los métodos AppFramework.SecureStorage value y setValue devuelven el siguiente error en mi aplicación en macOS: El nombre de usuario o contraseña que ha introducido no es correcto.
- Mi aplicación se comporta de manera inesperada cuando se utiliza el teclado SwiftKey en Android.
- Al entregar una apiKey falsa a mapas de tipo TiledLayer o VectorTiledLayer, el mapa aparece, pero con un estilo inesperado.
Crear archivos de instalación
- Puedo crear mi aplicación para iOS sin proporcionar un certificado.
- Se recibe el mensaje de error de compilación El perfil de aprovisionamiento "ABC" tiene un Id. de aplicación "com.abc.xyz", que no coincide con el Id. de paquete "com.xyz.abc".
- Se recibe el mensaje de error de compilación El perfil de aprovisionamiento no es un perfil "ABC".
- Se recibe el mensaje de error de compilación Error de firma del código: el perfil de aprovisionamiento "ABC" no incluye el certificado de firma "DEF".
- Se recibe el mensaje de error de compilación Error de firma del código: el perfil de aprovisionamiento "ABC" no admite la funcionalidad Dominios asociados.
- Se recibe el mensaje de error de compilación Parámetros de firma de Android no válidos.
Envío a la tienda
Instalación y configuración
Cuando hago doble clic en el archivo de Linux .run, se carga Ubuntu Software Center y aparece un mensaje de error. ¿Por qué?
Cuando descarga un archivo .run de Internet, su permiso de ejecución está deshabilitado. Para habilitarlo, haga lo siguiente:
- Haga clic con el botón derecho en el archivo .run.
- Vaya a la pestaña Permisos.
- Active la casilla de verificación Permitir ejecutar el archivo como un programa.
- Haga clic en Cerrar.
Ahora, cuando haga doble clic en el archivo .run, se iniciará el asistente de instalación.
ArcGIS AppStudio o se inicia y aparece un mensaje de error que indica que falta el archivo api-ms-win-crt-runtime-l1-1-0.dll.
Este mensaje indica que faltan los componentes de Universal C Runtime en Windows, que son obligatorios para ejecutar AppStudio. Estos componentes se distribuyeron en una actualización de Windows que puede descargar desde el soporte técnico de Windows.
Probablemente se debe a que su lugar de trabajo controla el acceso a Internet mediante un script de configuración automática basado en reglas. Actualmente, AppStudio no detecta esta forma de proxy, es decir, la capacidad de la aplicación para conectarse a ArcGIS Online puede verse afectada. En este caso, puede que tenga que desactivar el script de configuración automática y configurar manualmente el servidor proxy mediante una combinación de dirección y puerto.
En Windows, las opciones que controlan este proceso se pueden encontrar en Configuración de red de área local (LAN) en Opciones de Internet.
Se debe probablemente a que el firewall está filtrando o bloqueando los mensajes de User Datagram Protocol (UDP) que muestra la herramienta de consola. Se puede solucionar desactivando el firewall o permitiendo excepciones para los paquetes UDP mientras se use la herramienta de consola. Si se trata de una red de mayor confianza, también puede restablecer el firewall para permitir los paquetes UDP cuando se solicite.
Se debe probablemente a que el controlador de gráficos de su equipo Windows no cumple los requisitos mínimos. OpenGL 2.1 es el requisito mínimo para visualizar mapas 2D cuando se ejecutan aplicaciones de ArcGIS Runtime y 3.2 es el requisito mínimo para visualizar escenas 3D. Es recomendable que utilice la versión más reciente del controlador.
Si utiliza máquinas virtuales para probar su aplicación en varias plataformas, no puede ejecutar emuladores de Android en ellas. Esto se debe a que los emuladores de Android utilizan el Hardware Accelerated Execution Manager (HAXM), un motor de visualización que no admite máquinas virtuales anidadas. Solo puede ejecutar un emulador de Android en un equipo físico.
Inicialmente, AppStudio busca archivos en la ubicación predeterminada de Android Studio. Si la ubicación del SDK de Android se ha configurado en Qt Creator, AppStudio la usará en su lugar.
Las rutas predeterminadas del SDK de cada plataforma son las siguientes:
- Windows: Users/YourName/AppData/Local/Android/sdk
- macOS: ~/Library/Android/sdk
- Linux: ~/Android/Sdk
Los archivos utilizados para rellenar la lista de dispositivos virtuales deben estar ubicados en las siguientes carpetas:
- La configuración de AVD se lee desde los subdirectorios de ~/.android.
- El código de autorización del emulador se lee desde ~/.emulator_console_auth_token.
- La ruta del comando adb es <SDKPATH>/platform-tools/adb.
- La ruta del comando del emulador es <SDKPATH>/tools/emulator.
En los dispositivos que ejecutan iOS 14 o versiones posteriores, no todas las voces de texto a voz están disponibles en el dispositivo de forma predeterminada. Como resultado, cuando se leen las alertas, es posible que se escuche un idioma inesperado, normalmente el árabe.
Los archivos de voz se pueden descargar manualmente en el dispositivo. Para descargar, vaya a Ajustes > Accesibilidad > VoiceOver > Leer > Voz y descargue una de las voces que coincida con el idioma del dispositivo. Puede encontrar el idioma del dispositivo tocando Ajustes > General > Idioma y región > Idioma del iPhone.
La próxima vez que AppStudio Player o su aplicación compilada se inicie, utilizará la voz descargada.
Las aplicaciones creadas con AppStudio 5.0 requieren que Ubuntu tenga instalado el paquete libxcb-xinerama0. Para instalar este paquete, en una ventana de terminal, ejecute sudo apt update, seguido de sudo apt install libxcb-xinerama0. Para confirmar que tiene instalado este paquete, ejecute apt list libxcb-xinerama0.
El cuadro de diálogo de inicio de sesión de AppStudio aparece como una pantalla blanca en Ubuntu 22.04.
Para asegurarse de que el cuadro de diálogo de inicio de sesión se muestre en esta versión de Ubuntu, la variable de entorno QTWEBENGINE_DISABLE_SANDBOX debe establecerse en 1. Para establecer esta variable de entorno en una ventana del terminal, ejecute export QTWEBENGINE_DISABLE_SANDBOX=1. Para confirmar que la variable de entorno esté establecida, ejecute printenv | grep QTWEBENGINE_DISABLE_SANDBOX y compruebe que se devuelva QTWEBENGINE_DISABLE_SANDBOX=1.
Configurar y ampliar aplicaciones
Mis consultas SQL fallan e informan que la tabla de base de datos está ahora bloqueada o que la conexión sigue en uso.
Estos son dos errores separados que se producen cuando se realiza una segunda consulta mediante el componente AppFramework.SQLQuery, antes de que se complete una primera consulta. Estos errores se pueden evitar utilizando el método finish para informar a la aplicación de que cualquier resultado restante de la primera consulta no es necesario, o al asegurarse de que todos los resultados se solicitan con llamadas iterativas al método next.
Los métodos AppFramework.SecureStorage value y setValue devuelven el siguiente error en mi aplicación en macOS: El nombre de usuario o contraseña que ha introducido no es correcto.
Una aplicación creada para macOS que utiliza los módulos SecureStorage y ArcGIS Runtime debe estar firmada para obtener acceso a la cadena de claves del sistema. Para obtener más información, consulte Firmar la aplicación macOS.
Se trata de un problema conocido de Qt y está previsto corregirlo en una versión futura. Si la aplicación utiliza texto predictivo, el empleo del teclado SwiftKey puede hacer que las entradas y los cálculos se muestren de manera incorrecta. Es posible que el teclado SwiftKey no pueda volver a abrirse si utiliza la tecla Intro.
Crear archivos de instalación
A diferencia de otras plataformas, las aplicaciones de iOS requieren certificado de producción firmado antes de poder crearlas, incluso a efectos de prueba. El intento de crearlas sin él genera un error. Para obtener más información sobre cómo obtener y mantener estos certificados, consulte Mantener identidades de firma en la App Distribution Guide de Apple. También necesitará asignar a la aplicación un Id. de paquete adecuado. Para ello, abra la ventana Configuración, disponible en el panel lateral de AppStudio, después, vaya a la pestaña iOS en el encabezado Plataformas. Para obtener más información, consulte Firmar la aplicación iOS.
Este error indica que el método de distribución elegido no coincide con el tipo de perfil de aprovisionamiento proporcionado con la solicitud de compilación. Vaya a Configuración > Plataforma > iOS > Método de distribución y asegúrese de que el método de distribución coincide con el tipo de perfil de aprovisionamiento que utilizará en la solicitud de compilación.
Se recibe el mensaje de error de compilación Error de firma del código: el perfil de aprovisionamiento "ABC" no admite la funcionalidad Dominios asociados.
Este error indica que su aplicación define un vínculo a su aplicación para que otras aplicaciones, que no estén registradas en developers.apple.com, lo utilicen. Para obtener más información, consulte la documentación de Apple acerca de Permitir que se vinculen aplicaciones y sitios web a su contenido.
Es posible que se reciba este error si intenta compilar su aplicación en otro equipo diferente al de los intentos anteriores. El archivo KeyStore no se guarda dentro del elemento de la aplicación; solo se guarda una referencia a su ubicación en el elemento. Para verificar que tiene acceso al archivo KeyStore correcto, vaya a Configuración > Plataforma > Android y asegúrese de que la ruta al archivo KeyStore y el alias de Clave sean correctos.
Envío a la tienda
Este error se debe a la presencia de píxeles transparentes o de un canal alfa en el icono de la aplicación. Elimínelos del icono, vuelva a compilar los archivos de instalación de la aplicación y vuelva a enviarlos a la tienda. Esta limitación solo es aplicable a la iOS App Store. La transparencia en iconos de aplicaciones se permite en otras plataformas. Puede especificar los iconos de aplicación específicos de la plataforma editando el archivo appinfo.json de su proyecto. En AppStudio, seleccione su aplicación de la galería y haga clic en Editar. Elija el archivo appinfo.json y edite el elemento resources para incluir propiedades de appIcon para cada plataforma, de forma similar al siguiente ejemplo:"resources": {
"android": {
"appIcon": "assets/android_appicon.png"
},
"ios": {
"appIcon": "assets/ios_appicon.png"
},
"linux": {
"appIcon": "linux_appicon.png"
},
"macos": {
"appIcon": "mac_appicon.png"
},
"windows": {
"appIcon": "windows_appicon.png"
},
"appIcon": "allNotSpecifiedOperatingSystems_appicon.png"
},
Al crear una entrada de la tienda de aplicaciones, debe definir un identificador único para su aplicación. Normalmente, este identificador tiene el formato com.sudominio.nombreaplicación. Asegúrese de que introduce el mismo identificador en Configuración > Plataforma > Android o Configuración > Plataforma > iOS. Tras introducir el identificador único, asegúrese de hacer clic en Aplicar y cargue la aplicación en su organización de ArcGIS antes de solicitar una compilación.
Cuando carga un APK en Google Play, es posible que reciba un mensaje de advertencia indicando que su APK es un APK sin optimizar y es posible que se le recomiende utilizar Paquetes de aplicaciones. Es una advertencia y no evita que continúe el proceso de publicación de su aplicación en Google Play. AppStudio admitirá los paquetes de aplicaciones en el futuro.