am 75022d1d: am 7cf6aaf9: am 70e99bfe: am b50f2406: am 050f6611: am 78e5d183: Merge "Doc update: Misc doc bugs" into jb-mr1.1-docs
* commit '75022d1d86f73308ed1cb23220e97ba7865b06f6': Doc update: Misc doc bugs
This commit is contained in:
@@ -172,7 +172,7 @@ the user might not come back).</dd>
|
|||||||
|
|
||||||
<p>Most applications should implement at least these three methods for every fragment, but there are
|
<p>Most applications should implement at least these three methods for every fragment, but there are
|
||||||
several other callback methods you should also use to handle various stages of the
|
several other callback methods you should also use to handle various stages of the
|
||||||
fragment lifecycle. All the lifecycle callback methods are discussed more later, in the section
|
fragment lifecycle. All the lifecycle callback methods are discussed in more detail in the section
|
||||||
about <a href="#Lifecycle">Handling the Fragment Lifecycle</a>.</p>
|
about <a href="#Lifecycle">Handling the Fragment Lifecycle</a>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -479,7 +479,7 @@ ObjectAnimator.ofFloat(targetObject, "propName", 1f)
|
|||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li>Depending on what property or object you are animating, you might need to call the {@link
|
<li>Depending on what property or object you are animating, you might need to call the {@link
|
||||||
android.view.View#invalidate invalidate()} method on a View force the screen to redraw itself with the
|
android.view.View#invalidate invalidate()} method on a View to force the screen to redraw itself with the
|
||||||
updated animated values. You do this in the
|
updated animated values. You do this in the
|
||||||
{@link android.animation.ValueAnimator.AnimatorUpdateListener#onAnimationUpdate onAnimationUpdate()}
|
{@link android.animation.ValueAnimator.AnimatorUpdateListener#onAnimationUpdate onAnimationUpdate()}
|
||||||
callback. For example, animating the color property of a Drawable object only cause updates to the
|
callback. For example, animating the color property of a Drawable object only cause updates to the
|
||||||
@@ -825,7 +825,7 @@ rotationAnim.setDuration(5000ms);
|
|||||||
|
|
||||||
<h2 id="views">Animating Views</h2>
|
<h2 id="views">Animating Views</h2>
|
||||||
|
|
||||||
<p>The property animation system allow streamlined animation of View objects and offerse
|
<p>The property animation system allow streamlined animation of View objects and offers
|
||||||
a few advantages over the view animation system. The view
|
a few advantages over the view animation system. The view
|
||||||
animation system transformed View objects by changing the way that they were drawn. This was
|
animation system transformed View objects by changing the way that they were drawn. This was
|
||||||
handled in the container of each View, because the View itself had no properties to manipulate.
|
handled in the container of each View, because the View itself had no properties to manipulate.
|
||||||
|
|||||||
@@ -50,7 +50,7 @@ the {@code aapt} tool automatically generates.</p>
|
|||||||
<p>When your application is compiled, {@code aapt} generates the {@code R} class, which contains
|
<p>When your application is compiled, {@code aapt} generates the {@code R} class, which contains
|
||||||
resource IDs for all the resources in your {@code
|
resource IDs for all the resources in your {@code
|
||||||
res/} directory. For each type of resource, there is an {@code R} subclass (for example,
|
res/} directory. For each type of resource, there is an {@code R} subclass (for example,
|
||||||
{@code R.drawable} for all drawable resources) and for each resource of that type, there is a static
|
{@code R.drawable} for all drawable resources), and for each resource of that type, there is a static
|
||||||
integer (for example, {@code R.drawable.icon}). This integer is the resource ID that you can use
|
integer (for example, {@code R.drawable.icon}). This integer is the resource ID that you can use
|
||||||
to retrieve your resource.</p>
|
to retrieve your resource.</p>
|
||||||
|
|
||||||
@@ -68,7 +68,7 @@ resource is a simple value (such as a string).</li>
|
|||||||
|
|
||||||
<p>There are two ways you can access a resource:</p>
|
<p>There are two ways you can access a resource:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><strong>In code:</strong> Using an static integer from a sub-class of your {@code R}
|
<li><strong>In code:</strong> Using a static integer from a sub-class of your {@code R}
|
||||||
class, such as:
|
class, such as:
|
||||||
<pre class="classic no-pretty-print">R.string.hello</pre>
|
<pre class="classic no-pretty-print">R.string.hello</pre>
|
||||||
<p>{@code string} is the resource type and {@code hello} is the resource name. There are many
|
<p>{@code string} is the resource type and {@code hello} is the resource name. There are many
|
||||||
@@ -264,11 +264,13 @@ reference a system resource, you would need to include the package name. For exa
|
|||||||
android:text="@string/hello" />
|
android:text="@string/hello" />
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
<p class="note"><strong>Note:</strong> You should use string resources at all times, so that your
|
<p class="note"><strong>Note:</strong> You should use string resources at
|
||||||
application can be localized for other languages. For information about creating alternative
|
all times, so that your application can be localized for other languages.
|
||||||
|
For information about creating alternative
|
||||||
resources (such as localized strings), see <a
|
resources (such as localized strings), see <a
|
||||||
href="providing-resources.html#AlternativeResources">Providing Alternative
|
href="providing-resources.html#AlternativeResources">Providing Alternative
|
||||||
Resources</a>.</p>
|
Resources</a>. For a complete guide to localizing your application for other languages,
|
||||||
|
see <a href="localization.html">Localization</a>.</p>
|
||||||
|
|
||||||
<p>You can even use resources in XML to create aliases. For example, you can create a
|
<p>You can even use resources in XML to create aliases. For example, you can create a
|
||||||
drawable resource that is an alias for another drawable resource:</p>
|
drawable resource that is an alias for another drawable resource:</p>
|
||||||
|
|||||||
@@ -376,7 +376,7 @@ res/
|
|||||||
screen area. Specifically, the device's smallestWidth is the shortest of the screen's available
|
screen area. Specifically, the device's smallestWidth is the shortest of the screen's available
|
||||||
height and width (you may also think of it as the "smallest possible width" for the screen). You can
|
height and width (you may also think of it as the "smallest possible width" for the screen). You can
|
||||||
use this qualifier to ensure that, regardless of the screen's current orientation, your
|
use this qualifier to ensure that, regardless of the screen's current orientation, your
|
||||||
application's has at least {@code <N>} dps of width available for it UI.</p>
|
application has at least {@code <N>} dps of width available for its UI.</p>
|
||||||
<p>For example, if your layout requires that its smallest dimension of screen area be at
|
<p>For example, if your layout requires that its smallest dimension of screen area be at
|
||||||
least 600 dp at all times, then you can use this qualifer to create the layout resources, {@code
|
least 600 dp at all times, then you can use this qualifer to create the layout resources, {@code
|
||||||
res/layout-sw600dp/}. The system will use these resources only when the smallest dimension of
|
res/layout-sw600dp/}. The system will use these resources only when the smallest dimension of
|
||||||
|
|||||||
@@ -722,6 +722,7 @@ public boolean onCreateOptionsMenu(Menu menu) {
|
|||||||
// Get the SearchView and set the searchable configuration
|
// Get the SearchView and set the searchable configuration
|
||||||
SearchManager searchManager = (SearchManager) {@link android.app.Activity#getSystemService getSystemService}(Context.SEARCH_SERVICE);
|
SearchManager searchManager = (SearchManager) {@link android.app.Activity#getSystemService getSystemService}(Context.SEARCH_SERVICE);
|
||||||
SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView();
|
SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView();
|
||||||
|
// Assumes current activity is the searchable activity
|
||||||
searchView.setSearchableInfo(searchManager.getSearchableInfo({@link android.app.Activity#getComponentName()}));
|
searchView.setSearchableInfo(searchManager.getSearchableInfo({@link android.app.Activity#getComponentName()}));
|
||||||
searchView.setIconifiedByDefault(false); // Do not iconify the widget; expand it by default
|
searchView.setIconifiedByDefault(false); // Do not iconify the widget; expand it by default
|
||||||
|
|
||||||
|
|||||||
@@ -674,7 +674,7 @@ action view still appears in the action bar when the user selects the item. You
|
|||||||
view collapsible by adding {@code "collapseActionView"} to the {@code android:showAsAction}
|
view collapsible by adding {@code "collapseActionView"} to the {@code android:showAsAction}
|
||||||
attribute, as shown in the XML above.</p>
|
attribute, as shown in the XML above.</p>
|
||||||
|
|
||||||
<p>Because the system will expand the action view when the user selects the item, so you
|
<p>Because the system will expand the action view when the user selects the item, you
|
||||||
<em>do not</em> need to respond to the item in the {@link
|
<em>do not</em> need to respond to the item in the {@link
|
||||||
android.app.Activity#onOptionsItemSelected onOptionsItemSelected} callback. The system still calls
|
android.app.Activity#onOptionsItemSelected onOptionsItemSelected} callback. The system still calls
|
||||||
{@link android.app.Activity#onOptionsItemSelected onOptionsItemSelected()} when the user selects it,
|
{@link android.app.Activity#onOptionsItemSelected onOptionsItemSelected()} when the user selects it,
|
||||||
|
|||||||
@@ -54,7 +54,7 @@ parent.link=index.html
|
|||||||
<p>When DDMS starts, it connects to <a href="{@docRoot}tools/help/adb.html">adb</a>.
|
<p>When DDMS starts, it connects to <a href="{@docRoot}tools/help/adb.html">adb</a>.
|
||||||
When a device is connected, a VM monitoring service is created between
|
When a device is connected, a VM monitoring service is created between
|
||||||
<code>adb</code> and DDMS, which notifies DDMS when a VM on the device is started or terminated. Once a VM
|
<code>adb</code> and DDMS, which notifies DDMS when a VM on the device is started or terminated. Once a VM
|
||||||
is running, DDMS retrieves the the VM's process ID (pid), via <code>adb</code>, and opens a connection to the
|
is running, DDMS retrieves the VM's process ID (pid), via <code>adb</code>, and opens a connection to the
|
||||||
VM's debugger, through the adb daemon (adbd) on the device. DDMS can now talk to the VM using a
|
VM's debugger, through the adb daemon (adbd) on the device. DDMS can now talk to the VM using a
|
||||||
custom wire protocol.</p>
|
custom wire protocol.</p>
|
||||||
|
|
||||||
|
|||||||
@@ -30,7 +30,7 @@ device directly from Eclipse or from the command line with ADB. If
|
|||||||
you don't yet have a device, check with the service providers in your area to determine which
|
you don't yet have a device, check with the service providers in your area to determine which
|
||||||
Android-powered devices are available.</p>
|
Android-powered devices are available.</p>
|
||||||
|
|
||||||
<p>If you want a SIM-unlocked phone, then you might consider the Google Nexus S. To find a place
|
<p>If you want a SIM-unlocked phone, then you might consider a Nexus phone. To find a place
|
||||||
to purchase the Nexus S and other Android-powered devices, visit <a
|
to purchase the Nexus S and other Android-powered devices, visit <a
|
||||||
href="http://www.google.com/phone/detail/nexus-s">google.com/phone</a>.</p>
|
href="http://www.google.com/phone/detail/nexus-s">google.com/phone</a>.</p>
|
||||||
|
|
||||||
|
|||||||
@@ -68,12 +68,12 @@ page.title=Managing Projects
|
|||||||
<code>src<em>/your/package/namespace/ActivityName</em>.java</code>. All other source code
|
<code>src<em>/your/package/namespace/ActivityName</em>.java</code>. All other source code
|
||||||
files (such as <code>.java</code> or <code>.aidl</code> files) go here as well.</dd>
|
files (such as <code>.java</code> or <code>.aidl</code> files) go here as well.</dd>
|
||||||
|
|
||||||
<dt><code>bin</code></dt>
|
<dt><code>bin/</code></dt>
|
||||||
|
|
||||||
<dd>Output directory of the build. This is where you can find the final <code>.apk</code> file and other
|
<dd>Output directory of the build. This is where you can find the final <code>.apk</code> file and other
|
||||||
compiled resources.</dd>
|
compiled resources.</dd>
|
||||||
|
|
||||||
<dt><code>jni</code></dt>
|
<dt><code>jni/</code></dt>
|
||||||
|
|
||||||
<dd>Contains native code sources developed using the Android NDK. For more information, see the
|
<dd>Contains native code sources developed using the Android NDK. For more information, see the
|
||||||
<a href="{@docRoot}tools/sdk/ndk/index.html">Android NDK documentation</a>.</dd>
|
<a href="{@docRoot}tools/sdk/ndk/index.html">Android NDK documentation</a>.</dd>
|
||||||
@@ -88,7 +88,7 @@ page.title=Managing Projects
|
|||||||
<dd>This is empty. You can use it to store raw asset files. Files that you save here are
|
<dd>This is empty. You can use it to store raw asset files. Files that you save here are
|
||||||
compiled into an <code>.apk</code> file as-is, and the original filename is preserved. You can navigate this
|
compiled into an <code>.apk</code> file as-is, and the original filename is preserved. You can navigate this
|
||||||
directory in the same way as a typical file system using URIs and read files as a stream of
|
directory in the same way as a typical file system using URIs and read files as a stream of
|
||||||
bytes using the the {@link android.content.res.AssetManager}. For example, this is a good
|
bytes using the {@link android.content.res.AssetManager}. For example, this is a good
|
||||||
location for textures and game data.</dd>
|
location for textures and game data.</dd>
|
||||||
|
|
||||||
<dt><code>res/</code></dt>
|
<dt><code>res/</code></dt>
|
||||||
@@ -114,7 +114,7 @@ page.title=Managing Projects
|
|||||||
<dt><code>drawable/</code></dt>
|
<dt><code>drawable/</code></dt>
|
||||||
|
|
||||||
<dd>For bitmap files (PNG, JPEG, or GIF), 9-Patch image files, and XML files that describe
|
<dd>For bitmap files (PNG, JPEG, or GIF), 9-Patch image files, and XML files that describe
|
||||||
Drawable shapes or a Drawable objects that contain multiple states (normal, pressed, or
|
Drawable shapes or Drawable objects that contain multiple states (normal, pressed, or
|
||||||
focused). See the <a href=
|
focused). See the <a href=
|
||||||
"{@docRoot}guide/topics/resources/drawable-resource.html">Drawable</a> resource type.</dd>
|
"{@docRoot}guide/topics/resources/drawable-resource.html">Drawable</a> resource type.</dd>
|
||||||
|
|
||||||
@@ -251,7 +251,7 @@ used.</dd>
|
|||||||
code and resources as a standard Android project, stored in the same way. For example, source
|
code and resources as a standard Android project, stored in the same way. For example, source
|
||||||
code in the library project can access its own resources through its <code>R</code> class.</p>
|
code in the library project can access its own resources through its <code>R</code> class.</p>
|
||||||
|
|
||||||
<p>However, a library project differs from an standard Android application project in that you
|
<p>However, a library project differs from a standard Android application project in that you
|
||||||
cannot compile it directly to its own <code>.apk</code> and run it on an Android device.
|
cannot compile it directly to its own <code>.apk</code> and run it on an Android device.
|
||||||
Similarly, you cannot export the library project to a self-contained JAR file, as you would do
|
Similarly, you cannot export the library project to a self-contained JAR file, as you would do
|
||||||
for a true library. Instead, you must compile the library indirectly, by referencing the
|
for a true library. Instead, you must compile the library indirectly, by referencing the
|
||||||
|
|||||||
@@ -111,14 +111,14 @@ parent.link=index.html
|
|||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
The SDK tools for building and tests are available in Eclipse with ADT, and also in
|
The SDK tools for building and tests are available in Eclipse with ADT, and also in
|
||||||
command-line form for use with other IDES. These tools get information from the project of
|
command-line form for use with other IDEs. These tools get information from the project of
|
||||||
the application under test and use this information to automatically create the build files,
|
the application under test and use this information to automatically create the build files,
|
||||||
manifest file, and directory structure for the test package.
|
manifest file, and directory structure for the test package.
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
The SDK also provides
|
The SDK also provides
|
||||||
<a href="{@docRoot}tools/help/monkeyrunner_concepts.html">monkeyrunner</a>, an API
|
<a href="{@docRoot}tools/help/monkeyrunner_concepts.html">monkeyrunner</a>, an API
|
||||||
testing devices with Python programs, and <a
|
for testing devices with Python programs, and <a
|
||||||
href="{@docRoot}tools/help/monkey.html">UI/Application Exerciser Monkey</a>,
|
href="{@docRoot}tools/help/monkey.html">UI/Application Exerciser Monkey</a>,
|
||||||
a command-line tool for stress-testing UIs by sending pseudo-random events to a device.
|
a command-line tool for stress-testing UIs by sending pseudo-random events to a device.
|
||||||
</li>
|
</li>
|
||||||
|
|||||||
@@ -34,7 +34,7 @@ development steps encompass four development phases, which include:</p>
|
|||||||
</li>
|
</li>
|
||||||
<li><strong>Development</strong>
|
<li><strong>Development</strong>
|
||||||
<p>During this phase you set up and develop your Android project, which contains all of the
|
<p>During this phase you set up and develop your Android project, which contains all of the
|
||||||
source code and resource files for your application. For more informations, see
|
source code and resource files for your application. For more information, see
|
||||||
<a href="{@docRoot}tools/projects/index.html">Create an Android project</a>.</p>
|
<a href="{@docRoot}tools/projects/index.html">Create an Android project</a>.</p>
|
||||||
</li>
|
</li>
|
||||||
<li><strong>Debugging and Testing</strong>
|
<li><strong>Debugging and Testing</strong>
|
||||||
|
|||||||
Reference in New Issue
Block a user