public class DropBoxManager
extends Object
java.lang.Object | |
↳ | android.os.DropBoxManager |
排入大量数据(来自各种来源 - 应用程序崩溃,内核日志记录等)。 队列的大小是有限的,如果入队数据超过最大大小,将丢弃旧数据。 你可以把它看作一个持久的,系统范围的,基于blob的“logcat”。
您可以通过调用 getSystemService(Class
和 DROPBOX_SERVICE
来获得此类的实例。
DropBoxManager条目不会直接发送到任何地方,但其他系统服务和调试工具可能会扫描并上传条目以进行处理。
Nested classes |
|
---|---|
class |
DropBoxManager.Entry 从下拉框中检索单个条目。 |
Constants |
|
---|---|
String |
ACTION_DROPBOX_ENTRY_ADDED 广播动作:在收件箱中添加新条目时广播。 |
String |
EXTRA_TAG 额外 |
String |
EXTRA_TIME Extra for |
int |
IS_EMPTY 标记值:删除条目的内容以节省空间。 |
int |
IS_GZIPPED 标记值:内容可以用 |
int |
IS_TEXT 标志值:内容是人类可读的UTF-8文本(可以与IS_GZIPPED组合)。 |
Protected constructors |
|
---|---|
DropBoxManager() 创建一个虚拟实例进行测试。 |
Public methods |
|
---|---|
void |
addData(String tag, byte[] data, int flags) 存储二进制数据,与 |
void |
addFile(String tag, File file, int flags) 存储文件的内容,与 |
void |
addText(String tag, String data) 存储人类可读的文本。 |
DropBoxManager.Entry |
getNextEntry(String tag, long msec) 在指定时间 后从下拉框中获取下一个条目。 |
boolean |
isTagEnabled(String tag) 检查任何黑名单(在系统设置中设置)以查看是否允许某个标签。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
String ACTION_DROPBOX_ENTRY_ADDED
广播动作:在收件箱中添加新条目时广播。 您必须持有READ_LOGS
权限才能接收此广播。
这是一个受保护的意图,只能由系统发送。
常量值:“android.intent.action.DROPBOX_ENTRY_ADDED”
String EXTRA_TAG
Extra for ACTION_DROPBOX_ENTRY_ADDED
:包含dropbox标记的字符串。
常量值:“标签”
String EXTRA_TIME
ACTION_DROPBOX_ENTRY_ADDED
:包含创建条目时的长整数值(以1970年1月1日00:00:00以来的毫秒数)。
常数值:“时间”
DropBoxManager ()
创建一个虚拟实例进行测试。 除非用合适的模拟实现覆盖,否则所有方法都将失败。 要获取功能实例,请使用getSystemService(Class
。
void addData (String tag, byte[] data, int flags)
存储二进制数据,与 addText(String, String)
一样可能会被忽略或丢弃。
Parameters | |
---|---|
tag |
String : describing the type of entry being stored |
data |
byte : value to store |
flags |
int : describing the data |
void addFile (String tag, File file, int flags)
存储文件的内容,与 addText(String, String)
一样可以忽略或丢弃该文件。
Parameters | |
---|---|
tag |
String : describing the type of entry being stored |
file |
File : to read from |
flags |
int : describing the data |
Throws | |
---|---|
IOException |
if the file can't be opened |
void addText (String tag, String data)
存储人类可读的文本。 如果空间有限,数据可能会最终(甚至是立即)丢弃,或者如果标签被阻止,数据可能会被完全忽略(请参阅isTagEnabled(String)
)。
Parameters | |
---|---|
tag |
String : describing the type of entry being stored |
data |
String : value to store |
DropBoxManager.Entry getNextEntry (String tag, long msec)
在指定时间后从下拉框中获取下一个条目。 需要android.permission.READ_LOGS
。 您必须始终致电close()
获取返回值!
Parameters | |
---|---|
tag |
String : of entry to look for, null for all tags |
msec |
long : time of the last entry seen |
Returns | |
---|---|
DropBoxManager.Entry |
the next entry, or null if there are no more entries |
boolean isTagEnabled (String tag)
检查任何黑名单(在系统设置中设置)以查看是否允许某个标签。 具有禁用标签的条目将被立即删除,因此您可以保存实际构建和发送数据的工作。
Parameters | |
---|---|
tag |
String : that would be used in addText(String, String) or addFile(String, File, int) |
Returns | |
---|---|
boolean |
whether events with that tag would be accepted |