第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 配置要点
安装之后,有几个关键插件必须装:
- Flutter 插件(如果做跨平台)——装了之后才能创建Flutter项目。
- Kotlin 插件——虽然现在Android Studio自带,但版本要确认是最新的。
- 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图。你可以把它当成一张速查表,回头配置环境的时候对照着看。
3.5 环境验证 checklist
装完所有东西之后,我强烈建议你跑一遍验证。别等项目编译到一半才发现少东西:
- 终端验证:
git --version && node -v && npm -v应该都能正常输出版本号。 - IDE验证:新建一个空白项目,编译通过。
- SDK验证:运行
flutter doctor或react-native doctor,所有检查项都打绿勾。 - 权限验证:SSH 能连 GitHub,模拟器能正常启动。
我个人的小癖好:把验证步骤写成一个脚本,团队新人来了直接跑一遍。省得一个个手动检查。你可以试试。