Comportamentos que você pode encontrar ao utilizar o AppStudio que têm soluções conhecidas ou ações que você pode executar para corrigir o problema estão descritas abaixo.
Para reportar ou obter mais informações sobre erros no AppStudio, visite Suporte.
Instalação e configuração
- Quando eu clico duas vezes no arquivo .run do Linux, o Centro de Software do Ubuntu carrega e eu obtenho uma mensagem de erro. Por quê?
- O ArcGIS AppStudio falha ao iniciar e uma mensagem de erro aparece declarando que o arquivo api-ms-win-crt-runtime-l1-1-0.dll está ausente.
- O ArcGIS AppStudio não funciona no meu local de trabalho, mas funciona fora do local.
- O console do AppStudio não está recebendo logs do console.
- Meu aplicativo ArcGIS Runtime encerra com erro no Windows.
- Eu não consigo criar um Dispositivo Virtual do Android para testar meu aplicativo.
- Eu instalei o Android Studio, mas o AppStudio não o reconhece.
- A conversão de texto em voz é expressa em Árabe no iOS 14.
- Meu aplicativo AppStudio 5.0 falha ao iniciar no Ubuntu.
- A caixa de diálogo de login AppStudio aparece como uma tela branca no Ubuntu 22.04.
Configurar e estender aplicaitvos
- Meu aplicativo Relatório Rápido existente não funciona e exibe a mensagem de erro Não é possível atribuir a propriedade não existente onComposeError.
- Não consigo identificar uma camada de cena no aplicativo modelo 3D Scene Viewer.
- Minhas consultas SQL estão falhando, relatando que a tabela do banco de dados agora está bloqueada ou que a conexão ainda está em uso.
- Os métodos do AppFramework.SecureStorage value e setValue retornam o seguinte erro no meu aplicativo macOS: O nome de usuário ou senha que você digitou não está correto.
- Meu aplicativo se comporta de maneira inesperada ao usar o teclado SwiftKey no Android.
- Ao passar uma apiKey falsa para mapas do tipo TiledLayer ou VectorTiledLayer, o mapa aparece mas com um estilo inesperado.
Criar arquivos de instalação
- Eu não consigo construir meu aplicativo no iOS sem fornecer um certificado.
- Mensagem de erro de construção O perfil de aprovisionamento "ABC" tem um ID de aplicativo "com.abc.xyz", que não corresponde ao ID de pacote "com.xyz.abc" recebida.
- Mensagem de erro de construção O perfil de aprovisionamento não tem um perfil "ABC" recebida.
- Mensagem de erro de construção Erro ao registrar código: O perfil de aprovisionamento "ABC" não inclui o certificado de registro "DEF" recebida.
- Mensagem de erro de construção Erro ao registrar código: O perfil de aprovisionamento "ABC" não suporta o recurso Domínios Associados recebida.
- Mensagem de erro de construção Parâmetros de registro do Android inválidos recebida.
Enviar para loja
Instalação e configuração
Quando eu clico duas vezes no arquivo .run do Linux, o Centro de Software do Ubuntu carrega e eu obtenho uma mensagem de erro. Por quê?
Quando você baixa um arquivo .run da Internet, sua permissão de execução é desativada. Para habilitá-la, faça o seguinte:
- Clique com o botão direito no arquivo .run.
- Vá até a guia Permissões.
- Marque a caixa de seleção Permitir executar o arquivo como programa.
- Clique em Fechar.
Agora quando você clicar duas vezes no arquivo .run , o assistente da instalação iniciará.
O ArcGIS AppStudio falha ao iniciar e uma mensagem de erro aparece declarando que o arquivo api-ms-win-crt-runtime-l1-1-0.dll está ausente.
Esta mensagem indica que Universal C Runtime nos componentes do Windows, que são exigidos para executar o AppStudio estão ausentes. Estes componentes foram distribuídos em uma atualização do Windows que pode ser baixada do suporte do Windows.
A razão mais provável para isto é que seu local de trabalho controla acesso de Internet por um script de configuração automática baseada em regra. Este formulário de proxy é atualmente não detectado pelo AppStudio, significando que a habilidade do aplicativo de conectar ao ArcGIS Online pode ser afetada. Neste caso, você pode precisar desativar o script de configuração automática e configurar manualmente o servidor proxy por endereço e combinação de porta.
No Windows, as opções que controlam este processo podem ser localizadas nas Configurações de Rede Local (LAN) nas Opções de Internet.
Provavelmente, isto ocorre pois as mensagens do User Datagram Protocol (UDP) que a ferramenta do console exibe estão sendo filtradas ou bloqueadas pelo firewall. Isto pode ser corrigido ao desativar o firewall ou permitir exceções para pacotes UDP durante o uso da ferramenta de console. Você também pode, para uma rede mais confiável, redefinir o firewall para permitir pacotes UDP quando desafiados.
Este erro é provavelmente devido ao controlador de gráficos da sua máquina Windows que não atende aos requisitos mínimos. OpenGL 2.1 é o requisito mínimo para visualizações de mapa 2D ao executar aplicativos ArcGIS Runtime e 3.2 é o requisito mínimo para visualizações de cena 3D. É recomendado a você utilizar o controlador disponível mais recente.
Se você utilizar máquinas virtuais para testar seu aplicativo em múltiplas plataformas, não será possível executar os emuladores do Android nelas. Isto é devido aos emuladores do Android utilizarem Hardware Accelerated Execution Manager (HAXM), um mecanismo de visualização que não suporta máquinas virtuais agrupadas. Você pode executar um emulador do Android somente em uma máquina física.
O AppStudio inicialmente procura por arquivos no local padrão do Android Studio. Se o local do Android SDK foi configurado no Qt Creator, o AppStudio utilizará isto ao invés.
Os caminhos padrão do SDK de cada plataforma são como seguem:
- Windows: Users/YourName/AppData/Local/Android/sdk
- macOS: ~/Library/Android/sdk
- Linux: ~/Android/Sdk
Os arquivos para preencher a lista do dispositivo virtual, devem estar localizados nas seguintes pastas:
- A configuração de AVD é lida a partir de subdiretórios em ~/.android.
- O emulador de código auth é lido a partir do ~/.emulator_console_auth_token. .
- O caminho do comando adb é <SDKPATH>/platform-tools/adb.
- O caminho do comando do emulador é <SDKPATH>/tools/emulator.
Em dispositivos que executam o iOS 14 ou posterior, nem todas as vozes da conversão de texto em voz estão disponíveis no dispositivo por padrão. Como resultado, quando os alertas são lidos, um idioma inesperado pode ser ouvido, geralmente o Árabe.
Os arquivos de voz podem ser baixados manualmente para o dispositivo. Para baixar, vá até Configurações > Accessibilidade > Narração > Idioma > Voz e baixe uma das vozes que corresponda ao idioma do dispositivo. Você pode encontrar o idioma do dispositivo ao tocar em Configurações > Geral > Idioma & Região > Idioma do Iphone.
Da próxima vez que o AppStudio Player ou seu aplicativo integrado for iniciado, ele usará a voz baixada.
Aplicativos construídos com AppStudio 5.0 exigem Ubuntu para ter o pacote do libxcb-xinerama0 instalado. Para instalar este pacote, em uma janela do terminal, execute o sudo apt update, seguido por sudo apt install libxcb-xinerama0. Para confirmar que você tem este pacote instalado, execute apt list libxcb-xinerama0.
Para garantir que a caixa de diálogo de login seja exibida nesta versão do Ubuntu, a variável de ambiente QTWEBENGINE_DISABLE_SANDBOX deve ser definida como 1. Para definir esta variável de ambiente, em uma janela de terminal, execute export QTWEBENGINE_DISABLE_SANDBOX=1. Para confirmar que a variável de ambiente está definida, execute printenv | grep QTWEBENGINE_DISABLE_SANDBOX e veja que QTWEBENGINE_DISABLE_SANDBOX=1 é retornado.
Configurar e estender aplicaitvos
Minhas consultas SQL estão falhando, relatando que a tabela do banco de dados agora está bloqueada ou que a conexão ainda está em uso.
Esses são dois erros separados causados quando uma segunda consulta usando o componente AppFramework.SQLQuery é iniciada, antes que uma primeira consulta seja concluída. Esses erros podem ser evitados usando o método finish para permitir que o aplicativo saiba que quaisquer resultados restantes da primeira consulta não são necessários ou garantindo que todos os resultados sejam solicitados com chamadas iterativas para o método next.
Os métodos do AppFramework.SecureStorage value e setValue retornam o seguinte erro no meu aplicativo macOS: O nome de usuário ou senha que você digitou não está correto.
Um aplicativo construído para macOS que utilize o SecureStorage e módulos do ArcGIS Runtime deve estar registrado para obter acesso às chaves do sistema. Para mais informações, consulte Registrar seu aplicativo macOS.
Este é um problema conhecido do Qt e esperado para ser corrigido em uma futura versão. Se o texto preditivo for usado pelo seu aplicativo, o uso do teclado SwiftKey pode fazer com que as entradas e cálculos sejam exibidos incorretamente. O teclado SwiftKey pode não ser capaz de ser reaberto se a tecla Enter for usada.
Criar arquivos de instalação
Diferentemente de outras plataformas, aplicativos iOS exigem um certificado de produção assinado antes que possam ser construídos, até para propósitos de teste. Tentar construir sem um certificado produz um erro. Para informações sobre obter e manter estes certificados, consulte Mantendo assinaturas de ativos no Guia de Distribuição do Aplicativo da Apple. Você também precisa atribuir um ID de pacote apropriado ao aplicativo, que pode ser feito abrindo a janela Configurações no painel lateral do AppStudio e navegando até a guia iOS no cabeçalho de Plataformas . Para mais informações, consulte Registrar seu aplicativo iOS.
Este erro indica que o método de distribuição escolhido não corresponde ao tipo do perfil de aprovisionamento fornecido com a solicitação de construção. Vá até Configurações > Plataforma > iOS > Método de Distribuição e certifique-se que o método de distribuição corresponda ao tipo do perfil de provisionamento que você usará na solicitação de construção.
Mensagem de erro de construção Erro ao registrar código: O perfil de aprovisionamento "ABC" não suporta o recurso Domínios Associados recebida.
Este erro indica que seu aplicativo define um link para seu aplicativo para usar por outro aplicativos, isto não é registrado no developers.apple.com. Para saber mais, consulte a documentação da Apple em Permitindo que Aplicativos e Sites se Cinculem ao Seu Conteúdo.
Este erro pode ser recebido se você estiver tentando construir seu aplicativo em uma máquina diferente das tentativas anteriores. O arquivo KeyStore não é salvo no item do aplicativo, apenas uma referência à sua localização é salva no item. Para verificar se você tem acesso ao arquivo KeyStore correto, vá até Configurações > Plataforma > Android e certifique-se que o caminho para o arquivo KeyStore e o nome alternativo da chave estejam corretos.
Enviar para loja
Esse erro é causado pela presença de pixels transparentes ou por um canal alfa no ícone do aplicativo. Remova-os do ícone, reconstrua os arquivos de instalação do aplicativo e reenvie para a loja. Esta limitação é aplicável apenas aoiOS App Store. A transparência nos ícones do aplicativo é permitida em outras plataformas. Você pode especificar ícones de aplicativos específicos da plataforma editando o arquivo appinfo.json do seu projeto. No AppStudio, selecione seu aplicativo da galeria e clique em Editar. Escolha o arquivo appinfo.json e edite o elemento resources para incluir as propriedades appIcon para cada plataforma, semelhante ao seguinte exemplo:"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"
},
Ao criar uma entrada do app store, você deve definir um identificador único para seu aplicativo. Este identificador é normalmente do formato com.yourdomain.appname. Certifique-se de inserir o mesmo identificador em Configurações > Plataforma > Android ou Configurações > Plataforma > iOS. Após inserir o identificador único, certifique-se de clicar em Aplicar e carregar o aplicativo na sua organização do ArcGIS antes de solicitar uma construção.
Quando você carrega um APK no Google Play, é possível receber uma mensagem de aviso que seu APK é um APK não otimizado e uma recomendação para usar App Bundles. Este é um aviso e não o impede de continuar o processo de publicação de seu aplicativo no Google Play. O AppStudio oferecerá suporte ao App Bundles no futuro.