Ricerca traccia

Utilizza SQL per trovare stati specifici nelle tracce Winscope Perfetto. Utilizza il visualizzatore Ricerca globale nell'interfaccia utente di Winscope per eseguire query e visualizzare i risultati in formato tabellare:

Figura 1. Scheda Spettatori che hanno eseguito ricerche.

Il visualizzatore Ricerca ti consente di scrivere ed eseguire query SQL personalizzate sulle tracce Perfetto, nonché di accedere alle query recenti e salvate. Winscope fornisce viste SQL specializzate per facilitare la ricerca di tracce di SurfaceFlinger, Transazioni, Transizioni e ViewCapture.

Utilizza le seguenti convenzioni per tutte le visualizzazioni:

• Per le colonne property e flat_property:

  • I nomi delle proprietà sono in snake case, ad esempio visible_region da LayerProto.

  • La notazione con il punto rappresenta le proprietà nidificate, ad esempio, visible_region.rect.

  • I campi ripetuti in property sono distinti con parentesi quadre:

    Ad esempio, all'interno di due istanze del campo ripetuto visible_region.rect, il campo top è rappresentato da visible_region.rect[0].top e visible_region.rect[1].top.

  • I campi ripetuti in flat_property non sono distinguibili:

    Ad esempio, all'interno di due istanze del campo ripetuto visible_region.rect, il campo top è rappresentato da visible_region.rect.top in entrambe le istanze.

• Per le colonne value e previous_value, i valori booleani sono rappresentati da 0 (False) o 1 (True).

Winscope crea queste viste unendo i dati di tabelle specifiche della traccia con la tabella args di Perfetto. Puoi eseguire query direttamente su queste tabelle. Nella tabella args, le colonne key, flat_key e display_value sono analoghe alle colonne della vista property, flat_property e value rispettivamente.

args tabella:

Visualizzazioni SQL di SurfaceFlinger

I dati proto di SurfaceFlinger utilizzano questi formati:

• I dati del livello sono nel formato LayerProto.

• I dati della radice della gerarchia sono nel formato LayersSnapshotProto.

Per cercare i dati dei livelli, utilizza la visualizzazione sf_layer_search. Questa visualizzazione include le seguenti colonne:

Per cercare i dati della radice della gerarchia, utilizza la visualizzazione sf_hierarchy_root_search. Questa visualizzazione include le seguenti colonne:

Esempi di query

• Trova tutti i frame in cui il livello IME ha limiti dello schermo validi:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND property='screen_bounds.bottom'
    AND value<='24000'
  

• Trova tutti i fotogrammi in cui cambia il livello Taskbar color.a (alpha):

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'Taskbar%'
    AND property='color.a'
    AND value!=previous_value
  

• Trova tutti i frame in cui il limite inferiore di Wallpaper è minore o uguale a 2400:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name LIKE 'Wallpaper%'
    AND property='bounds.bottom'
    AND cast_int!(value) <= 2400
  

• Elenca tutte le proprietà per i display con uno stack di livelli valido:

  SELECT STATE.* FROM sf_hierarchy_root_search STATE_WITH_DISPLAY_ON
  INNER JOIN sf_hierarchy_root_search STATE
    ON STATE.state_id = STATE_WITH_DISPLAY_ON.state_id
    AND STATE_WITH_DISPLAY_ON.flat_property='displays.layer_stack'
    AND STATE_WITH_DISPLAY_ON.value!='4294967295'
    AND STATE.property LIKE CONCAT(
      SUBSTRING(
          STATE_WITH_DISPLAY_ON.property,
          0,
          instr(STATE_WITH_DISPLAY_ON.property, ']')
      ),
      '%'
    )
  

• Trovare tutti i frame in cui è visibile il gesto di scorrimento indietro

  SELECT DISTINCT STATE.ts FROM sf_layer_search STATE
    WHERE STATE.layer_name LIKE 'EdgeBackGestureHandler%'
  

Tabelle di dati

Le visualizzazioni SurfaceFlinger vengono create utilizzando le seguenti tabelle sottostanti.

surfaceflinger_layers_snapshot:

surfaceflinger_layer:

Visualizzazione SQL delle transazioni

I dati proto delle transazioni utilizzano il formato TransactionTraceEntry.

Per cercare i dati di traccia delle transazioni, utilizza la visualizzazione transactions_search. Questa visualizzazione include le seguenti colonne:

Esempi di query

• Trova il fotogramma in cui è stata applicata una transazione per modificare la posizione X del livello in -54.0:

  SELECT ts, transaction_id, value FROM transactions_search
    WHERE flat_property='transactions.layer_changes.x'
    AND value='-54.0'
  

• Trova il frame in cui è stato aggiunto il livello ImeContainer:

  SELECT ts FROM transactions_search
    WHERE flat_property='added_layers.name'
    AND value='ImeContainer'
  

Tabelle di dati

La visualizzazione SQL Transazioni viene creata utilizzando le seguenti tabelle sottostanti.

surfaceflinger_transactions:

android_surfaceflinger_transaction:

android_surfaceflinger_transaction_flag:

Le singole transazioni vengono aggiunte alla tabella args da diversi formati di messaggi proto in base al tipo di transazione:

• LAYER_ADDED: LayerCreationArgs format
• LAYER_CHANGED: LayerState format
• DISPLAY_ADDED: DisplayState format
• DISPLAY_CHANGED: DisplayState format
• LAYER_DESTROYED: Nessun argomento
• LAYER_HANDLE_DESTROYED: Nessun argomento
• DISPLAY_REMOVED: Nessun argomento
• NOOP: Nessun argomento

Visualizzazione SQL delle transizioni

I dati proto delle transizioni utilizzano il formato ShellTransition.

Per cercare i dati sulle transizioni, utilizza la visualizzazione transitions_search. Questa visualizzazione include le seguenti colonne:

Esempi di query

Trova le proprietà delle transizioni gestite da DefaultMixedHandler:

  SELECT
    PROPS.ts,
    PROPS.transition_id,
    PROPS.property,
    PROPS.value
  FROM transitions_search HANDLER_MATCH
  INNER JOIN transitions_search PROPS
    ON HANDLER_MATCH.transition_id = PROPS.transition_id
  WHERE HANDLER_MATCH.property = 'handler'
    AND HANDLER_MATCH.value LIKE "%DefaultMixedHandler"
  ORDER BY PROPS.transition_id, PROPS.property

Tabelle di dati

La visualizzazione Transizioni viene creata utilizzando le seguenti tabelle sottostanti.

window_manager_shell_transitions:

window_manager_shell_transition_handlers:

android_window_manager_shell_transition_participants:

Visualizzazione SQL ViewCapture

I dati proto ViewCapture utilizzano il formato View.

Per cercare i dati di ViewCapture, utilizza la visualizzazione viewcapture_search. Questa visualizzazione include le seguenti colonne:

Esempi di query

Trova tutti gli stati in cui SearchContainerView si è spostato nella direzione Y:

  SELECT * FROM viewcapture_search
  WHERE class_name LIKE '%SearchContainerView'
    AND flat_property='translation_y'
    AND value!=previous_value

Tabelle di dati

La vista ViewCapture viene creata utilizzando le seguenti tabelle sottostanti.

android_viewcapture:

android_viewcapture_view:

Tabella SQL ProtoLog

I dati proto ProtoLog utilizzano il formato ProtoLogMessage. Questa visualizzazione include le seguenti colonne:

Esempi di query

• Trovare tutti i log con un messaggio contenente transition:

  SELECT ts, message, location FROM protolog
    WHERE message LIKE '%transition%'
  

• Trova tutti i log che contengono ID transazione validi:

  CREATE PERFETTO VIEW valid_tx_ids AS
    SELECT DISTINCT transaction_id FROM transactions_search
    WHERE transaction_id IS NOT NULL AND transaction_id != '0';
  
  SELECT TRANS.transaction_id, message FROM valid_tx_ids TRANS
  INNER JOIN protolog LOGS
    ON LOGS.message LIKE CONCAT('%', TRANS.transaction_id, '%');
  

Esegui query

Puoi eseguire query di ricerca utilizzando il riquadro RICERCA GLOBALE a sinistra del visualizzatore Ricerca.

Quando interagisci per la prima volta con il riquadro GLOBAL SEARCH, la ricerca delle tracce viene inizializzata e Winscope crea le visualizzazioni SQL di assistenza. L'operazione richiede alcuni secondi. Durante l'inizializzazione della ricerca delle tracce, la cronologia non è disponibile.

Per avviare una query, scrivila nella casella di ricerca e fai clic su Esegui query di ricerca o premi Invio sulla tastiera per eseguirla.

Al termine, la tabella dei risultati viene visualizzata nel riquadro centrale. La query viene visualizzata sotto la casella di ricerca, con un campo per salvare la query tra le sessioni.

Puoi accedere alle query salvate facendo clic sulla scheda Salvate nel riquadro a sinistra e accedere alle query eseguite di recente facendo clic sulla scheda Recenti:

Figura 2. Riquadro a sinistra del visualizzatore di ricerca.

Risultati

Tutte le query restituiscono risultati tabulati, visualizzati in una visualizzazione scorrevole con un comportamento interattivo simile a quello dei visualizzatori di tracce basati sui log, ad esempio Transactions e ProtoLog:

Figura 3. Visualizzare i risultati della ricerca.

Se la tabella risultante contiene una colonna ts, i valori in questa colonna vengono interpretati come timestamp e aggiunti alla sovrapposizione della cronologia come una nuova riga di voci. Fai clic su questa riga e utilizza i tasti freccia sinistra e destra per spostarti tra le voci:

Figura 4. Cronologia delle ricerche.