原生移动开发 / 系统课时
安装 Android Studio 与 SDK
安装 Android Studio 与 SDK
完成 Android 开发环境安装后,至少要能启动 Android Studio、定位 SDK 目录,并让 adb 与 sdkmanager 正常工作。本课按“安装 IDE → 补齐 SDK 组件 → 配置命令行 → 验证”的顺序完成最小可用环境,不额外安装与基础开发无关的工具。
学习目标
- 完成 Android Studio 与基础 Android SDK 组件安装
- 在 SDK Manager 中确认 SDK Platform、Platform-Tools 和命令行工具
- 通过命令行验证 SDK 路径、
adb与sdkmanager可用
安装 Android Studio
从 Android Developers 官方下载页选择与当前操作系统和 CPU 架构匹配的 Android Studio 安装包。Windows 通常运行安装程序,macOS 将应用拖入 Applications,Linux 解压后从 android-studio/bin 启动。
首次启动时按 Setup Wizard 完成基础组件下载。若没有特殊需求,先使用默认推荐配置即可;SDK、模拟器镜像等体积较大,安装前应确认磁盘空间和网络可用。Android Studio 自带 Android 开发所需的核心支持,不需要为了“基础插件”额外安装来源不明的第三方插件。
补齐必要 SDK 组件
Android Studio 启动后打开 Tools > SDK Manager。在 SDK Platforms 中至少安装一个项目需要的 Android SDK Platform;在 SDK Tools 中确认 Android SDK Platform-Tools 和 Android SDK Command-line Tools 已安装。需要使用模拟器时,再安装 Android Emulator 和相应系统镜像。
SDK Platform 决定项目可使用的平台 API;Platform-Tools 提供 adb 等设备通信工具;Command-line Tools 提供 sdkmanager 等 SDK 管理命令。Build-Tools 通常由构建系统按项目需要解析,不必一开始手工安装所有历史版本。
配置命令行路径
SDK Manager 会显示 Android SDK Location。下面以 Bash 为例,将 <PATH_TO_ANDROID_SDK> 替换成界面中显示的真实路径,再把 Platform-Tools 和 Command-line Tools 加入 PATH。
export ANDROID_HOME="<PATH_TO_ANDROID_SDK>"
export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin"
adb version
sdkmanager --version预期输出
Android Debug Bridge version <VERSION>
Version <VERSION>
Installed as <PATH>
<VERSION>不同版本的 adb 可能多输出一两行,因此只要能看到 Android Debug Bridge 的版本信息,且 sdkmanager --version 能返回版本号即可。Windows 可在“环境变量”中设置 ANDROID_HOME,再把 %ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\cmdline-tools\latest\bin 加入 Path。
验证平台与设备工具
先让 sdkmanager 列出可见的 SDK 包,确认命令行工具能够读取同一个 SDK 目录。
sdkmanager --list预期输出
Installed packages:
Path | Version | Description
<INSTALLED_PACKAGE> | <VERSION> | <DESCRIPTION>
Available Packages:
<AVAILABLE_PACKAGE> | <VERSION> | <DESCRIPTION>实际包名和版本会随已安装组件变化。至少应能看到已安装的 Platform-Tools,以及一个项目所需的 platforms;android-<API_LEVEL>。
如果已经启动模拟器或连接并授权了真机,再运行设备检测:
adb devices预期输出
List of devices attached
<ID> device没有设备时只显示标题行是正常现象;出现 unauthorized 时需要在手机上确认 USB 调试授权,出现 command not found 或“不是内部或外部命令”则优先检查 PATH 和 SDK 实际目录。
处理最常见的安装失败
如果 SDK 组件下载失败,先确认系统代理、公司网络或防火墙是否阻断下载,再回到 SDK Manager 重试,不要直接复制来源不明的 SDK 文件。若 sdkmanager 找不到,检查是否安装了 Android SDK Command-line Tools,以及目录是否确实存在 cmdline-tools/latest/bin。
如果 adb 能运行却看不到真机,先确认手机已开启开发者选项和 USB 调试,再检查数据线、USB 模式与系统驱动;Windows 某些设备还需要厂商 USB 驱动。模拟器无法启动时,则检查虚拟化支持、系统镜像与可用内存,而不是重复重装整个 IDE。
最终验收标准很简单:Android Studio 能启动,SDK Manager 能看到已安装平台和工具,终端能执行 adb version 与 sdkmanager --list。达到这三个条件后,开发环境已经具备创建、构建和运行基础 Android 项目的前提。