DropBoxManager

ACTION_DROPBOX_ENTRY_ADDED

static val ACTION_DROPBOX_ENTRY_ADDED: String

Broadcast Action: This is broadcast when a new entry is added in the dropbox. For apps targeting 35 and later, For apps targeting Android versions lower than 35, you must hold android.Manifest.permission#READ_LOGS. This broadcast can be rate limited for low priority entries

This is a protected intent that can only be sent by the system.

Value: "android.intent.action.DROPBOX_ENTRY_ADDED"

EXTRA_DROPPED_COUNT

static val EXTRA_DROPPED_COUNT: String

Extra for android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED: integer value containing number of broadcasts dropped due to rate limiting on this android.os.DropBoxManager#EXTRA_TAG

Value: "android.os.extra.DROPPED_COUNT"

EXTRA_TAG

static val EXTRA_TAG: String

Extra for android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED: string containing the dropbox tag.

Value: "tag"

EXTRA_TIME

static val EXTRA_TIME: String

Extra for android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED: long integer value containing time (in milliseconds since January 1, 1970 00:00:00 UTC) when the entry was created.

Value: "time"

IS_EMPTY

static val IS_EMPTY: Int

Flag value: Entry's content was deleted to save space.

Value: 1

IS_GZIPPED

static val IS_GZIPPED: Int

Flag value: Content can be decompressed with java.util.zip.GZIPOutputStream.

Value: 4

IS_TEXT

static val IS_TEXT: Int

Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED).

Value: 2

DropBoxManager

protected DropBoxManager()

Create an instance for testing. All methods will fail unless overridden with an appropriate mock implementation. To obtain a functional instance, use android.content.Context#getSystemService.

addData

open fun addData(
    tag: String, 
    data: ByteArray?, 
    flags: Int
): Unit

Stores binary data, which may be ignored or discarded as with addText.

addFile

open fun addFile(
    tag: String, 
    file: File, 
    flags: Int
): Unit

Stores the contents of a file, which may be ignored or discarded as with addText.

addText

open fun addText(
    tag: String, 
    data: String
): Unit

Stores human-readable text. The data may be discarded eventually (or even immediately) if space is limited, or ignored entirely if the tag has been blocked (see isTagEnabled).

getNextEntry

open fun getNextEntry(
    tag: String!, 
    msec: Long
): DropBoxManager.Entry?

Gets the next entry from the drop box after the specified time. You must always call android.os.DropBoxManager.Entry#close() on the return value! android.Manifest.permission#READ_LOGS permission is required for apps targeting Android versions lower than 35.
Requires android.Manifest.permission#READ_DROPBOX_DATA and android.Manifest.permission#PACKAGE_USAGE_STATS

isTagEnabled

open fun isTagEnabled(tag: String!): Boolean

Checks any denylists (set in system settings) to see whether a certain tag is allowed. Entries with disabled tags will be dropped immediately, so you can save the work of actually constructing and sending the data.