AndroidManifest.xml文件,位于整个项目的根目录下,是Android应用程序中重要的清单文件。它包含了应用程序运行前Android系统必须了解的重要信息,主要内容如下:
① 应用程序包名称;
② 应用程序申请的自身所需要的权限;
③ 应用程序中包含的组件。
当新创建一个应用项目时,系统会自动生成该项目的AndroidManifest.xml文件。如新建的项目为HelloAndroid,包名为cn.edu.neusoft.helloandroid,那么AndroidManifest.xml文件的内容如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="cn.edu.neusoft.helloandroid" >
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme" >
<activity android:name=".MainActivity" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
AndroidManifest.xml文件为XML格式,开头都会出现“<?xml version="1.0" encoding="utf-8"?> ”文件序言信息。
<manifest> 标签定义了manifest是AndroidManifest.xml的根元素,其他的标签都定义在该元素下面。默认情况,该节点声明了xmlns:android和package两个属性。属性xmlns:android定义了Android的命名空间,这样使得Android中各种标准属性能在文件中使用。属性package定义了应用程序的包名称。该节点还有两个可选属性:android:versionCode和android:versionName。属性android:versionCode定义应用程序的版本号,版本号是一个整数值,值越大,版本越新,但仅在应用程序内部使用。属性 android:versionName定义应用程序的版本名称,仅限于为用户提供一个版本信息,一般使用流水号。如:
android:versionCode="1"
android:versionName="1.0"
manifest标签下,仅能包含一个application元素。只要在package中实现的Activity 、Service、BroadcastReceiver和ContentProvide这4大组件信息都需要在application元素下声明。声明包括各自的实现类、各种能被处理的数据和启动位置等信息。
application元素的属性解释如下。
android:allowBackup="true" 设置允许备份文件。
android:icon="@ mipmap/ic_launcher" 定义了应用程序的图标,@ mipmap/ic_launcher是一种资源引用方式,标志着图标是存放在/res/mipmap目录下的资源文件,资源文件的名称为ic_launcher。
android:supportsRtl="true"设置应用程序可以支持RTL布局。此属性只有在API 17之后才生效。
android:theme="@style/AppTheme" >设置应用程序的主题是AppTheme。
新创建一个应用程序,并且默认在应用中创建MainActivity类时,application元素下会默认包含一个activity子元素。activity元素是对Activity组件的声明。属性android:name定义了该Activity的名称。该名称可以是包含着包名的完整的类名,如android:name="cn.edu.neusoft.helloandroid.MainActivity";也可以省略包名,简化为android:name=".Main Activity"。
在<activity>标签下,可以定义0个或多个<intent-filter>标签,该标签用于设定Intent过滤条件,可与其他组件的通信,实现本Activity隐式启动,在这里不详细讨论。
<activity>标签下的<action android:name="android.intent.action.MAIN" 和<category android:name="android.intent.category.LAUNCHER"/>,用于声明本Activity是应用程序启动后首先被执行的Activity。由于第一个被执行的Activity只有一个,因此无论应用程序中有多少个Activity,只有一个Activity能这样声明。
如果用户在应用程序中又创建了一个Activity,则必须在AndroidManifest.xml文件的<application>标签下添加该Activity的信息,否则应用程序执行时根本无法启动该Activity。例如新建了SecondActivity,则必须添加代码如下:
<activity android:name=".SecondActivity"/>
Service组件采用<service>标签。如果在应用程序中新建了一个服务类MyService,必须在<application>标签下添加代码如下:
<service android:name=".MyService"/>
BroadcastReceiver组件采用<receiver>标签。如果在应用程序中新建了一个广播接收类MybroadcastReceiver,必须在<application>标签下添加代码如下:
<receiver android:name=".MyBroadcastReceiver">
<intent-filter>
<action android:name="cn.edu.neusoft.manifestdemo.mybroadcastreceiver"/>
<category/>
</intent-filter>
</receiver>
ContentProvider组件采用<provider>标签。如果在应用程序中新建了一个ContentProvider类MyContentProvider,必须在<application>标签下添加代码如下:
<provider
android:authorities="cn.edu.neusoft.manifestdemo.mycontentprovider"
android:name=".MyContentProvider"/>
Android系统限定网络系统资源的使用,当应用程序要求访问网络、SD卡、WiFi、蓝牙、短信、通讯录等系统资源时,必须向Android系统申请相关权限。申请权限的方式为:在AndroidManifest.xml文件的<manifest>标签下添加<uses-permission>标签。读取短信权限的示例代码如下:
<uses-permission android:name="android.permission.READ_SMS"/>
表2-1中列出了Android系统中部分常用的权限。
表2-1 MediaPlayer常用方法
AndroidManifest.xml的比较完整的示例代码如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="cn.edu.neusoft.manifestdemo" >
<uses-permission android:name="android.permission.READ_SMS"/>
<application
android:allowBackup="true"
android:icon="@drawable/java_coffee"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme" >
<activity android:name=".MainActivity" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity android:name=".SecondActivity"/>
<receiver android:name=".MyBroadcastReceiver">
<intent-filter>
<action android:name=" cn.edu.neusoft.manifestdemo.mybroadcastreceiver"/>
<category/>
</intent-filter>
</receiver>
<provider android:authorities=" cn.edu.neusoft.manifestdemo.mycontentprovider"
android:name=".MyContentProvider"/>
<service android:name=".MyService"/>
</application>
</manifest>