第 2 章 跨平台开发环境搭建：移动端与桌面端
开发环境这事，说简单也简单，说烦人也真烦人。我刚开始做跨平台集成时，光装工具就折腾了两天。嗯，后来摸清套路就好多了。这一章咱们就把移动端（Xcode / Android Studio）和桌面端（VS / CLion / CMake）的环境一次搞定。
2.1 环境规划——别急着下载
动手之前先想清楚：你要做什么项目？你的团队用哪些平台？我个人的习惯是先列一张工具清单，把版本和用途写在纸上。否则装到一半发现缺少组件，那才叫崩溃。
| 工具 | 目标平台 | 核心用途 |
|---|---|---|
| Xcode | macOS / iOS | iOS & macOS 原生编译与调试 |
| Android Studio | Windows / macOS / Linux | Android 原生开发、模拟器管理 |
| Visual Studio | Windows | Windows 桌面应用、C++ 编译 |
| CLion + CMake | Windows / macOS / Linux | 跨平台 C/C++ 开发、构建系统 |
你看，四样工具覆盖了三大桌面和两个移动平台。你可能会问：“能不能少装几个？”当然可以，但做 SDK 集成的时候，CMake 几乎是绕不开的。我在项目里见过太多因为 CMake 版本不一致导致链接失败的情况。
2.2 移动端环境（Xcode & Android Studio）
2.2.1 Xcode：macOS 上的“老大哥”
Xcode 只能装在 Mac 上。别想着在 Windows 上搞 – 当然你可以用虚拟机，但我劝你别折磨自己。直接去 Mac App Store 搜 Xcode 下载就好。注意，它有好几个 G，我建议你在上班前挂着下载，下班回来就装好了。
- Command Line Tools：安装完 Xcode 后，终端里跑
xcode-select --install，把命令行工具补上。否则 cmake 会找不到编译器。 - Simulator：Xcode 自带 iOS Simulator，测试 UI 很方便。不过真机调试需要 Apple Developer 账号。
- 版本选择：如果你要集成旧版 SDK，得保留多个 Xcode 版本。我一般把新版改名存到 Applications 文件夹，老版不删。
2.2.2 Android Studio：跨平台但坑也不少
Android Studio 基于 IntelliJ IDEA，官方下载包自带 JDK 和 Android SDK。安装步骤很简单，但有几个细节值得注意：
- SDK Manager：安装后打开 SDK Manager，勾选你需要的 API Level。我习惯至少装 21 到 33 几个常用版本。
- AVD 模拟器：创建虚拟设备时，CPU/ABI 选 x86_64，系统镜像下载 API 31 以上的，运行快很多。
- Gradle 版本：项目配置里 gradle-wrapper.properties 的 distributionUrl 要跟 Android Studio 推荐的版本一致。我曾经因为 Gradle 版本过高导致构建失败，降级就好了。
2.3 桌面端环境（Visual Studio、CLion、CMake）
2.3.1 Visual Studio：Windows 下的硬核选择
做 Windows 桌面应用，Visual Studio 几乎是唯一的选择。安装时注意勾选“使用 C++ 的桌面开发”工作负载，否则无法编译 C++ 代码。另外，SDK 集成通常需要 Windows SDK 10 或 11，安装器里默认勾选，保持就好。
- MSVC 编译器：VS 自带，CMake 可以通过
-G "Visual Studio 17 2022"指定生成器。 - Debug 与 Release：切换配置时记得检查“调试信息格式”和“优化”。我调 SDK 接口时习惯先用 Debug 模式，链路通了再切 Release。
- vcpkg：如果你要管理第三方库，可以考虑装 vcpkg。个人建议用它替代手动下载库文件，省心不少。
2.3.2 CLion + CMake：跨平台桌面开发的黄金搭档
CLion 是 JetBrains 的 C++ IDE，原生支持 CMake。你可以在 Windows/macOS/Linux 上获得几乎一致的体验。对于 SDK 集成，CMake 是核心 – 它负责把代码编译成动态库或静态库，然后给移动端调用。
安装步骤：
- 下载 CLion（提供 30 天试用，学生可免费申请许可证）。
- 安装 CMake 3.20 以上版本。你可以从 cmake.org 下载预编译包，或者用包管理器：
brew install cmake（macOS）、sudo apt install cmake（Linux）。 - 打开 CLion，在 Settings → Build, Execution, Deployment → Toolchains 里配置 CMake 路径和编译器。
我的配置清单（供参考）
# CMakeLists.txt 最小示例
cmake_minimum_required(VERSION 3.20)
project(MySDK VERSION 1.0.0 LANGUAGES C CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_library(mylib SHARED src/core.cpp src/helper.cpp)
target_include_directories(mylib PUBLIC include)
这个文件放在项目根目录，CLion 会自动加载。之后就可以在 IDE 里直接编译和调试了。
2.4 环境验证与避坑指南
全部装完后，别急着写代码。先跑一遍验证脚本，确保各工具能互相调用。
| 验证项 | 命令 | 期望输出 |
|---|---|---|
| Xcode Command Line Tools | xcrun --show-sdk-path |
显示 SDK 路径 |
| Android SDK 路径 | echo $ANDROID_HOME |
环境变量已设置 |
| MSVC 编译器 | cl /? |
弹出帮助信息 |
| CMake 版本 | cmake --version |
>=3.20 |
我曾经在一台新 Mac 上装完所有工具，结果 cmake 找不到 Xcode 编译器。后来发现是 xcode-select 指向了 Command Line Tools 而不是 Xcode.app。运行 sudo xcode-select -s /Applications/Xcode.app/Contents/Developer 解决。
这张图把整个环境搭建的框架说清楚了。移动端和桌面端各有两个主要 IDE，而 CMake 是中间的粘合剂。我在搭建过程中最大的感悟是：先装 CMake 并统一版本，再装 IDE，顺序对了能省一半时间。