Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "docs: Improved description of "package" attribute (manifest)." into mnc-mr-docs

Browse Source 
am: 190bf3b943

* commit '190bf3b943597e28a6d42da88b417c57073bad43':
  docs: Improved description of "package" attribute (manifest).

Change-Id: Id53521c27eab140e57ccba079cffcfa069852296
This commit is contained in:
Kevin Hufnagle
2016-04-20 00:56:18 +00:00
committed by android-build-merger
parent c9c3ad8c5e 190bf3b943
commit 19db30bc49
1 changed files with 19 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
docs/html/guide/topics/manifest/manifest-element.jd
View File

@@ -41,21 +41,24 @@ parent.link=manifest-intro.html
<p> <p>
<dt>description:</dt> <dt>description:</dt>
<dd itemprop="description">The root element of the AndroidManifest.xml file. It must <dd itemprop="description">The root element of the AndroidManifest.xml file. It must
contain an <code><a href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a></code> element contain an <code><a href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a></code> element
and specify {@code xmlns:android} and {@code package} attributes.</dd> and specify {@code xmlns:android} and {@code package} attributes.</dd>
<dt>attributes:</dt> <dt>attributes:</dt>
<dd> <dd>
<dl class="attr"> <dl class="attr">
<dt><a name="nspace"></a>{@code xmlns:android}</dt> <dt><a name="nspace"></a>{@code xmlns:android}</dt>
<dd>Defines the Android namespace. This attribute should always be set <dd>Defines the Android namespace. This attribute should always be set
to "{@code http://schemas.android.com/apk/res/android}".</dd> to "{@code http://schemas.android.com/apk/res/android}".</dd>
<dt><a name="package"></a>{@code package}</dt> <dt><a name="package"></a>{@code package}</dt>
<dd>A full Java-language-style package name for the application. The name should <dd>A full Java-language-style package name for the Android application. The
be unique. The name may contain uppercase or lowercase letters ('A' name should be unique. The name may contain uppercase or lowercase letters
through 'Z'), numbers, and underscores ('_'). However, individual ('A' through 'Z'), numbers, and underscores ('_'). However, individual
package name parts may only start with letters. package name parts may only start with letters. Note that you can use
different names for the Android application package and for the Java package
identifiers used in the application's classes; these two types of names are
entirely independent.
<p>To avoid conflicts with other developers, you should use Internet domain ownership as the <p>To avoid conflicts with other developers, you should use Internet domain ownership as the
basis for your package names (in reverse). For example, applications published by Google start with basis for your package names (in reverse). For example, applications published by Google start with
@@ -83,11 +86,11 @@ the previous version cannot update to the new version.</p>
</dd> </dd>
<dt><a name="uid"></a>{@code android:sharedUserId}</dt> <dt><a name="uid"></a>{@code android:sharedUserId}</dt>
<dd>The name of a Linux user ID that will be shared with other applications. <dd>The name of a Linux user ID that will be shared with other applications.
By default, Android assigns each application its own unique user ID. By default, Android assigns each application its own unique user ID.
However, if this attribute is set to the same value for two or more applications, However, if this attribute is set to the same value for two or more applications,
they will all share the same ID &mdash; provided that they are also signed they will all share the same ID &mdash; provided that they are also signed
by the same certificate. Application with the same user ID can access each by the same certificate. Application with the same user ID can access each
other's data and, if desired, run in the same process.</dd> other's data and, if desired, run in the same process.</dd>
<dt><a name="uidlabel"></a>{@code android:sharedUserLabel}</dt> <dt><a name="uidlabel"></a>{@code android:sharedUserLabel}</dt>
@@ -103,8 +106,8 @@ a reference to a string resource; it cannot be a raw string.
<dt><a name="vcode"></a>{@code android:versionCode}</dt> <dt><a name="vcode"></a>{@code android:versionCode}</dt>
<dd>An internal version number. This number is used only to determine whether <dd>An internal version number. This number is used only to determine whether
one version is more recent than another, with higher numbers indicating more one version is more recent than another, with higher numbers indicating more
recent versions. This is not the version number shown to users; that number recent versions. This is not the version number shown to users; that number
is set by the {@code versionName} attribute. is set by the {@code versionName} attribute.
<p> <p>
@@ -118,9 +121,9 @@ is set by the {@code versionName} attribute.
</dd> </dd>
<dt><a name="vname"></a>{@code android:versionName}</dt> <dt><a name="vname"></a>{@code android:versionName}</dt>
<dd>The version number shown to users. This attribute can be set as a raw <dd>The version number shown to users. This attribute can be set as a raw
string or as a reference to a string resource. The string has no other purpose string or as a reference to a string resource. The string has no other purpose
than to be displayed to users. The {@code versionCode} attribute holds than to be displayed to users. The {@code versionCode} attribute holds
the significant version number used internally. the significant version number used internally.
</dd> </dd>