Struct UsesNativeLibrary

pub struct UsesNativeLibrary {
    pub name: String,
    pub required: Option<VarOrBool>,
}

Specifies a vendor-provided shared native library that the application must be linked against.

This element tells the system to make the native library accessible for the package.

NDK libraries are by default accessible and therefore don’t require the <uses-native-library> tag.

Non-NDK native shared libraries that are provided by silicon vendors or device manufacturers are not accessible by default if the app is targeting Android 12 or higher. The libraries are accessible only when they are explicitly requested using the <uses-native-library> tag.

If the app is targeting Android 11 or lower, the <uses-native-library> tag is not required. n that case, any native shared library is accessible regardless of whether it is an NDK library.

This element also affects the installation of the application on a particular device:

Installation

If this element is present and its android:required attribute is set to true, the PackageManager framework won’t let the user install the application unless the library is present on the user’s device.

The android:required attribute is described in detail in the following section.

XML Syntax

 <uses-native-library
    android:name="string"
    android:required=["true" | "false"] />

Contained in

• <application>

Introduced in

API Level S

Fields

name: String

The name of the library file.

required: Option<VarOrBool>

Boolean value that indicates whether the application requires the library specified by android:name:

• "true": The application does not function without this library. The system will not allow the application on a device that does not have the library.

• "false": The application can use the library if present, but is designed to function without it if necessary. The system will allow the application to be installed, even if the library is not present. If you use "false", you are responsible for gracefully handling the absence of the library.

The default is "true".

Trait Implementations

impl Clone for UsesNativeLibrary

fn clone(&self) -> UsesNativeLibrary

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UsesNativeLibrary

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

Formats the value using the given formatter.

impl Default for UsesNativeLibrary

fn default() -> UsesNativeLibrary

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UsesNativeLibrary

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for UsesNativeLibrary

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for UsesNativeLibrary

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 UsesNativeLibrary

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

impl YaSerialize for UsesNativeLibrary

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 UsesNativeLibrary

impl StructuralPartialEq for UsesNativeLibrary