解析:Google官方示例中的teapots项目中的一个文件,
我们就针对这份文件来分析字段的意义,字段的意义参考的是官方文档;
<manifest xmlns:android="http://schemas.android.com/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:theme="@style/Theme.AppCompat.Light.NoActionBar"
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>
<manifest>元素
首先,所有的xml都必须包含<manifest>元素。这是文件的根节点。它必须要包含<application>元素,并且指明xmlns:android和package属性。
<manifest
//这个属性定义了Android命名空间。必须设置成这样,不要手动修改。
xmlns:android="http://schemas.android.com/apk/res/android"
//完整的Java语言风格包名。包名由英文字母(大小写均可)、数字和下划线组成。每个独立的名字必须以字母开头。
//包名也代表着唯一的application ID,用来发布应用。
//但是,要注意的一点是:在APK构建过程的最后一步,package名会被build.gradle文件中的applicationId属性取代。
//如果这两个属性值一样,那么万事大吉,如果不一样,那就要小心了。
package="com.sample.teapot"
//内部的版本号。用来表明哪个版本更新。这个数字不会显示给用户。
//显示给用户的是versionName。这个数字必须是整数。不能用16进制,也就是说不接受"0x1"这种参数
android:versionCode="1"
//显示给用户看的版本号
android:versionName="1.0.0.1" >
<uses-feature>的属性
<uses-feature
//指明应用需要的Opengl ES版本。高16位表示主版本号,低16位表示次版本号。
//例如,如果是要3.2的版本,就是0x00030002。如果定义多个glEsVersion,应用会自动启用最高的设置。
android:glEsVersion="0x00020000"
></uses-feature>
<application>元素
此元素描述了应用的配置。这是一个必备的元素,它包含了很多子元素来描述应用的组件,它的属性影响到所有的子组件。许多属性(例如icon、label、permission、process、taskAffinity和allowTaskReparenting)都可以设置成默认值。
<application
//表示是否允许APP加入到备份还原的结构中。如果设置成false,那么应用就不会备份还原。默认值为true。
android:allowBackup="false"
//这个属性指向了一个xml文件,该文件中包含了在进行自动备份时的完全备份规则。
//这些规则定义了哪些文件需要备份。此属性是一个可选属性。默认情况下,自动备份包含了大部分app文件。
android:fullBackupContent="false"
//声明你的APP是否支持RTL(Right To Left)布局。如果设置成true,并且targetSdkVersion被设
//置成17或更高。该属性的默认的值是false。
android:supportsRtl="true"
//APP的图标,以及每个组件的默认图标。可以在组价中自定义图标。
//这个属性必须设置成一个引用,指向一个可绘制的资源,这个资源必须包含图片。
android:icon="@mipmap/ic_launcher"
//一个用户可读的标签,以及所有组件的默认标签。
android:label="@string/app_name"
//该属性定义了应用使用的主题的,它是一个指向style资源的引用。
//各个activity也可以用自己的theme属性设置自己的主题。
android:theme="@style/AppTheme"
//Application子类的全名。包括前面的路径。例如com.sample.teapot.TeapotApplication。
//当应用启动时,这个类的实例被第一个创建。这个属性是可选的,大多数APP都不需要这个属性。
//在没有这个属性的时候,Android会启动一个Application类的实例。
android:name="com.sample.teapot.TeapotApplication"
>
<activity>元素
该元素声明一个实现应用可视化界面的Activity(Activity类子类)。这是<application>元素中必要的子元素。所有Activity都必须由清单文件中的<activity>元素表示。任何未在该处声明的Activity对系统都不可见,并且永远不会被执行。
<activity
//Activity类的名称,是Activity类的子类。该属性值为完全限定类名称,
//例如com.sample.teapot.TeapotNativeActivity。为了方便起见,
//如果第一个字符是点('.'),就需要加上<manifest>元素中的包名。应用一旦发布,不应更改该名称。
android:name="com.sample.teapot.TeapotNativeActivity"
//Activity标签,可以被用户读取。该标签会在Activity激活时显示在屏幕上。
//如果未设置,用<application>中的label属性。对属性的设置要求和<application>中一样。
android:label="@string/app_name"
//设定主题格式,与<application>中的theme类似。
android:theme="@style/Theme.AppCompat.Light.NoActionBar"
//列出 Activity 将自行处理的配置更改消息。在运行时发生配置更改时,默认情况下会关闭 Activity 然后将其重新启动,但使用该属性声明配置将阻止 Activity 重新启动。
//Activity 反而会保持运行状态,并且系统会调用其 onConfigurationChanged()方法。
//注:应避免使用该属性,并且只应在万不得已的情况下使用。 如需了解有关如何正确处理配置更改所致重新启动的详细信息,请阅读处理运行时变更。
android:configChanges="orientation|keyboardHidden">
<!-- Tell NativeActivity the name of our .so -->
//指定额外的数据项,该数据项是一个name-value对,提供给其父组件。这些数据会组成一个Bundle对象,可以由PackageItemInfo.metaData字段使用。
//虽然可以使用多个<meta-data>元素标签,但是不推荐这么使用。如果有多个数据项要指定,推荐做法是:将多个数据项合并成一个资源,然后使用一个<meta-data>包含进去。
<meta-data
//数据项名称,这是一个唯一值。
android:name="android.app.lib_name"
//数据项的值。
android:value="TeapotNativeActivity" />
//指明这个activity可以以什么样的意图(intent)启动。该元素有几个子元素可以包含。我们先介绍遇到的这两个:
<intent-filter>
//表示activity作为一个什么动作启动,android.intent.action.MAIN表示作为主activity启动。
<action android:name="android.intent.action.MAIN" />
//这是action元素的额外类别信息,android.intent.category.LAUNCHER表示这个activity为当前应用程序优先级最高的Activity。
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>