NDK C++支持 libc++_static和 GNU libstdc++ 和 STLport

最新推荐文章于 2024-07-26 18:41:21 发布

haima1998

最新推荐文章于 2024-07-26 18:41:21 发布

阅读量3.3k

点赞数

分类专栏：编程知识

原文链接：https://developer.android.com/ndk/guides/cpp-support?hl=zh-cn

版权

编程知识专栏收录该内容

42 篇文章 1 订阅

订阅专栏

转自：https://developer.android.com/ndk/guides/cpp-support?hl=zh-cn

C++ 库支持

NDK 支持多种 C++ 运行时库。本文档介绍了这些库的相关信息、所涉及的折衷做法以及库的使用方法。

C++ 运行时库

表 1. NDK C++ 运行时和功能。

名称	功能
libc++	现代 C++ 支持。
system	`new` 和 `delete`。（在 r18 中已弃用。）
none	无头文件，有限 C++。

libc++ 同时提供静态库和共享库。

警告：使用静态运行时可能会导致意外行为。如需了解详情，请参阅静态运行时部分。

libc++

LLVM 的 libc++ 是 C++ 标准库，自 Lollipop 以来 Android 操作系统便一直使用该库，并且从 NDK r18 开始成为 NDK 中唯一可用的 STL。

注意：如需全面详细了解任何给定版本对 C++ 库的支持级别是否达到了预期，请参阅 C++14 Status、C++17 Status 和 C++2a Status 页面。请注意，编译器的 C++ 语言支持级别互不相关；请改为参阅 Clang 中的 C++ 支持。

libc++ 的共享库为 libc++_shared.so，静态库为 libc++_static.a。

注意：libc++ 不是系统库。如果使用 libc++_shared.so，必须将其包含在 APK 中。如果使用 Gradle 构建应用，此步骤会自动完成。

libc++ 依据伊利诺伊大学“BSD 式”许可和 MIT 许可双重授权。如需了解详情，请参阅许可文件。

system

system 运行时指的是 /system/lib/libstdc++.so。请勿将该库与 GNU 的全功能 libstdc++ 混淆。在 Android 系统中，libstdc++ 只是 new 和 delete。对于全功能 C++ 标准库，请使用 libc++。

注意：系统 STL 将在未来 NDK 版本中移除。请参阅问题 744。

系统 C++ 运行时支持基础 C++ 运行时 ABI。从根本上来说，此库就是提供 new 和 delete。不同于 NDK 中提供的其他选项，此库不支持异常处理和 RTTI。

除 <cstdio> 等用于 C 库头文件的 C++ 封装容器之外，并无标准库支持。如需 STL，您应使用本页面提供的其他选项。

none

另外，您还可选择不使用 STL。在这种情况下，没有关联或授权要求。不提供 C++ 标准头文件。

选择 C++ 运行时

CMake

CMake 的默认值为 c++_static。

您可以使用模块级 build.gradle 文件中的 ANDROID_STL 变量指定 c++_shared、c++static、none 或 system。如需了解详情，请参阅有关 CMake 中 ANDROID_STL 的文档。

ndk-build

ndk-build 的默认值为 none。

您可以使用 Application.mk 文件中的 APP_STL 变量指定 c++_shared、c++static、none 或 system。例如：

APP_STL := c++_shared

ndk-build 仅允许为您的应用选择一个运行时，并且只能在 Application.mk 中进行选择。

直接使用 clang

如果您在自己的构建系统中直接使用 clang，则 clang++ 将默认使用 c++_shared。如需使用静态变体，请将 -static-libstdc++ 添加至链接器标志中。请注意，尽管由于历史原因该选项使用的名称是“libstdc++”，但也适用于 libc++。

重要注意事项

静态运行时

如果应用的所有原生代码均位于一个共享库中，我们建议使用静态运行时。这样可让链接器最大限度内联和精简未使用的代码，使应用达到最优化状态且文件最小巧。这样做还能避免旧版 Android 中的 PackageManager 和动态链接器出现错误，此类错误可导致处理多个共享库变得困难，且容易出错。

然而，在 C++ 中，在单一程序中定义多个相同函数或对象的副本并不安全。这是 C++ 标准中提出的单一定义规则的一个方面。

如果使用静态运行时（以及一般静态库），很容易在不经意间破坏这条规则。例如，以下应用就破坏了这一规则：

# Application.mk
APP_STL := c++_static

# Android.mk

include $(CLEAR_VARS)
LOCAL_MODULE := foo
LOCAL_SRC_FILES := foo.cpp
include $(BUILD_SHARED_LIBRARY)

include $(CLEAR_VARS)
LOCAL_MODULE := bar
LOCAL_SRC_FILES := bar.cpp
LOCAL_SHARED_LIBRARIES := foo
include $(BUILD_SHARED_LIBRARY)

在这种情况下，包括全局数据和静态构造函数在内的 STL 将同时存在于两个库中。此应用的运行时行为未定义，因此在实际运行过程中，应用会经常崩溃。其他可能存在的问题包括：

内存在一个库中分配，而在另一个库中释放，从而导致内存泄漏或堆损坏。
libfoo.so 中引发的异常在 libbar.so 中未被捕获，从而导致应用崩溃。
std::cout 的缓冲未正常运行。

将静态运行时链接至多个库，除了会导致行为问题，还会在每个共享库中复制代码，从而增加应用的大小。

一般情况下，只有在应用中有且只有一个共享库时，才能使用 C++ 运行时的静态变体。

注意：此规则既适用于您的代码，也适用于您的第三方依赖项。

共享运行时

注意：通过 Java AAR 分发的 JNI 库不得使用共享运行时，以免与其他库和应用发生冲突。以下警告仍然适用。如需了解详情，请参阅中间件供应商文档。

如果应用包括多个共享库，应使用 libc++_shared.so。

在 Android 系统中，NDK 使用的 libc++ 与操作系统的 libc++ 是不同的。如此一来，即使应用以旧版 Android 为目标平台，NDK 用户也能获得最新的 libc++ 功能和问题修复。需要权衡的是，如果使用 libc++_shared.so，就必须将其包含在您的 APK 中。如果使用 Gradle 构建应用，此步骤会自动完成。

旧版 Android 的 PackageManager 和动态链接器存在错误，导致原生库的安装、更新和加载不可靠。具体而言，如果应用以早于 Android 4.3（Android API 级别 18）的 Android 版本为目标，并且您使用 libc++_shared.so，必须先加载共享库，再加载依赖于共享库的其他库。

ReLinker 项目能够解决所有已知的原生库加载问题，而且相较于自行编写解决方法，它通常是更好的选择。