diff options
Diffstat (limited to 'docs/html/tools')
| -rw-r--r-- | docs/html/tools/building/building-cmdline.jd | 8 | ||||
| -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 |
9 files changed, 256 insertions, 14 deletions
diff --git a/docs/html/tools/building/building-cmdline.jd b/docs/html/tools/building/building-cmdline.jd index 33798a5..0e4c8b2 100644 --- a/docs/html/tools/building/building-cmdline.jd +++ b/docs/html/tools/building/building-cmdline.jd @@ -43,7 +43,7 @@ parent.link=index.html <p>Whether you're building with the debug or release build type, you need to run and build your module. This will create the .apk file that you can install on an emulator or device. When you build using the debug build type, the .apk file is automatically signed by the SDK tools - with a debug key based on the <code>debuggable true</code> setting in the module's gradle.build file, + with a debug key based on the <code>debuggable true</code> setting in the module's build.gradle file, so it's instantly ready for installation onto an emulator or attached development device. You cannot distribute an application that is signed with a debug key. When you build using the release build type, the .apk file is <em>unsigned</em>, so you @@ -174,7 +174,7 @@ $ ./gradlew assembleRelease the build will prompt you for your keystore and alias password when you build using the release build type and produce your final application package, which will be ready for distribution.</p> - <p>To specify your keystore and alias, open the module gradle.build file (found in + <p>To specify your keystore and alias, open the module build.gradle file (found in the root of the module directory) and add entries for {@code storeFile}, {@code storePassword}, {@code keyAlias} and {@code keyPassword}. For example:</p> @@ -188,7 +188,7 @@ keyAlias "MyReleaseKey" <ol> <li>Open a command-line and navigate to the root of your module directory.</li> - <li>Edit the gradle.build file to build your project in release mode: + <li>Edit the build.gradle file to build your project in release mode: <p><pre> ... android { @@ -222,7 +222,7 @@ android { <p>This creates your Android application .apk file inside the module <code>build/</code> directory, named <code><em><your_module_name></em>-release.apk</code>. This .apk file has - been signed with the private key specified in gradle.build file and aligned with {@code + been signed with the private key specified in build.gradle file and aligned with {@code zipalign}. It's ready for installation and distribution.</p> <h3 id="OnceBuilt">Once built and signed in release mode</h3> 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> |