android-manifest 0.3.0

Android Manifest serializer and deserializer for Rust
Documentation 
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use serde::{Deserialize, Serialize};

/// Declares a single GL texture compression format that the app supports.
///
/// An application "supports" a GL texture compression format if it is capable of
/// providing texture assets that are compressed in that format, once the application is
/// installed on a device. The application can provide the compressed assets locally, from
/// inside the .apk, or it can download them from a server at runtime.
///
/// Each `<supports-gl-texture>` element declares exactly one supported texture
/// compression format, specified as the value of a `android:name` attribute. If your
/// application supports multiple texture compression formats, you can declare multiple
/// `<supports-gl-texture>` elements.
///
/// ## XML Example
/// ```xml
/// <supports-gl-texture
///     android:name="GL_OES_compressed_ETC1_RGB8_texture" />
/// <supports-gl-texture
///     android:name="GL_OES_compressed_paletted_texture" />
/// ```
///
/// Declared <supports-gl-texture> elements are informational, meaning that the Android
/// system itself does not examine the elements at install time to ensure matching support
/// on the device. However, other services (such as Google Play) or applications can check
/// your application's <supports-gl-texture> declarations as part of handling or
/// interacting with your application.  For this reason, it's very important that you
/// declare all of the texture compression formats (from the list below) that your
/// application is capable of supporting.
///
/// Applications and devices typically declare their supported GL texture compression
/// formats using the same set of well-known strings, as listed below. The set of format
/// strings may grow over time, as needed, and since the values are strings, applications
/// are free to declare other formats as needed.
///
/// Assuming that the application is built with SDK Platform Tools r3 or higher, filtering
/// based on the `<supports-gl-texture>` element is activated for all API levels.
///
/// ## Note
/// Google Play filters applications according to the texture compression formats that
/// they support, to ensure that they can be installed only on devices that can handle
/// their textures properly. You can use texture compression filtering as a way of
/// targeting specific device types, based on GPU platform.
///
/// For important information about how Google Play uses `<supports-gl-texture>`
/// elements as the basis for filtering, read [`Google Play and texture compression
/// filtering`], below.
///
/// ## XML Syntax
/// ```xml
/// <supports-gl-texture
///   android:name="string" />
/// ```
///
/// ## Contained in
/// * [`<manifest>`]
///
/// [`Google Play and texture compression filtering`]: https://developer.android.com/guide/topics/manifest/supports-gl-texture-element#market-texture-filtering
/// [`<manifest>`]: crate::AndroidManifest
#[derive(
    Debug, Deserialize, Serialize, YaSerialize, YaDeserialize, PartialEq, Eq, Default, Clone,
)]
pub struct SupportsGlTexture {
    /// Specifies a single GL texture compression format supported by the application, as
    /// a descriptor string. Common descriptor values are listed in the table below.
    /// `GL_OES_compressed_ETC1_RGB8_texture` Ericsson texture compression. Specified
    /// in OpenGL ES 2.0 and available in all Android-powered devices that support
    /// OpenGL ES 2.0. `GL_OES_compressed_paletted_texture` Generic paletted texture
    /// compression. `GL_AMD_compressed_3DC_texture` ATI 3Dc texture
    /// compression. `GL_AMD_compressed_ATC_texture` ATI texture
    /// compression. Available on devices running Adreno GPU, including HTC
    /// Nexus One, Droid Incredible, EVO, and others. For widest
    /// compatibility, devices may also declare a <supports-gl-texture> element
    /// with the descriptor GL_ATI_texture_compression_atitc.
    /// `GL_EXT_texture_compression_latc` Luminance alpha texture compression.
    /// `GL_EXT_texture_compression_dxt1` S3 DXT1 texture compression. Supported
    /// on devices running Nvidia Tegra2 platform, including Motorala Xoom,
    /// Motorola Atrix, Droid Bionic, and others.
    /// `GL_EXT_texture_compression_s3tc` S3 texture compression, nonspecific to
    /// DXT variant. Supported on devices running Nvidia Tegra2 platform,
    /// including Motorala Xoom, Motorola Atrix, Droid Bionic, and others.
    /// If your application requires a specific DXT variant, declare that
    /// descriptor instead of this one. `GL_IMG_texture_compression_pvrtc`
    /// PowerVR texture compression. Available in devices running PowerVR
    /// SGX530/540 GPU, such as Motorola DROID series; Samsung Galaxy S, Nexus
    /// S, and Galaxy Tab; and others.
    #[yaserde(attribute = true, prefix = "android")]
    pub name: Option<SupportsGlTextureName>,
}

#[derive(Debug, Deserialize, Serialize, YaSerialize, YaDeserialize, PartialEq, Eq, Clone)]
#[allow(non_camel_case_types)]
#[derive(Default)]
pub enum SupportsGlTextureName {
    /// Ericsson texture compression. Specified in OpenGL ES 2.0 and available in all
    /// Android-powered devices that support OpenGL ES 2.0.
    #[default]
    GL_OES_compressed_ETC1_RGB8_texture,
    /// Generic paletted texture compression.
    GL_OES_compressed_paletted_texture,
    /// ATI 3Dc texture compression
    GL_AMD_compressed_3DC_texture,
    /// ATI texture compression. Available on devices running Adreno GPU, including HTC
    /// Nexus One, Droid Incredible, EVO, and others. For widest compatibility,
    /// devices may also declare a `<supports-gl-texture>` element with the descriptor
    /// `GL_ATI_texture_compression_atitc`.
    GL_AMD_compressed_ATC_texture,
    /// Luminance alpha texture compression.
    GL_EXT_texture_compression_latc,
    /// S3 DXT1 texture compression. Supported on devices running Nvidia Tegra2 platform,
    /// including Motorala Xoom, Motorola Atrix, Droid Bionic, and others.
    GL_EXT_texture_compression_dxt1,
    /// S3 texture compression, nonspecific to DXT variant. Supported on devices running
    /// Nvidia Tegra2 platform, including Motorala Xoom, Motorola Atrix, Droid Bionic,
    /// and others If your application requires a specific DXT variant, declare that
    /// descriptor instead of this one.
    GL_EXT_texture_compression_s3tc,
    /// PowerVR texture compression. Available in devices running PowerVR SGX530/540 GPU,
    /// such as Motorola DROID series; Samsung Galaxy S, Nexus S, and Galaxy Tab; and
    /// others.
    GL_IMG_texture_compression_pvrtc,
}