AndroidManifest.xml介绍及注意事项

一个典型的Android应用程序的结构如下图所示：

 

manifest文件结构:

<?xml version="1.0" encoding="utf-8"?>
< manifest>  //根节点，描述了package中所有的内容
    <uses-permission /> //请求你的package正常运作所需赋予的安全许可。一个manifest能包含零个或更多此元素
    <permission />  //声明了安全许可来限制哪些程序能使用你的package中的组件和功能。一个manifest能包含零个或更多此元素
    <permission-tree /> 
    <permission-group />
    <instrumentation />  //声明了用来测试此package或其他package指令组件的代码。一个manifest能包含零个或更多此元素
    <uses-sdk />  //指定当前应用程序兼容的最低sdk版本号
    <application>  //包含package中application级别组件声明的根节点。此元素也可包含application中全局和默认的属性，如标签，icon，主题，必要的权限，等等。一个manifest能包含零个或一个此元素（不允许多余一个）
        <activity>  //用来与用户交互的主要工具。当用户打开一个应用程序的初始页面时一个activity,大部分被使用到的其他页面也由不同的activity所实现并声明在另外的activity标记中。
            <intent-filter>  //声明了指定的一组组件支持的Intent值
                <action />
                <category />
                <data />
                    <type/>
                    <schema/>
                    <authority/>
                    <path/>
            </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>   //IntentReceiver能使你的application获得数据的改变或者发生的操作，即使它当前不在运行
            <intent-filter> . . . </intent-filter>
            <meta-data />
        </receiver>
        <provider>  //ContentProvider是用来管理持久化数据并发布给其他应用程序使用的组件
            <grant-uri-permission />
            <meta-data />
        </provider>
        <uses-library />
        <uses-configuration />  
    </application>
< /manifest>

详细说明:1，几乎所有的AndroidManifest.xml（以及许多其他Android的xml的文件）在第一个元素中包含了命名空间的声明xmlns:android="http://schemas.android.com/apk/res/android"。这样使得Android中各 种标准属性能在文件中使用，提供了大部分元素中的数据。
2，大部分manifests包含了单个<application>的元素，它定义了所有的application级别组件和属性，并能在package中使用。
3，任何被用户看作顶层应用程序，并能被程序启动器所用的package，需要包含至少一个Activity组件来支持MAIN操作和LAUNCHER种 类。动作android.intent.action.MAIN指示这是应用程序的入口点。类别android.intent.category.LAUNCHER将此Activity放在启动器窗口中。
在最外层的<manifest>中包含了包名如 package="cn.androidlover.demo" 、软件的版本号 android:versionCode="1" 以及 android:versionName="1.0"的属性，而里面一层的<application>分支中将可能包含Android程序的 四种对象 Activity、Service、Content  Provider以及Receiver。我们每添加上面四个类型中的任一种新对象都需要在androidmanifest.xml文件中添加相应节点，否 则运行时将会产生异常。每一个activity必须要一个<activity>标记对应，无论它给外部使用或是只用于自己的package中。如果一个activity没有对应的标记，你将不能运行它。
此文件一个重要的地方就是它所包含的intent-filters。这些filters描述了activity启动的位置和时间。每当一个activity（或者操作系统）要执行一个操作，例如：打开网页或联系簿时，它创建出一个intent的对象。它能承载一些信息描述了你想做什么，你想 处理什么数据，数据的类型，和一些其他信息。Android比较了intent对象中和每个application所暴露的intent-filter中 的信息，来找到最合适的activity来处理调用者所指定的数据和操作。关于intent的更多信息请访问Intent参考页面。
application属性介绍：
有关AndroidManifest.xml文件的application分支我们有必要了解一些常见的属性，这里可以看到一些我们实用的选项，比如允许 调试android:debuggable、任务关系android:taskAffinity，比如我们常见的方式创建一个新的任务实用标记FLAG_ACTIVITY_NEW_TASK，为程序制定一个主题，可以使用android:theme指向一个主题文件。平时我们创建的程序使用一些 安全敏感项，会需要请求系统许可权限，这里可以使用android:permission来制定相关的许可，每个程序的service、activity、content provider、receiver都需要在application的节点内实现。有关完整的属性可以查看:
<application android:allowClearUserData=["true" | "false"]
             android:allowTaskReparenting=["true" | "false"]
             android:debuggable=["true" | "false"]
             android:description="string resource"
              android:enabled=["true" | "false"]
             android:hasCode=["true" | "false"]
             android:icon="drawable resource"
              android:label="string resource"
             android:manageSpaceActivity="string"
              android:name="string"
              android:permission="string"
              android:persistent=["true" | "false"]
              android:process="string"
              android:taskAffinity="string"
              android:theme="resource or theme" >
     . . .
< /application>
另外：Activity的属性常用的可能为android:name和android:label两个，但我们需要了解所有的属性以帮助解决复杂的问题，完整的如下:

• android:allowTaskReparenting=["true" | "false"]
• android:alwaysRetainTaskState=["true" | "false"]
• android:clearTaskOnLaunch=["true"" | "false"]
• android:configChanges=[one or more of: "mcc" "mnc" "locale" "touchscreen" "keyboard"  "keyboardHidden" "navigation" "orientation" "fontScale"]
• android:enabled=["true" | "false"]
• android:excludeFromRecents=["true" | "false"]
• android:exported=["true" | "false"]
• android:finishOnTaskLaunch=["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" | "nonsensor"]
• android:stateNotNeeded=["true" | "false"]
• android:taskAffinity="string"
• android:theme="resource or theme"
• android:windowSoftInputMode=[one or more of: "stateUnspecified" "stateUnchanged" "stateHidden"  "stateAlwaysHidden" "stateVisible" "stateAlwaysVisible"  "adjustUnspecified" "adjustResize" "adjustPan"]

从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>
而对于服务相关定义如下:
<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>
最后是Broadcast使用的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>
总之，AndroidManifest.xml文件虽然看起来复杂，但是，只要我们理清中里面各元素的作用，那么一切就变得简单了。

 

 

注意事项:

一、target SDK version
Android Runtime和Dalvik会根据target SDK version决定是否工作在『兼容模式』下，所谓兼容模式，就是关闭了新版本中各种新机制和体验优化的状态。targetSdkVersion如果设置很低，就等于是关闭了所有高版本的新特性和机制，包括『屏幕自适应』、『硬件加速』。
为了保证各个版本的兼容性，及时使用到新特性，targetSdkVersion因随Android最新版本的发布而持续提高，以保证在各个Android版本的设备上都能获得完整的体验。

二、<application>中的debuggable=”true”
当debuggable打开时，除了更易暴露在攻击之下，SDK tools（包括ProGuard）也不会进行一些针对发布版本可以进行的优化，比如移除dex包中的代码调试信息（符号名、行号等），移除DEBUG和VERBOSE级别的日志输出。这些对App发布版本的容量和性能都有直接的影响。

三、 <uses-permission>写在<application>之后
表面上看没有什么问题，但却埋下了一些<application>内部属性正确生效的隐患。