112 lines
4.3 KiB
Plaintext
112 lines
4.3 KiB
Plaintext
page.title=<uses-library>
|
|
parent.title=The AndroidManifest.xml File
|
|
parent.link=manifest-intro.html
|
|
@jd:body
|
|
|
|
<div class="sidebox-wrapper">
|
|
<div class="sidebox">
|
|
<img src="{@docRoot}assets/images/icon_play.png" style="float:left;margin:0;padding:0;">
|
|
<p style="color:#669999;padding-top:1em;">Google Play Filtering</p>
|
|
<p style="padding-top:1em;">Google Play uses the <uses-library> elements declared
|
|
in your app manifest to filter your app from devices that do not meet it's library
|
|
requirements. For more information about filtering, see the topic
|
|
<a href="{@docRoot}google/play/filters.html">Google Play filters</a>.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<dl class="xml">
|
|
|
|
<dt>syntax:</dt>
|
|
<dd>
|
|
<pre class="stx">
|
|
<uses-library
|
|
android:<a href="#nm">name</a>="<var>string</var>"
|
|
android:<a href="#rq">required</a>=["true" | "false"] />
|
|
</pre>
|
|
</dd>
|
|
<dt>contained in:</dt>
|
|
<dd>
|
|
<code>
|
|
<a href="{@docRoot}guide/topics/manifest/application-element.html"><application></a>
|
|
</code>
|
|
</dd>
|
|
<dt>description:</dt>
|
|
<dd itemprop="descridption">
|
|
Specifies a shared library that the application must be linked against.
|
|
This element tells the system to include the library's code in the class
|
|
loader for the package.
|
|
<p>
|
|
All of the {@code android} packages (such as {@link android.app},
|
|
{@link android.content}, {@link android.view}, and {@link android.widget})
|
|
are in the default library that all applications are automatically linked
|
|
against. However, some packages (such as {@code maps}) are
|
|
in separate libraries that are not automatically linked. Consult the
|
|
documentation for the packages you're using to determine which library
|
|
contains the package code.
|
|
</p>
|
|
<p>
|
|
This element also affects the installation of the application on a particular device and
|
|
the availability of the application on Google Play:
|
|
</p>
|
|
<dl>
|
|
<dt><em>Installation</em></dt>
|
|
<dd>
|
|
If this element is present and its {@code android:required} attribute is set to
|
|
{@code true}, the {@link android.content.pm.PackageManager} framework won't let the user
|
|
install the application unless the library is present on the user's device.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
The {@code android:required} attribute is described in detail in the following section.
|
|
</p>
|
|
</dd>
|
|
<dt>attributes:</dt>
|
|
<dd>
|
|
<dl class="attr">
|
|
<dt><a name="nm"></a>{@code android:name}</dt>
|
|
<dd>
|
|
The name of the library. The name is provided by the
|
|
documentation for the package you are using. An example of this is
|
|
"<code>android.test.runner</code>", a package that contains Android test
|
|
classes.
|
|
</dd>
|
|
<dt><a name="rq"></a>{@code android:required}</dt>
|
|
<dd>
|
|
Boolean value that indicates whether the application requires the
|
|
library specified by {@code android:name}:
|
|
<ul>
|
|
<li>
|
|
<code>"true"</code>: The application does not function without this
|
|
library. The system will not allow the application on a device that does not
|
|
have the library.
|
|
</li>
|
|
<li>
|
|
<code>"false"</code>: The application can use the
|
|
library if present, but is designed to function without it if necessary.
|
|
The system will allow the application to be installed, even if the library is
|
|
not present. If you use <code>"false"</code>, you are responsible for
|
|
checking at runtime that the library is available.
|
|
<p>
|
|
To check for a library, you can use reflection to determine
|
|
if a particular class is available.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>
|
|
The default is <code>"true"</code>.
|
|
</p>
|
|
<p>Introduced in: API Level 7.</p>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<!-- ##api level indication## -->
|
|
<dt>introduced in:</dt>
|
|
<dd>API Level 1</dd>
|
|
|
|
<dt>see also:</dt>
|
|
<dd>
|
|
<ul>
|
|
<li>{@link android.content.pm.PackageManager}</li>
|
|
</ul>
|
|
</dd>
|
|
</dl> |