原生移动开发 / 系统课时

安装 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。

bash
export ANDROID_HOME="<PATH_TO_ANDROID_SDK>"
export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin"

adb version
sdkmanager --version

预期输出

text
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 目录。

bash
sdkmanager --list

预期输出

text
Installed packages:
  Path                               | Version | Description
  <INSTALLED_PACKAGE>                | <VERSION> | <DESCRIPTION>
Available Packages:
  <AVAILABLE_PACKAGE>                | <VERSION> | <DESCRIPTION>

实际包名和版本会随已安装组件变化。至少应能看到已安装的 Platform-Tools,以及一个项目所需的 platforms;android-<API_LEVEL>。

如果已经启动模拟器或连接并授权了真机,再运行设备检测:

bash
adb devices

预期输出

text
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 项目的前提。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Android Studio 与 SDK

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通