4. 开发环境搭建：Node.js、Java、Android SDK、Xcode 等基础环境配置

说实话，很多跨平台 SDK 集成卡在第一步。

不是代码写不出来，而是环境没配好。我见过太多同学花一整天装工具，结果到最后跑不起来，发现是 JDK 版本不对或者 PATH 没配全。咱们今天就把这些东西一次搞定。

核心思路：先把工具链拆开，一个个装。别贪快，装一个测一个。

4.1 Node.js：前端 SDK 的基石

现在绝大多数 SDK 都需要 Node.js 环境。不管是 React Native、Flutter 还是纯 JS SDK，Node 都是标配。

我个人习惯用 nvm（Node Version Manager）来装。为啥？因为你手上可能同时有好几个项目，有的要求 Node 14，有的要求 Node 18。nvm 能随时切换。

安装步骤

  1. macOS/Linux：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  2. Windows：去 nvm-windows 的 GitHub 仓库下载最新安装包
  3. 装完后重新打开终端，运行 nvm --version 验证
  4. 安装 LTS 版本：nvm install --lts
  5. 设为默认：nvm alias default node
小经验：装完记得执行 node -v 和 npm -v。我曾经装完 nvm 后发现 PATH 没生效，折腾了半小时才发现是终端没重启。

还有一个容易忽略的点——npm 配置。国内用户建议配一下镜像源：

npm config set registry https://registry.npmmirror.com

嗯，这个不配的话，你后面装 SDK 依赖时可能会等到怀疑人生。

4.2 Java：Android 与部分后端 SDK 的依赖

Android SDK 的编译工具链依赖 JDK。我记得以前有个项目，团队里有人装的是 JDK 11，有人是 JDK 8，结果 Gradle 构建报一堆怪错。

后来我们统一了标准——JDK 11（推荐）或 JDK 8（兼容性更好）。

安装方式

  • macOS：brew install openjdk@11
  • Windows/Linux：去 adoptium.net 下载 .msi 或 tar.gz 包
  • 装完设置 JAVA_HOME 环境变量

JAVA_HOME 怎么配？我直接给你写出来：

# macOS/Linux（加到 ~/.zshrc 或 ~/.bashrc 里）
export JAVA_HOME=/usr/local/opt/openjdk@11
export PATH=$JAVA_HOME/bin:$PATH

# Windows（系统变量里新建）
变量名: JAVA_HOME
变量值: C:\Program Files\Java\jdk-11

验证方法

命令期望输出说明
java -versionopenjdk version "11.0.x"版本要对上
javac -versionjavac 11.0.x编译器也要有
echo $JAVA_HOME/path/to/jdk路径不能为空
避坑指南：曾经有同学只装了 JRE，没有装 JDK。Gradle 编译直接报 "tools.jar not found"。记住，SDK 集成需要的是 JDK，不是 JRE。

4.3 Android SDK：移动端集成的基础

Android SDK 的安装以前挺麻烦的，现在有了 Android Studio 就简单多了。

但我想提醒你的是——不要直接在 Android Studio 里装完就不管了。很多 SDK 集成环节需要你在命令行里调用 aapt、adb、zipalign 这些工具。这些工具在 SDK 目录的 build-tools 和 platform-tools 下。

推荐的安装流程

  1. 下载 Android Studio（developer.android.com/studio）
  2. 启动后进入 SDK Manager，勾选以下内容：
    • Android SDK Platform（至少一个版本，建议 API 34）
    • Android SDK Build-Tools（最新版）
    • Android SDK Platform-Tools（包含了 adb）
    • Android Emulator（可选，但建议装）
  3. 记录 SDK 路径（macOS 默认 ~/Library/Android/sdk，Windows 默认 C:\Users\用户名\AppData\Local\Android\Sdk）
  4. 设置环境变量 ANDROID_HOME 并添加到 PATH

我建议你这样配环境变量：

# macOS/Linux
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$ANDROID_HOME/platform-tools:$ANDROID_HOME/build-tools/34.0.0:$PATH

# Windows（系统变量）
ANDROID_HOME = C:\Users\用户名\AppData\Local\Android\Sdk
PATH 里追加 %ANDROID_HOME%\platform-tools;%ANDROID_HOME%\build-tools\34.0.0
实战经验：我建议你装完后在命令行跑一下 adb --version 和 aapt --version。如果提示 "command not found"，说明 PATH 没配好。我遇到过很多次这种问题，基本都是路径写错了。

4.4 Xcode：iOS 集成的必经之路

Xcode 这玩意儿…说实话，没法跳过去。iOS SDK 集成必须用 macOS 开发机，而且 Xcode 只能从 Mac App Store 下载。

我自己的经验是——装 Xcode 的时候做好心理准备。那个安装包现在差不多 7-8 GB，下载加解压可能要一个小时。

关键配置

  • 安装 Xcode（从 App Store 获取，版本建议最新稳定版）
  • 打开一次 Xcode，让它自动安装额外的 Command Line Tools
  • 手动安装 Command Line Tools：xcode-select --install
  • 接受许可协议：sudo xcodebuild -license accept
  • 检查版本：xcodebuild -version

有个细节容易被忽略——模拟器。Xcode 默认只会下载当前 iOS 版本的模拟器镜像。但很多 SDK 要求兼容低版本 iOS，这时候你得手动去 Window → Devices and Simulators → Simulators 里添加。

曾经踩过的坑：我有个项目需要在 iOS 15 上测试，但 Xcode 只装了 iOS 17 的模拟器。结果集成 SDK 后，有个 API 只在 iOS 16+ 上可用，调试了半天才发现是模拟器版本不对。所以，尽量把你的目标 iOS 版本模拟器都装上。

4.5 环境集成验证流程

工具都装完之后，我建议你走一遍完整的验证流程。不要等到真正集成 SDK 时才发现环境有问题。

下面这张图展示了我们这套开发环境的整体关系：

基础开发环境全景图 操作系统（macOS / Windows / Linux） Node.js 运行环境 Java 开发环境 Xcode / macOS npm / nvm Node 版本管理 JDK 11 / Gradle 编译与构建 Xcode CLI 模拟器 / 构建 前端 SDK React Native / Flutter 等 Android SDK API / Build-Tools / ADB iOS SDK UIKit / Metal / SwiftUI 环境验证 & 集成测试 🔑 关键：PATH 配置 版本一致性检查

你可以按这个顺序做一次完整验证：

  1. 验证 Node.js：node -v + npm -v
  2. 验证 Java：java -version + javac -version + echo $JAVA_HOME
  3. 验证 Android SDK：adb --version + aapt --version + echo $ANDROID_HOME
  4. 验证 Xcode：xcodebuild -version + xcrun --show-sdk-path
个人经验：我建议你把这些验证命令写成一个脚本文件（比如 verify_env.sh），每次搭建新机器时直接跑一遍。这样既省时间，又不会漏掉环节。

好了，环境搭完了。你可能会觉得这些东西装起来很啰嗦。但说实话，一套干净、完整、可复现的开发环境，能帮你后面省下大把调试时间。我自己的电脑上，这些工具的版本都是固定的，换机器时照着文档来一遍，半小时搞定。

← 上一章 📖 返回目录 下一章 →