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

Commit 22f6a60e authored by Scott Main's avatar Scott Main Committed by Android (Google) Code Review
Browse files

Merge "add docs for new attributes, including account restriction for...

Merge "add docs for new attributes, including account restriction for restricted profiles" into jb-mr2-dev
parents addc906f b40c1fda
Loading
Loading
Loading
Loading
+1 −0
Original line number Diff line number Diff line
@@ -184,6 +184,7 @@ import java.util.ArrayList;
 * @attr ref android.R.styleable#ProgressBar_maxWidth
 * @attr ref android.R.styleable#ProgressBar_minHeight
 * @attr ref android.R.styleable#ProgressBar_minWidth
 * @attr ref android.R.styleable#ProgressBar_mirrorForRtl
 * @attr ref android.R.styleable#ProgressBar_progress
 * @attr ref android.R.styleable#ProgressBar_progressDrawable
 * @attr ref android.R.styleable#ProgressBar_secondaryProgress
+86 −3
Original line number Diff line number Diff line
page.title=<application>
parent.title=The AndroidManifest.xml File
parent.link=manifest-intro.html

@jd:body

<dl class="xml">
<dt>syntax:</dt>
<dd><pre class="stx">&lt;application android:<a href="#reparent">allowTaskReparenting</a>=["true" | "false"]
             android:<a href="#allowbackup">allowBackup</a>=["true" | "false"]
             android:<a href="#agent">backupAgent</a>="<i>string</i>"
             android:<a href="#debug">debuggable</a>=["true" | "false"]
             android:<a href="#desc">description</a>="<i>string resource</i>"
@@ -23,10 +23,14 @@ parent.link=manifest-intro.html
             android:<a href="#persistent">persistent</a>=["true" | "false"]
             android:<a href="#proc">process</a>="<i>string</i>"
             android:<a href="#restoreany">restoreAnyVersion</a>=["true" | "false"]
             android:<a href="#requiredAccountType">requiredAccountType</a>="<i>string</i>"
             android:<a href="#restrictedAccountType">restrictedAccountType</a>="<i>string</i>"
             android:<a href="#supportsrtl">supportsRtl</a>=["true" | "false"]
             android:<a href="#aff">taskAffinity</a>="<i>string</i>"
             android:<a href="#testOnly">testOnly</a>=["true" | "false"]
             android:<a href="#theme">theme</a>="<i>resource or theme</i>"
             android:<a href="#uioptions">uiOptions</a>=["none" | "splitActionBarWhenNarrow"] &gt;
             android:<a href="#uioptions">uiOptions</a>=["none" | "splitActionBarWhenNarrow"]
             android:<a href="#vmSafeMode">vmSafeMode</a>=["true" | "false"] &gt;
    . . .
&lt;/application&gt;</pre></dd>

@@ -52,6 +56,10 @@ for corresponding attributes of the component elements. Others (such as
{@code allowClearUserData})  set values for the application as a whole and 
cannot be overridden by the components.</dd>





<dt>attributes</dt>
<dd><dl class="attr">

@@ -71,6 +79,15 @@ attribute that can override the value set here. See that attribute for more
information.
</p></dd>


<dt><a name="allowbackup"></a>{@code android:allowbackup}</dt>
<dd>Whether to allow the application to participate in the backup
and restore infrastructure. If this attribute is set to false, no backup
or restore of the application will ever be performed, even by a full-system
backup that would otherwise cause all application data to be saved via adb.
The default value of this attribute is true.</dd>


<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
@@ -282,6 +299,57 @@ incompatible. <em>Use with caution!</em>
<p>The default value of this attribute is {@code false}.
</p></dd>



<dt><a name="requiredAccountType"></a>{@code android:requiredAccountType}</dt>
<dd>Specifies the account type required by the application in order to function.
If your app requires an {@link android.accounts.Account}, the value for this attribute must
correspond to the account authenticator
type used by your app (as defined by {@link android.accounts.AuthenticatorDescription}),
such as "com.google".  

<p>The default value is null and indicates that the application
can work <em>without</em> any accounts.

<p>Because restricted profiles currently
cannot add accounts, specifying this attribute <strong>makes your app
unavailable from a restricted profile</strong> unless you also declare
<a href="#restrictedAccountType">{@code android:restrictedAccountType}</a> with
the same value.</p>

<p class="caution"><strong>Caution:</strong>
If the account data may reveal personally identifiable information, it's important
that you declare this attribute and leave <a href="#restrictedAccountType">{@code android:restrictedAccountType}</a> null, so that restricted profiles cannot use
your app to access personal information that belongs to the owner user.</p>

<p>This attribute was added in API level 18.</p>
</dd>


<dt><a name="restrictedAccountType"></a>{@code android:restrictedAccountType}</dt>
<dd>Specifies the account type required by this application and indicates that restricted profiles
are allowed to access such accounts that belong to the owner user. If your app requires an
{@link android.accounts.Account} and restricted profiles <strong>are allowed to
access</strong> the primary user's accounts, the value for this attribute must
correspond to the account authenticator type used by your app (as
defined by {@link android.accounts.AuthenticatorDescription}), such as "com.google".

<p>The default value is null and indicates that the application can work <em>without</em> any
accounts.

<p class="caution"><strong>Caution:</strong>
Specifying this attribute allows restricted profiles to use your
app with accounts that belong to the owner user, which may reveal personally identifiable
information. If the account may reveal personal details, you <strong>should not</strong>
use this attribute and you should instead declare the <a
href="#requiredAccountType">{@code android:requiredAccountType}</a> attribute
to make your app unavailable to restricted profiles.</p>

<p>This attribute was added in API level 18.</p>
</dd>



<dt><a name="supportsrtl"></a>{@code android:supportsRtl}</dt>
<dd>Declares whether your application is willing to support right-to-left (RTL) layouts.
<p>If set to {@code true} and <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target"
@@ -310,6 +378,13 @@ set by the
<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code> element.
</p></dd>

<dt><a name="testOnly"></a>{@code android:testOnly}</dt>
<dd>Indicates whether this application is only for testing purposes. For example,
it may expose functionality or data outside of itself that would cause a security
hole, but is useful for testing. This kind of application can be installed
only through adb.</dd>


<dt><a name="theme"></a>{@code android:theme}</dt>
<dd>A reference to a style resource defining a default theme for all
activities in the application.  Individual activities can override
@@ -340,6 +415,14 @@ href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guide.<
  <p>This attribute was added in API level 14.</p>
</dd>

<dt><a name="vmSafeMode"></a>{@code android:vmSafeMode}</dt>
<dd>Indicates whether the app would like the virtual machine (VM) to operate
in safe mode. The default value is {@code "false"}.
</dd>




</dl></dd>

<!-- ##api level indication## -->
+7 −0
Original line number Diff line number Diff line
@@ -174,6 +174,7 @@ In XML: <code>@[<em>package</em>:]drawable/<em>filename</em></code>
    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                      "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                      "center" | "fill" | "clip_vertical" | "clip_horizontal"]
    android:mipMap=["true" | "false"]
    android:tileMode=["disabled" | "clamp" | "repeat" | "mirror"] /&gt;
</pre>
</dd>
@@ -245,6 +246,12 @@ the right edge, a right gravity clips the left edge, and neither clips both edge
</td></tr>
</table>
          </dd>

        <dt><code>android:mipMap</code></dt>
          <dd><em>Boolean</em>. Enables or disables the mipmap hint. See {@link
          android.graphics.Bitmap#setHasMipMap setHasMipMap()} for more information.
          Default value is false.</dd>

        <dt><code>android:tileMode</code></dt>
          <dd><em>Keyword</em>. Defines the tile mode. When the tile mode is enabled, the bitmap is
repeated. Gravity is ignored when the tile mode is enabled.
+2 −0
Original line number Diff line number Diff line
@@ -53,6 +53,7 @@ import java.io.IOException;
 * @attr ref android.R.styleable#BitmapDrawable_filter
 * @attr ref android.R.styleable#BitmapDrawable_dither
 * @attr ref android.R.styleable#BitmapDrawable_gravity
 * @attr ref android.R.styleable#BitmapDrawable_mipMap
 * @attr ref android.R.styleable#BitmapDrawable_tileMode
 */
public class BitmapDrawable extends Drawable {
@@ -283,6 +284,7 @@ public class BitmapDrawable extends Drawable {
     *         is null, this method always returns false.
     *
     * @see #setMipMap(boolean) 
     * @attr ref android.R.styleable#BitmapDrawable_mipMap
     */
    public boolean hasMipMap() {
        return mBitmapState.mBitmap != null && mBitmapState.mBitmap.hasMipMap();