Enum android_manifest::PersistableMode

pub enum PersistableMode {
    PersistRootOnly,
    PersistAcrossReboots,
    PersistNever,
}

Defines how an instance of an activity is preserved within a containing task across device restarts.

Variants

PersistRootOnly

Default value. When the system restarts, the activity task is preserved, but only the root activity’s launching intent is used.

When your app’s launching intent loads your app’s root activity, the activity doesn’t receive a PersistableBundle object. Therefore, don’t use onSaveInstanceState() to preserve the state of your app’s root activity across a device restart.

Note

This attribute value affects your app’s behavior only if it’s set on your app’s root activity.

PersistAcrossReboots

This activity’s state is preserved, along with the state of each activity higher up the back stack that has its own persistableMode attribute set to persistAcrossReboots. If an activity doesn’t have a persistableMode attribute that is set to persistAcrossReboots, or if it’s launched using the Intent.FLAG_ACTIVITY_NEW_DOCUMENT flag, then that activity, along with all activities higher up the back stack, aren’t preserved.

When an intent loads an activity whose persistableMode attribute is set to persistAcrossReboots in your app, the activity receives a PersistableBundle object in its onCreate() method. Therefore, you can use onSaveInstanceState() to preserve the state of an activity across a device restart as long as its persistableMode attribute is set to persistAcrossReboots.

Note

This attribute value affects your app’s behavior even if it’s set on an activity other than your app’s root activity

PersistNever

The activity’s state isn’t preserved.

Note

This attribute value affects your app’s behavior only if it’s set on your app’s root activity.

Trait Implementations

impl Clone for PersistableMode

fn clone(&self) -> PersistableMode

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PersistableMode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PersistableMode

fn default() -> PersistableMode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PersistableMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq<PersistableMode> for PersistableMode

fn eq(&self, other: &PersistableMode) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PersistableMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.

impl YaDeserialize for PersistableMode

fn deserialize<R: Read>(reader: &mut Deserializer<R>) -> Result<Self, String>

impl YaSerialize for PersistableMode

fn serialize<W: Write>(&self, writer: &mut Serializer<W>) -> Result<(), String>

fn serialize_attributes( &self, source_attributes: Vec<OwnedAttribute>, source_namespace: Namespace ) -> Result<(Vec<OwnedAttribute>, Namespace), String>

impl Eq for PersistableMode

impl StructuralEq for PersistableMode

impl StructuralPartialEq for PersistableMode