第3章:开发环境准备——操作系统、IDE与工具链

好,咱们进入正题。SDK集成这事儿,说白了就是“工欲善其事,必先利其器”。环境没搭好,后面全是坑。我自己这些年踩过的雷,十个有八个都出在环境配置上。

这一章我带你走一遍,把操作系统、IDE和工具链挨个捋清楚。嗯,咱们从上往下说。

环境配置的核心原则:一致性、可复现、版本锁定。

团队里所有人的环境必须一致。别问我为什么强调这个……我曾经见过同事在Windows上跑得好好的,到我macOS上就崩,最后发现是个路径分隔符的问题。

3.1 操作系统要求

不同的SDK对操作系统的要求不太一样。但大体上,我们可以分成三类:

  • Android SDK:支持Windows 10/11、macOS 10.14+、主流Linux发行版。我个人最推荐在macOS或Linux下搞,因为终端体验更好,而且Android模拟器在macOS上跑得最稳。
  • iOS SDK:只能跑在macOS上,而且必须是Catalina 10.15以上。这个没得选,Xcode就是老大。
  • 跨平台SDK(如Flutter、React Native):理论上三平台都行,但Windows上搞iOS开发需要额外的远程编译,麻烦。我建议主力开发机选macOS。
SDK类型 推荐操作系统 最低版本 备注
Android SDK macOS / Linux / Win10+ macOS 10.14 / Win 10 1809 模拟器性能差异大
iOS SDK macOS 专属 macOS 10.15 无替代方案
Flutter SDK macOS / Win10+ / Linux macOS 10.14 / Win10 1909 iOS构建仍需macOS

注意磁盘空间:Xcode 完整安装占用约 30-40GB,Android Studio + 各版本SDK 约 20-30GB。再加上工具链和项目文件……嗯,建议至少留 100GB 空余。

3.2 IDE 配置

IDE的选择其实没那么复杂。我个人的习惯是:

  • Android / Flutter 开发:Android Studio,没跑。IntelliJ IDEA Ultimate也行,但咱们图省事儿,直接用官方的。
  • iOS / macOS 开发:Xcode,没得选。
  • React Native / Node.js:VS Code,轻量、插件生态牛。

3.2.1 Android Studio 配置要点

安装之后,有几个关键插件必须装:

  1. Flutter 插件(如果做跨平台)——装了之后才能创建Flutter项目。
  2. Kotlin 插件——虽然现在Android Studio自带,但版本要确认是最新的。
  3. SDK Manager 里勾选对应版本——别一股脑全下,按项目需求来。我之前图省事全勾了,结果磁盘直接爆红。

3.2.2 Xcode 配置要点

Xcode其实装完就能用,但还是有几件事我得提醒你:

  • Command Line Tools:必须单独装。在 Xcode > Preferences > Locations 里选好版本。
  • 模拟器版本:默认只带最新iOS,如果需要旧版本,得去 Components 里手动下。
  • 证书管理:登录你的Apple ID,否则真机调试走不通。

一个小技巧:Xcode 的 DerivedData 文件夹经常占很多空间。你可以把它移到外置硬盘上。命令:ln -s /Volumes/External/DerivedData ~/Library/Developer/Xcode/DerivedData

3.3 工具链安装

工具链这块,我说几个绕不开的:

3.3.1 包管理器

不同的平台,包管理器不一样:

  • macOS:Homebrew。装啥都靠它。brew install node、brew install cocoapods。我个人觉得Homebrew是macOS上最好的工具,没有之一。
  • Windows:Chocolatey 或 Winget。但我觉得 Chocolatey 更成熟一点。
  • Linux:apt、yum 或者 pacman,看你发行版。

3.3.2 Git 与版本控制

Git 肯定要装。但我建议同时装一个图形化工具,比如 SourceTree 或者 GitHub Desktop。有时候命令行看 diff 不如图形界面直观。

配置 SSH 密钥这块,我踩过坑:

# 生成密钥
ssh-keygen -t ed25519 -C "你的邮箱"
# 启动 agent
eval "$(ssh-agent -s)"
# 添加到 ssh 配置
touch ~/.ssh/config
# 编辑 config 文件,添加:
Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

记住:把公钥添加到 GitHub/GitLab 之后,一定要测一下连接:ssh -T git@github.com。我之前忘加公钥,折腾了半天才发现。

3.3.3 Node.js 与 npm/yarn

如果是 React Native 或者前端系SDK,Node.js 是必须的。版本管理我推荐用 nvm:

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装指定版本
nvm install 18.17.0
nvm use 18.17.0

为什么要用 nvm?因为不同项目可能依赖不同 Node 版本。我同时维护三个项目,一个用 14,一个用 16,一个用 18,没有 nvm 我早崩了。

3.3.4 Gradle 与 CocoaPods

  • Gradle:Android 项目的构建工具。Android Studio 自带,但如果你在 CI/CD 环境,得手动装。建议用 sdkman 管理版本。
  • CocoaPods:iOS 项目的依赖管理。sudo gem install cocoapods。装完之后运行 pod setup 初始化仓库。这一步比较慢,我建议你趁泡杯茶的功夫让它跑。

3.4 整体环境流程图

下面是本章知识结构的SVG图。你可以把它当成一张速查表,回头配置环境的时候对照着看。

SDK集成开发环境结构图 开发环境整体结构 操作系统层 macOS 10.15+ Windows 10/11 Linux (Ubuntu 20.04+) IDE 层 Android Studio Xcode 15+ VS Code IntelliJ IDEA 工具链层 Git / SSH Node.js / nvm Gradle / SDKMAN CocoaPods Homebrew / Chocolatey 跨平台组件 模拟器 / 真机调试 / CI/CD环境 核心原则 一致性:团队统一环境 | 可复现:脚本化部署 | 版本锁定:固定SDK与工具版本

3.5 环境验证 checklist

装完所有东西之后,我强烈建议你跑一遍验证。别等项目编译到一半才发现少东西:

  1. 终端验证:git --version && node -v && npm -v 应该都能正常输出版本号。
  2. IDE验证:新建一个空白项目,编译通过。
  3. SDK验证:运行 flutter doctor 或 react-native doctor,所有检查项都打绿勾。
  4. 权限验证:SSH 能连 GitHub,模拟器能正常启动。

我个人的小癖好:把验证步骤写成一个脚本,团队新人来了直接跑一遍。省得一个个手动检查。你可以试试。