1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

use serde::{Deserialize, Serialize};

/// Adds an action to an intent filter.
///
/// An [`<intent-filter>`] element must contain one or more `<action>` elements. If there
/// are no `<action>` elements in an intent filter, the filter doesn't accept any
/// [`Intent`] objects. See [`Intents and Intent Filters`] for details on intent filters
/// and the role of action specifications within a filter.
///
/// ## XML Syntax
/// ```xml
/// <action android:name="string" />
/// ```
///
/// ## Contained in
/// * [`<intent-filter>`]
///
/// ## Introduced in
/// API Level 1
///
/// [`<intent-filter>`]: crate::IntentFilter
/// [`Intent`]: https://developer.android.com/reference/android/content/Intent
/// [`Intents and Intent Filters`]: https://developer.android.com/guide/components/intents-filters
#[derive(Debug, Deserialize, Serialize, YaSerialize, YaDeserialize, PartialEq, Default, Clone)]
pub struct Action {
    /// The name of the action. Some standard actions are defined in the [`Intent`] class
    /// as `ACTION_string` constants. To assign one of these actions to this
    /// attribute, prepend `"android.intent.action."` o the `string` that follows
    /// `ACTION_`. For example, for `ACTION_MAIN`, use "`android.intent.action.MAIN`"
    /// and for `ACTION_WEB_SEARCH`, use "`android.intent.action.WEB_SEARCH`".
    ///
    /// For actions you define, it's best to use your app's package name as a prefix to
    /// ensure uniqueness.
    ///
    /// ## XML Examples
    /// A `TRANSMOGRIFY` action might be specified as follows:
    /// ```xml
    /// <action android:name="com.example.project.TRANSMOGRIFY" />
    /// ```
    ///
    /// [`Intent`]: https://developer.android.com/reference/android/content/Intent
    #[yaserde(attribute, prefix = "android")]
    pub name: Option<String>,
}