Catturare l'output della console

Lo strumento desktop Console consente di acquisire l'output della console, lo stesso che si visualizza correntemente in Qt Creator, da un'app AppStudio usando uno strmento desktop. Come con la console Qt Creator, è possibile utilizzare lo strumento Console con un'app in esecuzione sullo stesso computer, ma è possibile anche ricevere l'output da un altro dispositivo sulla stessa rete. Ciò è l'ideale per catturare l'output della console dal dispositivo iOS o Android e visualizzarlo sul desktop.

Quando si esegue un'app AppStudio su un dispositivo Android e l'applicazione si blocca, è possibile recuperare i file di log di sistema generati per eseguire la diagnostica e la risoluzione dei problemi. Questo richiede l'utilizzo degli strumenti SDK Android. Per maggiori informazioni, vedere l'articolo di conoscenza di base Come esportare un registro di crash (logcat) da un dispositivo Android.

Abilita lo strumento Console

Quando si avvia la versione ArcGIS AppStudio 1.2 o successiva, si vedrà il pulsante Console nella barra degli strumenti in cima all'app. Questo apre lo strumento Console.

Nota:

Per accedere a questo strumento non è necessario effettuare l'accesso.

Indirizzo del computer in Console

Eccetto i dettagli sul computer host, questa pagina sembra vuota a prima vista, poiché un'app deve essere reindirizzata a una console prima che le informazioni siano trasmesse alla console. Questo può essere fatto solo in un'app AppStudio che ha la registrazione abilitata.

Abilitare la registrazione in AppStudio Player

Per le app in fase di sviluppo o aziendali, AppStudio Player dispone di compatibilità integrata con la console. Per abilitare l'accesso a Player, aprire il menu laterale e scegliere l'opzione Connetti console remota. Sarà poi necessario scegliere tra uno dei tre metodi di connessione al dispositivo.

Connetti la pagina della console remota con le opzioni di connessione
  • Esegui scansione codice QR è utile quando si eseguono app in AppStudio Player su dispositivi mobili. Prima di eseguire la scansione codice QR, selezionare l’indirizzo IP sullo strumento della Console. Da quando il sistema esegue la consoole AppStudio potrebbe avere più indirizzi IP assegnati ad esso, il codice QR verrà generato per l'indirizzo selezionato dall'elenco a discesa che compare affianco ad esso. Facendo clic sul codice QR, ne viene visualizzata la versione estesa, utile se il dispositivo non è in grado di scansionare il codice più breve. Scannerizzare il codice QR generato a qualsiasi dimensione per completare la connessione.
    Un codice QR più grande per connettersi a una console
  • Connettersi tramite rete consente di scegliere una conesole AppStudio correntemente in esecuzione su una rete per completare la connessione.
  • Immetti indirizzo IP apre una nuova pagina in cui immettere manualmente l'indirizzo IP e la porta, ad esempio syslog://10.112.25.174:514. Selezionare Avanti per connettersi alla console.
    Immetti immagine indirizzo IP
    .

Qualsiasi metodo si selezioni, tutte le azioni eseguite in AppStudio Player invieranno messaggi alla console del desktop selezionato.

Registrare messaggi con Console

Dopo che AppStudio Player è stato connesso allo strumento Console, il campo Log posizioni di output si popolerà automaticamente con le informazioni del dispositivo connesso.

Console in azione

La console sul desktop selezionato mostrerà immediatamente le informazioni diagnostiche sia da AppStudio Player sia dall'app in esecuzione su di esso. I messaggi inviati da Player e dall'app si distinguono nella colonna App. La console riceve le informazioni finché non si disabilita l'accesso a AppStudio Player o non si fa clic su Stop nella console stessa.

Accesso ad altre console online

Lo strumento Console impiega il protocollo syslog, uno strumento di registrazione di informazioni in una rete od online ampiamente supportato e compatibile. Questo significa che è possibile usare la registrazione delle funzionalità di AppStudio Player e le app che supportano la console per inviare messaggi ad altre console syslog come Loggly.

A tale scopo, occorre immettere manualmente l'URL o l'indirizzo IP della posizione syslog nella casella di testo Accedi a posizione di output. Può essere necessario anche fornire l'ID utente. In tal caso, inserirlo nella casella di testo Dati utente. Per scoprire di più sulle informazioni ID utente Loggly, fare riferimento alla documentazione Loggly.

Salvare messaggi di log della console in un file

Lo strumento Console può anche esportare i messaggi ricevuti in un file di registro a cui si può fare riferimento in seguito o da inviare ad altri. A tale scopo, fare clic sul pulsante Salva nella console durante o dopo aver effettuato l'accesso. Una casella di dialogo compare, consentendo di scegliere la destinazione del file e il nome e salvare i risultati come file .log.

Aggiungere compatibilità della console alla propria app

È possibile inviare i messaggi della console alla propria app. Come minimo, la seguente riga del codice consentirà all'app di salvare i messaggi della console in un file di log esterno nella posizione predefinita sul dispositivo:

AppFramework.logging.enabled = true;

Nota:

Per garantire che sia possibile creare tale file quando si esegue l'app su un dispositivo Android, in Impostazione, nella scheda Funzionalità confermare che l'opzione Archivio esterno è selezionata.

Per esempi più dettagliati su come implementare la registrazione, consultare il modello aziendale di AppStudio Player fornito con AppStudio.