AndroidManifest.xml是每一个应用都需要的文件, 位于应用根目录下,它 描述了程序包的全局变量, 包括暴露的应用组件(activities, services等等)和为每个组件的实现类, 什么样的数据可以操作, 以及在什么地方运行。
这个文件的一个重要方面就是是其中的intent过滤器(intent filters)。 这些过滤器描述了何时何种情况下让活动(activity) 启动。 当一个activity(或是操作系统)想要执行一个动作, 例如打开一个Web页或是打开一个联系人选取屏幕,它将会创建一个Intent对象。 该对象包含了很多几个描述符(descriptors), 描述了你想做什么操作, 你想处理什么数据, 数据的类型, 以及一些其他的信息。 Android将Intent对象中的信息与所有应用暴露的intent过滤器比较, 找到一个最能恰当处理请求者要求的数据和动作(action)的activity。关于intents的更多信息在Intent页可以找到。
除了声明应用的活动(Activities),内容管理器( Content Providers),服务( Services), 和 Intent 接收器(Intent Receivers), 你也可以在AndroidManifest.xml文件中指定权限和instrumentation(安全控制和测试). 请查看AndroidManifest了解这个标签和他们的属性。
如下是一个简单的AndroidManifest.xml文件:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.my_domain.app.helloactivity"> <application android:label="@string/app_name"> <activity android:name=".HelloActivity"> <intent-filter> <action android:name="android.intent.action.MAIN"/> <category android:name="android.intent.category.LAUNCHER"/> </intent-filter> </activity> </application> </manifest>
需要注意的一些通用事项:
几乎所有的AndroidManifest.xml 文件(同其他的Android文件一样)都会在其第一个元素(element)中包含一个命名空间的声明xmlns:android="http://schemas.android.com/apk/res/android"
。 该声明使标准Android属性在该文件中可用,这些属性为文件中的xml元素提供了大部分数据。.
大多数的manifests包含一个<application>
元素, 该元素定了这个程序包内所有应用层面上可用的组件和属性。
所有需要可以从应用程序启动器(program launcher)中呈现给用户的顶层应用都至少需要包括一个活动(Activity)组件,它用来支持MAIN action 和显示在LAUNCHER 目录中。
下面列出了AndroidManifest.xml 这个文件详细的结构大纲, 描述了所有可用标签。
注意: 无论活动是外部可见还是仅在程序包内使用,在manifest中每一个活动必须在定义一个 此外,为了支持运行时活动查找,你可以包含一个或多个 你也可把一个或多个meta-data 与你的活动(activity)关联,其它客户端(clients)可以取得这些meta-dada以获得关于这个活动的任意信息。