AndroidManifest.xml配置详解

时间  2019-11-06
标签 androidmanifest.xml androidmanifest xml 配置 详解 栏目 Android 繁體版
原文   原文链接
AndroidManifest.xml配置文件对于Android应用开发来讲是很是重要的基础知识，本文旨在总结该配置文件中重点的用法，以便往后查阅。下面是一个标准的AndroidManifest.xml文件样例。

  1. <?xml version="1.0" encoding="utf-8"?>  
  2.   
  3. <manifest>  
  4.   
  5.     <!-- 基本配置 -->  
  6.     <uses-permission />  
  7.     <permission />  
  8.     <permission-tree />  
  9.     <permission-group />  
  10.     <instrumentation />  
  11.     <uses-sdk />  
  12.     <uses-configuration />  
  13.     <uses-feature />  
  14.     <supports-screens />  
  15.     <compatible-screens />  
  16.     <supports-gl-texture />  
  17.       
  18.     <!-- 应用配置 -->  
  19.     <application>  
  20.           
  21.         <!-- Activity 配置 -->  
  22.         <activity>  
  23.             <intent-filter>  
  24.                 <action />  
  25.                 <category />  
  26.                 <data />  
  27.             </intent-filter>  
  28.             <meta-data />  
  29.         </activity>  
  30.           
  31.         <activity-alias>  
  32.             <intent-filter> . . . </intent-filter>  
  33.             <meta-data />  
  34.         </activity-alias>  
  35.           
  36.         <!-- Service 配置 -->  
  37.         <service>  
  38.             <intent-filter> . . . </intent-filter>  
  39.             <meta-data/>  
  40.         </service>  
  41.           
  42.         <!-- Receiver 配置 -->  
  43.         <receiver>  
  44.             <intent-filter> . . . </intent-filter>  
  45.             <meta-data />  
  46.         </receiver>  
  47.           
  48.         <!-- Provider 配置 -->  
  49.         <provider>  
  50.             <grant-uri-permission />  
  51.             <meta-data />  
  52.         </provider>  
  53.           
  54.         <!-- 所需类库配置 -->  
  55.         <uses-library />  
  56.   
  57.     </application>  
  58.   
  59. </manifest>   

<?xml version="1.0" encoding="utf-8"?>

<manifest>

    <!-- 基本配置 -->
    <uses-permission />
    <permission />
    <permission-tree />
    <permission-group />
    <instrumentation />
    <uses-sdk />
    <uses-configuration />
    <uses-feature />
    <supports-screens />
    <compatible-screens />
    <supports-gl-texture />
    
    <!-- 应用配置 -->
    <application>
        
        <!-- Activity 配置 -->
        <activity>
            <intent-filter>
                <action />
                <category />
                <data />
            </intent-filter>
            <meta-data />
        </activity>
        
        <activity-alias>
            <intent-filter> . . . </intent-filter>
            <meta-data />
        </activity-alias>
        
        <!-- Service 配置 -->
        <service>
            <intent-filter> . . . </intent-filter>
            <meta-data/>
        </service>
        
        <!-- Receiver 配置 -->
        <receiver>
            <intent-filter> . . . </intent-filter>
            <meta-data />
        </receiver>
        
        <!-- Provider 配置 -->
        <provider>
            <grant-uri-permission />
            <meta-data />
        </provider>
        
        <!-- 所需类库配置 -->
        <uses-library />

    </application>

</manifest>


从以上示例代码中，咱们能够看出Android配置文件采用XML做为描述语言，每一个XML标签都不一样的含义，大部分的配置参数都放在标签的属性中，下面咱们便按照以上配置文件样例中的前后顺序来学习Android配置文件中主要元素与标签的用法。

<manifest>

AndroidManifest.xml配置文件的根元素，必须包含一个<application>元素而且指定xlmns:android和package属性。xlmns:android指定了Android的命名空间，默认状况下是“http://schemas.android.com/apk/res/android”；而package是标准的应用包名，也是一个应用进程的默认名称，以本书微博应用实例中的包名为例，即“com.app.demos”就是一个标准的Java应用包名，咱们为了不命名空间的冲突，通常会以应用的域名来做为包名。固然还有一些其余经常使用的属性须要注意一下，好比android:versionCode是给设备程序识别版本用的，必须是一个整数值表明app更新过多少次；而android:versionName则是给用户查看版本用的，须要具有必定的可读性，好比“1.0.0”这样的。<manifest>标签语法范例以下。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="string"
    android:sharedUserId="string"
    android:sharedUserLabel="string resource"
    android:versionCode="integer"
    android:versionName="string"
    android:installLocation=["auto" | "internalOnly" | "preferExternal"] >
... ...
</manifest>

<uses-permission>

为了保证Android应用的安全性，应用框架制定了比较严格的权限系统，一个应用必须声明了正确的权限才可使用相应的功能，例如咱们须要让应用可以访问网络就须要配置“android.permission.INTERNET”，而若是要使用设备的相机功能，则须要设置“android.permission.CAMERA”等。<uses-permission>就是咱们最常用的权限设定标签，咱们经过设定android:name属性来声明相应的权限名，好比在微博应用实例中，咱们就是根据应用的所需功能声明了对应的权限，相关代码以下。

<manifest ...>
... ...
    <!-- 网络相关功能 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 读取电话状态 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <!-- 通知相关功能 -->
    <uses-permission android:name="android.permission.VIBRATE" />
... ...
</manifest>

<permission>

权限声明标签，定义了供给<uses-permission>使用的具体权限，一般状况下咱们不须要为本身的应用程序声明某个权限，除非须要给其余应用程序提供可调用的代码或者数据，这个时候你才须要使用<permission>标签。该标签中提供了android:name权限名标签，权限图标android:icon以及权限描述android:description等属性，另外还能够和<permission-group>以及<permission-tree>配合使用来构造更有层次的、更有针对性权限系统。<permission>标签语法范例以下。

<permission android:description="string resource"
    android:icon="drawable resource"
    android:label="string resource"
    android:name="string"
    android:permissionGroup="string"
    android:protectionLevel=["normal" | "dangerous" | "signature" | "signatureOrSystem"] />

<instrumentation>

用于声明Instrumentation测试类来监控Android应用的行为并应用到相关的功能测试中，其中比较重要的属性有：测试功能开关android:functionalTest，profiling调试功能开关android:handleProfiling，测试用例目标对象android:targetPackage等。另外，咱们须要注意的是Instrumentation对象是在应用程序的组件以前被实例化的，这点在组织测试逻辑的时候须要被考虑到。<instrumentation>标签语法范例以下。

<instrumentation android:functionalTest=["true" | "false"]
    android:handleProfiling=["true" | "false"]
    android:icon="drawable resource"
    android:label="string resource"
    android:name="string"
    android:targetPackage="string" />

<uses-sdk>

用于指定Android应用中所须要使用的SDK的版本，好比咱们的应用必须运行于Android 2.0以上版本的系统SDK之上，那么就须要指定应用支持最小的SDK版本数为5；固然，每一个SDK版本都会有指定的整数值与之对应，好比咱们最经常使用的Android 2.2.x的版本数是8。固然，除了能够指定最低版本以外，<uses-sdk>标签还能够指定最高版本和目标版本，语法范例以下。

<uses-sdk android:minSdkVersion="integer"
    android:targetSdkVersion="integer"
    android:maxSdkVersion="integer" />

<uses-configuration>与<uses-feature>

这两个标签都是用于描述应用所须要的硬件和软件特性，以便防止应用在没有这些特性的设备上安装。<uses-configuration>标签中，好比有些设备带有D-pad或者Trackball这些特殊硬件，那么android:reqFiveWayNav属性就须要设置为true；而若是有一些设备带有硬件键盘，android:reqHardKeyboard也须要被设置为true。另外，若是设备须要支持蓝牙，咱们可使用<uses-feature android:name="android.hardware.bluetooth" />来支持这个功能。这两个标签主要用于支持一些特殊的设备中的应用，两个标签的语法范例分别以下。

<uses-configuration android:reqFiveWayNav=["true" | "false"]
    android:reqHardKeyboard=["true" | "false"]
    android:reqKeyboardType=["undefined" | "nokeys" | "qwerty" | "twelvekey"]
    android:reqNavigation=["undefined" | "nonav" | "dpad" | "trackball" | "wheel"]
    android:reqTouchScreen=["undefined" | "notouch" | "stylus" | "finger"] />

<uses-feature android:name="string"
    android:required=["true" | "false"]
    android:glEsVersion="integer" />

<uses-library>

用于指定Android应用可以使用的用户库，除了系统自带的android.app、android.content、android.view和android.widget这些默认类库以外，有些应用可能还须要一些其余的Java类库做为支持，这种状况下咱们就可使用<uses-library>标签让ClassLoader加载其类库供Android应用运行时用。<uses-library>标签的用法很简单，如下是语法范例。

<uses-library android:name="string"
    android:required=["true" | "false"] />

小贴士：
当运行Java程序时，首先运行JVM（Java虚拟机），而后再把Java类加载到JVM里头运行，负责加载Java类的这部分就叫作ClassLoader。固然，ClassLoader是由多个部分构成的，每一个部分都负责相应的加载工做。当运行一个程序的时候，JVM启动，运行BootstrapClassLoader，该ClassLoader加载java核心API（ExtClassLoader和AppClassLoader也在此时被加载），而后调用ExtClassLoader加载扩展API，最后AppClassLoader加载CLASSPATH目录下定义的Class，这就是一个Java程序最基本的加载流程。

<supports-screens>

对于一些应用或者游戏来讲，只能支持某些屏幕大小的设备或者在某些设备中的效果比较好，咱们就会使用<supports-screens>标签来指定支持的屏幕特征。其中比较重要的属性包括：屏幕自适应属性android:resizeable，小屏（android:smallScreens）、中屏（android:normalScreens）、大屏（android:largeScreens）和特大屏（android:xlargeScreens）支持属性，按屏幕渲染图像属性android:anyDensity以及最小屏幕宽度属性android:requiresSmallestWidthDp等。<supports-screens>标签的语法范例以下。

<supports-screens android:resizeable=["true"| "false"]
    android:smallScreens=["true" | "false"]
    android:normalScreens=["true" | "false"]
    android:largeScreens=["true" | "false"]
    android:xlargeScreens=["true" | "false"]
    android:anyDensity=["true" | "false"]
    android:requiresSmallestWidthDp="integer"
    android:compatibleWidthLimitDp="integer"
    android:largestWidthLimitDp="integer"/>

<application>

应用配置的根元素，位于<manifest>下层，包含全部与应用有关配置的元素，其属性能够做为子元素的默认属性，经常使用的属性包括：应用名android:label，应用图标android:icon，应用主题android:theme等。固然，<application>标签还提供了其余丰富的配置属性，因为篇幅缘由就不列举了，你们能够打开Android SDK文档来进一步学习，如下是语法范例。

<application android:allowTaskReparenting=["true" | "false"]
    android:backupAgent="string"
    android:debuggable=["true" | "false"]
    android:description="string resource"
    android:enabled=["true" | "false"]
    android:hasCode=["true" | "false"]
    android:hardwareAccelerated=["true" | "false"]
    android:icon="drawable resource"
    android:killAfterRestore=["true" | "false"]
    android:label="string resource"
    android:logo="drawable resource"
    android:manageSpaceActivity="string"
    android:name="string"
    android:permission="string"
    android:persistent=["true" | "false"]
    android:process="string"
    android:restoreAnyVersion=["true" | "false"]
    android:taskAffinity="string"
    android:theme="resource or theme" >
... ...
</application>

<activity>

Activity活动组件（即界面控制器组件）的声明标签，Android应用中的每个Activity都必须在AndroidManifest.xml配置文件中声明，不然系统将不识别也不执行该Activity。<activity>标签中经常使用的属性有：Activity对应类名android:name，对应主题android:theme，加载模式android:launchMode（详见2.1.3.4节），键盘交互模式android:windowSoftInputMode等，其余的属性用法你们能够参考Android SDK文档学习。另外，<activity>标签还能够包含用于消息过滤的<intent-filter>元素，固然还有可用于存储预约义数据的<meta-data>元素，如下是<activity>标签的语法范例。

<activity android:allowTaskReparenting=["true" | "false"]
    android:alwaysRetainTaskState=["true" | "false"]
    android:clearTaskOnLaunch=["true" | "false"]
    android:configChanges=["mcc", "mnc", "locale",
        "touchscreen", "keyboard", "keyboardHidden",
        "navigation", "orientation", "screenLayout",
        "fontScale", "uiMode"]
    android:enabled=["true" | "false"]
    android:excludeFromRecents=["true" | "false"]
    android:exported=["true" | "false"]
    android:finishOnTaskLaunch=["true" | "false"]
    android:hardwareAccelerated=["true" | "false"]
    android:icon="drawable resource"
    android:label="string resource"
    android:launchMode=["multiple" | "singleTop" | "singleTask" | "singleInstance"]
    android:multiprocess=["true" | "false"]
    android:name="string"
    android:noHistory=["true" | "false"]  
    android:permission="string"
    android:process="string"
    android:screenOrientation=["unspecified" | "user" | "behind" |
        "landscape" | "portrait" |
        "sensor" | "nosensor"]
    android:stateNotNeeded=["true" | "false"]
    android:taskAffinity="string"
    android:theme="resource or theme"
    android:windowSoftInputMode=["stateUnspecified",
        "stateUnchanged", "stateHidden",
        "stateAlwaysHidden", "stateVisible",
        "stateAlwaysVisible", "adjustUnspecified",
        "adjustResize", "adjustPan"] >   
... ...
</activity>

<activity-alias>

Activity组件别名的声明标签，简单来讲就是Activity的快捷方式，属性android:targetActivity表示的就是其相关的Activity名，固然必须是前面已经声明过的Activity。除此以外，其余比较常见的属性有：Activity别名名称android:name，别名开关android:enabled，权限控制android:permission等。另外，咱们还须要注意的是，Activity别名也是一个独立的Activity，能够拥有本身的<intent-filter>和<meta-data>元素，其语法范例以下。

<activity-alias android:enabled=["true" | "false"]
    android:exported=["true" | "false"]
    android:icon="drawable resource"
    android:label="string resource"
    android:name="string"
    android:permission="string"
    android:targetActivity="string" >
... ...
</activity-alias>

<intent-filter>与<action>、<category>、<data>

<intent-filter>用于Intent消息过滤器的声明，在前面的2.1.3.2节中咱们已经对Android应用框架中的Intent消息做过比较详细的介绍，咱们了解到Intent消息对于Android应用系统来讲，是很是重要的“粘合剂”，<intent-filter>元素能够放在<activity>、<activity-alias>、<service>和<receiver>元素标签中，来区分可用于处理消息的Activity控制器、Service服务和广播接收器Broadcast Receiver。另外，咱们还知道Intent消息还包含有名称、动做、数据、类别等几个重要属性。这点与该标签的写法也有必定的关系，好比<intent-filter>中必须包含有<action>元素，即用于描述具体消息的名称；<category>标签则用于表示能处理消息组件的类别，即该Action所符合的类别；而<data>元素则用于描述消息须要处理的数据格式，咱们甚至还可使用正则表达式来限定数据来源。固然，这些元素和标签的具体用法咱们还须要慢慢学习，下面是标准<intent-filter>元素标签的语法范例。

<intent-filter android:icon="drawable resource"
    android:label="string resource"
    android:priority="integer" >
    <action android:name="string" />
    <category android:name="string" />
    <data android:host="string"
        android:mimeType="string"
        android:path="string"
        android:pathPattern="string"
        android:pathPrefix="string"
        android:port="string"
        android:scheme="string" />
</intent-filter>

<meta-data>

用于存储预约义数据，和<intent-filter>相似，<meta-data>也能够放在<activity>、<activity-alias>、<service>和<receiver>这四个元素标签中。Meta数据通常会以键值对的形式出现，个数没有限制，而这些数据都将被放到一个Bundle对象中，程序中咱们则可使用ActivityInfo、ServiceInfo甚至ApplicationInfo对象的metaData属性中读取。假设咱们在一个Activity中定义了一个<meta-data>元素，相关示例用法以下。

<activity...>
    <meta-data android:name="testData" android:value="Test Meta Data"></meta-data>
</activity>

ActivityInfo info = this.getPackageManager()
    .getActivityInfo(getComponentName(), PackageManager.GET_META_DATA);
String testData = info.metaData.getString("testData");
System.out.println("testData:" + testData);

<service>

Service服务组件的声明标签，用于定义与描述一个具体的Android服务，主要属性有：Service服务类名android:name，服务图标android:icon，服务描述android:label以及服务开关android:enabled等。关于Service服务组件的概念和用法请参考2.1.4.2节的内容，如下是<service>标签的语法范例。

<service android:enabled=["true" | "false"]
    android:exported=["true" | "false"]
    android:icon="drawable resource"
    android:label="string resource"
    android:name="string"
    android:permission="string"
    android:process="string" >
... ...
</service>

<receiver>

Boardcast Receiver广播接收器组件的声明标签，用于定义与描述一个具体的Android广播接收器，其主要属性和<service>标签有些相似：Boardcast Receiver接收器类名android:name，接收器图标android:icon，接收器描述android:label以及接收器开关android:enabled等。关于Boardcast Receiver广播接收器组件的概念和用法请参考2.1.4.3节的内容，如下是<receiver>标签的语法范例。

<receiver android:enabled=["true" | "false"]
    android:exported=["true" | "false"]
    android:icon="drawable resource"
    android:label="string resource"
    android:name="string"
    android:permission="string"
    android:process="string" >
... ...
</receiver>

<provider>与<grant-uri-permission> 除Activity、Service和Boardcast Receiver以外的另外一个“四大组件”，也就是Content Provider内容提供者的声明标签。关于内容提供者组件的概念和用法请参考2.1.4.4节的内容，再也不赘述。<provider>标签除了和其余组件相同的android:name、android:icon和android:label等基础属性以外，还提供了用于支持其功能的特殊属性，如：内容提供者标识名称android:authorities，对指定URI授予权限标识android:grantUriPermission以及具体的读、写权限，即android:readPermission和android:writePermission等。固然，这些属性的具体用法咱们还须要慢慢学习，如下是<provider>标签的语法范例。 <provider android:authorities="list"     android:enabled=["true" | "false"]     android:exported=["true" | "false"]     android:grantUriPermissions=["true" | "false"]     android:icon="drawable resource"     android:initOrder="integer"     android:label="string resource"     android:multiprocess=["true" | "false"]     android:name="string"     android:permission="string"     android:process="string"     android:readPermission="string"     android:syncable=["true" | "false"]     android:writePermission="string" > ... ... </provider>
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程