第二章 开发环境搭建：工欲善其事，必先利其器

好，咱们直接进入正题。这一章要搞定三样东西：Android Studio、Xcode、还有 Node.js 与 npm。别小看这一步，我见过太多人卡在环境配置上，一卡就是半天。说实话，环境搭好了，后面写代码就是享受；搭不好，那真是噩梦。

2.1 Android Studio 安装与配置

Android Studio，说白了就是 Android 开发的官方 IDE。它基于 IntelliJ IDEA，Google 专门为它定制了很多工具。我个人习惯用最新稳定版，别追 beta 版，容易踩坑。

2.1.1 下载与安装

去 developer.android.com/studio 下载对应你操作系统的版本。Windows、macOS、Linux 都有。下载后直接安装，Windows 上记得勾选「Android Virtual Device」——这个后面模拟器要用。

小提示： 安装路径不要有中文，不要有空格。我以前有个同事路径里带了个「&」符号，结果 Gradle 死活编译不过，查了两小时才发现。

2.1.2 SDK 管理

安装完后，第一件事是配置 SDK。打开 Preferences → Appearance & Behavior → System Settings → Android SDK。这里你要关注三个东西：

  • SDK Platforms： 勾选你目标 API Level。我个人建议至少装 API 33 和 API 34，覆盖大部分设备。
  • SDK Tools： 确保 Android SDK Build-Tools、Android Emulator、Android SDK Platform-Tools 都勾上了。
  • SDK Location： 记住这个路径，后面配置环境变量要用。
注意： 我曾经遇到过 SDK Tools 版本不匹配导致编译失败的情况。解决办法是：保持 Build-Tools 版本和 compileSdkVersion 一致。比如你用 compileSdkVersion 34，Build-Tools 最好也是 34.x.x。

2.1.3 环境变量配置

Windows 用户：把 ANDROID_HOME 加到系统变量，值就是 SDK 路径。再把 %ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\tools 加到 Path 里。

macOS/Linux 用户：在 ~/.bash_profile 或 ~/.zshrc 里加上：

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin

配置完记得 source ~/.zshrc 刷新。然后终端输入 adb --version，能看到版本号就说明成功了。

2.2 Xcode 安装与配置

Xcode 是 macOS 专属，Windows 用户请直接跳过这节——或者考虑用虚拟机，但说实话体验很差。

2.2.1 从 App Store 安装

打开 App Store，搜索 Xcode，下载。文件很大，大概 10 多个 G，建议用 Wi-Fi 或者提前规划好时间。我记得第一次下载时等了快两个小时，还以为网坏了。

小提示： 如果你只需要命令行工具，可以只装 Command Line Tools。终端输入 xcode-select --install 就行。但做原生模块开发，我建议还是装完整版 Xcode，因为你需要 Interface Builder 和模拟器。

2.2.2 首次启动与配置

安装完后打开 Xcode，它会自动安装一些额外组件。然后你要做两件事：

  • 同意许可证： 这个不用多说，点同意就行。
  • 安装模拟器： 打开 Xcode → Preferences → Platforms，点那个「+」号，添加你需要的 iOS 版本。我个人习惯保留最新的两个大版本，比如 iOS 17 和 iOS 16。

2.2.3 命令行工具路径设置

这个很多人会忽略。打开 Xcode → Preferences → Locations，确保 Command Line Tools 下拉框选中的是你安装的 Xcode 版本。不设置的话，后面 pod install 会报错。

避坑指南： 我曾经升级 Xcode 后忘了重新设置这个路径，结果 CocoaPods 一直报「xcode-select: error: tool 'xcodebuild' requires Xcode」。折腾了半天才发现是路径没更新。所以每次升级 Xcode 后，记得检查这里。

2.3 Node.js 与 npm 环境准备

Node.js 是 JavaScript 运行时，npm 是它的包管理器。做 React Native 或原生模块开发，这两个是标配。

2.3.1 安装 Node.js

去 nodejs.org 下载 LTS 版本。别下载 Current 版，除非你想当小白鼠。LTS 版本稳定，社区支持好，出了问题也好查资料。

安装过程很简单，一路 Next 就行。安装完后打开终端验证：

node --version
npm --version

能看到版本号就说明装好了。我建议 Node.js 版本不低于 18，npm 版本不低于 9。

2.3.2 配置 npm 镜像源

国内用户一定要配镜像源，不然下载包能等到你怀疑人生。我个人习惯用淘宝镜像：

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

配置完后可以验证：

npm config get registry

看到返回的地址是淘宝镜像就对了。

小提示： 如果你在公司内网，可能还需要配置代理。用 npm config set proxy http://你的代理地址:端口 就行。我曾经在客户现场折腾了一下午，最后发现是公司网络限制了外网访问。

2.3.3 安装 nvm（可选但推荐）

nvm 是 Node Version Manager，可以让你在同一台机器上切换多个 Node.js 版本。为什么需要这个？因为不同项目可能依赖不同版本的 Node.js。比如老项目可能只能用 Node 14，新项目要求 Node 18。

安装方式：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完后重启终端，输入 nvm --version 验证。然后你就可以用 nvm install 18 安装指定版本，用 nvm use 18 切换版本。

重点总结： 开发环境搭建看似繁琐，但每一步都有它的道理。Android Studio 管 Android 端，Xcode 管 iOS 端，Node.js 和 npm 管 JavaScript 生态。这三样东西配好了，后面写原生模块就是水到渠成的事。

嗯，这一章就到这里。下一章我们聊聊原生模块的项目结构，看看一个完整的原生模块到底长什么样。

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