android使用高版本属性,Android SDK 版本属性

Android 应用可在其 build.gradle 文件中设置多项 SDK 版本属性。Android build.gradle 文档说明了这些属性对于应用的一般含义。本文档介绍了这些属性如何影响 NDK 构建。

compileSdkVersion

此属性对 NDK 构建没有任何影响。NDK 的 API 可用性受 minSdkVersion 约束。这是因为 C++ 符号应在库加载时被即时解析，而不是延迟到首次调用时解析(像在 Java 中一样)。如果在 minSdkVersion 中使用任何不可用的符号，将会导致库在不具备新 API 的操作系统版本上加载失败，无论这些 API 是否被调用都是如此。

targetSdkVersion

与 Java 类似，应用的 targetSdkVersion 可以改变原生代码的运行时行为。系统中的行为变更仅会在可行情况下影响满足以下条件的应用：targetSdkVersion 高于或等于引入相应变更的操作系统版本。

虽然应用开发者通常知道其应用的 targetSdkVersion，但对于无法知晓其用户会选择哪个 targetSdkVersion 的库开发者来说，此 API 非常有用。

在运行时，您可以通过调用 android_get_application_target_sdk_version() 来获取应用所使用的 targetSdkVersion。此 API 可在 API 级别 24 及更高级别中找到。此函数包含以下签名：

/**

* Returns the `targetSdkVersion` of the caller, or `__ANDROID_API_FUTURE__` if

* there is no known target SDK version (for code not running in the context of

* an app).

*

* The returned values correspond to the named constants in ``,

* and is equivalent to the AndroidManifest.xml `targetSdkVersion`.

*

* See also android_get_device_api_level().

*

* Available since API level 24.

*/

int android_get_application_target_sdk_version() __INTRODUCED_IN(24);

其他行为变更可能取决于设备 API 级别。您可以通过调用 android_get_device_api_level() 来获取运行应用的设备的 API 级别。此函数包含以下签名：

/**

* Returns the API level of the device we're actually running on, or -1 on failure.

* The returned values correspond to the named constants in ``,

* and is equivalent to the Java `Build.VERSION.SDK_INT` API.

*

* See also android_get_application_target_sdk_version().

*/

int android_get_device_api_level();

maxSdkVersion

此属性对 NDK 构建没有任何影响。

minSdkVersion

build.gradle 文件中设置的 minSdkVersion 决定了在构建时可用的 API(请参阅 compileSdkVersion，了解这不同于 Java 构建的原因)，还决定了与您的代码兼容的最低操作系统版本。

您的应用的 minSdkVersion 可通过 __ANDROID_API__ 宏提供给预处理器。此宏由 Clang 自动定义，因此无需添加头文件即可使用它。对于 NDK 构建，系统始终会定义此宏。

NDK 使用 minSdkVersion 来确定在编译代码时可以使用哪些功能。例如，此属性决定 libc 中使用的 FORTIFY 功能，如果您的二进制文件与旧版 Android 系统不兼容，此属性还可能会为这些二进制文件启用性能或大小改进(例如 GNU 哈希或 RELR)。即使您不使用任何新的 API，此属性仍然决定您的代码支持的最低操作系统版本。尽管如此，库仍有可能会在较低版本的操作系统上加载。请勿依赖此属性，因为它可能因 NDK 版本、操作系统版本或各个设备而异。