ردیابی

رویدادهای ردیابی را در میان‌گیر ردیابی سیستم بنویسید یا ردیابی‌های کم‌سربار درحال پردازش را ضبط کنید.
جدیدترین به‌روزرسانی نسخه پایدار نامزد انتشار انتشار نسخه بتا نسخه آلفا
‫۲۱ اکتبر ۲۰۲۶ ۲.۰.۵ - - -

اعلام وابستگی‌ها

برای افزودن وابستگی به 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 BufferedSink and ProtoWriter in TraceSink. (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(...) اضافه کنید که نوع Java Long را می‌گیرد. (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 TraceSink to 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ها است.

رفع اشکال‌ها

  • Avoid class verification errors when Trace.java is loaded for the first time (05f6b4 and cb101f)

نسخه 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 LibrarySource allowing for future use-cases (e.g. loading the .so file directly) to be easily added to the API if needed. (I128df)
  • Making enableTracingColdStart parameters match enableTracingImmediate (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 استفاده شود.