https://github.com/nmgwddj/cross-building-with-conan

Last synced: 15 days ago
JSON representation

Host: GitHub
URL: https://github.com/nmgwddj/cross-building-with-conan
Owner: nmgwddj
Created: 2022-05-05T06:15:35.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2022-05-05T07:31:02.000Z (almost 3 years ago)
Last Synced: 2025-04-10T00:55:12.153Z (15 days ago)
Language: CMake
Size: 5.86 KB
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Cross building with conan

该项目演示了如何使用 Conan 管理三方库并交叉编译各个平台下的产物（Android、iOS、macOS、Windows、Linux）

## 软件版本

- Conan 1.47.0+
- CMake 3.18+

## 编译当前平台、架构产物

在 Apple Silicon M1 设备上，默认编译出来的产物就是 arm64 架构，而在 Intel Chip 设备上，默认编译出来的产物是 x86_64 架构，我们不需要特殊配置，执行正常的 CMake 初始化和编译指令即可。Windows 和 Linux 等也均是如此。

```bash
# 生成为 Xcode 工程
cmake -Bbuild -GXcode -DCMAKE_BUILD_TYPE=Debug
# 编译工程
cmake --build build --config Debug
```

## 交叉编译

除了编译当前平台下的产物以外，我们更希望能交叉编译其他平台的产物，比如在 arm64 设备上交叉编译出 x86_64 架构的产物，在 macOS 下交叉编译出 iOS、Android 平台产物等需求。这就要求我们要给 CMake 和 Conan 传递一些关键信息，告诉他们我们即将要编译的目标平台是什么，对于 Conan 我们还需要告诉它本机的编译环境是怎样的。

通过一些参数我们可以告诉 CMake 目标平台的一些信息，如下所示：

- `CMAKE_SYSTEM_NAME` 目标系统，如 iOS、Android
- `CMAKE_OSX_ARCHITECTURES` Apple 系架构列表，如 arm64、x86_64
- `CMAKE_OSX_DEPLOYMENT_TARGET` Apple 系最低支持目标系统版本
- `CMAKE_OSX_SYSROOT` Apple 系目标系统 SDK，如 iphoneos、iphonesimulator
- `CMAKE_SYSTEM_VERSION` 指定 Android 系统的 API level，如 19、20、21 等
- `CMAKE_ANDROID_ARCH_ABI` 指定 Android 系统的目标架构，如 x86、x86_64、arm64-v8a、armeabi-v7a
- `CMAKE_ANDROID_NDK` 指定 Android 交叉编译时 NDK（工具链）的位置信息

而 Conan 支持通过传递 profile 的方式来显示的指定要编译得目标平台、架构和本机编译环境信息。我们使用 [conan.cmake](https://github.com/conan-io/cmake-conan) 简化了 conan install 流程，你只需要在 CMake 初始化时指定 `DCONAN_PROFILE_BUILD` 和 `DCONAN_PROFILE_HOST` 变量告诉 Conan 本机（BUILD）和目标（HOST）系统的 profile 信息即可。如下所示：

```bash
cmake -Bbuild -GXcode \
-DCONAN_PROFILE_BUILD=default \
-DCONAN_PROFILE_HOST=$(pwd)/.profiles/macos-x86_64 \
.... other arguments
```

CMake 脚本中会将 `CONAN_PROFILE_BUILD` 变量和 `CONAN_PROFILE_HOST` 变量的值透传给 conan install，使用本机 profile 将值设置为 `default` 即可，conan 会读取本机默认的 profile 信息。

对于目标系统，我们将保存了所有可能的目标系统和架构信息的 profile 文件存放到了工程的 [.profiles](./.profiles) 目录，需要使用时我们通过命令行指定即可。如下所示：

> 请注意，Conan 的 BUILD 和 HOST 与 CMake 的一些变量使用刚好相反，一旦概念混淆，将可能导致编译出错。

以下展示了所有可能得交叉编译场景命令，用于编译出各个平台各个架构下的产物，用以参考：

## macOS 交叉编译示例

- 系统环境：macOS

**Apple Silicon M1 arm64 交叉编译 x86_64**

```bash
# configure
cmake -Bbuild -GXcode \
-DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_OSX_ARCHITECTURES=x86_64 \
-DCONAN_PROFILE_BUILD=default \
-DCONAN_PROFILE_HOST=$(pwd)/.profiles/macos-x86_64