Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 12a54752 authored by Scott Main's avatar Scott Main
Browse files

docs: update hw accel attribute's default behavior and fix link to l10n tutorial

Change-Id: I445a5ef7513749ab55537c16dac2ee00aee0859d
parent 0038ec11
Loading
Loading
Loading
Loading
+28 −21
Original line number Diff line number Diff line
@@ -57,9 +57,9 @@ cannot be overridden by the components.</dd>
<dt><a name="reparent"></a>{@code android:allowTaskReparenting}</dt>
<dd>Whether or not activities that the application defines can move from 
the task that started them to the task they have an affinity for when that task 
is next brought to the front &mdash; "{@code true}" if they can move, and 
"{@code false}" if they must remain with the task where they started.  
The default value is "{@code false}".
is next brought to the front &mdash; {@code "true"} if they can move, and 
{@code "false"} if they must remain with the task where they started.  
The default value is {@code "false"}.

<p>
The 
@@ -73,9 +73,9 @@ information.
<dt><a name="agent"></a>{@code android:backupAgent}</dt>
<dd>The name of the class that implement's the application's backup agent,
a subclass of {@link android.app.backup.BackupAgent}.  The attribute value should be
a fully qualified  class name (such as, "{@code com.example.project.MyBackupAgent}").  
a fully qualified  class name (such as, {@code "com.example.project.MyBackupAgent"}).  
However, as a shorthand, if the first character of the name is a period 
(for example, "{@code .MyBackupAgent}"), it is appended to the 
(for example, {@code ".MyBackupAgent"}), it is appended to the 
package name specified in the 
<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code> 
element.
@@ -86,29 +86,29 @@ There is no default. The name must be specified.

<dt><a name="debug"></a>{@code android:debuggable}</dt>
<dd>Whether or not the application can be debugged, even when running 
on a device in user mode &mdash; "{@code true}" if it can be, and "{@code false}"
if not.  The default value is "{@code false}".</dd> 
on a device in user mode &mdash; {@code "true"} if it can be, and {@code "false"}
if not.  The default value is {@code "false"}.</dd> 

<dt><a name="desc"></a>{@code android:description}</dt>
<dd>User-readable text about the application, longer and more descriptive than the application label.  The value must be set as a reference to a string resource.  Unlike the label, it cannot be a raw string.  There is no default value.</dd>

<dt><a name="enabled"></a>{@code android:enabled}</dt>
<dd>Whether or not the Android system can instantiate components of 
the application &mdash; "{@code true}" if it can, and "{@code false}" 
if not.  If the value is "{@code true}", each component's 
the application &mdash; {@code "true"} if it can, and {@code "false"} 
if not.  If the value is {@code "true"}, each component's 
{@code enabled} attribute determines whether that component is enabled 
or not.  If the value is "{@code false}", it overrides the 
or not.  If the value is {@code "false"}, it overrides the 
component-specific values; all components are disabled.

<p>
The default value is "{@code true}".
The default value is {@code "true"}.
</p></dd>  

<dt><a name="code"></a>{@code android:hasCode}</dt>
<dd>Whether or not the application contains any code &mdash; "{@code true}" 
if it does, and "{@code false}" if not.  When the value is "{@code false}", 
<dd>Whether or not the application contains any code &mdash; {@code "true"} 
if it does, and {@code "false"} if not.  When the value is {@code "false"}, 
the system does not try to load any application code when launching components.  
The default value is "{@code true}".
The default value is {@code "true"}.

<p>
An application would not have any code of its own only if it's using nothing
@@ -118,10 +118,14 @@ android.app.AliasActivity} class, a rare occurrence.</p>

<dt><a name="hwaccel"></a>{@code android:hardwareAccelerated}</dt>
<dd>Whether or not hardware-accelerated rendering should be enabled for all
Activities and Views in this application &mdash; "{@code true}" if it
should be enabled, and "{@code false}" if not. The default value is "{@code false}".

<p>Starting from Android 3.0, a hardware-accelerated OpenGL renderer is
activities and views in this application &mdash; {@code "true"} if it
should be enabled, and {@code "false"} if not. The default value is {@code "true"} if you've set
either <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code minSdkVersion}</a>
or <a 
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code targetSdkVersion}</a>
to {@code "14"} or higher; otherwise, it's {@code "false"}.

<p>Starting from Android 3.0 (API level 11), a hardware-accelerated OpenGL renderer is
available to applications, to improve performance for many common 2D graphics
operations. When the hardware-accelerated renderer is enabled, most operations
in Canvas, Paint, Xfermode, ColorFilter, Shader, and Camera are accelerated.
@@ -132,6 +136,9 @@ the framework's OpenGL libraries. </p>
<p>Note that not all of the OpenGL 2D operations are accelerated. If you enable
the hardware-accelerated renderer, test your application to ensure that it can
make use of the renderer without errors.</p>

<p>For more information, read the <a href="{@docRoot}guide/topics/graphics/hardware-accel.html"
>Hardware Acceleration</a> guide.</p>
</dd>

<dt><a name="icon"></a>{@code android:icon}</dt>
@@ -233,8 +240,8 @@ Permissions</a>.

<dt><a name="persistent"></a>{@code android:persistent}</dt>
<dd>Whether or not the application should remain running at all times &mdash; 
"{@code true}" if it should, and "{@code false}" if not.  The default value 
is "{@code false}".  Applications should not normally set this flag; 
{@code "true"} if it should, and {@code "false"} if not.  The default value 
is {@code "false"}.  Applications should not normally set this flag; 
persistence mode is intended only for certain system applications.</dd>

<dt><a name="proc"></a>{@code android:process}</dt>
+2 −7
Original line number Diff line number Diff line
@@ -48,8 +48,6 @@ defaults.</li>

<h2>See also</h2>
  <ol>
  <li><a
href="{@docRoot}resources/tutorials/localization/index.html">Hello, L10N Tutorial</a></li>
    <li><a href="{@docRoot}guide/topics/resources/providing-resources.html">Providing Resources</a></li>
    <li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">Layouts</a></li>
    <li><a href="{@docRoot}reference/android/app/Activity.html#ActivityLifecycle">Activity Lifecycle</a></li>
@@ -87,11 +85,8 @@ programmatically. This document does not cover how to localize your Java code.
</li>
</ul>

<p>The <a
href="{@docRoot}resources/tutorials/localization/index.html">Hello, L10N
</a> tutorial takes you through the steps of creating a simple localized
application that uses  locale-specific resources in the way described in this
document. </p>
<p>For a short guide to localizing strings in your app, see the training lesson, <a
href="{@docRoot}training/basics/supporting-devices/languages.html">Supporting Different Languages</a>. </p>


<h2 id="resource-switching">Overview: Resource-Switching in Android</h2>