定义:AndrodiManifest.xml文件为Android程序的入口文件,并且是必须的,位于整个项目的根目录下。拿到一个Android项目,可以先从AndroidManifest.xml文件入手,进行分析。它提供了一些必要的信息,比如程序的入口Activity,其他组件的声明,权限的声明,包名,版本信息等。
Manifest可以做以下事情:
- 定义包名,包名为APP的唯一标识,每个不同APP的包名必然不同。
- 组件声明。Activity,Service,BroadcastReceiver,ContentProvider
- 确定应用程序组件的进程
- 权限声明
- 列出Instrumentation类的信息,提供性能分析和APP在执行的其他信息
- 声明应用支持最低Android API的版本
- 声明必须链接的共享类库
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>
<intent-filter>
<action />
<category />
<data />
</intent-filter>
<meta-data />
</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 />
<path-permission />
</provider>
<uses-library />
</application>
</manifest>
manifest
清单文件的根元素,必须包含<application>标签,指定命名空间xmlns:android和package属性
<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>
xmlns:android,定义android命名空间,通常设置为“http://schemas.android.com/apk/res/android”。关于xml的命名空间,可以看这里
package:不同的APP具有不同的包名。以Java包名风格进行命名,必须唯一。
sharedUserId:具有相同的uderId并且具有相同签名的APP可以共享和访问彼此的数据,甚至可以在同一个进程里面运行,此时必须设置<android:process>相同。
sharedUserLabel:给共享userId定义了用户可读标签,只有设置了sharedUserId,此属性才有意义。
versionCode:内部版本号。必须是整数,Integer类型。用来判断版本的升级,每一次发布都必须必之前的要大。如果versionName没有设置,则设置成此值。
versionName:展示给用户看的版本号。为String类型。
installLocation:设置apk文件的默认安装路径。
- internalOnly,只能安装在设备ROM上(内部存储),如果设备ROM空间满了,则会安装失败。如果没定义androdi:installLocation,则默认设置的是此项。
- auto,系统优先安装apk包到内部存储,如果内部存储满了,则会安装到SD卡。用户也可以把外部存储安装好的应用移到内部存储上
- preferExternal,会优先安装在外部存储上(SD卡),当无SD卡或SD卡满了的话,则会安装到内部存储上。当然,用户可以把外部存储安装好的应用移到内部存储上
关于外部存储的几个注意点:- .apk文件是安装在SD卡上,但是数据还是保持在内部存储上
- SD卡上安装的apk文件和设备关联,把SD卡放到另外一台设备进行访问是不行的。
- 用户可以把已安装好的应用移入内部存储
权限
user-permission
声明APP需要使用到的权限,Android5.1或以下在安装的时候声请,Android6.0或以上的需要运行时权限申请
<uses-permission android:name="string"
android:maxSdkVersion="integer" />
name:权限的名称。可以是系统定义的权限,也可以是其他应用的权限,或者是使用<permission>自定义的权限
maxSdkVersion:此申请的权限最高的作用Android版本。当一些权限在高版本无需申请的时候可以设置此值,比如 WRITE_EXTERNAL_STORAGE,在API 19就不需要进行申请了,可以进行如下操作
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="18" />
permission
自定义权限,以限制访问指定的组件或APP——本APP或其他APP,起到保护的作用。
<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"] />
description:自定义的用户可读的权限描述,
icon:权限的icon图标
label:展示给用户的权限名字
name:权限的命名,为一串唯一的英文字符,如:com.example.READ_ACTIVITY。需要注意的是Android系统不允许不同的包名定义相同的权限名(permission name),除非不同的包名具有相同的签名证书。如果一个APP1声明了权限名A,则系统不允许另外一个声明了权限名A的不同签名证书的APP2进行安装。为了避免这种情况发生,可以以自己APP的包名为前缀进行权限声明
permissionGroup:权限所属的权限组,此项的值必须为<permission-group>中声明的name或者是其他APP声明的。如果此项不设置,则此权限不属于权限组。
protectionLevel:权限的级别。
- normal:默认值。低风险的。系统会自动分配此类权限,而不需要通过用户来点击确认
- dangerous:危险的权限。需要经用户允许才能够获取此类权限
- signature:申请权限的APP必须也声明此权限的APP具有相同的签名才允许获得。
- signatureOrSystem:申请权限的APP必须为系统签名或是和声明此权限的APP具有相同的签名才允许获得权限
要访问受权限保护的组件,必须在<uses-permission>进行声明,不论是官方定义的还是自定义的,如:
<manifest . . . >
<permission android:name="com.example.READ_ACTIVITY" . . . />
<uses-permission android:name="com.example.READ_ACTIVITY" />
. . .
<application . . .>
<activity android:name="com.example.TestActivity"
android:permission="com.example.READ_ACTIVITY"
. . . >
. . .
</activity>
</application>
</manifest>
TestActivity声明了READ_ACTIVITY权限保护,如果要启动TestActivity,必须要申请READ_ACTIVITY权限
permission-tree
声明一个权限树,可以在此节点上动态添加权限,PackageManager.addPermission()。如声明了权限树com.example.project.taxes,在此节点上可以动态添加权限:
com.example.project.taxes.CALCULATE
com.example.project.taxes.deductions.MAKE_SOME_UP
com.example.project.taxes.deductions.EXAGGERATE
需要注意的是此项声明的不是权限,是权限的命名空间。
<permission-tree android:icon="drawable resource"
android:label="string resource" ]
android:name="string" />
icon和label与permission的类似。
name为权限的命名,如:com.example.project.taxes
permission-group
声明一个逻辑上的权限分组
<permission-group android:description="string resource"
android:icon="drawable resource"
android:label="string resource"
android:name="string" />
instrumentation
声明一个Instrumentation类,用来监控APP和系统的交互。Instrumentation对象会在APP的所有组件之前进行实例化。
<instrumentation android:functionalTest=["true" | "false"]
android:handleProfiling=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:targetPackage="string" />
functionalTest:是否进行功能性的测试。true:是。false:否。默认值为false
handleProfiling:true:自定义性能分析的开始和结束时间。false:性能分析整个运行过程。默认值为false
name:Instrumentation子类的全名。比如:com.example.project.StringInstrumentation
targetPackage:Instrumentation对象所依赖的目标包名
uses-sdk
<uses-sdk android:minSdkVersion="integer"
android:targetSdkVersion="integer"
android:maxSdkVersion="integer" />
minSdkVersion:指定APP运行的所需最低API级别的整数,如果系统API级别低于此值,则会阻止用户安装。如果不声明该属性,则默认为1。
targetSdkVersion:指定APP目标API级别的整数,不过不声明该属性,则默认和minSdkVersion一样
maxSdkVersion:APP能够运行在系统的最大API级别。在Android2.0.1以下,如果APP指定的此项低于系统的API级别,则会安装不了,已安装的会被隐藏掉。Android2.0.1(不包含)以上的系统不会检查安装的APP的此项属性,所以不会出现2.0.1以下的情况。此值一般不进行设置。
uses-configuration
用来设置APP需要的相关硬件和软件的配置。大部分APP都不需要此属性。
<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"] />
reqFiveWayNav:是否需要五维导航控制,如方向版(D-pad),轨迹球等。
reqHardKeyboard:是否需要物理键盘
reqKeyboardType:设置所需键盘的类型
reqNavigation:指定方向控制的确切类型或不指定(undefined,为默认值)
reqTouchScreen:触摸屏的类型。
uses-feature
用来声明APP所要使用和依赖的单一的软硬件功能。该项所提供的require属性如果是需要的功能,那么如果缺少的话就会无法使用。比如声明了<uses-feature android:name="android.hardware.camera" require="true"/>,如果缺少摄像头,那么就会无法使用。并且必须单独地为每个功能进行声明。很重要的一点是GooglePlay会根据此项所声明的功能进行过滤提供给兼容设备的用户,用户只能下载和其设备相容的APP。
<uses-feature
android:name="string"
android:required=["true" | "false"]
android:glEsVersion="integer" />
name:硬件或软件功能的字符串描述。
required:true,当设备没有改指定的功能(name)时,APP无法正常工作或设计为无法正常工作;false,有该功能优先使用该功能,无也可正常工作。默认值为true
glEsVersion:所需要的OpenGL ES版本。高16位表示主版本号,底16位表示次版本号。例如,要指定 OpenGL ES 2.0 版,您需要将其值设置为“0x00020000”;要指定 OpenGL ES 3.2,则需将其值设置为“0x00030002”。如果声明多个,则选择最高版本的那个,其它的忽略。如果不声明,则默认为1.0版本,所有Android设备都支持。