diff options
Diffstat (limited to 'docs/html/tools')
| -rw-r--r-- | docs/html/tools/debugging/ddms.jd | 6 | ||||
| -rw-r--r-- | docs/html/tools/debugging/debugging-tracing.jd | 12 | ||||
| -rw-r--r-- | docs/html/tools/help/hprof-conv.jd | 6 | ||||
| -rw-r--r-- | docs/html/tools/revisions/studio.jd | 15 | ||||
| -rw-r--r-- | docs/html/tools/support-library/features.jd | 9 | ||||
| -rw-r--r-- | docs/html/tools/support-library/index.jd | 210 | ||||
| -rw-r--r-- | docs/html/tools/testing/testing_eclipse.jd | 2 | ||||
| -rw-r--r-- | docs/html/tools/testing/testing_otheride.jd | 2 |
8 files changed, 252 insertions, 10 deletions
diff --git a/docs/html/tools/debugging/ddms.jd b/docs/html/tools/debugging/ddms.jd index d2fb47a..5822e27 100644 --- a/docs/html/tools/debugging/ddms.jd +++ b/docs/html/tools/debugging/ddms.jd @@ -140,7 +140,7 @@ parent.link=index.html <li>Click <strong>Get Allocations</strong> to see a list of objects that have been allocated since you clicked on the <strong>Start Tracking</strong> button. You can click on <strong>Get - Allocations</strong> again to append to the list new objects that that have been + Allocations</strong> again to append to the list new objects that have been allocated.</li> <li>To stop tracking or to clear the data and start over, click the <strong>Stop Tracking @@ -204,6 +204,10 @@ parent.link=index.html <li>Click the <strong>Start Method Profiling</strong> button.</li> + <li>In Android 4.4 and later, choose either trace-based profiling or sample-based profiling + with a specified sampling interval. For earlier versions of Android, only trace-based profiling + is available.</li> + <li>Interact with your application to start the methods that you want to profile.</li> <li>Click the <strong>Stop Method Profiling</strong> button. DDMS stops profiling your diff --git a/docs/html/tools/debugging/debugging-tracing.jd b/docs/html/tools/debugging/debugging-tracing.jd index bd4afbc..fa5b4e1 100644 --- a/docs/html/tools/debugging/debugging-tracing.jd +++ b/docs/html/tools/debugging/debugging-tracing.jd @@ -127,7 +127,7 @@ parent.link=index.html {@link android.os.Debug#startMethodTracing() startMethodTracing()} methods. In the call, you specify a base name for the trace files that the system generates. To stop tracing, call {@link android.os.Debug#stopMethodTracing() stopMethodTracing()}. These methods start and stop method - tracing across the entire virtual machine. For example, you could call + tracing across the entire virtual machine. For example, you could call {@link android.os.Debug#startMethodTracing() startMethodTracing()} in your activity's {@link android.app.Activity#onCreate onCreate()} method, and call {@link android.os.Debug#stopMethodTracing() stopMethodTracing()} in that activity's @@ -157,6 +157,13 @@ parent.link=index.html times are only useful in relation to other profile output, so you can see if changes have made the code faster or slower relative to a previous profiling run.</p> + <p>In Android 4.4 and later, you can use sample-based profiling to profile with less runtime + performance impact. To enable sample profiling, call {@link + android.os.Debug#startMethodTracingSampling(java.lang.String, int, int) + startMethodTracingSampling()} with a specified sampling interval. The system will then gather + samples periodically until tracing is stopped via {@link android.os.Debug#stopMethodTracing() + stopMethodTracing()}.</p> + <h2 id="copyingfiles">Copying Trace Files to a Host Machine</h2> <p>After your application has run and the system has created your trace files @@ -277,7 +284,8 @@ dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] <trace-base Traceview logging does not handle threads well, resulting in these two problems: <ol> - <li>If a thread exits during profiling, the thread name is not emitted;</li> + <li>If a thread exits during profiling, the thread name is not emitted (fixed in Android 5.1 + and later);</li> <li>The VM reuses thread IDs. If a thread stops and another starts, they may get the same ID.</li> diff --git a/docs/html/tools/help/hprof-conv.jd b/docs/html/tools/help/hprof-conv.jd index f96def2..982f337 100644 --- a/docs/html/tools/help/hprof-conv.jd +++ b/docs/html/tools/help/hprof-conv.jd @@ -8,9 +8,13 @@ The <code>hprof-conv</code> tool converts the HPROF file that is generated by the Android SDK tools to a standard format so you can view the file in a profiling tool of your choice. </p> -<pre> hprof-conv <infile> <outfile></pre> +<pre> hprof-conv [-z] <infile> <outfile></pre> <p> You can use "-" for <code><infile></code> or <code><outfile></code> to specify stdin or stdout. </p> + +<p> +You can use "-z" to filter out zygote allocations shared by all applications. +</p> diff --git a/docs/html/tools/revisions/studio.jd b/docs/html/tools/revisions/studio.jd index f530a5f..7138efe 100644 --- a/docs/html/tools/revisions/studio.jd +++ b/docs/html/tools/revisions/studio.jd @@ -43,6 +43,21 @@ Android Studio, as denoted by revision number. </p> <div class="toggle-content opened"> <p><a href="#" onclick="return toggleContent(this)"> <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" + alt=""/>Android Studio v1.2.1</a> <em>(May 2015)</em> + </p> + <div class="toggle-content-toggleme"> + <p>Various fixes and enhancements:</p> + <ul> + <li>Fixed minor performance and feature issues. </li> + </ul> + </div> +</div> + + + +<div class="toggle-content closed"> + <p><a href="#" onclick="return toggleContent(this)"> + <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt=""/>Android Studio v1.2.0</a> <em>(April 2015)</em> </p> diff --git a/docs/html/tools/support-library/features.jd b/docs/html/tools/support-library/features.jd index 119d74a..573baad 100644 --- a/docs/html/tools/support-library/features.jd +++ b/docs/html/tools/support-library/features.jd @@ -205,9 +205,12 @@ com.android.support:multidex:1.0.0 information on using the Action Bar, see the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guide. </li> - <li>{@link android.support.v7.app.ActionBarActivity} - Adds an application activity class that - must be used as a base class for activities that uses the Support Library action bar - implementation. + <li>{@link android.support.v7.app.AppCompatActivity} - Adds an application activity class that can + be used as a base class for activities that use the Support Library action bar + implementation. + </li> + <li>{@link android.support.v7.app.AppCompatDialog} - Adds a dialog class that can be used as a base + class for AppCompat themed dialogs. </li> <li>{@link android.support.v7.widget.ShareActionProvider} - Adds support for a standardized sharing action (such as email or posting to social applications) that can be included in an diff --git a/docs/html/tools/support-library/index.jd b/docs/html/tools/support-library/index.jd index 56a3954..1aef0c1 100644 --- a/docs/html/tools/support-library/index.jd +++ b/docs/html/tools/support-library/index.jd @@ -62,6 +62,211 @@ page.title=Support Library <div class="toggle-content opened"> <p id="rev21"><a href="#" onclick="return toggleContent(this)"> <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" alt="" +/>Android Support Library, revision 22.1.0</a> <em>(April 2015)</em> + </p> + <div class="toggle-content-toggleme"> + <dl> + <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt> + <dd> + <ul> + + <li>Added the {@link android.support.v4.graphics.ColorUtils ColorUtils} class + to provide a set of color-related utility methods. + </li> + <li>Added the {@link android.support.v4.graphics.drawable.DrawableCompat#unwrap unwrap()} and + {@link android.support.v4.graphics.drawable.DrawableCompat#wrap wrap()} methods to the + {@link android.support.v4.graphics.drawable.DrawableCompat} class , allowing you to use + {@link android.support.v4.graphics.drawable.DrawableCompat#setTint setTint()}, + {@link android.support.v4.graphics.drawable.DrawableCompat#setTintList setTintList()}, + and {@link android.support.v4.graphics.drawable.DrawableCompat#setTintMode setTintMode()} + on all API level 4 or higher devices. + </li> + <li>Added the {@link android.support.v4.os.TraceCompat} class to + write trace events to the system trace buffer, which can then be collected and + visualized using the <a href="{@docRoot}tools/help/systrace.html">Systrace</a> tool. + </li> + <li>Added the {@link android.support.v4.util.CircularIntArray} class + to create circular integer array data structures. + </li> + <li>Added the {@link android.support.v4.util.CircularArray#clear clear()}, + {@link android.support.v4.util.CircularArray#removeFromStart removeFromStart()}, + and {@link android.support.v4.util.CircularArray#removeFromEnd removeFromEnd()} + methods to the {@link android.support.v4.util.CircularArray} class. Also, changed the + existing methods in this class to be non-final. + </li> + <li>Added the {@link android.support.v4.view.InputDeviceCompat} + as a helper class to access data in the + {@link android.support.v4.view.InputDeviceCompat} class. + </li> + <li>Added the {@link android.support.v4.view.LayoutInflaterCompat} + class as a helper class to access data in the + {@link android.support.v4.view.LayoutInflaterCompat} class + and added the {@link android.support.v4.view.LayoutInflaterFactory} interface. + </li> + <li>Added classes, methods, and interfaces to support nested scrolling. + <ul> + <li>Added the {@link android.support.v4.view.NestedScrollingChildHelper} + and {@link android.support.v4.view.NestedScrollingParentHelper} + helper classes for implementing nested scrolling parent and child views.</li> + <li>Added the {@link android.support.v4.view.NestedScrollingChild} + interface to be implemented by {@link android.view.View} subclasses.</li> + <li>Added the {@link android.support.v4.view.NestedScrollingParent} + and {@link android.support.v4.view.ScrollingView} interfaces to support + scrolling operations and provide scroll related APIs.</li> + <li>Added the + {@link android.support.v4.view.ViewGroupCompat#getNestedScrollAxes + getNestedScrollAxes()} method to the {@link android.support.v4.view.ViewGroupCompat} + class.</li> + <li>Added methods to the {@link android.support.v4.view.ViewParentCompat} class to + support nested scrolling. + </li> + <li>Added the {@link android.support.v4.widget.NestedScrollView} + class to support nested scrolling parent and child on both new and old versions of + Android. + </li> + </ul> + </li> + <li>Added methods and constants to the {@link android.support.v4.view.MotionEventCompat} + class for getting axis values and event source. + </li> + <li>Updated the {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} + class to add methods for errors, content invalidation and labels. + </li> + <li>Added the following interpolation classses for animation: + {@link android.support.v4.view.animation.FastOutLinearInInterpolator}, + {@link android.support.v4.view.animation.FastOutSlowInInterpolator}, + {@link android.support.v4.view.animation.LinearOutSlowInInterpolator}, + {@link android.support.v4.view.animation.LinearOutSlowInInterpolator}, and + {@link android.support.v4.view.animation.PathInterpolatorCompat}. + </li> + <li>Added the {@link android.support.v4.widget.Space} class to create gaps between + components in general purpose layouts. This class is deprecated in the gridlayout library. + </li> + <li>Added the {@link android.support.v4.widget.TextViewCompat} class for accessing + features in a {@link android.widget.TextView}. + </li> + <li>Added a displacement parameter to the + {@link android.support.v4.widget.EdgeEffectCompat#onPull onPull()} method in the + {@link android.support.v4.widget.EdgeEffectCompat} class. + </li> + + </ul> + </dd> + + + <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library</a>:</dt> + <dd> + <ul> + <li>Added tint support to appcompat widgets, including + {@link android.support.v7.widget.AppCompatAutoCompleteTextView}, + {@link android.support.v7.widget.AppCompatButton}, + {@link android.support.v7.widget.AppCompatCheckBox}, + {@link android.support.v7.widget.AppCompatCheckedTextView}, + {@link android.support.v7.widget.AppCompatEditText}, + {@link android.support.v7.widget.AppCompatMultiAutoCompleteTextView}, + {@link android.support.v7.widget.AppCompatRadioButton}, + {@link android.support.v7.widget.AppCompatRatingBar}, + {@link android.support.v7.widget.AppCompatSpinner}, and + {@link android.support.v7.widget.AppCompatTextView}. + </li> + <li>Updated the {@link android.support.v7.app.AppCompatActivity} as the base + class for activities that use the support library action bar features. This class + replaces the deprecated {@link android.support.v7.app.ActionBarActivity}. + </li> + <li>Added the + {@link android.support.v7.app.AppCompatCallback} interface + to be implemented for AppCompat to be able to perform callbacks. + </li> + <li>Added the + {@link android.support.v7.app.AppCompatDelegate} abstract class + as a delegate you can use to extend AppCompat's support to any activity. + </li> + <li>Added the + {@link android.support.v7.app.AppCompatDialog} class + as the base class for AppCompat themed dialogs. + </li> + <li>Added the spinner style + {@link android.support.v7.app.AlertDialog} and + {@link android.support.v7.app.AlertDialog.Builder} classes to provide an AppCompat + themed {@link android.app.AlertDialog}. + </li> + <li>Added the {@link android.support.v7.graphics.Palette.Builder} class + for generating {@link android.support.v7.graphics.Palette} instances. + <ul> + <li>Added the + {@link android.support.v7.graphics.Palette#from} + method to the {@link android.support.v7.graphics.Palette} class to + start generating a Palette with the returned + {@link android.support.v7.graphics.Palette.Builder} instance. + </li> + <li>Deprecated the {@link android.support.v7.graphics.Palette#generate generate()} and + {@link android.support.v7.graphics.Palette#generateAsync generateAsync()} methods. + </li> + </ul> + </li> + + <li>Added the + {@link android.support.v7.widget.GridLayout.Spec#getAbsoluteAlignment + getAbsoluteAlignment()} method to the {@link android.support.v7.widget.GridLayout.Spec} + class. + </li> + <li>Deprecated use of <code>app:theme</code> for styling + {@link android.support.v7.widget.Toolbar}. You can now use + <code>android:theme</code> for toolbars on all API level 7 and higher devices and + <code>android:theme</code> support for all widgets on API level 11 and higher devices. + </li> + </ul> + </dd> + + + <dt>Changes for <a href="features.html#v17-leanback">v17 leanback library</a>:</dt> + <dd> + <ul> + <li> Added {@link android.support.v17.leanback.app.GuidedStepFragment}, + {@link android.support.v17.leanback.widget.GuidanceStylist} and + {@link android.support.v17.leanback.widget.GuidedActionsStylist} to support + creating multi-step decision flows. + </li> + </ul> + </dd> + + + <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview library</a>:</dt> + <dd> + <ul> + <li>Added {@link android.support.v7.util.SortedList} classes to display items in + a list order and provide notification of changes to the list. + </li> + <li>Added the {@link android.support.v7.widget.util.SortedListAdapterCallback} class + that can bind a sorted list to a + {@link android.support.v7.widget.RecyclerView.Adapter} class. + </li> + </ul> + </dd> + + + <dt>Changes for v8 renderscript library:</dt> + <dd> + <ul> + <li>Added the {@link android.support.v8.renderscript.ScriptIntrinsicHistogram} class for + use as a histogram filter.</li> + <li>Added the {@link android.support.v8.renderscript.ScriptIntrinsicResize} class for + performing a resize of a 2D allocation. + </li> + </ul> + </dd> + + </dl> + + + </div> +</div> <!-- end of collapsible section --> + + + +<div class="toggle-content closed"> + <p id="rev21"><a href="#" onclick="return toggleContent(this)"> + <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" />Android Support Library, revision 22</a> <em>(March 2015)</em> </p> <div class="toggle-content-toggleme"> @@ -159,6 +364,10 @@ page.title=Support Library </ul> </dd> + </div> +</div> + + <div class="toggle-content closed"> @@ -1113,4 +1322,3 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w <p>Initial release with the v4 library.</p> </div> </div> - diff --git a/docs/html/tools/testing/testing_eclipse.jd b/docs/html/tools/testing/testing_eclipse.jd index 7d3be47..6c9d55b 100644 --- a/docs/html/tools/testing/testing_eclipse.jd +++ b/docs/html/tools/testing/testing_eclipse.jd @@ -218,7 +218,7 @@ from Eclipse</a>. <p> Another useful convention is to add the method <code>testPreconditions()</code> to your test class. Use this method to test that the application under test is initialized correctly. If this - test fails, you know that that the initial conditions were in error. When this happens, further + test fails, you know that the initial conditions were in error. When this happens, further test results are suspect, regardless of whether or not the tests succeeded. </p> <p> diff --git a/docs/html/tools/testing/testing_otheride.jd b/docs/html/tools/testing/testing_otheride.jd index 9484158..a774087 100644 --- a/docs/html/tools/testing/testing_otheride.jd +++ b/docs/html/tools/testing/testing_otheride.jd @@ -281,7 +281,7 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd <p> Another useful convention is to add the method <code>testPreConditions()</code> to your test class. Use this method to test that the application under test is initialized correctly. If this - test fails, you know that that the initial conditions were in error. When this happens, further + test fails, you know that the initial conditions were in error. When this happens, further test results are suspect, regardless of whether or not the tests succeeded. </p> <p> |