文档章节

Android开发指南-框架主题-清单文件

JavaGG
 JavaGG
发布于 2010/03/24 14:24
字数 2935
阅读 481
收藏 0

清单文件The AndroidManifest.xml File

每个应用程序都有一个AndroidManifest.xml文件(一定是这个名字)在它的根目录里。这个清单文件给Android系统提供了关于这个应用程序的基本信息,系统在能运行任何程序代码之前必须知道这些信息。AndroidManifest.xml主要包含以下功能:

命名应用程序的Java包,这个包名用来唯一标识应用程序;
描述应用程序的组件-活动,服务,广播接收者,以及组成应用程序的内容提供器;对实现每个组件和公布其能力(比如,能处理哪些意图消息)的类进行命名。这些声明使得Android系统了解这些组件以及在什么条件下可以被启动;
决定应用程序组件运行在哪个进程里面;
声明应用程序所必须具备的权限,用以访问受保护的部分API,以及和其它应用程序交互;
声明应用程序其他的必备权限,用以组件之间的交互;
列举测试设备Instrumentation类,用来提供应用程序运行时所需的环境配置及其他信息,这些声明只在程序开发和测试阶段存在,发布前将被删除;
声明应用程序所要求的Android API的最低版本级别;
列举application所需要链接的库;
 

清单文件结构Structure of the Manifest File

下面的图表显示了清单文件的基本结构以及它能包含的所有元素。每个元素,和它所有的属性,在一个单独的文件中完整描述。要查看任何元素的细节信息,可在图表下方的以字符序排列的元素列表中点击其元素名称。

 

 

   

   

   

   

 

   

 

   

 

   

 

       

           

               

               

               

           

           

       

 

       

            . . .

           

       

 

       

            . . .

           

       

 

       

            . . .

           

       

 

       

           

           

       

 

       

         

 

   

 

所有清单文件中可能出现的元素按字符序排列如下。只有这些元素是合法的,你不能添加自己的元素或属性:





















文件约定File Conventions

下面是一些清单文件中适用于所有元素和属性的约定和规则:

元素Elements:

在所有的元素中只有 是必需的,且只能出现一次。很多其他元素可以出现多次甚或一次都没有-尽管如果清单文件想要完成一些有意义的工作,必须设置至少其中的一些。如果一个元素包含点什么,那就是包含其他元素。所有的值必须通过属性来设置,而不是元素中的字符数据。同一级别的元素一般是没有顺序的。比如, , , 和 元素可以以任意顺序混合使用。( 元素是个例外:它必须跟在该别名所指的 后面。)

属性Attributes:

正规意义上,所有的属性都是可选的,但实际上有些属性是必须为一个元素指定来完成其目标。把这篇文档当作一个指南。对于那些真正可选的属性,即使不存在一个规格,也会有默认的数值或状态。

除了根元素 的一些属性,所有其他元素属性的名字都是以android:作为前缀的-比如, android:alwaysRetainTaskState。因为这个前缀是通用的,这篇文档提及属性名称时一般会忽略它。

声明类名Declaring class names:

很多对应于Java对象的元素,包括应用程序自己( 元素)以及它的基础组件-活动( ),服务( ),广播接收器( ),以及内容提供器( )。

如果你定义一个子类,就像你将经常为组件类(Activity, Service, BroadcastReceiver, 和ContentProvider)所做的那样,这个子类通过一个名字属性来声明。这个名字必须包含完整的包名称。比如,一个服务Service子类可能会声明如下:

   

       

            . . .

       

        . . .

   

不过,作为类名的简写,如果这个字符串的第一个字符是一个点号“.”,那么这个字符串将被扩展到应用程序包名的后面(正如 元素的package属性所指明的那样)。下面这个赋值和上面效果一样:

   

       

            . . .

       

        . . .

   

当启动一个组件时,Android创建了一个命名子类的实例。如果没有指定一个子类,它创建基类的一个实例。

多数值项Multiple values:

如果某个元素有超过一个数值,这个元素几乎总是需要被重复声明,而不能将多个数值项列举在一个属性中。比如,一个意图过滤器可以列举多个动作:

   

   

   

    . . .

资源项Resource values:

一些属性有能显示给用户的数值-比如,活动(activity)的一个标签和图标。这些属性的值应该被本地化,从一个资源或主题中设置。当需要引用某个资源时,采用如下的表述格式:

@[package:]type:name

这里package名称可以被忽略,要是资源和应用程序在同一个包里的话;type是资源的类型-如"string"或"drawable"-而且name是用来标识特定资源的名字。例如

从主题获取的数据以类似的方式表述,不过以'?'而不是'@'开头。

?[package:]type:name

 

字符串值String values:

如果属性值是一个字符串,则必须使用双反斜杠('\\')来表示escape('\')字符;第一个反斜杠起转义字符的作用)。比如,'\ '表示换行或'\\uxxxx'表示一个Unicode字符。

文件特性File Features

下面的章节描述了一些Android特性如何被映射到清单(manifest)文件中。

意图过滤器Intent Filters

应用程序的核心组件(活动,服务和广播接收器)通过意图被激活。意图是描述期望动作的信息包(一个Intent 对象)-包括要操作的数据,执行该动作的组件类别,以及其他有关指令。Android寻找一个合适的组件来响应这个意图,如果需要会启动这个组件一个新的实例,并传递给这个意图对象。

组件通过意图过滤器(intent filters)通告它们所具备的能力-能响应的意图类型。由于Android系统在启动一个组件前必须知道该组件能够处理哪些意图,那么意图过滤器需要在manifest中以 元素指定。一个组件可以拥有多个过滤器,每一个描述不同的能力。

一个显式命名目标组件的意图将会激活那个组件;过滤器不起作用。但是一个没有指定目标的意图只在它能够通过组件过滤器任一过滤器时才能激活该组件。

请查看关于意图和意图过滤器的文档以获取更多信息:Intents and Intent Filters.

图标和标签Icons and Labels

许多元素有图标(icon)和标签(label)属性。其中一些还有一个描述(description)属性,可以用更长的解释性文字呈现给用户。比如, 元素有所有这三个属性,因此当用户被询问是否授予一个应用程序请求的权限许可时,一个代表权限的图标,权限的名称和必定伴有的权限描述会全部被显示给用户。

所有的情况中,设置在一个包含元素里的图标和标签会成为该容器所有子元素的缺省设置。这样,在 元素中设置的图标和标签就是该应用程序每个组件的缺省图标和标签。类似的,为一个组件设置的图标和标签-比如,一个 元素-是这个组件 元素的缺省值。如果一个 元素设置了一个图标,但活动及其意图过滤器没有,那么程序标签被当作活动和意图过滤器的标签。

当呈现给用户的组件实现一个意图过滤器公告的函数时,为这个过滤器设置的图标和标签将被用来代表这个组件。比如,一个设置了"android.intent.action.MAIN"和"android.intent.category.LAUNCHER"的过滤器公告了一个活动来初始化应用程序-也就是,会被显示在应用程序启动器中。因此设置在过滤器中的图标和标签也就是显示在启动器里的那些图标和标签。

许可Permissions

一个许可(permission)是代码对设备上数据的访问限制。这个限制被引入来保护可能会被误用而曲解或破坏用户体验的关键数据和代码。

每个许可被一个唯一的标签所标识。这个标签常常指出了受限的动作。例如,下面是一些Android定义的许可:

android.permission.CALL_EMERGENCY_NUMBERS
android.permission.READ_OWNER_DATA
android.permission.SET_WALLPAPER
android.permission.DEVICE_POWER

一个功能(feature)最多只能被一个权限许可保护。

如果一个应用程序需要访问一个需要特定权限的功能,它必须在manifest文件中使用 元素来声明这一点。这样,当应用程序安装到设备上时,安装器可以通过检查签署应用程序认证的机构来决定是否授予请求的权限,在某些情况下,会询问用户。如果权限已被授予,那应用程序就能够访问受保护的功能特性。如果没有,访问将失败,但不会给用户任何通知。

应用程序还可以通过权限许可来保护它自己的组件(活动,服务,广播接收器,和内容提供器)。它可以利用Android已经定义(列在android.Manifest.permission里)或其他应用程序已声明的权限许可。或者定义自己的许可。一个新的许可通过 元素声明。比如,一个活动可以用下面的方式保护:

   

    . . .

   

       

                  android:permission="com.example.project.DEBIT_ACCT"

                  . . . >

            . . .

       

   

    . . .

   

    . . .

注意,在这个例子里,这个DEBIT_ACCT 许可并非仅仅在 元素中声明,它同样声明在 元素里。为了应用程序的其他组件可以启动这个受保护的活动,必须请求它的使用(use),即使这个保护是应用程序自己引入的。

如果,就在这个例子里,这个permission 属性被设置为在其他地方声明的权限许可(例如android.permission.CALL_EMERGENCY_NUMBERS,它将不需要再次声明它,但是,它仍然需要通过 来请求它的使用。

这个 元素为一组想在代码中定义的权限许可声明了一个命名空间。而 元素为一系列许可定义了一个标签(用 元素定义在manifest中的以及其他地方声明的)。它仅仅影响这些权限许可在显示给用户时如何分组。 元素并不指明哪个权限属于这个分组;它只是给这个组命名。一个权限许可通过给 元素的permissionGroup属性赋予这个组名来放置到这个权限组中。

库Libraries

每个应用程序都链接到缺省的Android库,这个库包含了基础应用程序开发包(实现了基础类如活动,服务,意图,视图,按钮,应用程序,内容提供器,等等)

然而,一些包处于它们自己的库中。如果你的应用程序使用了其他开发包中的代码,它必须显式的请求链接到它们。这个manifest必须包含一个单独的 元素来命名每一个库。

 

本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/iefreer/archive/2009/09/10/4540172.aspx

本文转载自:http://www.javagg.com/diary/104369666

JavaGG

JavaGG

粉丝 404
博文 185
码字总数 35279
作品 0
广州
私信 提问
Android开发指南-用户界面-风格和主题

应用风格和主题Applying Styles and Themes 当设计应用程序时,你可以用风格和主题来统一格式化各种屏幕和UI元素。 l 风格是一个包含一种或者多种格式化属性的集合,你可以将其作为一个单位用...

JavaGG
2010/03/24
77
0
Android开发者指南(10) —— Android API Levels

Android开发者指南(10) —— Android API Levels 前言   本章内容为开发者指南(Dev Guide)/Appendix/Android API Levels,版本为Android3.0 r1,翻译来自:"jackeylu",欢迎大家访问他的博...

vane_
2012/09/19
290
0
用 Sencha Touch 构建移动 web 应用程序

Sencha Touch 是一个使用 HTML5、CSS3 和 JavaScript 语言构建的移动 web 应用程序框架,在本文中,学习如何应用您当前的 web 开发技能进行移动 web 开发。下载和建立 Sencha Touch,通过一个...

IBMdW
2012/03/19
1K
0
android开发基础(Android Application Fundamentals)

应用基础 在Java编程语言编写的Android应用程序的Android的SDK工具编译代码以及与任何数据和到一个Android的包,一个归档文件档案资源的后缀,所有的在一个单一的代码文件被认为是一个应用程...

_kxng
2011/08/03
847
3
浅入浅出 Android 安全:第六章 Android 安全的其它话题

第六章 Android 安全的其它话题 来源:Yury Zhauniarovich | Publications 译者:飞龙 协议:CC BY-NC-SA 4.0 在本章中,我们会涉及到与 Android 安全相关的其他主题,这些主题不直接属于已经...

apachecn_飞龙
2016/12/02
0
0

没有更多内容

加载失败,请刷新页面

加载更多

Podman 使用指南

> 原文链接:Podman 使用指南 Podman 原来是 CRI-O 项目的一部分,后来被分离成一个单独的项目叫 libpod。Podman 的使用体验和 Docker 类似,不同的是 Podman 没有 daemon。以前使用 Docker...

米开朗基杨
今天
6
0
拯救 项目经理个人时间的5个技巧

优秀的项目经理都有一个共同点,那就是良好的时间管理能力。专业的项目经理会确保他们的时间投入富有成效,尽可能避免时间浪费。 时间管理叫做GTD,即Getting Things Done——“把事情做完”...

Airship
今天
7
0
LNMP环境介绍,Mariadb安装,服务管理,mariadb安装3

LNMP环境介绍 Nginx 处理的请求有两种,分为 静态与动态 图片,js,css,视频,音频,flash 等都是静态请求,这些数据都不是保存在数据库里面的 动态请求一般来说,需要的数据是在数据库里面...

doomcat
今天
2
0
前端技术之:Prisma Demo服务部署过程记录

安装前提条件: 1、已经安装了docker运行环境 2、以下命令执行记录发生在MackBook环境 3、已经安装了PostgreSQL(我使用的是11版本) 4、Node开发运行环境可以正常工作 首先需要通过Node包管...

popgis
今天
7
0
数组和链表

数组 链表 技巧一:掌握链表,想轻松写出正确的链表代码,需要理解指针获引用的含义: 对指针的理解,记住下面的这句话就可以了: 将某个变量赋值给指针,实际上就是将这个变量的地址赋值给指...

code-ortaerc
今天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部