Esta ferramenta Console do desktop permite a você capturar a saída do console, a mesma que você visualiza no Qt Creator atualmente, de um aplicativo AppStudio utilizando uma ferramenta do desktop. Assim como no console Qt Creator, você pode usar a ferramenta Console com um aplicativo em execução na mesma máquina, mas também pode receber saída de outro dispositivo na mesma rede. Isto é ideal para capturar a saída do console do seu dispositivo iOS ou Android e visualizar em seu desktop.
Ao executar um aplicativo AppStudio em um dispositivo Android e o aplicativo travar, você pode recuperar os arquivos de log do sistema gerados para realizar diagnósticos e solução de problemas. Isso requer o uso de ferramentas SDK do Android. Para obter mais informações, consulte o artigo da base de conhecimento Como exportar um log de travamento (logcat) de um dispositivo Android.
Habilitar a ferramenta Console
Ao iniciar o ArcGIS AppStudio versão 1.2 ou posterior, você verá o botão Console na barra de ferramentas na parte superior do aplicativo. Isso abre a ferramenta Console.
Anotação:
O acesso para esta ferramenta não exige que você esteja registrado.
Além dos detalhes do computador de hospedagem, esta página aparece vazia na primeira vez, pois um aplicativo precisa ser direcionado para um console antes que as informações sejam enviadas para ele. Isto pode ser feito somente em um aplicativo AppStudio que tem registro habilitado.
Habilitar registro no AppStudio Player
Para aplicativos enterprise ou em desenvolvimento, o AppStudio Player tem compatibilidade embutida com o console. Para habilitar o login no player, abra o menu lateral e pressione a opção Conectar console remoto . Você deve então escolher uma opção a partir de três métodos diferentes para conectar em seu dispositivo.
- Escanear o código QR é útil ao executar aplicativos no AppStudio Player em dispositivos móveis. Antes de escanear o código, selecione o endereço de IP na ferramenta Console. Já que o sistema executando o console do AppStudio pode ter vários endereços IP atribuídos a ele, o código QR será gerado para o endereço selecionado da lista suspensa e aparecerá ao lado dele. Clicar neste código QR exibe uma versão maior, que é útil se o dispositivo não conseguir digitalizar o código menor. Digitalize o código QR gerado em qualquer um dos tamanhos para completar a conexão.
- Conectar via rede permite a você escolher um console do AppStudio sendo executado atualmente em sua rede para completar a conexão.
- Digitar Endereço IP abre uma nova página onde você digita manualmente o endereço IP e a porta; por exemplo, syslog://10.112.25.174:514. Selecione Avançar para conectar ao console.
Com todos estes métodos, todas as ações que você executar no AppStudio Player enviarão mensagens para o console no desktop selecionado.
Mensagens de registro com Console
Após o AppStudio Player ter sido conectado à ferramenta Console, o campo Locais de saída do registro automaticamente preencherá com os detalhes do dispositivo conectado.
O console no desktop selecionado exibirá imediatamente as informações de diagnóstico do AppStudio Player e do aplicativo executando dentro dele. Mensagens do player e do aplicativo são distinguidas na coluna Aplicativo. O console receberá informações até você desabilitar o registro no AppStudio Player ou clicar em Parar no console.
Registrar em outros consoles online
A ferramenta Console utiliza o protocolo syslog, um meio amplamente suportado e compatível de informações de registro dentro de uma rede ou online. Isso significa que você pode usar os recursos de registro do AppStudio Player e aplicativos de suporte de console para enviar mensagens a outros consoles syslog, como o Loggly.
Para isto, digite manualmente a URL ou endereço IP de local do syslog na caixa de texto Local de saída do registro. Talvez seja necessário fornecer informações de ID do usuário. Digite isto na caixa de texto Dados do usuário. Para aprender mais sobre informações de ID do usuário e Loggly, consulte Documentação do Loggly.
Salvar mensagens de console registradas no arquivo
A ferramenta Console também pode exportar as mensagens recebidas para um arquivo de log que você pode consultar posteriormente ou enviar a outras pessoas. Para fazer isto, clique no botão Salvar no console durante ou após registrar. Uma caixa de diálogo é exibida, permitindo que você escolha o destino e o nome do arquivo e salve os resultados como um arquivo .log.
Adicionar compatibilidade de console no aplicativo
Você pode adicionar o recurso de enviar mensagens do console para seu próprio aplicativo. No mínimo, a seguinte linha de código permitirá que seu aplicativo emita mensagens do console em um arquivo de registro externo no local padrão do dispositivo:
AppFramework.logging.enabled = true;
Anotação:
Para garantir que este arquivo possa ser criado ao executar seu aplicativo em um dispositivo Android, em Configurações, na guia Recursos, confirme que Armazenamento Externo está selecionado.
Para obter exemplos mais detalhados de como você pode implementar o registro, consulte os modelos enterprise do AppStudio Player fornecidos com AppStudio.