diff --git a/docs/html/images/tools/studio-allocation-tracker-icon.png b/docs/html/images/tools/studio-allocation-tracker-icon.png new file mode 100644 index 0000000000000..3b6e5bafb575a Binary files /dev/null and b/docs/html/images/tools/studio-allocation-tracker-icon.png differ diff --git a/docs/html/images/tools/studio-allocation-tracker.png b/docs/html/images/tools/studio-allocation-tracker.png new file mode 100644 index 0000000000000..058a099b9bff3 Binary files /dev/null and b/docs/html/images/tools/studio-allocation-tracker.png differ diff --git a/docs/html/tools/debugging/debugging-memory.jd b/docs/html/tools/debugging/debugging-memory.jd index fc9520abe7f43..fc4f4bedd5113 100644 --- a/docs/html/tools/debugging/debugging-memory.jd +++ b/docs/html/tools/debugging/debugging-memory.jd @@ -300,7 +300,33 @@ allocations that need to be done for that behavior, what thread they are on, and from. This is extremely valuable for tightening up these paths to reduce the work they need and improve the overall smoothness of the UI.

-

To use Allocation Tracker:

+

To use the Allocation Tracker, open the Memory Monitor in Android Studio and click the + +Allocation Tracker icon. You can also track allocations in the Android Device Monitor:

+ + +

Android Studio

+

To use the Allocation Tracker in +Android Studio:

+ +
    +
  1. Start your app on a connected device or emulator
    2. +
  2. Open the Android run-tme window, and view the free and allocated memory in the Memory + Monitor.
    3. +
  3. Click the Allocation Tracker icon + () in the Memory Monitor tool bar to start and stop memory + allocations. +

    Android Studio creates the allocation file with the filename + Allocations-yyyy.mm.dd-hh.mm.ss.alloc in the Captures tab.

    +
    4. +
  4. Double-click the allocation file to open the Allocation viewer.
    5. +
  5. Identify which actions in your app are likely causing too much allocation and determine where + in your app you should try to reduce allocations and release resources. +
+ + + +

Device Monitor

  1. Open the Device Monitor.

    From your <sdk>/tools/ directory, launch the monitor tool.

    @@ -641,7 +667,7 @@ hprof-conv heap-original.hprof heap-converted.hprof

    Note: If you're using the version of DDMS that's integrated into -Eclipse, you do not need to perform the HPROF conversion—DDMS performs the conversion by +Eclipse, you do not need to perform the HPROF conversation—it performs the conversion by default.

    You can now load the converted file in MAT or another heap analysis tool that understands diff --git a/docs/html/tools/performance/allocation-tracker/index.jd b/docs/html/tools/performance/allocation-tracker/index.jd index e71b584ffba18..d68f601e7effa 100644 --- a/docs/html/tools/performance/allocation-tracker/index.jd +++ b/docs/html/tools/performance/allocation-tracker/index.jd @@ -90,19 +90,24 @@ page.article=true alt="" width="400px" />

    - Figure 1. Steps for starting Allocation Tracker. + Figure 1. Steps for starting Allocation Tracker in Android DDMS.

  2. Connect your mobile device to your computer.
    3. -
  3. Open your application in Android Studio, build the source, and run it on your device.
    4. +
  4. Open your application in Android Studio, build the source, and run it on your device or + emulator.
  5. Click the Android button at the bottom of your Android Studio window.
    6. -
  6. Click the RECORD button +
  7. If you are using the Android Device Monitor, click the RECORD button - (Start Allocation Tracking tooltip).
    8. + (Start Allocation Tracking tooltip) in the Android DDMS tool bar. If you are using Android + Studio, click the + + icon in the Memory Monitor tool + bar.
  8. Interact with your application.
    9. @@ -119,7 +124,7 @@ page.article=true alt="" width="440px" />

    - Figure 2. Example of Allocation Tracker output. + Figure 2. Example of Allocation Tracker output in Android DDMS.

    diff --git a/docs/html/tools/performance/comparison.jd b/docs/html/tools/performance/comparison.jd index 06407173fffa0..f79e762797f55 100644 --- a/docs/html/tools/performance/comparison.jd +++ b/docs/html/tools/performance/comparison.jd @@ -111,7 +111,7 @@ page.article=true

    Allocation Tracker

    -

    diff --git a/docs/html/tools/studio/index.jd b/docs/html/tools/studio/index.jd index bbb4edc230b8e..43cb2fe53ed52 100644 --- a/docs/html/tools/studio/index.jd +++ b/docs/html/tools/studio/index.jd @@ -226,6 +226,30 @@ snapshot in the Captures view and select Export to standard .hp +

    Allocation tracker

    +

    Android Studio allows you to track memory allocation as it monitors memory use. Tracking memory +allocation allows you to monitor where objects are being allocated when you perform certain actions. +Knowing these allocations enables you to adjust the method +calls related to those actions to optimize your app's performance and memory use.

    + + +

    Figure 6. Allocation tracker.

    + +

    Perform the following steps to track and analyze allocations:

    +
      +
    1. Click the Start/Stop Allocation Tracking icon + () in the + Memory Monitor. Android Studio starts tracking memory allocations.
      2. +
    2. Perform the tasks whose mallocs you want to track.
      3. +
    3. Click the Start/Stop Allocation Tracking icon again. Android Studio stops tracking mallocs + and saves the data to a file named Allocation-yyyy.mm.dd-hh.mm.ss.alloc. The + resulting file appears in the Captures tab.
      4. +
    4. Double-click the file to open it in the allocation viewer. +

      The allocation viewer allows you to view and analyze the allocations your app made while + running.

      5. +
    + +

    Data file access

    The Android SDK tools, such as Systrace, logcat, and