第3章 环境准备：开发环境搭建与SDK配置
说实话，很多新手在SDK接入时翻车，不是因为代码写错了，而是环境没搭对。我见过太多人花了一整天排查一个编译错误，最后发现是JDK版本不对。所以这一章咱们把地基打牢。
3.1 IDE选择与配置
主流的选择就三个：Android Studio、Xcode、VS Code。我个人习惯用Android Studio做原生Android开发，Xcode做iOS，VS Code用来写点脚本或者跨平台项目。
但注意，IDE版本不要太新。我建议选稳定版，别追预览版。曾经我在一个项目中用了Android Studio的Canary版本，结果Gradle插件不兼容，整个团队都要等我降级。这种痛，一次就够了。
| IDE | 适用平台 | 推荐版本 | 注意事项 |
|---|---|---|---|
| Android Studio | Android | Hedgehog (2023.1.1) 以上稳定版 | 必须配套Gradle 8.x，否则会出现Task配置错误 |
| Xcode | iOS / macOS | 15.x 稳定版 | Command Line Tools 要单独勾选，很多新手漏掉这一步 |
| VS Code | 跨平台脚本 / Flutter | 最新稳定版 | 需要装C/C++扩展和对应SDK的插件 |
3.2 依赖管理方案
依赖管理说白了就是帮你的项目自动下载第三方库。不同平台的工具不一样，但核心思想是一致的：声明依赖，工具解析并下载。
- Android： Gradle + Maven Central / Google Maven
- iOS： CocoaPods 或 Swift Package Manager
- Flutter： pubspec.yaml + pub.dev
下面是一个典型的 Android 下依赖配置（build.gradle.kts）：
// 项目级 build.gradle.kts
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath("com.android.tools.build:gradle:8.2.0")
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20")
}
}
// 模块级 build.gradle.kts
dependencies {
implementation("com.example:sdk-core:2.1.0")
implementation("com.example:sdk-utils:2.1.0")
}// 强制指定版本
configurations.all {
resolutionStrategy {
force("com.squareup.okhttp3:okhttp:4.11.0")
}
}为什么会出现这个冲突？因为SDK作者可能没做版本上限约束。你想想看，两个库都依赖同一个组件但版本不同，Gradle 必须决定用哪一个。如果版本不兼容，运行时就会抛出 NoSuchMethodError。
3.3 模拟器与真机调试
模拟器能快速验证UI和基本逻辑，但真机才能暴露真正的性能问题和硬件交互问题。我个人习惯先跑模拟器，等核心流程跑通后，强制用真机复测一遍。
- Android 模拟器： 建议选 x86_64 镜像，启动快。如果电脑内存小于16G，别开带Google Play的镜像，容易卡死。
- iOS 模拟器： 只能运行在 macOS 上，而且不能模拟摄像头、陀螺仪等硬件。我因为忽略这点，结果在真机上才发现相机权限没弹窗。
- 真机调试关键点： 开启开发者选项、USB调试（Android）、证书信任（iOS）。
3.4 SDK版本选择与下载
SDK版本怎么选？说白了就是平衡稳定性和新特性。我给一个经验法则：
- 优先选 LTS 或稳定版，不要用 alpha / beta 做生产项目。
- 看版本发布的时间，超过一年的旧版本可能已被厂商放弃维护。
- 关注 changelog 中的 breaking changes，大版本升级通常伴随API删除。
下载渠道一般就两个：官方GitHub Release 或 Maven / CocoaPods 仓库。国内开发者可以配镜像来加速，比如阿里云 Maven 镜像。
// 在 ~/.gradle/init.gradle 中配置镜像
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/google' }
}
}本章知识体系
下面这张图把环境准备的几个关键环节串起来了。你可以用它当检查清单，每完成一步就打勾。
到这步，你的开发环境基本就绪了。记住：环境搭建没有捷径，一步步来反而最快。接下来就可以开始真正的SDK初始化编码了。