我们在进行APP开发的时候都会遇到一个文件:AndroidManifest.xml。从刚开始进行Android开发,到现在已经过去了几个月,还是对这个文件一知半解,只知道它是配置用的。但是这文件里的东西具体有什么用,该怎么用一直都没有理解。借着做项目的机会,仔细研究一下这个文件。 研究AndroidManifest.xml最好的方式自然就是对照着官方文档详细理解项目中每个字段的作用,并且做出一些修改来验证。 AndroidManifest是什么?AndroidManifest官方解释是应用清单(manifest意思是货单),每个应用的根目录中都必须包含一个,并且文件名必须一模一样。这个文件中包含了APP的配置信息,系统需要根据里面的内容运行APP的代码,显示界面。 AndroidManifest的作用是什么?上述的功能是非常笼统的解释,具体到细节就是:
上面是官方的解释。很多东西笔者现在还不能理解,也没有用到,先挑笔者理解的进行解释。 一份真实的AndroidManifest.xml文件<manifest xmlns:android='http://schemas./apk/res/android' package='com.sample.teapot' android:versionCode='1' android:versionName='1.0.0.1' > <uses-feature android:glEsVersion='0x00020000'></uses-feature> <application android:allowBackup='false' android:fullBackupContent='false' android:supportsRtl='true' android:icon='@mipmap/ic_launcher' android:label='@string/app_name' android:theme='@style/AppTheme' android:name='com.sample.teapot.TeapotApplication' > <!-- Our activity is the built-in NativeActivity framework class. This will take care of integrating with our NDK code. --> <activity android:name='com.sample.teapot.TeapotNativeActivity' android:label='@string/app_name' android:configChanges='orientation|keyboardHidden'> <!-- Tell NativeActivity the name of our .so --> <meta-data android:name='android.app.lib_name' android:value='TeapotNativeActivity' /> <intent-filter> <action android:name='android.intent.action.MAIN' /> <category android:name='android.intent.category.LAUNCHER' /> </intent-filter> </activity> </application></manifest> 这是Google官方示例中的teapots项目中的一个文件,我们就针对这份文件来分析字段的意义。字段的意义参考的是官方文档。 <manifest>元素首先,所有的xml都必须包含<manifest>元素。这是文件的根节点。它必须要包含<application>元素,并且指明xmlns:android和package属性。 <manifest>元素中的属性xmlns:android 这个属性定义了Android命名空间。必须设置成' package 这是一个完整的Java语言风格包名。包名由英文字母(大小写均可)、数字和下划线组成。每个独立的名字必须以字母开头。 构建APK的时候,构建系统使用这个属性来做两件事:
比如:package被设置成com.sample.teapot,那么生成的R类就是:com.sample.teapot.R
包名也代表着唯一的application ID,用来发布应用。但是,要注意的一点是:在APK构建过程的最后一步,package名会被build.gradle文件中的applicationId属性取代。如果这两个属性值一样,那么万事大吉,如果不一样,那就要小心了。 android:versionCode 内部的版本号。用来表明哪个版本更新。这个数字不会显示给用户。显示给用户的是versionName。这个数字必须是整数。不能用16进制,也就是说不接受'0x1'这种参数 android:versionName 显示给用户看的版本号。 <manifest>元素中的元素<uses-feature>元素Google Play利用这个元素的值从不符合应用需要的设备上将应用过滤。 这东西的作用是将APP所依赖的硬件或者软件条件告诉别人。它说明了APP的哪些功能可以随设备的变化而变化。 使用的时候要注意,必须在单独的<uses-feature>元素中指定每个功能,如果要多个功能,需要多个<uses-feture>元素。比如要求设备同时具有蓝牙和相机功能:
<uses-feature>的属性android:name 该属性以字符串形式指定了APP要用的硬件或软件功能。 android:required 这项属性如果值为true表示需要这项功能否则应用无法工作,如果为false表示应用在必要时会使用该功能,但是如果没有此功能应用也能工作。 android:glEsVersion 指明应用需要的Opengl ES版本。高16位表示主版本号,低16位表示次版本号。例如,如果是要3.2的版本,就是0x00030002。如果定义多个glEsVersion,应用会自动启用最高的设置。 <application>元素此元素描述了应用的配置。这是一个必备的元素,它包含了很多子元素来描述应用的组件,它的属性影响到所有的子组件。许多属性(例如icon、label、permission、process、taskAffinity和allowTaskReparenting)都可以设置成默认值。 <application>的属性android:allowBackup 表示是否允许APP加入到备份还原的结构中。如果设置成false,那么应用就不会备份还原。默认值为true。 android:fullBackupContent 这个属性指向了一个xml文件,该文件中包含了在进行自动备份时的完全备份规则。这些规则定义了哪些文件需要备份。此属性是一个可选属性。默认情况下,自动备份包含了大部分app文件。 android:supportsRtl 声明你的APP是否支持RTL(Right To Left)布局。如果设置成true,并且targetSdkVersion被设置成17或更高。很多RTL API会被集火,这样你的应用就可以显示RTL布局了。如果设置成false或者targetSdkVersion被设置成16或更低。哪些RTL API就不起作用了。 该属性的默认的值是false。 android:icon APP的图标,以及每个组件的默认图标。可以在组价中自定义图标。这个属性必须设置成一个引用,指向一个可绘制的资源,这个资源必须包含图片。系统不设置默认图标。例如mipmap/ic_launcher引用的就是下面的资源 android:label 一个用户可读的标签,以及所有组件的默认标签。子组件可以用他们的label属性定义自己的标签,如果没有定义,那么就用这个标签。 标签必须设置成一个字符串资源的引用。这样它们就能和其他东西一样被定位,比如@string/app_name。当然,为了开发方便,你也可以定义一个原始字符串。 android:theme 该属性定义了应用使用的主题的,它是一个指向style资源的引用。各个activity也可以用自己的theme属性设置自己的主题。 android:name Application子类的全名。包括前面的路径。例如 <activity>元素 该元素声明一个实现应用可视化界面的Activity(Activity类子类)。这是<application>元素中必要的子元素。所有Activity都必须由清单文件中的<activity>元素表示。任何未在该处声明的Activity对系统都不可见,并且永远不会被执行。 android:name Activity类的名称,是Activity类的子类。该属性值为完全限定类名称,例如 没有默认值,必须指定该名称。 android:label Activity标签,可以被用户读取。该标签会在Activity激活时显示在屏幕上。如果未设置,用<application>中的label属性。对属性的设置要求和<application>中一样。 android:configChanges 列出 Activity 将自行处理的配置更改消息。在运行时发生配置更改时,默认情况下会关闭 Activity 然后将其重新启动,但使用该属性声明配置将阻止 Activity 重新启动。 Activity 反而会保持运行状态,并且系统会调用其 onConfigurationChanged()方法。
这属性可以设置的项很多,这里列出常用的项: orientation 屏幕放心啊发生了变化,比如用户旋转了设备 keyboardHidden 键盘无障碍功能发生了变化,比如用户显示了硬件键盘 android:launchMode 关于如何启动Activity的指令。一共有四种指令:
<meta-data>元素 指定额外的数据项,该数据项是一个name-value对,提供给其父组件。这些数据会组成一个Bundle对象,可以由PackageItemInfo.metaData字段使用。虽然可以使用多个<meta-data>元素标签,但是不推荐这么使用。如果有多个数据项要指定,推荐做法是:将多个数据项合并成一个资源,然后使用一个<meta-data>包含进去。 该元素有三个属性: android:name 数据项名称,这是一个唯一值。 android:resource 一个资源的引用。 android:value 数据项的值。 <intent-filter>元素 指明这个activity可以以什么样的意图(intent)启动。该元素有几个子元素可以包含。我们先介绍遇到的这两个: <action>元素 表示activity作为一个什么动作启动, <category>元素 这是action元素的额外类别信息, 总结至此,所有的元素信息已经分析完毕,如有错误,欢迎各位读者指正。后面再遇到什么元素会继续往里面添加。 |
|
来自: 好汉勃士 > 《Java的基本概述》