KeyedAppState


@AutoValue
abstract class KeyedAppState


A keyed app state to be sent to an EMM (enterprise mobility management), with the intention that it is displayed to the management organization.

Summary

Nested types

The builder for KeyedAppState.

Constants

const Int

This property is deprecated.

Use getMaxDataLength

const Int

This property is deprecated.

Use getMaxKeyLength

const Int

This property is deprecated.

Use getMaxMessageLength

const Int
const Int

Public functions

java-static KeyedAppState.KeyedAppStateBuilder

Create a KeyedAppStateBuilder.

abstract String?

Optionally, a machine-readable value to be read by the EMM.

abstract String

The key for the app state.

java-static Int

Get the maximum length of getData.

java-static Int

Get the maximum length of getKey.

java-static Int

Get the maximum length of getMessage.

abstract String?

Optionally, a free-form message string to explain the app state.

abstract Int

The severity of the app state.

Constants

MAX_DATA_LENGTH

Added in 1.0.0
Deprecated in 1.1.0-rc01
const val MAX_DATA_LENGTH = 1000: Int

MAX_KEY_LENGTH

Added in 1.0.0
Deprecated in 1.1.0-rc01
const val MAX_KEY_LENGTH = 100: Int

MAX_MESSAGE_LENGTH

Added in 1.0.0
Deprecated in 1.1.0-rc01
const val MAX_MESSAGE_LENGTH = 1000: Int

SEVERITY_ERROR

Added in 1.0.0
const val SEVERITY_ERROR = 2: Int

SEVERITY_INFO

Added in 1.0.0
const val SEVERITY_INFO = 1: Int

Public functions

builder

Added in 1.0.0
java-static fun builder(): KeyedAppState.KeyedAppStateBuilder

Create a KeyedAppStateBuilder.

getData

Added in 1.0.0
abstract fun getData(): String?

Optionally, a machine-readable value to be read by the EMM. For example, setting values that the admin can choose to query against in the EMM console (e.g. “notify me if the battery_warning data <10”).

getKey

Added in 1.0.0
abstract fun getKey(): String

The key for the app state. Acts as a point of reference for what the app is providing state for. For example, when providing managed configuration feedback, this key could be the managed configuration key to allow EMMs to take advantage of the connection in their UI.

getMaxDataLength

Added in 1.1.0-rc01
java-static fun getMaxDataLength(): Int

Get the maximum length of getData.

getMaxKeyLength

Added in 1.1.0-rc01
java-static fun getMaxKeyLength(): Int

Get the maximum length of getKey.

getMaxMessageLength

Added in 1.1.0-rc01
java-static fun getMaxMessageLength(): Int

Get the maximum length of getMessage.

getMessage

Added in 1.0.0
abstract fun getMessage(): String?

Optionally, a free-form message string to explain the app state. If the state was triggered by a particular value (e.g. a managed configuration value), it should be included in the message.

getSeverity

Added in 1.0.0
abstract fun getSeverity(): Int

The severity of the app state. This allows EMMs to choose to notify admins of errors. This should only be set to SEVERITY_ERROR for genuine error conditions that a management organization needs to take action to fix.

When sending an app state containing errors, it is critical that follow-up app states are sent when the errors have been resolved, using the same key and this value set to SEVERITY_INFO.