page.title=Hierarchy Viewer Walkthrough
meta.tags="android, performance, profiling, tools, rendering, hierarchyviewer"
page.tags="android", "performance", "profiling", "tools", "rendering", "hierarchyviewer"
page.metaDescription=Visualize your app's view hierarchy to help you simplify your layouts.
page.image=tools/performance/thumbnails/tools_hierarchy_viewer.png
page.article=true
@jd:body
In this document
You should also read
This walkthrough shows the basic usage and workflow for the Hierarchy Viewer tool.
The Hierarchy Viewer tool visualizes your app's view hierarchy and
profiles the relative rendering speed for each view.
What it's good for:
- Simplifying your view hierarchy to reduce overdraw, and make it easier to manage.
- Finding potential rendering performance bottlenecks related to the structure and shape of your
view hierarchy.
Prerequisites
- A mobile device set up to work with Hierarchy Viewer:
-
- You must have Developer
Options enabled on your mobile device. You must use a physical device to get
accurate measurements.
- Set an {@code ANDROID_HVPROTO} environment variable on the desktop machine
that is connected to your device. For more information, see
Device Setup for Hierarchy Viewer.
- Debuggable app code with a view hierarchy. Use your own code, or the code for the Sunshine sample app from the Android Fundamentals Udacity course.
Working with Hierarchy Viewer
- Connect your mobile device to your computer.
- Open your application in Android Studio, build the source, and run it on your device.
- From Android Studio, start the Android Device Monitor: Tools > Android >
Android Device Monitor.
- Allow USB Debugging on your phone (if asked).
- Figure 2 illustrates what is initially shown in the Device Monitor tool. This varies
depending on your setup.
Make sure your device
and the package for your application are showing in the Devices (DDMS mode) or Windows
(Hierarchy Viewer mode) tab. You can choose Window > Reset Perspective to get
back to the default arrangement.
If the app does not appear, make sure you
followed the device
setup instructions, then start over at step 1.
- In Android Device Monitor (ADM), in the menu bar, choose Window > Open
Perspective, and in the popup click Hierarchy View.
OR
Click the Hierarchy View button if it's already visible.
- If not already open, the Hierarchy View panes open.
The example screen in Figure 4 shows an example of these panes.
- If you see a different window arrangement, in Android Device Manager, use
Window > Reset Perspective to return to the default layout for this tutorial.
- Double-click your application in the Windows tab. This populates the panes with the
view hierarchy of your application.
This display is a static representation of the complete view hierarchy defined for the
app.
- You can adjust the sizes of the panes and ADM will preserve your
arrangement in future sessions.
- If necessary, click the Layout View tab to hide the Console and show a wireframe of
your layout. The outline of the currently selected view is red. Click an outline to select
it.
- The rest of the panes:
- The Tree Overview in the upper right gives you a bird's-eye view of your
app's complete View Hierarchy.
- In the Tree Overview, move the gray viewport rectangle to change what section of
your hierarchy shows in the Tree View pane (in the center).
- In the Tree View, you can drag and zoom the tree using your mouse.
- Click on a View node to display details. Here is an annotated close-up of a node
and its details.
- Click the View Properties tab at the top right (next to the Windows tab) to see
properties of the selected View node.
- Double-click a View node in the Tree View to render it in a popup window.
- Nodes in the Tree View show a Type, which indicates the View class,
and an id, which is the view identifier in your code.