（转）android manifest.xml中元素含义

最新推荐文章于 2025-09-18 13:43:19 发布

原创最新推荐文章于 2025-09-18 13:43:19 发布 · 176 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Android #XML #活动 #应用服务器 #数据结构

本文深入解析AndroidManifest.xml文件中的组件属性与配置，包括活动、服务、广播接收器等，详细阐述各属性的功能及作用，帮助开发者更好地理解和使用AndroidManifest.xml。

转自http://blog.youkuaiyun.com/wbw1985/archive/2009/11/24/4862319.aspx

是否允许activity更换从属的任务，比如从短信息任务切换到浏览器任务。
--------------------------------------------------------------------------------------
android:alwaysRetainTaskState
是否保留状态不变，比如切换回home, 再从新打开， activity处于最后的状态
--------------------------------------------------------------------------------------
android:clearTaskOnLanunch
比如 P 是 activity, Q 是被P 触发的 activity, 然后返回Home, 从新启动 P，是否显示 Q
--------------------------------------------------------------------------------------
android:configChanges
当配置list发生修改时，是否调用 onConfigurationChanged() 方法比如 "locale|navigation|orientation".
--------------------------------------------------------------------------------------

activity 是否可以被实例化,
--------------------------------------------------------------------------------------

是否可被显示在最近打开的activity列表里
--------------------------------------------------------------------------------------
android:exported
是否允许activity被其它程序调用
--------------------------------------------------------------------------------------
android:finishOnTaskLaunch
是否关闭已打开的activity当用户重新启动这个任务的时候
--------------------------------------------------------------------------------------
android.icon
--------------------------------------------------------------------------------------
android:label
--------------------------------------------------------------------------------------
android:launchMode
activity启动方式， "standard" "singleTop" "singleTask" "singleInstance" 其中前两个为一组，后两个为一组
--------------------------------------------------------------------------------------
android:multiprocess
允许多进程
--------------------------------------------------------------------------------------
android:name

--------------------------------------------------------------------------------------
android:onHistory
是否需要移除这个activity当用户切换到其他屏幕时。这个属性是 API level 3 中引入的
--------------------------------------------------------------------------------------
android:permission
--------------------------------------------------------------------------------------
android:process
一个activity运行时所在的进程名，所有程序组件运行在应用程序默认的进程中，这个进程名跟应用程序的包名一致。中的元素process属性能够为所有组件设定一个新的默认值。但是任何组件都可以覆盖这个默认值，允许你将你的程序放在多进程中运行。如果这个属性被分配的名字以:开头，当这个activity运行时, 一个新的专属于这个程序的进程将会被创建。如果这个进程名以小写字母开头，这个activity将会运行在全局的进程中，被它的许可所提供。
--------------------------------------------------------------------------------------

activity显示的模式, "unspecified" 默认值 "landscape" 风景画模式，宽度比高度大一些 "portrait" 肖像模式, 高度比宽度大。 "user" 用户的设置 "behind" "sensor" "nosensor"

android:stateNotNeeded

--------------------------------------------------------------------------------------

activity的亲属关系，默认情况同一个应用程序下的activity有相同的关系

android:theme
activity的样式主题, 如果没有设置，则activity的主题样式从属于应用程序，参见元素的theme属性
--------------------------------------------------------------------------------------

activity主窗口与软键盘的交互模式, 自从API level 3 被引入

以下转自http://www.chinaup.org/docs/devel/bblocks-manifest.html

AndroidManifest.xml 文件

AndroidManifest.xml是每一个应用都需要的文件，位于应用根目录下，它描述了程序包的全局变量, 包括暴露的应用组件(activities, services等等)和为每个组件的实现类，什么样的数据可以操作，以及在什么地方运行。

这个文件的一个重要方面就是是其中的intent过滤器（intent filters）。这些过滤器描述了何时何种情况下让活动（activity）启动。当一个activity（或是操作系统）想要执行一个动作，例如打开一个Web页或是打开一个联系人选取屏幕，它将会创建一个Intent对象。该对象包含了很多几个描述符（descriptors），描述了你想做什么操作，你想处理什么数据，数据的类型，以及一些其他的信息。 Android将Intent对象中的信息与所有应用暴露的intent过滤器比较，找到一个最能恰当处理请求者要求的数据和动作（action）的activity。关于intents的更多信息在Intent页可以找到。

除了声明应用的活动（Activities），内容管理器（ Content Providers），服务（ Services），和 Intent 接收器（Intent Receivers），你也可以在AndroidManifest.xml文件中指定权限和instrumentation(安全控制和测试). 请查看AndroidManifest了解这个标签和他们的属性。

如下是一个简单的AndroidManifest.xml文件：

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.my_domain.app.helloactivity">
        
    <application android:label="@string/app_name">
    
        <activity android:name=".HelloActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        
    </application>
    
</manifest>

需要注意的一些通用事项：

几乎所有的AndroidManifest.xml 文件(同其他的Android文件一样)都会在其第一个元素(element)中包含一个命名空间的声明xmlns:android="http://schemas.android.com/apk/res/android" 。该声明使标准Android属性在该文件中可用，这些属性为文件中的xml元素提供了大部分数据。.
大多数的manifests包含一个<application>元素，该元素定了这个程序包内所有应用层面上可用的组件和属性。
所有需要可以从应用程序启动器（program launcher）中呈现给用户的顶层应用都至少需要包括一个活动（Activity）组件，它用来支持MAIN action 和显示在LAUNCHER 目录中。

下面列出了AndroidManifest.xml 这个文件详细的结构大纲, 描述了所有可用标签。

文件根节点。描述了程序包的所有内容。在其节点下面内可以放置：

<uses-permission>

请求一个安全授权, 你的程序包必须被授予该权限才能正确的操作。参见看安全模块( Security Model)文档以了解有关授权的更多信息。一个manifest可以包含零个或多个这样的节点。

声明一个安全授权，它用来限制哪些应用可以访问你的（或别的）程序包内的组件和特有功能（feature）。参见看安全模块( Security Model)文档以了解有关授权的更多信息。一个manifest可以包含零个或多个这样的节点。

声明一个instrumentation 组件可用于测试这一个或别的包的代码。更详细内容参见 Instrumentation 。一个manifest可以包含零个或多个这样的节点。

声明程序包内应用级别组件的根节点。该节点能够描述应用程序的全局（和/或）默认属性，例如标签，图标，主题，需要的权限，等等。一个manifest可以包含零个或一个这样的节点（多个application 节点是不允许的）。在该节点下, 可以包含零个或多个以下每个组件的声明：

活动（ Activity）是应用与用户交互的最主要机制。当一个应用运行的时候，用户看到的第一个屏幕就是activity。此外，用户所使用的其他绝大多数屏幕也是由独立的活动实现的，它们由额外活动tag声明。

注意: 无论活动是外部可见还是仅在程序包内使用，在manifest中每一个活动必须在定义一个 <activity>标签。如果活动在manifest 中没有匹配的标签，那么你无法启动它。</activity>

此外，为了支持运行时活动查找，你可以包含一个或多个 <intent-filter>元素来描述该活动支持的动作（actions）。</intent-filter>

<intent-filter>

以一个 IntentFilter的形式声明组件所支持的特定的一组 Intent 值。除了可以在此元素下指定的各种值，也可以在此对属性（atttibutes）进行赋值以支持唯一的标签（label），图标（icon），和所描述动作（action）的其它信息。

该组件支持的 Intent action。

该组件支持的Intent目录（ Intent category）。

<data>

该组件支持的 Intent data MIME type, Intent data URI scheme, Intent data URI authority, 或 Intent data URI path。

你也可把一个或多个meta-data 与你的活动（activity）关联，其它客户端（clients）可以取得这些meta-dada以获得关于这个活动的任意信息。

<meta-data>

向活动（activity）添加新的元数据（meta data），客户端可以通过 ComponentInfo.metaData获取该数据。

一个 BroadcastReceiver 可以使应用接收数据变化和行为发生的通知，即使这个应用没有在运行也同样可以。同activity 标签一样, 你可以选择包含一个或多个该receiver支持<intent-filter>元素或<meta-data>值。更多信息参见活动（activity）的<a href="http://www.chinaup.org/docs/devel/bblocks-manifest.html#intent-filter" style="color: rgb(0, 0, 204); outline-style: none; "><intent-filter></a> 和 <a href="http://www.chinaup.org/docs/devel/bblocks-manifest.html#meta-data" style="color: rgb(0, 0, 204); outline-style: none; "><meta-data></a>描述。</meta-data></intent-filter>

服务（ Service ）是一个在后台可以运行任意长时间的组件。同activity 标签一样, 你可以选择包含一个或多个该服务支持<intent-filter>元素或<meta-data>值。更多信息参见活动（activity）的<a href="http://www.chinaup.org/docs/devel/bblocks-manifest.html#intent-filter" style="color: rgb(0, 0, 204); outline-style: none; "><intent-filter></a>和 <a href="http://www.chinaup.org/docs/devel/bblocks-manifest.html#meta-data" style="color: rgb(0, 0, 204); outline-style: none; "><meta-data></a> 描述。</meta-data></intent-filter>

组件管理器（ ContentProvider）用来管理持久数据和向其它应用发布数据的组件。你也可以按照活动的(activity’s)<meta-data>中描述附加一个或多 <a href="http://www.chinaup.org/docs/devel/bblocks-manifest.html#meta-data" style="color: rgb(0, 0, 204); outline-style: none; "><meta-data></a> 值。</meta-data>