ردیابی
| جدیدترین بهروزرسانی | نسخه پایدار | نامزد انتشار | انتشار نسخه بتا | نسخه آلفا |
|---|---|---|---|---|
| ۲۱ اکتبر ۲۰۲۶ | ۲.۰.۵ | - | - | - |
اعلام وابستگیها
برای افزودن وابستگی به Tracing، باید مخزن Google Maven را به پروژهتان اضافه کنید. برای اطلاعات بیشتر، مخزن Maven در Google را بخوانید.
وابستگیهای لازم برای مصنوعات موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:
شیک
dependencies { def tracing_version = "2.0.5" // Core tracing API (for libraries and apps to emit trace events) implementation "androidx.tracing:tracing:$tracing_version" // In-process tracing backend and Perfetto sink (for apps) implementation "androidx.tracing:tracing-wire:$tracing_version" // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0) implementation "androidx.tracing:tracing-ktx:$tracing_version" }
کاتلین
dependencies { val tracing_version = "2.0.5" // Core tracing API (for libraries and apps to emit trace events) implementation("androidx.tracing:tracing:$tracing_version") // In-process tracing backend and Perfetto sink (for apps) implementation("androidx.tracing:tracing-wire:$tracing_version") // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0) implementation("androidx.tracing:tracing-ktx:$tracing_version") }
برای اطلاعات بیشتر درباره وابستگیها، به افزودن وابستگیهای ساخت مراجعه کنید.
بازخورد
بازخوردتان به بهبود Jetpack کمک میکند. اگر مشکل جدیدی پیدا کردید یا ایدهای برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبلاز ایجاد مشکل جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره میتوانید رأی خود را به مشکل موجود اضافه کنید.
برای اطلاعات بیشتر، مستندات Issue Tracker را ببینید.
ردیابی
نسخه ۲.۰
نسخه ۲.۰.۵
۲۱ اکتبر ۲۰۲۶
androidx.tracing:tracing-*:2.0.5 منتشر شده است. نسخه ۲.۰.۵ حاوی این ثبتها است.
رفع اشکالها
- شرایط رقابت در مدیریت استخر که در آن همان رشته میتوانست بهطور همزمان بستهها را تخلیه و آزاد کند، برطرف شد. این مشکل باعث بنبستهای احتمالی بهویژه هنگام استفاده از
EmptyCoroutineContextمیشد. (Ia0aef48c، b/570135466)
نسخه ۲.۰.۴
۱۲ اکتبر ۲۰۲۶
androidx.tracing:tracing-*:2.0.4 منتشر شده است. نسخه ۲.۰.۴ حاوی این ثبتها است.
رفع اشکالها
- شرایط رقابتی هنگام پاک کردن بستههای ردیابی برطرف شد. (aosp/4344047)
نسخه ۲.۰.۳
۲۳ سپتامبر ۲۰۲۶
androidx.tracing:tracing-*:2.0.3 منتشر شده است. نسخه ۲.۰.۳ حاوی این ارسالها است.
نسخه ۲.۰.۲
۹ سپتامبر ۲۰۲۶
androidx.tracing:tracing-*:2.0.2 منتشر شده است. نسخه ۲.۰.۲ حاوی این ثبتها است.
نسخه ۲.۰.۱
۲۶ اوت ۲۰۲۶
androidx.tracing:tracing-*:2.0.1 منتشر شده است. نسخه ۲.۰.۱ حاوی این ثبتها است.
نسخه ۲.۰.۰
۱۲ اوت ۲۰۲۶
androidx.tracing:tracing-*:2.0.0 منتشر شده است. نسخه ۲.۰.۰ حاوی این ارسالها است.
ویژگیهای اصلی نسخه 2.0.0:
میانای برنامهسازی کاربردی درحال پردازش جدید این موارد را فعال میکند:
- ضبط محتوای ردیابی درحال پردازش، در فیلد
- جریانهای Perfetto (پیکانها از یک برش به برش دیگر)
- حاشیهنویسیهای Perfetto (فرادادههای برش کلید/مقدار)
traceCoroutine() {}- Coroutine Tracing API که تعویضهای رشته را ردیابی میکند- فیلتر کردن دسته
- سربار بسیار کمتر نسبت به میانای برنامهسازی کاربردی
android.os.Traceو پوشانندهtrace() {}موجود - ردیابی KMP - میتواند در کتابخانههای بدون وابستگی Android و در پروژههای JVM میزبان استفاده شود
- ادغام با ضبط ردیابی سیستم پساز وقوع (بهطور پیشفرض در AndroidX Benchmark 1.5 پیادهسازی شده است)
توجه داشته باشید که میانگیر کنترلشده با فرایند ضبط میانگیرهای جدید ردیابی هنوز توسط ضبط ردیابی سیستم «استودیو» ضبط نشده است. این مشکل در نسخه پخش آتی در Studio Profilers برطرف خواهد شد.
میاناهای برنامهسازی کاربردی android.os.Trace / trace() {} موجود منسوخ نشدهاند. این میاناهای برنامهسازی کاربردی همچنان برای رویدادهای با بسامد پایین که باید همیشه در میانگیر ردگیری سیستم ثبت شوند، بهویژه در کتابخانهها، توصیه میشوند.
نسخه 2.0.0-rc01
۲۹ ژوئیه ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-rc01 منتشر شده است. نسخه 2.0.0-rc01 حاوی این کدهای ثبتشده است.
نسخه 2.0.0-beta01
۱۵ ژوئیه ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-beta01 منتشر شده است. نسخه 2.0.0-beta01 حاوی این موارد ثبت است.
تغییرات میانای برنامهسازی کاربردی
-
PerfettoCaptureوPerfettoTraceRuleاکنون میتوانند ردگیریهای درحال پردازش را ضبط کنند و آنها را برای بسته هدف ادغام کنند. (I9a00b، b/497959820) -
androidx.benchmarkاکنونminSdk۲۴ دارد. (Ic2a85)
رفع اشکالها
- Tracing 2.0-beta01 release. (I1b162)
- هنگام تولید اطلاعات قطعه، از شناسههای رشته خاص پلاتفرم استفاده کنید. (I6ba64)
نسخه 2.0.0-alpha09
۲۳ ژوئن ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha09 منتشر شده است. نسخه 2.0.0-alpha09 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- تغییر جزئی در میانای برنامهسازی کاربردی در
Tracerبرای رفع ابهام بینinstant(...)وwriteInstant(...). (I0935a) - افزودن پشتیبانی از کدهای انتشار در رویدادهای فوری. (I99f81)
- اجازه استفاده کامل از جریانهای Perfetto در میانای برنامهسازی کاربردی انتشار زمینه دستی آزمایشی. (I20cb6)
- Defer creation of the
BufferedSinkandProtoWriterinTraceSink. (Ibd098) -
Tracerرا برای کتابخانههای Java و Android ساده و قابلاتصال کنید. (I99111) - توسعهدهندگان کتابخانه بهراحتی میتوانند نمونهای از
TraceDriverرا که میتواند برای ردیابی درونفرایندی استفاده شود پیدا کنند. (Ia503e)
نسخه 2.0.0-alpha08
۱۹ مه ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha08 منتشر شده است. نسخه 2.0.0-alpha08 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- قابلیت کشف و لغو نمونههای
TraceDriverرا برای استفاده در سراسر فرایند اضافه کنید. (I3f715) - نام
Tracer.recordExceptionبهTracer.recordExceptionAndThrowتغییر کرد. (I4411f، b/503092450)
نسخه 2.0.0-alpha07
۶ مه ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha07 منتشر شده است. نسخه 2.0.0-alpha07 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- یک میانای برنامهسازی کاربردی اضافه کنید تا ردیاب خردی را بهدست آورید که بتوان از آن درصورت غیرفعال بودن ردیابی استفاده کرد. (I84c98)
- چرخه حیات ردیابی را با ردیابی سیستم سازگار کنید. (Ib391b)
- میاناهای برنامهسازی کاربردی شمارنده اکنون کاملاً بدون تخصیص هستند. (I5e73a)
رفع اشکالها
- قانون حفظ برای Perfetto SDK (
tracing-perfetto) اصلاح شد تا اطمینان حاصل شود که Perfetto SDK میتواند فعال شود. (I1d227) - قابلیت ردیابی رویدادهای
flush()را اضافه کنید. (I38014، b/495852704)
نسخه 2.0.0-alpha06
۲۲ آوریل ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha06 منتشر شده است. نسخه 2.0.0-alpha06 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- محدودیت
File.createPerfettoFile()را لغو کنید تا دیگران بتوانند بهطور ایمن سینک ایجاد کنند. وقتیblock()استثنایی درtrace/traceCoroutineایجاد میکند، رویدادinstantبرای استثنا با فرادادهای که نشاندهنده عناصر ردیابی پشته مربوطه است ایجاد کنید. (I682e5، b/501536851، b/437166283) - یک سربارگذاری
setCounter(...)اضافه کنید که نوع JavaLongرا میگیرد. (Ic0469, b/356082604) - Tracing 2.0 اکنون از
Longبرای شناسههایThreadمختص پلاتفرم استفاده میکند. (I67277)
رفع اشکالها
- اسناد مربوط به
AttributeEntry.reset()را بهبود دهید. (I5d3a1، b/496079439)
نسخه 2.0.0-alpha05
۸ آوریل ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha05 منتشر شده است. نسخه 2.0.0-alpha05 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
TraceSinkتوابع کارخانه اکنونTraceSinkرا برمیگردانند و نهAbstractTraceSink. اکنون فایلها پسوند یکتایی دارند. مطمئن میشویم که میتوانیم بهطور اتمی فایل جدیدی ایجاد کنیم که برای ذخیره بستههای ردیابی استفاده خواهد شد. (I4c4aa، b/496298726)- انتشار بافت روال همگام را سادهتر و سریعتر کنید. (Ia62db)
attributes()اختیاری را هنگام ساختنTraceDriverمعرفی کنید که روشی برای افزودن فراداده مربوط به ردگیری ارائه میدهد. (Ia147e)
رفع اشکالها
- رشتههای پردازش و قطعههای شمارنده اکنون همگامسازی شدهاند. این کار استثناهای فرم را برطرف میکند:
java.lang.NullPointerException: Cannot invoke "androidx.tracing.ThreadTrack.flush$tracing()" because "threadTrack" is null - Avoid emitting sink events when tracing is disabled.
نسخه 2.0.0-alpha04
۲۵ مارس ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha04 منتشر شده است. نسخه 2.0.0-alpha04 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
-
AbstractTraceDriverرا واقعاً انتزاعی کنید و پیادهسازیPerfettoرا به واحدtracing-wireمنتقل کنید. (Ie2f59) - نامهای توصیفیتری به پیادهسازیهای پایه بدهید تا از استفاده از نام اشتباه جلوگیری شود. توسعهدهندگانی که قبلاً
androidx.tracing.Trace{Sink|Driver}را گسترش میدادند، اکنون باید به استفاده ازAbstractTrace{Sink|Driver}روی آورند. (I9b46d)
نسخه 2.0.0-alpha03
۱۱ مارس ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha03 منتشر شده است. نسخه 2.0.0-alpha03 حاوی این ارسالها است.
تغییرات میانای برنامهسازی کاربردی
- پیادهسازی آزمایشی
InMemoryRingBufferTraceSinkاضافه شد که امکان تنظیم محدودیت ظرفیت را فراهم میکند و از نوشتن روی دیسک جلوگیری میکند، مگراینکه صریحاً درخواست شود. (I1dc44، b/484409653، I65a37، b/484409653) - رفع شرایط رقابتی هنگام انتشار رویدادهای ردیابی برای تعلیق و ازسرگیری کوروتین. (Ie145e)
رفع اشکالها
androidx.tracingدیگر بهطور پیشفرض تلاش نمیکند اتصالات را از روالهای همزمان والد به فرزند در ردگیریها ترسیم کند. این موضوع گیجکننده بوده است، زیرا قالب ردیابی زیربنایی از اتصالات1:NوN:1پشتیبانی نمیکند، که منجر به ایجاد لانهای از پیکانها بهدلیل ابهام درباره اینکه کدام برش همروال به چه چیزی متصل میشود، شده است. همچنان میتوانید بهطور دستی بااستفاده ازtokenForManualPropagation()API برای انتشار موافقت کنید، بهویژه زمانی که برای مورد استفاده شما مهم باشد. (Ib2cf9)
نسخه 2.0.0-alpha02
۲۵ فوریه ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha02 منتشر شده است. نسخه 2.0.0-alpha02 حاوی این commit-ها است.
ویژگیهای جدید
- بهبود عملکرد برای پیادهسازی Perfetto Trace Sink بااستفاده از
suspendCoroutineUninterceptedOrReturnذاتی (2ea97b).
نسخه 2.0.0-alpha01
۲۸ ژانویه ۲۰۲۶
androidx.tracing:tracing-*:2.0.0-alpha01 منتشر شده است. نسخه 2.0.0-alpha01 حاوی این ارسالها است.
ویژگیهای جدید
AndroidX Tracing 2.0 یک سطح میانای برنامهسازی کاربردی جدید و مهم برای ردیابی کمسربار و درونفرایندی معرفی میکند که مکمل میاناهای برنامهسازی کاربردی مبتنی بر android.os.Tracing موجود در Tracing 1.0 است. میاناهای برنامهسازی کاربردی جدید هم در Android و هم در JVM میزبان دردسترس هستند، که به ابزارهای میزبان امکان میدهد ردگیریهای سربار کم را برای تجزیهوتحلیل عملکرد، بااستفاده از همان قالب ردگیری استاندارد Perfetto، منتشر کنند.
ردگیریهای منتشرشده هم توسط Android Studio و هم Perfetto پشتیبانی میشوند و میتوانند با مجموعه ویژگیهای گستردهای ازجمله برچسبگذاری برشها با فراداده (مانند آرگومانهای تابع!) و انتشار ردگیری بافت کوروتین ضبط شوند.
این نسخه آلفای اولیه فقط برای گردشهای کاری ردیابی درحال پردازش درنظر گرفته شده است و هنوز با ردیابی سیستمعامل Android یا «ردیابی سیستم نمایهساز Studio» ادغام نشده است - این موارد در نسخه آلفای آینده ارائه خواهند شد.
/**
* A [TraceSink] defines how traces are serialized.
*
* [androidx.tracing.wire.TraceSink] uses the `Perfetto` trace packet format.
*/
fun createSink(): TraceSink {
val outputDirectory = File(/* pathname = */ "/tmp/perfetto")
// We are using the factory function defined in androidx.tracing.wire
return TraceSink(
sequenceId = 1,
directory = outputDirectory
)
}
/**
* Creates a new instance of [androidx.tracing.TraceDriver].
*/
fun createTraceDriver(): TraceDriver {
// We are using a factory function from androidx.tracing.wire here.
// `isEnabled` controls whether tracing is enabled for the application.
val driver = TraceDriver(sink = createSink(), isEnabled = true)
return driver
}
fun main() {
val driver = createTraceDriver()
driver.use {
driver.tracer.trace(category = CATEGORY_MAIN, name = "basic") {
Thread.sleep(100L)
}
}
}
تغییرات میانای برنامهسازی کاربردی
Tracerرا به ویژگیTraceDriverتبدیل کنید. (Iabd9b)- پشتیبانی از انتشار دستی بافت اضافه شد. (I899ff)
- افزودن قابلیت اضافه کردن اطلاعات پشته فراخوانی در بخش ردیابی. (If6a1b)
- میاناهای برنامهسازی کاربردی جدید
androidx.tracingرا معرفی کنید. (I5102b) - به رویدادهای فوری اجازه دهید فراداده داشته باشند و به رویدادهای فوری و شمارندهها شمارنده اضافه کنید. (Ia2ed3)
- مساحت سطح میانای برنامهسازی کاربردی حاشیهنویسیشده با
@DelicateTracingApiرا کاهش دهید. هیچچیز در میانای برنامهسازی کاربردی سطح بالا نباید به استفاده از@DelicateTracingApiنیاز داشته باشد. (I565e0) - با یکپارچه کردن
PropagationToken، انتشار بافت را ساده کنید. (Iab839) - میاناهای برنامهسازی کاربردی
BlackHoleرا درandroidx.benchmarkتثبیت کنید. (I2b67e، b/451749438) - افزودن قابلیت حاشیهنویسی بخش ردیابی بهعنوان گستره ریشه. (Ic8365)
- به توسعهدهنده اجازه دهید درباره کدهای انتشار صریح باشد. (I06bb1)
- نام
MetadataHandleCloseableبهEventMetadataCloseableو نامMetadataHandleبهEventMetadataتغییر کرد. همچنین یک آرگومان اختیاریCoroutinePropagationTokenبهTracer.traceCoroutineاضافه شد تا توسعهدهنده بتواند بهطور صریح کد انتشار را برای استفاده مشخص کند. (I219f7، b/454147392) - نقطه ورودی جدید
Tracerمعرفی شد که به توسعهدهندگان کنترل بسیار بیشتری بر نحوه ردیابی میدهد. (I24a7b) - افزودن توانایی کنترل نحوه انتشار بافت در
SliceTrack. (Ieb8fc) fillCountدرPooledTracePacketArrayاکنون بهدرستی بهعنوان فرار علامتگذاری شده است. (I75d2c)- علامتگذاری
MetadataEntry@DelicateTracingApi. (I8c723) - Add the ability for a
TraceSinkto be able to handle lost trace events (when the pool is exhausted). (I3b374) - افزودن توانایی انتشار مشروط رویدادهای ردیابی براساس گزاره. (I621b4)
- افزودن قابلیت اضافه کردن دستهها به رویداد ردیابی. (I449c2)
- علامتگذاری
TraceEvent،PooledTracePacketArrayبهعنوانDelicateTracingApi. (Iaac6d) -
ProcessTrack.id،ThreadTrack.id،ThreadTrack.name،CounterTrack.name، وCounterTrack.parentرا عمومی کنید. (I81210) - نام میانای برنامهسازی کاربردی
SliceTrack.traceFlow()بهtraceCoroutine()تغییر کرد. (I79ad0) - افزودن قابلیت اضافه کردن اطلاعات زمینهای به برشها ازطریق حاشیهنویسیهای اشکالزدایی در ردگیری Perfetto. (Ic2b56)
- امکان ساختن نمونهای از
WireTraceSinkباFile/OutputStreamرا فراهم کنید. (Iecea0) - Removing obsolete
@RequiresApi(21)annotations (Ic4792)
نسخه ۱.۳
نسخه ۱.۳.۰
۲۳ آوریل ۲۰۲۵
androidx.tracing:tracing:1.3.0، androidx.tracing:tracing-android:1.3.0، و androidx.tracing:tracing-ktx:1.3.0 منتشر شدهاند. نسخه ۱.۳.۰ حاوی این ثبتها است.
تغییرات مهم از نسخه ۱.۲.۰
- کلاس
androidx.tracing.Traceبه Kotlin تبدیل شد و همه کدها از واحدtracing-ktxبهtracingمنتقل شد. - crossinline را از trace بردارید تا بتوانید از آن در
@Composableاستفاده کنید. (I53882، b/248344805)
نسخه 1.3.0-rc01
۹ آوریل ۲۰۲۵
androidx.tracing:tracing:1.3.0-rc01، androidx.tracing:tracing-android:1.3.0-rc01، و androidx.tracing:tracing-ktx:1.3.0-rc01 بدون هیچ تغییری نسبتبه آخرین نسخه بتا منتشر شدهاند. نسخه 1.3.0-rc01 حاوی این موارد ثبت است.
نسخه 1.3.0-beta01
۱۲ فوریه ۲۰۲۵
androidx.tracing:tracing:1.3.0-beta01، androidx.tracing:tracing-android:1.3.0-beta01، و androidx.tracing:tracing-ktx:1.3.0-beta01 منتشر شدهاند. نسخه 1.3.0-beta01 حاوی این موارد ثبت است.
تغییرات میانای برنامهسازی کاربردی
- همه کدها را از واحد
tracing-ktxبهtracingمنتقل کردیم. (Iba550) - کلاس
androidx.tracing.Traceبه Kotlin تبدیل شد. (Ie4e5d)
رفع اشکالها
- طرحبندی دستی دسترسی به میاناهای برنامهسازی کاربردی پلاتفرم جدید برداشته شد زیرا این کار بهطور خودکار ازطریق مدلسازی میانای برنامهسازی کاربردی هنگام استفاده از R8 با AGP نسخه ۷.۳ یا جدیدتر (برای نمونه، R8 نسخه ۳.۳) و برای همه ساختها هنگام استفاده از AGP نسخه ۸.۱ یا جدیدتر (برای نمونه، D8 نسخه ۸.۱) انجام میشود. به کارخواهانی که از AGP استفاده نمیکنند توصیه میشود به D8 نسخه ۸.۱ یا بالاتر بهروزرسانی کنند. برای جزئیات بیشتر، این مقاله را ببینید. (Ia60e0، b/345472586)
نسخه 1.3.0-alpha02
۲۱ ژوئن ۲۰۲۳
androidx.tracing:tracing:1.3.0-alpha02 و androidx.tracing:tracing-ktx:1.3.0-alpha02 بدون تغییر نسبت به نسخه آلفای قبلی منتشر شدهاند. نسخه 1.3.0-alpha02 حاوی این commit-ها است.
نسخه 1.3.0-alpha01
۷ ژوئن ۲۰۲۳
androidx.tracing:tracing:1.3.0-alpha01 و androidx.tracing:tracing-ktx:1.3.0-alpha01 منتشر شدهاند. نسخه 1.3.0-alpha01 حاوی این commitها است.
تغییرات میانای برنامهسازی کاربردی
- crossinline را از trace بردارید تا بتوانید از آن در
@Composableاستفاده کنید. (I53882، b/248344805)
نسخه ۱.۲
نسخه ۱.۲.۰
۲۹ نوامبر ۲۰۲۳
androidx.tracing:tracing:1.2.0 و androidx.tracing:tracing-ktx:1.2.0 منتشر شدهاند. نسخه ۱.۲.۰ حاوی این ارسالها است.
تغییرات مهم از نسخه ۱.۱.۰
- افزودن انواع
trace()وtraceAsync()با رشته تنبل و محاسبه کوکی. همچنین اکنون اگرTrace.beginپرتاب کند، بهدرستی ازTrace.endرد میشود.
نسخه 1.2.0-rc01
۲۴ مه ۲۰۲۳
androidx.tracing:tracing:1.2.0-rc01 و androidx.tracing:tracing-ktx:1.2.0-rc01 منتشر شدهاند. نسخه 1.2.0-rc01 حاوی این commit-ها است.
رفع اشکالها
- Prevent crashes when long trace section names are passed by truncating automatically (Iaf6e2)
نسخه 1.2.0-beta04
۳ مه ۲۰۲۳
androidx.tracing:tracing:1.2.0-beta04 و androidx.tracing:tracing-ktx:1.2.0-beta04 بدون تغییر منتشر شدهاند. نسخه 1.2.0-beta04 شامل این commit-ها است.
نسخه 1.2.0-beta03
۵ آوریل ۲۰۲۳
androidx.tracing:tracing:1.2.0-beta03 و androidx.tracing:tracing-ktx:1.2.0-beta03 بدون تغییر جدیدی منتشر شدهاند. نسخه 1.2.0-beta03 حاوی این موارد است.
نسخه 1.2.0-beta02
۲۲ مارس ۲۰۲۳
androidx.tracing:tracing:1.2.0-beta02 و androidx.tracing:tracing-ktx:1.2.0-beta02 بدون هیچ تغییری نسبتبه نسخه بتای قبلی منتشر شدهاند. نسخه 1.2.0-beta02 حاوی این commit-ها است.
نسخه 1.2.0-beta01
۸ مارس ۲۰۲۳
androidx.tracing:tracing:1.2.0-beta01 و androidx.tracing:tracing-ktx:1.2.0-beta01 بدون هیچ تغییری نسبتبه آخرین نسخه آلفا منتشر شدهاند. نسخه 1.2.0-beta01 شامل این ارسالها است.
نسخه 1.2.0-alpha02
۲۳ فوریه ۲۰۲۳
androidx.tracing:tracing:1.2.0-alpha02 و androidx.tracing:tracing-ktx:1.2.0-alpha02 بدون تغییر نسبتبه نسخه آلفای قبلی منتشر شدهاند. نسخه 1.2.0-alpha02 شامل این commitها است.
رفع اشکالها
- این نسخه خطای
Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02را هنگام ارتقا بهandroidx.tracing: tracing-perfetto-common:1.0.0-alpha11برطرف میکند
نسخه 1.2.0-alpha01
۵ اکتبر ۲۰۲۲
androidx.tracing:tracing:1.2.0-alpha01 و androidx.tracing:tracing-ktx:1.2.0-alpha01 منتشر شدهاند. نسخه 1.2.0-alpha01 حاوی این commit-ها است.
ویژگیهای جدید
- افزودن انواع
trace()وtraceAsync()با رشته تنبل و محاسبه کوکی. همچنین اکنون اگرTrace.beginپرتاب کند، بهدرستی ازTrace.endرد میشود. (I31421، b/175233952، b/247066503)
نسخه ۱.۱
نسخه ۱.۱.۰
۱۱ مه ۲۰۲۲
androidx.tracing:tracing:1.1.0 و androidx.tracing:tracing-ktx:1.1.0 منتشر شدهاند. نسخه ۱.۱.۰ حاوی این ثبتها است.
تغییرات مهم از نسخه ۱.۰.۰
Trace.forceEnableAppTracing()یک API برای فعالسازی اجباری ضبط بخش ردیابی برنامه (یعنی android.os.Trace / androidx.tracing APIs) در ساختهای غیرقابلاشکالزدایی اضافه شد. این را در ابتدای راهاندازی فراخوانی کنید تا ردیابی دقیق سیستم غیرقابلاشکالزدایی را قبلاز معرفی برچسب مانیفست قابلنمایهسازی در API 29 فعال کنید. (I3a309)- Avoid class verification errors when Trace.java is loaded for the first time (05f6b4 and cb101f)
نسخه 1.1.0-rc01
۲۰ آوریل ۲۰۲۲
androidx.tracing:tracing:1.1.0-rc01 و androidx.tracing:tracing-ktx:1.1.0-rc01 منتشر شدهاند و از beta01 تغییری نکردهاند. نسخه 1.1.0-rc01 شامل این commit-ها است.
نسخه 1.1.0-beta01
۱ دسامبر ۲۰۲۱
androidx.tracing:tracing:1.1.0-beta01 و androidx.tracing:tracing-ktx:1.1.0-beta01 منتشر شدهاند. نسخه 1.1.0-beta01 حاوی این commit-ها است.
از 1.1.0-alpha02 تغییری داده نشده است.
نسخه 1.1.0-alpha02
۱۷ نوامبر ۲۰۲۱
androidx.tracing:tracing:1.1.0-alpha02 و androidx.tracing:tracing-ktx:1.1.0-alpha02 منتشر شدهاند. نسخه 1.1.0-alpha02 حاوی این commit-ها است.
ویژگیهای جدید
- Trace.forceEnableAppTracing() به API اضافه شد تا ضبط بخش ردیابی برنامه (یعنی android.os.Trace / andoridx.tracing APIs) را در ساختهای غیرقابلاشکالزدایی اجباراً فعال کند. این را در ابتدای راهاندازی فراخوانی کنید تا ردیابی دقیق سیستم غیرقابلاشکالزدایی را قبلاز معرفی برچسب مانیفست قابلنمایهسازی در API 29 فعال کنید. (I3a309)
نسخه 1.1.0-alpha01
۳ نوامبر ۲۰۲۱
androidx.tracing:tracing:1.1.0-alpha01 و androidx.tracing:tracing-ktx:1.1.0-alpha01 منتشر شدهاند. نسخه 1.1.0-alpha01 حاوی این commitها است.
رفع اشکالها
نسخه 1.0
نسخه ۱.۰.۰
۲۸ اکتبر ۲۰۲۰
androidx.tracing:tracing:1.0.0 و androidx.tracing:tracing-ktx:1.0.0 منتشر شدهاند. نسخه ۱.۰.۰ حاوی این ارسالها است.
ویژگیهای اصلی نسخه ۱.۰.۰
به نوشتن رویدادهای ردیابی در میانگیر ردیابی سیستم کمک میکند. این را میتوان بااستفاده از ابزارهایی مانند Systrace و Perfetto تجسم کرد. این کتابخانه جایگزین کلاس منسوخشده androidx.core.os.TraceCompat میشود.
نسخه 1.0.0-rc01
۱۴ اکتبر ۲۰۲۰
androidx.tracing:tracing:1.0.0-rc01 و androidx.tracing:tracing-ktx:1.0.0-rc01 منتشر شدهاند. نسخه 1.0.0-rc01 شامل این commit-ها است.
این نسخهٔ پخش با 1.0.0-beta01 یکسان است.
نسخه 1.0.0-beta01
۲۴ ژوئن ۲۰۲۰
androidx.tracing:tracing:1.0.0-beta01 و androidx.tracing:tracing-ktx:1.0.0-beta01 بدون هیچ تغییری از 1.0.0-alpha01 منتشر شدهاند. نسخه 1.0.0-beta01 شامل این commit-ها است.
نسخه 1.0.0-alpha01
۱۰ ژوئن ۲۰۲۰ (۲۱ خرداد ۱۳۹۹)
androidx.tracing:tracing:1.0.0-alpha01 و androidx.tracing:tracing-ktx:1.0.0-alpha01 منتشر شدهاند. نسخه 1.0.0-alpha01 حاوی این commit-ها است.
ویژگیهای جدید
androidx.tracing کتابخانهای است که به نوشتن رویدادهای ردیابی در میانگیر ردیابی سیستم کمک میکند. این را میتوان بااستفاده از ابزارهایی مانند Systrace و Perfetto تجسم کرد. این کتابخانه جایگزین کلاس منسوخشده androidx.core.os.TraceCompat میشود. این نسخهٔ پخش اولیه 1.0.0-alpha01 است.
ردیابی Perfetto
نسخه 1.0
نسخه ۱.۰.۱
۱۹ نوامبر ۲۰۲۵
androidx.tracing:tracing-perfetto:1.0.1، androidx.tracing:tracing-perfetto-binary:1.0.1، و androidx.tracing:tracing-perfetto-handshake:1.0.1 منتشر شدهاند. نسخه ۱.۰.۱ حاوی این ثبتها است.
رفع اشکالها
- پشتیبانی از اندازه صفحه ۱۶ کیلوبایتی (b7a7dd)
- طرحبندی دستی دسترسی به میاناهای برنامهسازی کاربردی پلاتفرم جدید برداشته شد زیرا این کار بهطور خودکار ازطریق مدلسازی میانای برنامهسازی کاربردی هنگام استفاده از R8 با AGP نسخه ۷.۳ یا جدیدتر (برای نمونه، R8 نسخه ۳.۳) و برای همه ساختها هنگام استفاده از AGP نسخه ۸.۱ یا جدیدتر (برای نمونه، D8 نسخه ۸.۱) انجام میشود. به کارخواهانی که از AGP استفاده نمیکنند توصیه میشود به D8 نسخه ۸.۱ یا بالاتر بهروزرسانی کنند. برای جزئیات بیشتر، این مقاله را ببینید. (Ia60e0، b/345472586)
- از بستهبندی نسخههای
FastNative/CriticalNativeدر کتابخانه اجتناب کنید و از نسخههای پلاتفرم پایدار استفاده کنید. (I8238a، b/35664282، b/280878596)
نسخه ۱.۰.۰
۴ اکتبر ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0، androidx.tracing:tracing-perfetto-binary:1.0.0، و androidx.tracing:tracing-perfetto-handshake:1.0.0 منتشر شدهاند. نسخه ۱.۰.۰ حاوی این ارسالها است.
ویژگیهای اصلی نسخه ۱.۰.۰
- این اولین نسخه پایدار از کتابخانههای Tracing-perfetto است.
نسخه 1.0.0-rc01
۲۰ سپتامبر ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-rc01، androidx.tracing:tracing-perfetto-binary:1.0.0-rc01، و androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 بدون هیچ تغییری نسبتبه آخرین نسخه بتا منتشر شدهاند. نسخه 1.0.0-rc01 شامل این commit-ها است.
نسخه 1.0.0-beta03
۳۰ اوت ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-beta03، androidx.tracing:tracing-perfetto-binary:1.0.0-beta03، و androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 منتشر شدهاند. نسخه 1.0.0-beta03 حاوی این ارسالها است.
- افزایش نسخه برای مطابقت با انتشار androidx.benchmark.
نسخه 1.0.0-beta02
۲۳ اوت ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-beta02، androidx.tracing:tracing-perfetto-binary:1.0.0-beta02، و androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 منتشر شدهاند. نسخه 1.0.0-beta02 شامل این commit-ها است.
ویژگیهای جدید
- پشتیبانی از ردیابی در راهاندازی برنامه (راهاندازی سرد) فعال شد.
نسخه 1.0.0-beta01
۱۸ ژوئیه ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-beta01، androidx.tracing:tracing-perfetto-binary:1.0.0-beta01، و androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 منتشر شدهاند. نسخه 1.0.0-beta01 شامل این commit-ها است.
تغییرات میانای برنامهسازی کاربردی
- نام
androidx.tracing.perfetto.Traceبهandroidx.tracing.perfetto.PerfettoSdkTraceتغییر کرد (I44af8) - ثابتهای «کد خروج» به «کد نتیجه» در پروتکل تغییر نام داده شد تا سازگاری حفظ شود (Id1d1e)
- نام
EnableTracingResponseبهResponseتغییر کرد. (I56275) - گزینهای برای فعال کردن ردیابی شروع سرد در حالت پایدار اضافه شد. تابعی برای پاک کردن ردیابی شروع سرد (دائمی یا غیردائمی) اضافه شد. (Iaa09d)
- میاناهای برنامهسازی کاربردی کیت توسعه نرمافزار Tracing Perfetto با
android.os.Traceسازگار شد. (I73ba0، b/282199917) - Moved to a factory pattern for
LibrarySourceallowing for future use-cases (e.g. loading the.sofile directly) to be easily added to the API if needed. (I128df) - Making
enableTracingColdStartparameters matchenableTracingImmediate(I54126) - متغیر مستقل
killProcessدرenableTracingColdStartبرداشته شد (I81c4d)
نسخه 1.0.0-alpha17
۲۱ ژوئن ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha17، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17، و androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 بدون تغییر نسبتبه نسخه آلفای قبلی منتشر شدهاند. نسخه 1.0.0-alpha17 حاوی این commit-ها است.
نسخه 1.0.0-alpha16
۷ ژوئن ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha16، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 بدون تغییر نسبتبه نسخه آلفای قبلی منتشر شدهاند. نسخه 1.0.0-alpha16 حاوی این ارسالها است.
نسخه 1.0.0-alpha15
۳ مه ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha15، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 بدون تغییر منتشر شدهاند. نسخه 1.0.0-alpha15 حاوی این commit-ها است.
نسخه 1.0.0-alpha14
۵ آوریل ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha14، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 بدون تغییر جدیدی منتشر شدهاند. نسخه 1.0.0-alpha14 شامل این commit-ها است.
نسخه 1.0.0-alpha13
۲۲ مارس ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha13، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 بدون هیچ تغییری نسبتبه آخرین انتشار، منتشر شدهاند. نسخه 1.0.0-alpha13 حاوی این commit-ها است.
نسخه 1.0.0-alpha12
۸ مارس ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha12، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 بدون تغییر نسبتبه نسخه آلفای قبلی منتشر شدهاند. نسخه 1.0.0-alpha12 حاوی این commit-ها است.
نسخه 1.0.0-alpha11
۲۲ فوریه ۲۰۲۳ (۳ اسفند ۱۴۰۱)
androidx.tracing:tracing-perfetto:1.0.0-alpha11، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 بدون تغییر منتشر شدهاند. نسخه 1.0.0-alpha11 حاوی این commit-ها است.
نسخه 1.0.0-alpha10
۸ فوریه ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha10، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 بدون تغییر منتشر شدند. نسخه 1.0.0-alpha10 حاوی این commit-ها است.
نسخه 1.0.0-alpha09
۱۰ فوریه ۲۰۲۳
androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 منتشر شده است. نسخه 1.0.0-alpha09 حاوی این ارسالها است.
ویژگیهای جدید
- انتشار نسخه جدید برای اینکه کتابخانههای
androidx.tracing:tracing-perfetto*: 1.0.0-alpha09دیگر بتوانند باهم کار کنند.
۱۱ ژانویه ۲۰۲۳
androidx.tracing:tracing-perfetto:1.0.0-alpha09 و androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 بدون تغییر منتشر شدهاند. نسخه 1.0.0-alpha09 حاوی این ارسالها است.
نسخه 1.0.0-alpha08
۷ دسامبر ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha08، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 منتشر شدهاند. نسخه 1.0.0-alpha08 حاوی این commit-ها است.
ویژگیهای جدید
- بهبود عملکرد با بهینهسازی نحوه مدیریت رشتهها.
رفع اشکالها
- یک قانون proguard اضافه شد که از هرس شدن روشهای
PerfettoNativeدرصورت استفاده از کلاس جلوگیری میکند (از خرابی در یک مورد خاص هنگام مقداردهی اولیه ردیابی، اما عدم وجود فراخوانیهای ردیابی در برنامه جلوگیری میکند).
نسخه 1.0.0-alpha07
۹ نوامبر ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha07، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 منتشر شدهاند. نسخه 1.0.0-alpha07 شامل این ارسالها است.
- سربار JNI میاناهای برنامهسازی کاربردی
androidx.tracing:tracing-perfettoکاهش یافته است.
نسخه 1.0.0-alpha06
۲۴ اکتبر ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha06، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 منتشر شدهاند. نسخه 1.0.0-alpha06 حاوی این commit-ها است.
- این بهروزرسانی شامل هیچ تغییری نیست، فقط شماره نسخه را برای همگامسازی با androidx.benchmark بهروز میکند.
نسخه 1.0.0-alpha05
۵ اکتبر ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha05، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 منتشر شدهاند. نسخه 1.0.0-alpha05 شامل این commit-ها است.
نسخه 1.0.0-alpha04
۲۱ سپتامبر ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha04، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 منتشر شدهاند. نسخه 1.0.0-alpha04 حاوی این commit-ها است.
نسخه 1.0.0-alpha03
۷ سپتامبر ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha03، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 منتشر شدهاند.
ویژگیهای جدید
- هیچ ویژگی جدیدی از 1.0.0-alpha02 وجود ندارد.
نسخه 1.0.0-alpha02
۲۴ اوت ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha02، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 منتشر شدهاند. نسخه 1.0.0-alpha02 حاوی این commit-ها است.
رفع اشکالها
- چندین بهبود در مقداردهی اولیه سرویس Perfetto
- مدیریت بهبودیافته برای موارد بدون پاسخ با معرفی کد خروج اختصاصی: RESULT_CODE_CANCELLED.
- مدیریت خطاهای تجزیه بهبود یافته است.
EnableTracingResponse.requiredVersionرا قابلتهی کردیم، زیرا اگر نتوانیم با بسته ارتباط برقرار کنیم، نمیتوانیم نسخه را بدانیم. (I5ba20)
نسخه 1.0.0-alpha01
۲۷ ژوئیه ۲۰۲۲
androidx.tracing:tracing-perfetto:1.0.0-alpha01، androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01، و androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 منتشر شدهاند. نسخه 1.0.0-alpha01 حاوی این commit-ها است.
- توجه: همه کتابخانههای
androidx.tracing:tracing-perfetto*در ابتدا فقط برای استفاده داخلی در کتابخانههای AndroidX درنظر گرفته شدهاند. نباید نیازی به وابستگی مستقیم به آنها داشته باشید.
ویژگیهای جدید
همه کتابخانههای
androidx.tracing:tracing-perfetto*در ابتدا فقط برای استفاده داخلی در کتابخانههای AndroidX درنظر گرفته شدهاند و نباید نیازی به وابستگی مستقیم به آنها داشته باشید. ما این جزئیات پیادهسازی را برای شفافیت مستند میکنیم.
androidx.tracing:tracing-perfettoکتابخانهای است که به نوشتن رویدادهای ردیابی بااستفاده از Perfetto SDK با سربار کم کمک میکند. این را میتوان در Benchmark، Android Studio، یا Perfetto UI استفاده کرد.
androidx.tracing:tracing-perfetto-binaryمجموعهای از وابستگیهای دودویی است که برای androidx.tracing:tracing-perfetto لازم است.
androidx.tracing:tracing-perfetto-commonیک وابستگی داخلی androidx.tracing:tracing-perfetto است و میتواند توسط ابزارها برای ادغام با androidx.tracing:tracing-perfetto استفاده شود.