Debug di JavaScript in Qt Creator

Stampa sulla console

Il metodo preferibile per eseguire il debug delle app AppStudio è impiegando messaggi console.log nel codice QML, in quanto tali messaggi vengono visualizzati nella console di Qt Creator e sono uguali per tutte le piattaforme. Questo metodo non richiede l'installazione del kit Qt, ma solo di AppStudio.

Per eseguire l'app in Qt Creator, fare clic su Esegui nel menu Strumenti > Esterno > AppStudio. È anche possibile premere Alt+Shift+R sulla tastiera, oppure fare clic sul pulsante Esegui in basso a sinistra della finestra di Qt Creator.

Modalità di debug di Qt Creator

La versione di Qt Creator inclusa con AppStudio versione 4.0 fornisce accesso immediato agli strumenti di debug di Qt Creator. Per aprire l’app in modalità di debug, premere F5 in Qt Creator, oppure fare clic sul pulsante Inizia il debug del progetto di avvio in basso a sinistra della finestra di Qt Creator.

Per ulteriori informazioni su come impiegare gli strumenti di debug di Qt Creator, consultare Interagire con il Debugger.

Nota:

Sebbene la documentazione di Qt contenga informazioni sul debug di C++, è richiesta una licenza Qt SDK per usare questo linguaggio, che non è fornito con AppStudio.

Punti di interruzione

I punti di interruzione possono essere usati in Qt Creator per interrompere l'app quando si raggiungono specifiche righe di codice, passando il controllo all’utente. In questo modo, è possibile esaminare lo stato dell'app e continuare l'esecuzione riga per riga o in modo continuo.

È possibile inserire un punto di interruzione nell’app in questo modo:

  • Premere F9 (F8 su macOS) con il puntatore posizionato sulla riga in cui si desidera inserire il punto di interruzione.
  • Fare clic sullo spazio a sinistra del numero della riga.
  • Fare doppio clic sulla parte vuota della vista Punti di interruzione e inserire un numero di riga nella finestra Aggiungi punti di interruzione visualizzata.
  • Selezionare Aggiungi punti di interruzione nella vista Punti di interruzione e inserire un numero di riga nella finestra Aggiungi punti di interruzione visualizzata.

In questo modo, l’app si interromperà in corrispondenza del punto in cui è stato impostato il punto di interruzione e il debugger in Qt Creator fornirà le opzioni per riprendere normalmente, interrompere l'app o passare a un'altra riga di codice.

Per aprire la finestra Modifica punti di interruzione, fare doppio clic sul punto di interruzione nella vista Punti di interruzione oppure fare clic con il tasto destro del mouse sul punto di interruzione nella vista del codice, quindi fare clic su Modifica punti di interruzione. In questa finestra è possibile impostare tipi diversi di punti di interruzione, le condizioni prima che l'app si interrompa nel punto di interruzione, il numero di volte in cui il punto di interruzione verrà ignorato prima di interrompere l'app e i comandi per passare automaticamente quando si raggiunge il punto di interruzione.

Per spostare un punto di interruzione, selezionarlo e trascinarlo nella posizione desiderata. Per eliminare un punto di interruzione, premere nuovamente F9 (F8 su macOS), fare clic sull’icona del punto di interruzione, oppure fare clic con il tasto destro del mouse sul punto di interruzione e selezionare Elimina punti di interruzione selezionati o Elimina tutti i punti di interruzione.

Per maggiori informazioni sui punti di interruzione, consultare Impostare i punti di interruzione nella documentazione di Qt.

QML Profiler

Oltre a causare possibili errori imprevisti che impediscono a un'app di funzionare come previsto, JavaScript può anche essere responsabile della riduzione delle prestazioni in un'app QML. Eseguire troppi JavaScript in un breve periodo di tempo, ad esempio, può provocare ritardi o cali di frame. Lo strumento QML Profiler può essere usato per trovare la causa dei cali nelle prestazioni monitorando dati come le funzionalità JavaScript in uso, l’uso della memoria e gli eventi di input.

Per abilitare QML Profiler, assicurarsi prima che l’app non stia eseguendo Qt Creator. Successivamente, con la vista Progetto dell’app aperta, selezionare Analizza > QML Profiler. L'app verrà aperta, con la sezione QML Profiler aperta in Qt Creator dietro di essa. Eseguire le azioni da profilare nell’app, poi fare clic su Stop nella sezione QML Profiler. La sezione QML Profiler fornisce un Grafico del comportamento dell'app. La vista del codice mostrerà anche i valori percentuali del tempo che l'app ha impiegato per eseguire ciascuna parte del suo codice.

Per maggiori informazioni su QML Profiler, consultare Profilatura delle applicazioni QML nella documentazione di Qt.