AndroidManifest.xml 最全详解

时间 2019-11-17

标签 androidmanifest.xml androidmanifest xml 详解栏目 Android 繁體版

原文原文链接

AndroidManifest.xml 是每一个android程序中必须的文件，它位于整个项目的根目录。咱们天天都在使用这个文件，往里面配置程序运行所必要的组件，权限，以及一些相关信息。可是对于这个文件，咱们真正又了解多少了，仍是只是停留在只会简单的配置，而不明白其中的具体含义，以及为何要这样设置？今天就让咱们来详细的学习一下这个文件里各项参数的具体含义，由于它是整个应用的入口，因此有助于咱们更加深刻的理解Android。html

1、概述：

　　AndroidManifest.xml是Android应用的入口文件，它描述了package中暴露的组件（activities, services, 等等），他们各自的实现类，各类能被处理的数据和启动位置。除了能声明程序中的Activities, ContentProviders, Services, 和Intent Receivers,还能指定permissions和instrumentation（安全控制和测试）。
　　前端

2、结构图

<?xmlversion="1.0"encoding="utf-8"?>
<manifest>

    <uses-sdk/> 
    <uses-configuration/> 
    <uses-feature/>  

    <uses-permission/>
    <permission/>
    <permission-tree/>
    <permission-group/>
    <instrumentation/> 

    <supports-screens/>

    <application> 
       <activity> 
           <intent-filter>
               <action/> 
               <category/> 
           </intent-filter> 
      </activity>
       <activity-alias> 
           <intent-filter></intent-filter> 
           <meta-data/> 
      </activity-alias> 
       <service> 
           <intent-filter></intent-filter> 
           <meta-data/> 
       </service>
       <receiver>
           <intent-filter></intent-filter> 
           <meta-data/> 
       </receiver> 
       <provider> 
           <grant-uri-permission/>
           <meta-data/> 
       </provider> 
       <uses-library/> 
    </application>  

</manifest>

3、详解

一、Manifest:属性

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

A、xmlns:androidjava

定义android命名空间，通常为http://schemas.android.com/apk/res/android，这样使得Android中各类标准属性能在文件中使用，提供了大部分元素中的数据。android

B、package后端

指定本应用内java主程序包的包名，它也是一个应用进程的默认名称api

C、sharedUserId浏览器

代表数据权限，由于默认状况下，Android给每一个APK分配一个惟一的UserID，因此是默认禁止不一样APK访问共享数据的。若要共享数据，第一能够采用Share Preference方法，第二种就能够采用sharedUserId了，将不一样APK的sharedUserId都设为同样，则这些APK之间就能够互相共享数据了。详见：http://wallage.blog.163.com/blog/static/17389624201011010539408/安全

D、sharedUserLabel网络

一个共享的用户名，它只有在设置了sharedUserId属性的前提下才会有意义app

E、versionCode

是给设备程序识别版本(升级)用的必须是一个interger值表明app更新过多少次，好比初版通常为1，以后若要更新版本就设置为2，3等等。。。

F、versionName

这个名称是给用户看的，你能够将你的APP版本号设置为1.1版，后续更新版本设置为1.二、2.0版本等等。。。

G、installLocation

安装参数，是Android2.2中的一个新特性，installLocation有三个值能够选择：internalOnly、auto、preferExternal

选择preferExternal,系统会优先考虑将APK安装到SD卡上(固然最终用户能够选择为内部ROM存储上，若是SD存储已满，也会安装到内部存储上)

选择auto，系统将会根据存储空间本身去适应

选择internalOnly是指必须安装到内部才能运行

二、Application:属性

一个AndroidManifest.xml中必须含有一个Application标签，这个标签声明了每个应用程序的组件及其属性(如icon,label,permission等)

<application  android:allowClearUserData=["true" | "false"]
             android:allowTaskReparenting=["true" | "false"]
             android:backupAgent="string"
             android:debuggable=["true" | "false"]
             android:description="string resource"
             android:enabled=["true" | "false"]
             android:hasCode=["true" | "false"]
             android:icon="drawable resource"
             android:killAfterRestore=["true" | "false"]
             android:label="string 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>

A、android:allowClearUserData(‘true’ or ‘false’)

用户是否能选择自行清除数据，默认为true，程序管理器包含一个选择容许用户清除数据。当为true时，用户可本身清理用户数据，反之亦然

B、android:allowTaskReparenting(‘true’ or ‘false’)

是否容许activity更换从属的任务，好比从短信息任务切换到浏览器任务

C、android:backupAgent

这也是Android2.2中的一个新特性，设置该APP的备份，属性值应该是一个完整的类名，如com.project.TestCase，此属性并无默认值，而且类名必须得指定(就是个备份工具，将数据备份到云端的操做)

D、android:debuggable

这个从字面上就能够看出是什么做用的，当设置为true时，代表该APP在手机上能够被调试。默认为false,在false的状况下调试该APP，就会报如下错误：

Device XXX requires that applications explicitely declare themselves as debuggable in their manifest.

Application XXX does not have the attribute ‘debuggable’ set to TRUE in its manifest and cannot be debugged.

E、android:description/android:label

此两个属性都是为许可提供的，均为字符串资源，当用户去看许可列表(android:label)或者某个许可的详细信息(android:description)时，这些字符串资源就能够显示给用户。label应当尽可能简短，之须要告知用户该许但是在保护什么功能就行。而description能够用于具体描述获取该许可的程序能够作哪些事情，实际上让用户能够知道若是他们赞成程序获取该权限的话，该程序能够作什么。咱们一般用两句话来描述许可，第一句描述该许可，第二句警告用户若是批准该权限会可能有什么很差的事情发生

F、android:enabled

Android系统是否可以实例化该应用程序的组件，若是为true，每一个组件的enabled属性决定那个组件是否能够被 enabled。若是为false，它覆盖组件指定的值；全部组件都是disabled。

G、android:hasCode(‘true’ or ‘false’)

表示此APP是否包含任何的代码，默认为true，若为false，则系统在运行组件时，不会去尝试加载任何的APP代码

一个应用程序自身不会含有任何的代码，除非内置组件类，好比Activity类，此类使用了AliasActivity类，固然这是个罕见的现象

(在Android2.3能够用标准C来开发应用程序，可在androidManifest.xml中将此属性设置为false,由于这个APP自己已经不含有任何的JAVA代码了)

H、android:icon

这个很简单，就是声明整个APP的图标，图片通常都放在drawable文件夹下

I、android:killAfterRestore

J、android:manageSpaceActivity

K、android:name

为应用程序所实现的Application子类的全名。当应用程序进程开始时，该类在全部应用程序组件以前被实例化。

若该类(比方androidMain类)是在声明的package下，则能够直接声明android:name=”androidMain”,但此类是在package下面的子包的话，就必须声明为全路径或android:name=”package名称.子包名成.androidMain”

L、android:permission

设置许可名，这个属性若在上定义的话，是一个给应用程序的全部组件设置许可的便捷方式，固然它是被各组件设置的许可名所覆盖的

M、android:presistent

该应用程序是否应该在任什么时候候都保持运行状态,默认为false。由于应用程序一般不该该设置本标识，持续模式仅仅应该设置给某些系统应用程序才是有意义的。

N、android:process

应用程序运行的进程名，它的默认值为元素里设置的包名，固然每一个组件均可以经过设置该属性来覆盖默认值。若是你想两个应用程序共用一个进程的话，你能够设置他们的android:process相同，但前提条件是他们共享一个用户ID及被赋予了相同证书的时候

O、android:restoreAnyVersion

一样也是android2.2的一个新特性，用来代表应用是否准备尝试恢复全部的备份，甚至该备份是比当前设备上更要新的版本，默认是false

P、android:taskAffinity

拥有相同的affinity的Activity理论上属于相同的Task，应用程序默认的affinity的名字是元素中设定的package名

Q、android:theme

是一个资源的风格，它定义了一个默认的主题风格给全部的activity,固然也能够在本身的theme里面去设置它，有点相似style。

三、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: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>

一、android:alwaysRetainTaskState

是否保留状态不变，好比切换回home, 再重新打开，activity处于最后的状态。好比一个浏览器拥有不少状态(当打开了多个TAB的时候)，用户并不但愿丢失这些状态时，此时可将此属性设置为true

二、android:clearTaskOnLaunch
好比 P 是 activity, Q 是被P 触发的 activity, 而后返回Home, 从新启动 P，是否显示 Q

三、android:configChanges

当配置list发生修改时，是否调用 onConfigurationChanged() 方法好比 “locale|navigation|orientation”.
这个我用过,主要用来看手机方向改变的. android手机在旋转后,layout会从新布局, 如何作到呢?
正常状况下. 若是手机旋转了.当前Activity后杀掉,而后根据方向从新加载这个Activity. 就会从onCreate开始从新加载.
若是你设置了这个选项, 当手机旋转后,当前Activity以后调用onConfigurationChanged() 方法. 而不跑onCreate方法等.

四、android:excludeFromRecents

是否可被显示在最近打开的activity列表里，默认是false

五、android:finishOnTaskLaunch

当用户从新启动这个任务的时候，是否关闭已打开的activity，默认是false

若是这个属性和allowTaskReparenting都是true,这个属性就是王牌。Activity的亲和力将被忽略。该Activity已经被摧毁并不是re-parented

六、android:launchMode(Activity加载模式)

在多Activity开发中，有多是本身应用之间的Activity跳转，或者夹带其余应用的可复用Activity。可能会但愿跳转到原来某个Activity实例，而不是产生大量重复的Activity。这须要为Activity配置特定的加载模式，而不是使用默认的加载模式

Activity有四种加载模式：

standard、singleTop、singleTask、singleInstance(其中前两个是一组、后两个是一组)，默认为standard

standard：就是intent将发送给新的实例，因此每次跳转都会生成新的activity。

singleTop：也是发送新的实例，但不一样standard的一点是，在请求的Activity正好位于栈顶时(配置成singleTop的Activity)，不会构造新的实例

singleTask：和后面的singleInstance都只建立一个实例，当intent到来，须要建立设置为singleTask的Activity的时候，系统会检查栈里面是否已经有该Activity的实例。若是有直接将intent发送给它。

singleInstance：

首先说明一下task这个概念，Task能够认为是一个栈，可放入多个Activity。好比启动一个应用，那么Android就建立了一个Task，而后启动这个应用的入口Activity，那在它的界面上调用其余的Activity也只是在这个task里面。那若是在多个task中共享一个Activity的话怎么办呢。举个例来讲，若是开启一个导游服务类的应用程序，里面有个Activity是开启GOOGLE地图的，当按下home键退回到主菜单又启动GOOGLE地图的应用时，显示的就是刚才的地图，其实是同一个Activity，实际上这就引入了singleInstance。singleInstance模式就是将该Activity单独放入一个栈中，这样这个栈中只有这一个Activity，不一样应用的intent都由这个Activity接收和展现，这样就作到了共享。固然前提是这些应用都没有被销毁，因此刚才是按下的HOME键，若是按下了返回键，则无效

七、android:multiprocess

是否容许多进程，默认是false

具体可看该篇文章：http://www.bangchui.org/simple/?t3181.html

八、android:noHistory

当用户从Activity上离开而且它在屏幕上再也不可见时，Activity是否从Activity stack中清除并结束。默认是false。Activity不会留下历史痕迹

九、android:screenOrientation

activity显示的模式

默认为unspecified：由系统自动判断显示方向

landscape横屏模式，宽度比高度大

portrait竖屏模式, 高度比宽度大

user模式，用户当前首选的方向

behind模式：和该Activity下面的那个Activity的方向一致(在Activity堆栈中的)

sensor模式：有物理的感应器来决定。若是用户旋转设备这屏幕会横竖屏切换

nosensor模式：忽略物理感应器，这样就不会随着用户旋转设备而更改了

十、android:stateNotNeeded

activity被销毁或者成功重启时是否保存状态

十一、android:windowSoftInputMode

activity主窗口与软键盘的交互模式，能够用来避免输入法面板遮挡问题，Android1.5后的一个新特性。

这个属性能影响两件事情：

【A】当有焦点产生时，软键盘是隐藏仍是显示

【B】是否减小活动主窗口大小以便腾出空间放软键盘

各值的含义：

【A】stateUnspecified：软键盘的状态并无指定，系统将选择一个合适的状态或依赖于主题的设置

【B】stateUnchanged：当这个activity出现时，软键盘将一直保持在上一个activity里的状态，不管是隐藏仍是显示

【C】stateHidden：用户选择activity时，软键盘老是被隐藏

【D】stateAlwaysHidden：当该Activity主窗口获取焦点时，软键盘也老是被隐藏的

【E】stateVisible：软键盘一般是可见的

【F】stateAlwaysVisible：用户选择activity时，软键盘老是显示的状态

【G】adjustUnspecified：默认设置，一般由系统自行决定是隐藏仍是显示

【H】adjustResize：该Activity老是调整屏幕的大小以便留出软键盘的空间

【I】adjustPan：当前窗口的内容将自动移动以便当前焦点从不被键盘覆盖和用户能老是看到输入内容的部分

四、intent-filter: 属性

结构图：

<intent-filter  android:icon="drawable resource"
               android:label="string resource"
               android:priority="integer" >

      <action />

      <category />

      <data />

</intent-filter>

intent-filter属性

android:priority(解释：有序广播主要是按照声明的优先级别，如A的级别高于B，那么，广播先传给A，再传给B。优先级别就是用设置priority属性来肯定，范围是从-1000～1000，数越大优先级别越高)

Intent filter内会设定的资料包括action,data与category三种。也就是说filter只会与intent里的这三种资料做对比动做

action属性

action很简单，只有android:name这个属性。常见的android:name值为android.intent.action.MAIN，代表此activity是做为应用程序的入口。有关android:name具体有哪些值，可参照这个网址：http://hi.baidu.com/linghtway/blog/item/83713cc1c2d053170ff477a7.html

category属性

category也只有android:name属性。常见的android:name值为android.intent.category.LAUNCHER(决定应用程序是否显示在程序列表里)

有关android:name具体有哪些值，可参照这个网址：http://chroya.javaeye.com/blog/685871

data属性

五、meta-data：属性

<meta-data android:name="string"
           android:resource="resource specification"
           android:value="string"/>

这是该元素的基本结构.能够包含在四个元素中。

android:name（解释：元数据项的名字，为了保证这个名字是惟一的，采用java风格的命名规范，如com.woody.project.fried)

android:resource(解释：资源的一个引用，指定给这个项的值是该资源的id。该id能够经过方法Bundle.getInt()来从meta-data中找到。)

android:value(解释：指定给这一项的值。能够做为值来指定的数据类型而且组件用来找回那些值的Bundle方法：[getString],[getInt],[getFloat],[getString],[getBoolean])

六、activity-alias：属性

<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">

<intent-filter/> 
<meta-data/>
</activity-alias>

是为activity建立快捷方式的，以下实例：

<activity android:name=".shortcut">

            <intent-filter>

                <action android:name="android.intent.action.MAIN" />

            </intent-filter>

</activity>

 <activity-alias android:name=".CreateShortcuts" android:targetActivity=".shortcut" android:label="@string/shortcut">

    <intent-filter>

             <action android:name="android.intent.action.CREATE_SHORTCUT" />

             <category android:name="android.intent.category.DEFAULT" />

     </intent-filter>

 </activity-alias>

其中android.targetActivity是指向对应快捷方式的activity,如上述的shortcut(此Activity名)

android:label是指快捷方式的名称，而快捷方式的图标默认是给定的application图标

七、Service：

【1】service与activity同级，与activity不一样的是，它不能本身启动的，运行在后台的程序，若是咱们退出应用时，Service进程并无结束，它仍然在后台运行。好比听音乐，网络下载数据等，都是由service运行的

【2】service生命周期：Service只继承了onCreate(),onStart(),onDestroy()三个方法，第一次启动Service时，前后调用了onCreate(),onStart()这两个方法，当中止Service时，则执行onDestroy()方法，若是Service已经启动了，当咱们再次启动Service时，不会在执行onCreate()方法，而是直接执行onStart()方法

【3】service与activity间的通讯

Service后端的数据最终仍是要呈如今前端Activity之上的，由于启动Service时，系统会从新开启一个新的进程，这就涉及到不一样进程间通讯的问题了(AIDL)，Activity与service间的通讯主要用IBinder负责。具体可参照：http://zhangyan1158.blog.51cto.com/2487362/491358

【4】

<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>

service标签内的属性以前已有描述，在此不重复了～

八、Receiver

receiver的属性与service同样，这里就不显示了

BroadcastReceiver：用于发送广播，broadcast是在应用程序之间传输信息的一种机制，而BroadcastReceiver是对发送出来的 Broadcast进行过滤接受并响应的一类组件，具体参照http://kevin2562.javaeye.com/blog/686787

九、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">

           <grant-uri-permission/>

           <meta-data/>

</provider>

contentProvider(数据存储)

【1】android:authorities：

标识这个ContentProvider，调用者能够根据这个标识来找到它

【2】android:grantUriPermission：

对某个URI授予的权限

【3】android:initOrder

十、uses-library

用户库，可自定义。全部android的包均可以引用

十一、supports-screens

<supports-screens  android:smallScreens=["true" | "false"] 
                  android:normalScreens=["true" | "false"] 
                  android:largeScreens=["true" | "false"] 
                  android:anyDensity=["true" | "false"] />

这是在android1.6之后的新特性，支持多屏幕机制

各属性含义：这四个属性，是否支持大屏，是否支持中屏，是否支持小屏，是否支持多种不一样密度

十二、uses-configuration 与uses-feature性能都差很少

<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:glEsVersion="integer"
              android:name="string"
              android:required=["true" | "false"] />

这二者都是在描述应用所须要的硬件和软件特性，以便防止应用在没有这些特性的设备上安装。

1三、uses-sdk

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

描述应用所需的api level，就是版本，目前是android 2.2 = 8，android2.1 = 7，android1.6 = 4，android1.5=3

在此属性中能够指定支持的最小版本，目标版本以及最大版本

1四、instrumentation

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

定义一些用于探测和分析应用性能等等相关的类，能够监控程序。在各个应用程序的组件以前instrumentation类被实例化

android:functionalTest(解释：instrumentation类是否能运行一个功能测试，默认为false)

1五、permission、uses-permission、permission-tree 、permission-group 区别～

最经常使用的当属，当咱们须要获取某个权限的时候就必须在咱们的manifest文件中声明，此与同级，具体权限列表请看此处

一般状况下咱们不须要为本身的应用程序声明某个权限，除非你提供了供其余应用程序调用的代码或者数据。这个时候你才须要使用这个标签。很显然这个标签可让咱们声明本身的权限。好比：

<application . . .>
        <activity android:name="XXX" . . . >            android:permission="com.teleca.project.MY_SECURITY"> </activity>

 </application>

固然本身声明的permission也不能随意的使用，仍是须要使用来声明你须要该权限

就是声明一个标签，该标签表明了一组permissions，而是为一组permissions声明了一个namespace。

4、分享几个经常使用方法

/**获取APP版本号
     * @param context
     * @return
     */
    public static String getAppVersion(Context context) {
         try {
            // 获取packagemanager的实例
            PackageManager packageManager = context.getPackageManager();
            // getPackageName()是你当前类的包名，0表明是获取版本信息
            PackageInfo packInfo = packageManager.getPackageInfo(context.getPackageName(),0);
            String version = packInfo.versionName;
            return version;
        } catch (NameNotFoundException e) {
            e.printStackTrace();
        }
         return null;
    }

    /**
     * get android os version no
     * @return
     */
    public static float getAndroidVersion() {
        return Float.valueOf(android.os.Build.VERSION.RELEASE);
    }

    /**
     * get device model
     * @return
     */
    public String getDeviceModel () {
        return android.os.Build.MODEL;
    }

    /**
     * get android os sdk version  2.2 = 8,2.3 = 9,4.2.1 = 17
     * @return sdk version
     */
    public static int getSDKVersion(){
        return android.os.Build.VERSION.SDK_INT;
    }