Android开发-API指南-<receiver>
<receiver>
英文原文:http://developer.android.com/guide/topics/manifest/receiver-element.html
采集(更新)日期:2014-7-2
搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmv7.html
- 语法:
-
<receiver android:enabled=["true" | "false"]
android:exported=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name="string"
android:permission="string"
android:process="string" >
. . .
</receiver> - 包含于:
<application>
- 可包含:
-
<intent-filter>
<meta-data>
- 说明:
-
声明一个广播接收器(
BroadcastReceiver
的子类),并成为应用程序的一个组件。
广播接收器使得应用程序能接收由系统或其他应用程序广播的 Intent,即使本应用程序的其他组件都没有运行也没关系。向系统声明广播接收器的方式有两种:
一种是在 Manifest 文件中以本元素声明,
另一种是用代码动态创建接收器并用
Context.registerReceiver()
方法注册。
关于动态创建广播接收器的更多信息,请参阅
BroadcastReceiver
类的说明。 - 属性:
-
android:enabled
-
广播接收器是否能被系统实例化 — “
true
”可以,“false
”不可以。
默认值是“true
”。<application>
元素拥有自己的
enabled
属性,适用于应用程序的所有组件,包括广播接收器。
为了启用广播接收器,
<application>
和<receiver>
的本属性都必须设置为“true
”。
只要其中任何一个为“false
”,则广播接收器就将被禁用,它将不能被实例化。 android:exported
-
广播接收器能否接收来自应用程序之外的消息 — “
true
”可接收,“false
”不接收。
如果设为“false
”,则本接收器只能接收本应用程序或用户 ID 相同程序的组件所发出的消息。默认值依赖于广播接收器是否包含 Intent 过滤器。
如果不含任何过滤器,则意味着只能通过指定精确类名的 Intent 对象来触发。
这表示该接收器仅供应用程序内部使用(因为其他程序通常不知道精确的类名称)。这时缺省值是“false
”。
另一方面,如果存在一个以上的过滤器,则表示广播接收器愿意接收来自系统或其他应用程序的 Intent,因此默认值是“true
”。本属性并不是限制广播接收器对外公开程度的唯一途径。
还可以利用权限来对可发送消息的外部对象进行限制(请参阅permission
属性)。 android:icon
-
代表广播接收器的图标。
本属性必须设为对 drawable 资源的引用,该资源包含了图片的定义。
如果未设置本属性值,则将使用全局性的应用程序图标来代替。(参阅
<application>
元素的
icon
属性)。广播接收器的图标 — 不管是在本属性还是在
<application>
元素中设置的 — 同时也是接收器中所有 Intent 过滤器的默认图标(参阅
<intent-filter>
元素的
icon
属性)。 android:label
-
供用户阅读的广播接收器的文本标签。
如果未设置本属性,则用全局性的应用程序文本标签代替(参阅
<application>
元素的
label
属性)。广播接收器的文本标签 — 不管是在本属性还是在
<application>
元素中设置的 — 同时也是接收器中所有 Intent 过滤器的默认文本标签(参阅
<application>
元素的
label
属性)。本文本标签应该设为对字符串资源的引用,这样就能像用户界面中的其他字符串一样对其进行本地化。
不过为了应用程序开发时的便利,也可以直接设置为字符串。 android:name
-
实现广播接收器的类的名称,即
BroadcastReceiver
的子类。
这应该是一个完全限定格式的类名(比如“com.example.project.ReportReceiver
”)。
不过作为简称,如果首字符为句点(比如“. ReportReceiver
”,则会自动在前面加上
<manifest>
元素指定的包名称。应用程序一经发布,就
不应更改本名称
(除非设置了android:exported="false"
)。没有默认值。本名称必须指定。
android:permission
-
发送方要发送消息给广播接收器所必需的权限名称。
如果本属性未被设置,则
<application>
元素的
permission
属性所设置的权限将应用于广播接收器。
如果以上两个属性都未设置,则本接收器将不受权限机制的保护。关于权限的详细信息,请参阅 Manifest 介绍一文的
Permissions
部分和另一篇文档安全和权限。 android:process
-
运行广播接收器的进程名称。
通常,应用程序的所有组件都运行在创建时的默认进程中。
该进程的名称与程序包名相同。
<application>
元素的
process
属性可以为每个组件设置不同的默认进程。
但每个组件也可以用各自的process
属性覆盖该默认值,使得程序可以跨越多个进程运行。如果本属性值的名称以冒号(':')开头,则必要时会新建一个属于该程序私有的进程,广播接收器将运行于该新进程中。
如果进程名称以小写字母开头,则广播接收器将运行于一个以此名字命名的全局进程中,并赋予相应的访问权限。
这就允许不同应用程序的多个组件共享同一个进程,以减少资源的占用。
- 引入自:
- API 级别 1
Android开发-API指南-<receiver>的更多相关文章
- Android开发-API指南-<permission>
<permission> 英文原文:http://developer.android.com/guide/topics/manifest/permission-element.html 采 ...
- Android开发-API指南-<provider>
<provider> 英文原文:http://developer.android.com/guide/topics/manifest/provider-element.html 采集(更新 ...
- Android开发-API指南-应用程序开发基础
Application Fundamentals 英文原文:http://developer.android.com/guide/components/fundamentals.html 采集(更新) ...
- Android开发-API指南-Intent和Intent过滤器
Intents and Intent Filters 英文原文:http://developer.android.com/guide/components/intents-filters.html 采 ...
- Android开发-API指南-Android简介
Introduction to Android 英文原文:http://developer.android.com/intl/zh-cn/guide/index.html 采集日期:2014-4-16 ...
- Android开发-API指南-设备兼容性
Device Compatibility 英文原文:http://developer.android.com/guide/practices/compatibility.html 采集日期:2014- ...
- Android开发-API指南-任务和回退栈
Task and Back Stack 英文原文: http://developer.android.com/guide/components/tasks-and-back-stack.html 采集 ...
- 【最后一篇API译文】Android开发-API指南- Contacts Provider
Contacts Provider 今年加入了某字幕组,加之杂事颇多,许久未添新文了,惭愧之极. 在听闻 Google 即将重返中国后,近日忽又发现官方网站正在放出 API 中文版,比如本文.当然不是 ...
- Android开发-API指南-创建 Content Provider
Creating a Content Provider 英文原文:http://developer.android.com/guide/topics/providers/content-provide ...
- Android开发-API指南-Content Provider基础
Content Provider Basics 英文原文:http://developer.android.com/guide/topics/providers/content-provider-ba ...
随机推荐
- UITableView控件Protocell的Identifier设置 注意事项
1. 注意:如果想使用Subtitle类型的单元格,需在Storyboard中将Protocell设置为subtitle类型,且Protocell的identifier必须与ViewControll ...
- STM32F103 ucLinux开发之二(内核启动汇编代码分析)
start_kernel之前的汇编代码分析 Boot中执行下面两句话之后,进入uclinux内核. theKernel = (void (*)(int, int, unsigned int))((ui ...
- 10.vue router 带参数跳转
vue router 带参数跳转 发送:this.$router.push({path:'/news',query:{id:row.id}}) 接收:var id=this.$route.query. ...
- 使用EF Core的CodeFirt 出现的问题The specified framework version '2.1' could not be parsed
今天使用了一下EF Core的Code First,进行数据库迁移的的时候报错了: The specified framework version '2.1' could not be parsed ...
- Java : java基础(5) Socket网络编程
使用 DatagramSocket 创建一个 UDP协议的Socket, 用DatagramPacket创建一个数据包,可以指定ip和端口号以及包的数据,用socket.send()可以发送这个数据包 ...
- spark exectors的启动总结
在spark启动之后,worker和master注册通信之后,在进入用户提交app中,new SparkContext之后就会在worker上分配exectors了. 首先在sparkContext中 ...
- python+selenium webdriver.firefox()方式配置浏览器设置
webdriver.firefox() 爬虫需求: (其实是输入参数可获取.zip/pdf 文件,然后点击下载) ——但是firefox浏览器有Bug,点击下载之后会有弹出窗口,需要你点击确定,这怎 ...
- pip快速git项目安装
pip install git+https://github.com/xx/xx.git
- 关于 VirtualBox6 下的 Win10 虚拟机 与 宿主机 共享文件
1. 概述 需要在 宿主机 和 虚拟机 之间交换文件 复制粘贴 貌似不太好使 2. 问题 设置了共享文件夹之后, 找不到目录 3. 环境 宿主机 OS Win10 开启了 网络发现 略 虚拟机 OS ...
- MySQL高级第五章——主从复制
一.复制的基本原理 slave会从master读取binlog(二进制日志文件)进行数据同步 步骤: 详细操作步骤请参见:http://www.cnblogs.com/luckcs/articles/ ...