BroadcastReceiver 类的sdk文档!
来源:互联网 发布:软件外包公司排名 编辑:程序博客网 时间:2024/05/01 05:58
BroadcastReceiver
extends ObjectClass Overview
Base class for code that will receive intents sent by sendBroadcast(). You can either dynamically register an instance of this class with Context.registerReceiver()
or statically publish an implementation through the <receiver>
tag in your AndroidManifest.xml
. Note: If registering a receiver in your Activity.onResume()
implementation, you should unregister it in Activity.onPause()
. (You won't receive intents when paused, and this will cut down on unnecessary system overhead). Do not unregister in Activity.onSaveInstanceState()
, because this won't be called if the user moves back in the history stack.
There are two major classes of broadcasts that can be received:
- Normal broadcasts (sent with
Context.sendBroadcast
) are completely asynchronous. All receivers of the broadcast are run in an undefined order, often at the same time. This is more efficient, but means that receivers cannot use the result or abort APIs included here. - Ordered broadcasts (sent with
Context.sendOrderedBroadcast
) are delivered to one receiver at a time. As each receiver executes in turn, it can propagate a result to the next receiver, or it can completely abort the broadcast so that it won't be passed to other receivers. The order receivers run in can be controlled with theandroid:priority
attribute of the matching intent-filter; receivers with the same priority will be run in an arbitrary order.
Even in the case of normal broadcasts, the system may in some situations revert to delivering the broadcast one receiver at a time. In particular, for receivers that may require the creation of a process, only one will be run at a time to avoid overloading the system with new processes. In this situation, however, the non-ordered semantics hold: these receivers still cannot return results or abort their broadcast.
Note that, although the Intent class is used for sending and receiving these broadcasts, the Intent broadcast mechanism here is completely separate from Intents that are used to start Activities with Context.startActivity()
. There is no way for a BroadcastReceiver to see or capture Intents used with startActivity(); likewise, when you broadcast an Intent, you will never find or start an Activity. These two operations are semantically very different: starting an Activity with an Intent is a foreground operation that modifies what the user is currently interacting with; broadcasting an Intent is a background operation that the user is not normally aware of.
The BroadcastReceiver class (when launched as a component through a manifest's <receiver>
tag) is an important part of an application's overall lifecycle.
Topics covered here:
- Receiver Lifecycle
- Permissions
- Process Lifecycle
Receiver Lifecycle
A BroadcastReceiver object is only valid for the duration of the call to onReceive(Context, Intent)
. Once your code returns from this function, the system considers the object to be finished and no longer active.
This has important repercussions to what you can do in an onReceive(Context, Intent)
implementation: anything that requires asynchronous operation is not available, because you will need to return from the function to handle the asynchronous operation, but at that point the BroadcastReceiver is no longer active and thus the system is free to kill its process before the asynchronous operation completes.
In particular, you may not show a dialog or bind to a service from within a BroadcastReceiver. For the former, you should instead use the NotificationManager
API. For the latter, you can use Context.startService()
to send a command to the service.
Permissions
Access permissions can be enforced by either the sender or receiver of an Intent.
To enforce a permission when sending, you supply a non-null permission argument to sendBroadcast(Intent, String)
or sendOrderedBroadcast(Intent, String, BroadcastReceiver, android.os.Handler, int, String, Bundle)
. Only receivers who have been granted this permission (by requesting it with the <uses-permission>
tag in their AndroidManifest.xml
) will be able to receive the broadcast.
To enforce a permission when receiving, you supply a non-null permission when registering your receiver -- either when calling registerReceiver(BroadcastReceiver, IntentFilter, String, android.os.Handler)
or in the static <receiver>
tag in your AndroidManifest.xml
. Only broadcasters who have been granted this permission (by requesting it with the <uses-permission>
tag in their AndroidManifest.xml
) will be able to send an Intent to the receiver.
See the Security and Permissions document for more information on permissions and security in general.
Process Lifecycle
A process that is currently executing a BroadcastReceiver (that is, currently running the code in its onReceive(Context, Intent)
method) is considered to be a foreground process and will be kept running by the system except under cases of extreme memory pressure.
Once you return from onReceive(), the BroadcastReceiver is no longer active, and its hosting process is only as important as any other application components that are running in it. This is especially important because if that process was only hosting the BroadcastReceiver (a common case for applications that the user has never or not recently interacted with), then upon returning from onReceive() the system will consider its process to be empty and aggressively kill it so that resources are available for other more important processes.
This means that for longer-running operations you will often use a Service
in conjunction with a BroadcastReceiver to keep the containing process active for the entire time of your operation.
Summary
Context.sendOrderedBroadcast
.setDebugUnregister(boolean)
.Context.sendOrderedBroadcast
.Context.sendOrderedBroadcast
.Context.sendOrderedBroadcast
.Context.sendOrderedBroadcast
.- BroadcastReceiver 类的sdk文档!
- 关于BroadcastReceiver从SDK中学到的
- SDK文档
- .Net FrameWork SDK文档的例子演示
- 制作CHM版本的android sdk文档
- 学习SDK文档的步骤大概是这样
- Xcode离线浏览iPhone SDK的文档
- iOS解析XML文档的SDK
- 关于开源库或者SDK的文档问题
- BroadcastReceiver类
- BroadcastReceiver类中调用activity的函数
- BroadcastReceiver类中调用activity的函数
- Android SDK 中文文档计划 (0) 我的声明 - [Android SDK 中文文档]
- 在使用SDK进行编译时,在文档类中设置背景颜色的元数据格式
- [Android--Tool]Android的SDK文档的下载
- android 官方SDK文档
- Activity SDK文档
- Activity SDK文档
- 正整数js正则表达式
- 设置div里的内容在最底部
- 软件版本的识别
- 关于输入框的光标
- 崔永元:做一个合格的公民
- BroadcastReceiver 类的sdk文档!
- 把图象文件转换成XML格式文件
- 做职业监理师(七)——施工组织方案的审核
- 保密安全与信息销毁
- 你为谁工作-付诸行动,不要害怕失败
- Myeclipse中关闭updating indexes
- 如何发布vc调用Python的独立运行的程序
- asp.net中用户注册、角色分配,以及已登录用户的退出
- BOM展开函数 其中的参数设置还是有待研究