1# 标准C++库 2 3OpenHarmony使用llvm开源项目的C++标准库[libc++](https://libcxx.llvm.org/)作为C++运行时库。 4 5## libc++版本 6 7从OpenHarmony 4.0开始到OpenHarmony 5.0，libc++升级到clang/llvm 15.0.4版本 8 9从OpenHarmony 3.2开始，libc++升级到clang/llvm 12.0.1版本 10 11从OpenHarmony 3.0开始，libc++使用clang/llvm 10.0.1版本 12 13## C++语言支持能力 14 15C++11、C++14标准已完全支持，C++17和C++20标准正在完善，开发者可以通过[如何修改代码工程所支持的C++语言版本](https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs-V5/faqs-ndk-9-V5)来设置自己开发所需C++标准版本。具体语言特性支持标准可以参考[https://libcxx.llvm.org/](https://libcxx.llvm.org/)网站对应的Release Notes。 16 17 18## 如何在CMake中选择C++ 19 20在NDK的{ndk_root}/build/cmake/ohos.toolchain.cmake文件中，定义了OHOS_STL变量，可以通过设置"c++_shared"或者"c++_static"来控制应用工程中原生库链接C++运行库的方式。 21* c++_shared，原生库动态链接libc++_shared.so 22* c++_static，原生库静态链接libc++_static.a 23 24## C++运行时兼容性 25 26在OpenHarmony系统中，系统库与应用原生库都在使用C++标准库，两部分升级节奏不一样，依赖C++运行时版本也可能不一样。系统库依赖的C++标准库随镜像版本升级，而应用原生库依赖的C++标准库随编译使用的SDK版本升级，两部分依赖的C++基础库会跨多个大版本，产生ABI兼容性问题。为了解决此问题，OpenHarmony上把两部分依赖的C++标准库进行了区分。 27 28 * 系统库：使用libc++.so， 随系统镜像发布。 29 * 应用Native库：使用libc++_shared.so，随应用发布。 30 31 两个库使用的C++命名空间不一样，libc++_shared.so使用__n1作为C++符号的命名空间，libc++.so使用__h作为C++符号的命名空间。 32 33 注意：两边使用的C++标准库不能进行混用，Native API接口当前只能是C接口，可以通过这个接口隔离两边的C++运行环境。 34 35## 注意事项 36 371. C++运行时库工具链进行大版本升级的时候，不保证一定二进制兼容；一个应用包如果有多个动态库，这些动态库**必须用同一个大版本的clang工具链进行编译**，依赖相同版本的libc++_shared库，否则有可能产生不可预知的错误。 38 392. 在一个应用工程里面，如果只有一个共享库，建议使用静态链接c++_static，这样能够让链接器精简使用的C++运行时代码，降低包大小。如果有多个库，或者依赖带动态库的har包，或者ohpm上带库的二进制中间件，建议采用动态链接C++库；采用静态链接会导致程序中定义多个函数或对象的副本，会破坏C++的单一定义规则（One Definition Rule），出现不可预知问题。