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
45
46

use serde::{Deserialize, Serialize};

/// Adds a category name to an intent filter.
///
/// See [`Intents and Intent Filters`] for details on intent filters and
/// the role of category specifications within a filter.
///
/// ## XML Syntax
/// ```xml
///  <category android:name="string" />
/// ```
///
/// ## Contained in:
/// * [`<intent-filter>`]
///
/// ## Introduced in
/// API Level 1
///
/// [`Intents and Intent Filters`]: https://developer.android.com/guide/components/intents-filters
/// [`<intent-filter>`]: crate::IntentFilter
#[derive(Debug, Deserialize, Serialize, YaSerialize, YaDeserialize, PartialEq, Default, Clone)]
pub struct Category {
    /// The name of the category. Standard categories are defined in the [`Intent`]
    /// class as CATEGORY_name constants. The name assigned here can be derived
    /// from those constants by prefixing `"android.intent.category."` to
    /// the name that follows CATEGORY_. For example, the string value for
    /// CATEGORY_LAUNCHER is`"android.intent.category.LAUNCHER"`.
    ///
    /// ## Note
    /// In order to receive implicit intents, you must include the
    /// [`CATEGORY_DEFAULT`] category in the intent filter. The methods
    /// [`startActivity()`] and [`startActivityForResult()`] treat all intents
    /// as if they declared the [`CATEGORY_DEFAULT`] category. If you do not
    /// declare it in your intent filter, no implicit intents will resolve to
    /// your activity.
    ///
    /// Custom categories should use the package name as a prefix, to ensure that
    /// they are unique.
    ///
    /// [`Intent`]: https://developer.android.com/reference/android/content/Intent
    /// [`CATEGORY_DEFAULT`]: https://developer.android.com/reference/android/content/Intent#CATEGORY_DEFAULT
    /// [`startActivity()`]: https://developer.android.com/reference/android/app/Activity#startActivity(android.content.Intent)
    /// [`startActivityForResult()`]: https://developer.android.com/reference/android/app/Activity#startActivityForResult(android.content.Intent,%20int)
    #[yaserde(attribute, prefix = "android")]
    pub name: Option<String>,
}