dmtracedump
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
dmtracedump ابزاری است که نمودارهای پشته تماس گرافیکی را از فایل‌های ثبت ردیابی تولید می‌کند. این ابزار از ابزار Graphviz Dot برای ایجاد خروجی گرافیکی استفاده می کند، بنابراین قبل از اجرای dmtracedump باید Graphviz را نصب کنید. اگر هنوز گزارش‌های ردیابی ایجاد نکرده‌اید و آن‌ها را از دستگاه متصل خود در دستگاه محلی خود ذخیره نکرده‌اید، به «ایجاد گزارش‌های ردیابی با ابزارسازی برنامه» بروید.
ابزار dmtracedump داده های پشته تماس را به صورت نمودار درختی تولید می کند که در آن هر گره یک فراخوانی متد را نشان می دهد. جریان تماس (از گره والد به گره فرزند) را با استفاده از فلش نشان می دهد. نمودار زیر یک نمونه خروجی از dmtracedump را نشان می دهد.
ابزار dmtracedump در بسته Android SDK Tools ارائه شده است و در android-sdk /platform-tools/ قرار دارد.
نحو
کاربرد dmtracedump به صورت زیر است:
dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] trace-base-name
سپس این ابزار داده های گزارش ردیابی را از trace-base-name .data و trace-base-name .key بارگیری می کند.
گزینه های جهانی
| گزینه های جهانی | توضیحات |
|---|
-h | خروجی HTML را روشن کنید |
-o | به جای پروفایل کردن، فایل ردیابی را تخلیه کنید |
دستورات و گزینه های فرمان
| دستورات و گزینه ها | توضیحات |
|---|
-d trace-base-name | با این نام ردیابی تفاوت دارد |
-g outfile | تولید خروجی به outfile |
-s sortable | پایگاه URL به محل فایل جاوا اسکریپت قابل مرتب سازی |
-t percent | حداقل آستانه برای گنجاندن گره های فرزند در نمودار (زمان فراگیر کودک به عنوان درصدی از زمان فراگیر والدین). در صورت عدم استفاده از این گزینه، آستانه پیش فرض 20 درصد است. |
خروجی
شکل 1. تصویری از dmtracedump
برای هر گره در نمودار، dmtracedump اطلاعات زیر را نشان می دهد:
ref callname (inc-ms, exc-ms,numcalls)
-
ref - شماره مرجع تماس، همانطور که در گزارش های ردیابی استفاده می شود -
inc-ms — زمان سپری شده فراگیر (میلی ثانیه های صرف شده در روش، از جمله همه روش های فرزند) -
exc-ms - زمان انحصاری سپری شده (میلی ثانیه های صرف شده در روش، بدون احتساب هیچ روش فرزند) -
numcalls - تعداد تماس‌ها
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# dmtracedump\n\n`dmtracedump` is a tool that generates\ngraphical call-stack diagrams from trace log files. The tool uses the Graphviz\nDot utility to create the graphical output, so you need to install Graphviz\nbefore running `dmtracedump`. If you haven't yet generated trace logs and\nsaved them from your connected device to your local machine, go to\n[Generate trace logs by instrumenting your app](/studio/profile/generate-trace-logs).\n\nThe `dmtracedump` tool generates the call stack data as a tree diagram, where each\nnode represents a method call. It shows call flow (from parent node to child nodes)\nusing arrows. The diagram below shows a sample output of `dmtracedump`.\n\nThe `dmtracedump` tool is provided in the Android SDK Tools package and is\nlocated in \u003cvar translate=\"no\"\u003eandroid-sdk\u003c/var\u003e`/platform-tools/`.\n\nSyntax\n------\n\nThe usage for dmtracedump is: \n\n```\ndmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] trace-base-name\n```\n\nThe tool then loads trace log data from \u003cvar translate=\"no\"\u003etrace-base-name\u003c/var\u003e`.data` and\n\u003cvar translate=\"no\"\u003etrace-base-name\u003c/var\u003e`.key`.\n\n### Global options\n\n| Global options | Description |\n|----------------|------------------------------------------|\n| `-h` | Turn on HTML output |\n| `-o` | Dump the trace file instead of profiling |\n\n### Commands and command options\n\n| Commands and options | Description |\n|------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `-d `\u003cvar translate=\"no\"\u003etrace-base-name\u003c/var\u003e | Diff with this trace name |\n| `-g `\u003cvar translate=\"no\"\u003eoutfile\u003c/var\u003e | Generate output to \u003cvar translate=\"no\"\u003eoutfile\u003c/var\u003e |\n| `-s `\u003cvar translate=\"no\"\u003esortable\u003c/var\u003e | URL base to the location of the sortable javascript file |\n| `-t `\u003cvar translate=\"no\"\u003epercent\u003c/var\u003e | Minimum threshold for including child nodes in the graph (child's inclusive time as a percentage of parent inclusive time). If this option is not used, the default threshold is 20%. |\n\nOutput\n------\n\n\n**Figure 1.** Screenshot of dmtracedump\n\n\u003cbr /\u003e\n\nFor each node in the graph, `dmtracedump` shows the following\ninformation: \n\n```\nref callname (inc-ms, exc-ms,numcalls)\n```\n\n- \u003cvar translate=\"no\"\u003eref\u003c/var\u003e --- Call reference number, as used in trace logs\n- \u003cvar translate=\"no\"\u003einc-ms\u003c/var\u003e --- Inclusive elapsed time (milliseconds spent in method, including all child methods)\n- \u003cvar translate=\"no\"\u003eexc-ms\u003c/var\u003e --- Exclusive elapsed time (milliseconds spent in method, not including any child methods)\n- \u003cvar translate=\"no\"\u003enumcalls\u003c/var\u003e --- Number of calls"]]
