【翻译】(67)uses-library元素
see
http://developer.android.com/guide/topics/manifest/uses-library-element.html
原文见
http://developer.android.com/guide/topics/manifest/uses-library-element.html
-------------------------------
<uses-library>
uses-library元素
-------------------------------
* syntax:
* 语法：
-------------------------------
<uses-library android:name="string"
android:required=["true" | "false"] />
-------------------------------
* contained in:
* 被包含在：
<application>
* description:
* 描述：
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.
指定一个应用程序必须被链接到的共享库。这个元素告诉系统要为该包在类加载器中包含那个库的代码。
All of the android packages (such as android.app, android.content, android.view, and android.widget) are in the default library that all applications are automatically linked against. However, some packages (such as 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.
所有android包（诸如android.app，android.content，android.view，和android.widget）是在默认的库中，所有应用程序都会自动地链接到它。然而，一些包（诸如maps）是在单独的库中不被自动地链接。参考你正在使用的包的文档以决定哪个库包含该包的代码。
This element also affects the installation of the application on a particular device and the availability of the application in Android Market:
此元素还影响应用程序在一个特定设备上的安装以及Android市场里应用程序的可用性。
Installation
安装
If this element is present and its android:required attribute is set to true, the PackageManager framework won't let the user install the application unless the library is present on the user's device.
如果这个元素存在并且它的android:required属性被设置为true，那么PackageManager框架将不让用户安装应用程序，除非库存在于用户的设备上。
Market
市场
Android Market filters applications based on the libraries installed on the user's device. For more information about filtering, see the topic Market Filters.
Android市场基于安装在用户的设备上的库来过滤应用程序。想获得关于过滤的更多信息，参见主题市场过滤器。
The android:required attribute is described in detail in the following section.
android:required属性在以下章节中被详细地描述。
* attributes:
* 属性：
* android:name
The name of the library. The name is provided by the documentation for the package you are using. An example of this is "android.test.runner", a package that contains Android test classes.
库的名称。该名称由你正在使用的包的文档来提供。它的一个示例是"android.test.runner"，一个包含Android测试类的包。
* android:required
Boolean value that indicates whether the application requires the library specified by android:name:
布尔值，指示应用程序是否必需被android:name指定的库：
* "true": The application does not function without this library. The system will not allow the application on a device that does not have the library.
* "true"：应用程序在没有这个库的情况下不起作用。系统将不允许在一个没有该库的设备上存在这个应用程序。
* "false": 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 "false", you are responsible for checking at runtime that the library is available.
* "false"：应用程序可以使用该库，如果存在的话，但被设计为在没有它的情况下起作用，如果有必要的话。系统将允许应用程序被安装，即便库不存在。如果你使用"false"，那么你有责任在运行时检查该库是可用的。
To check for a library, you can use reflection to determine if a particular class is available.
为了检查一个库，你可以使用反射以确定一个特定的类是否可用。
The default is "true".
默认为"true"。
Introduced in: API Level 7.
引入：API级别7。
* introduced in:
* 引入：
API Level 1
API级别1
* see also:
* 另见：
* PackageManager
Except as noted, this content is licensed under Apache 2.0. For details and restrictions, see the Content License.
除特别说明外，本文在Apache 2.0下许可。细节和限制请参考内容许可证。
Android 4.0 r1 - 14 Feb 2012 21:12
-------------------------------
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
（此页部分内容基于Android开源项目，以及使用根据创作公共2.5来源许可证描述的条款进行修改）
（本人翻译质量欠佳，请以官方最新内容为准，或者参考其它翻译版本：
* ソフトウェア技術ドキュメントを勝手に翻訳
http://www.techdoctranslator.com/android
* Ley's Blog
http://leybreeze.com/blog/
* 农民伯伯
http://www.cnblogs.com/over140/
* Android中文翻译组
http://androidbox.sinaapp.com/
）
assets目录与res下的raw、drawable目录一样，也可用来存放资源文件，但它们三者有区别，对比总结如下表：
assets res/raw res/drawable 获取资源方式： 文件路径+文件名 R.raw.xxx R.drawable.xxx 是否被压缩： NO NO YES（失真压缩） 能否获取子目录下的资源： YES NO NO
说明：
一、assets目录下的资源文件不会在R.java自动生成ID，所以读取assets目录下的文件必须指定文件的路径。可以通过AssetManager类来访问这些文件。比如要读取assets目录下的background.png：
Bitmap bgImg = getImageFromAssetFile( "background.png" );
/**
* 从assets中读取图片
*/
private Bitmap getImageFromAssetsFile(String fileName)
{
Bitmap image = null;
AssetManager am = getResources().getAssets();
try
{
InputStream is = am.open(fileName);
image = BitmapFactory.decodeStream(is);
is.close();
}
catch (IOException e)
{
e.printStackTrace();
}
return image;
}
二、如果在res/drawable目录下建了一个名为ppt的子目录，则通过 R.drawable.ppt.xxx 是获取不到ppt目录下的xxx文件的，会报 "R.layout.ppt cannot be resolved" 的错误。若在assets目录下建立一个名为ppt的子目录，并将background.png放入其中，则代码 Bitmap bgImg = getImageFromAssetFile( "ppt/background.png" ); 可正常运行。
笔记本 创建wifi热点