很多人在Android Studio里看到「SDK Manager」「SDK Path」「compileSdk」这些字样就懵,装了.NET的SDK之后又碰到一堆同名文件夹更分不清。这篇不背定义,而是按「它管什么、字段怎么写、装错了怎么查」三步走,给你一张能对着电脑操作的对照表。适合刚接触安卓或.NET、被SDK弹窗和报错拦住的人。
SDK到底替你打包了什么
把 SDK 想成一个「工具箱打包」:它不是单个软件,而是一整套开发时要用的东西被塞进一个目录里。你平时敲的代码只是原料,真正把它变成能装在手机上的安装包、能跑在模拟器里的应用,靠的是这套箱子里的一件件工具。
| 箱子里通常有什么 | 干什么用 |
|---|---|
| 编译器与构建工具 | 把源码、资源、清单文件处理成可安装的产物 |
| 平台库与平台文件 | 对应某个安卓系统版本的类库、资源与运行时约定 |
| 调试与设备工具 | 连真机、连模拟器、看日志、装包、抓堆栈 |
| 文档与示例 | 离线说明和可参考的样例工程,帮你不联网也能查 |
很多人把 API 和 SDK 混着说。API 只是箱子里被你的代码「调用」的那层接口,比如你调用某个系统能力;而 SDK 还包含你没直接调用、但构建和运行绕不开的那部分——构建脚本、打包流程、设备通信都在里面。所以讨论「要不要装 SDK」时,不能只看你写不写 API 调用。
- Android Studio
- 你写代码、改布局、跑调试的 IDE 界面
- SDK
- IDE 背后真正负责编译、打包、部署到设备的那套工具与平台文件
- 两者关系
- IDE 负责「写」,SDK 负责「变成能跑的东西」,缺一边流程就断
- 项目要产出安装包(不管自己装还是发给别人),绕不开 SDK。
- 要在模拟器里启动应用、或在真机上安装运行,绕不开 SDK。
- 只是打开工程读代码、搜关键字、看结构,不点编译不点运行,可以先不装。
- 只做纯文档、产品原型图、需求梳理,不碰构建,也可以先不装。
- 一旦你发现点运行报「找不到 SDK」这类错,说明流程已经走到需要它的那一步了。
- 先确认你要不要编译打开工程只浏览代码,可以不装;只要点过编译或运行,就必须有它。
- 再确认要跑在哪模拟器或真机都算「要跑」,这两种情况都要用到 SDK 里的设备工具和平台文件。
- 最后看箱子缺不缺件进 IDE 的 SDK 管理界面,看构建工具、平台文件、设备工具这几类是否已勾选安装。
常见字段和目录名逐个对照
先说清楚一件事:SDK 里那些字段名字看着像一家人,其实各管各的。版本类字段决定「拿什么编译、跑起来什么脾气、能装到多老的机器上」;路径类字段决定「这些文件真身放在硬盘哪儿」。搞混了最常见的结果就是 Gradle 同步报错,或者装到旧机器上一开就崩。
- compileSdk
- 告诉编译器用哪一套平台文件来编你的代码,它只影响编译那一刻能看到哪些 API。
- targetSdk
- 告诉系统「我按这个版本的行为规范来跑」,系统会据此决定要不要给你套上兼容逻辑。
- minSdk
- 声明能安装的最老系统版本,低于它的设备直接装不上,应用商店也会按这个筛。
- sdk.dir / 本地 SDK 路径
- 指向 SDK 实际存放的根目录,构建工具顺着它去找平台、构建工具和平台工具。
- 三个版本字段别当同一个东西填:编译用哪套、运行时按哪套规则、最低能装到哪代,是三个独立决定。
- 路径类字段只关心「存哪儿」,不管版本高低;同一台机器上多套版本是并存关系,不是覆盖关系。
- 改路径或整体搬家前,先把原值抄下来,否则构建工具按老路径找文件,直接找不到。
- 目录结构一般能自解释:平台文件一层、构建工具一层、平台工具一层,各自独立。
- 工具链的版本编号和平台版本编号是两套体系,别按数字大小硬对应,容易对错。
| 看到的名字 | 它管什么 | 填错会怎样 |
|---|---|---|
| compileSdk | 用哪套平台文件编译 | 编译期找不到你用的 API,直接报错 |
| targetSdk | 运行时按哪套行为规范走 | 新系统上行为异常,比如后台限制不生效 |
| minSdk | 最低能装到哪代设备 | 旧机型装不上,或商店直接不给展示 |
| sdk 路径字段 | SDK 实际存放位置 | 构建工具找不到文件,同步或打包失败 |
| 目录分层 | 平台 / 构建工具 / 平台工具各一层 | 把两套编号混用,选错目录版本 |
- 先抄原值再动手改路径或搬家之前,把当前 SDK 路径字段的原值记下来,最好截图或存文本,出问题能回退。
- 按用途分开核对先确认编译用哪套、运行时按哪套、最低支持哪代这三件事各自填了什么,别在一个字段里塞两个意图。
- 按目录层级找文件顺着路径字段进到根目录,看平台文件、构建工具、平台工具是不是各占一层,确认没有把两套编号硬对应。
- 用一次同步验证改完跑一次同步或构建,看有没有报路径找不到或版本不匹配,比对改动前后差异。
.NET 开发者容易混淆的几处
.NET 这边的 SDK,本质是「运行时 + 命令行工具 + 编译链」打包在一起的一整套。只装运行时,等于只能跑别人编好的程序,自己动手编译就会报找不到编译器或目标包。安卓这边说的 SDK 是另一条产品线,指 Android 平台的开发套件。两边都叫 SDK,但根本不是一回事,排查时第一句话先问清楚:你看的是 .NET 那条线,还是安卓那条线?
| 你看到的说法 | 实际指的是什么 | 能不能直接编译 |
|---|---|---|
| .NET 运行时 | 只负责加载和执行已编译程序 | 不能,缺编译工具链 |
| .NET SDK | 运行时加命令行工具加编译链 | 可以,命令行就能编译 |
| Android SDK | 安卓平台开发套件与构建工具 | 属于纯安卓那条线 |
| 同一个项目换版本打开 | 行为可能不同,编译目标会变 |
- 命令行确认当前生效版本在终端里跑 dotnet --version 看当前解析到的是哪一个;再用 dotnet --list-sdks 列出机器上装了哪些。这一步拿到的是真实生效值,不依赖任何图形界面。
- 对比 IDE 里的显示打开项目后看 IDE 里标识的 SDK 版本,和上面命令行结果对照。两边不一致时,以命令行实际生效的为准,因为 IDE 可能读的是项目文件里写死的目标框架。
- 确认你在查哪条产品线如果手上是安卓工程,就别拿这组命令的版本号去和安卓那边拼装工具的版本互相比对,两套编号体系没有对应关系。
- 换项目前重新确认一次同一个项目被不同版本的 SDK 打开,编译产物和报错都可能变。换机器或换人接手时,先重复第一步,别凭上次的记忆直接开工。
- 装了运行时不一定能编译,这是最常见的误判
- 同一个项目用不同 SDK 版本打开,行为可能不一样
- 先命令行确认生效版本,再看 IDE 显示,顺序不要反
- 安卓和 .NET 都有 SDK,但路径和编号不能互相对照
- 排查问题时先锁定产品线,再谈版本对不对
这套判断只适用于你要自己动手编译或排查构建问题的场景。如果你只是运行一个别人已经编译好的程序,那确实只需要运行时就够,不必纠结有没有完整的 SDK。想核对两条产品线各自的资料,可以到 站内模型与资料库(/models) 看当时整理好的条目。
下一步如果你正卡在编译报错上,先按上面顺序把生效版本和产品线确认一遍,再去对照资料就没那么容易被误导。→拿到一个 SDK 后的 30 分钟核对清单
不管你是刚解压完一个 SDK,还是接手同事留下的环境,别急着写业务代码。先花半小时做一遍核对,把「东西在哪、跑的是哪个、能不能编」这三件事确认清楚,后面九成的环境报错都能省掉。
- 找安装目录并记下来别信安装器界面上显示的路径,直接去文件管理器里把 SDK 根目录翻出来,确认里面确实有可执行文件和平台目录。把绝对路径复制进笔记,之后任何「找不到」「未配置」类报错,第一步都回到这个目录确认东西还在不在、路径有没有被挪过。
- 查真正生效的版本打开命令行,用这套工具自带的版本查询命令跑一遍,看它实际报出来的版本字段,而不是只看安装包文件名或安装器界面。如果机器上装了多份,重复这一步并对比输出,确认命令行解析到的是你打算用的那一份。
- 跑一次最小构建新建或打开一个空项目,只做编译,不加任何三方依赖。能顺利编译通过,才算环境真的通了。失败时先看日志里的第一处路径错误——通常就是根目录没被正确引用或被挪了位置,后面成串的报错多半是它的连带结果。
- 把原值抄进项目说明把版本字段和安装绝对路径原样记进项目说明文件,别只记「已装好」。换机器、升级或交接时,拿这份记录逐项对照,能立刻判断是环境变了还是代码变了。
| 核对项 | 看哪里 | 记录什么 |
|---|---|---|
| 安装位置 | 文件管理器里的 SDK 根目录 | 绝对路径 |
| 生效版本 | 命令行版本查询命令的输出 | 工具报出的版本字段 |
| 可用性 | 空项目的构建结果 | 通过 / 第一处路径报错 |
| 对照基准 | 项目说明文件 | 路径与版本原值 |
这套清单不适用于你只是临时跑个在线环境、根本不在本机装 SDK 的情况,那种场景该查的是账号与配额,不是本地路径。至于当前各版本字段和目录结构的准确形态,站内资料是跟着更新走的,写到项目说明里之前,到 /models 核对一遍再抄,别凭记忆填。
常见问题
SDK 和 API 是一回事吗?
不是。API 是别人给你调用的那层约定,SDK 是把工具、库、示例和文档一起打包给你的整套东西。多数 SDK 里包含调用 API 的封装,也有 SDK 不主打接口调用,只提供编译和调试工具。想先弄清概念关系,可以到站内 /ai-dict 把两个词对照着看一遍。
为什么我装了 SDK,Android Studio 还说找不到?
最常见是路径指向了错误的层级,或者是安装目录换了位置但配置里没跟着改。先确认安装目录真实存在,再检查配置里的路径字段是否指到该目录本身而不是它的子目录,最后重启一次工具让它重新读取。
SDK 一定要装最新版吗?
不一定。用哪套取决于你项目的版本字段怎么填,老项目锁在旧版本上很常见。旧版本不再被维护、缺少新平台支持,或者你的构建工具要求更高版本时,才需要升级。升级前把原路径和版本先记下来,方便回退。