החל משנת 2026, כדי להתאים את התהליך למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור תוספים ל-AOSP ולתרום לו, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main. ענף המניפסט android-latest-release תמיד יפנה לגרסה העדכנית ביותר שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

ActiveTrace

public class ActiveTrace
extends Object

java.lang.Object
↳	com.android.tradefed.invoker.tracing.ActiveTrace

המחלקות העיקריות שעוזרות לתאר ולנהל מעקב פעיל.

סיכום

ערכים קבועים
`String`	`TRACE_KEY`

Constructors ציבוריים
`ActiveTrace(long pid, long tid)`
`ActiveTrace(long pid, long tid, boolean mainProcess)` Constructor.

‫methods ציבוריים
`void`	`addSubprocessTrace(File subTrace)` מספקים את קובץ המעקב מתהליך משנה שרוצים להוסיף לתהליך האב.
`File`	`finalizeTracing()` מדווח על קובצי המעקב הסופיים ומנקה את המשאבים לפי הצורך.
`boolean`	`isMainTradefedProcess()`
`void`	`reportTraceEvent(String categories, String name, PerfettoTrace.TrackEvent.Type type)`
`void`	`reportTraceEvent(String categories, String name, int threadId, String threadName, PerfettoTrace.TrackEvent.Type type)` דיווח בסיסי מאוד על אירועים כדי לבצע התחלה / סיום של מעקב.
`long`	`reportingThreadId()` מזהה השרשור של השרשור שיזם את המעקב.
`void`	`startTracing(boolean isSubprocess)` מתחילים את המעקב ומדווחים על המטא-נתונים של המעקב.

ערכים קבועים

TRACE_KEY

public static final String TRACE_KEY

ערך קבוע: "invocation-trace"

Constructors ציבוריים

ActiveTrace

public ActiveTrace (long pid, 
                long tid)

פרמטרים
`pid`	`long`
`tid`	`long`

ActiveTrace

public ActiveTrace (long pid, 
                long tid, 
                boolean mainProcess)

Constructor.

פרמטרים
`pid`	‫`long`: מזהה התהליך הנוכחי
`tid`	‫`long`: מזהה השרשור הנוכחי
`mainProcess`	`boolean`

‫methods ציבוריים

addSubprocessTrace

public void addSubprocessTrace (File subTrace)

מציינים את קובץ המעקב מתהליך משנה שרוצים להוסיף לתהליך האב.

פרמטרים
`subTrace`	`File`

finalizeTracing

public File finalizeTracing ()

מדווח על קובצי המעקב הסופיים ומנקה את המשאבים לפי הצורך.

החזרות
`File`

isMainTradefedProcess

public boolean isMainTradefedProcess ()

החזרות
`boolean`

reportTraceEvent

public void reportTraceEvent (String categories, 
                String name, 
                PerfettoTrace.TrackEvent.Type type)

פרמטרים
`categories`	`String`
`name`	`String`
`type`	`PerfettoTrace.TrackEvent.Type`

reportTraceEvent

public void reportTraceEvent (String categories, 
                String name, 
                int threadId, 
                String threadName, 
                PerfettoTrace.TrackEvent.Type type)

דיווח בסיסי מאוד על אירועים כדי לבצע התחלה / סיום של מעקבים.

פרמטרים
`categories`	‫`String`: קטגוריה שמשויכת לאירוע
`name`	`String`: שם האירוע
`threadId`	`int`
`threadName`	`String`
`type`	`PerfettoTrace.TrackEvent.Type`: סוג האירוע שמדווחים עליו

reportingThreadId

public long reportingThreadId ()

מזהה השרשור של השרשור שיזם את המעקב.

החזרות
`long`

startTracing

public void startTracing (boolean isSubprocess)

מתחילים את המעקב ומדווחים על המטא-נתונים של המעקב.

פרמטרים
`isSubprocess`	`boolean`