Skip to content

2. 搭建开发环境

2.1. Android Studio

[Android Studio] 可从 https://developer.android.com/studio 免费下载。首次启动时,向导会提供标准安装:接受它,它就会下载 [Android] SDK(编译应用所需的库和工具)以及模拟器。

Image

[SDK Manager]([Tools / SDK Manager],或在欢迎界面选择 [More Actions / SDK Manager])用于安装和更新 SDK 的各个组件。[SDK Platforms] 选项卡:一个较新的 [Android] 平台(本课程使用 API 37,即项目的 [compileSdk] 设置);[SDK Tools] 选项卡:[Android SDK Build-Tools]、[Android SDK Platform-Tools](其中包含 [adb])以及 [Android Emulator]。

Image

[Android Studio] 还会安装自带的 JDK,即 [JBR]([JetBrains Runtime],位于 [C:\Program Files\Android\Android Studio\jbr] 中):执行 [Gradle] 的正是它。若要在 [Android Studio] 之外通过命令行编译项目,只需指定这个 JDK 和 SDK:

1
2
3
$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
$env:ANDROID_HOME = "$env:LOCALAPPDATA\Android\Sdk"
.\gradlew.bat installDebug
  • [gradlew.bat](“Gradle 包装器”):每个项目自带的一个小型启动器,会根据需要下载项目所要求的 [Gradle] 版本(文件 [gradle/wrapper/gradle-wrapper.properties]);
  • [installDebug]:编译应用(调试版本)并将其安装到已连接的设备上。[assembleDebug] 只编译,输出到 [app/build/outputs/apk/debug/app-debug.apk]。

2.2. 设置 Android 模拟器

如果你没有手机,可以在模拟器上测试应用:模拟器是在电脑窗口中运行的虚拟手机。前提条件:必须在 BIOS 中启用虚拟化,并且在 [Windows] 下必须勾选 [Windows Hypervisor Platform] 功能。在 [Device Manager]([Tools / Device Manager])中创建虚拟设备:[Create Device],选择一个模板(例如 [Pixel 8])和适用于 [x86_64] 处理器的较新系统映像,然后点击 [Finish]。

Image

[Device Manager] 上的 [Play] 按钮用于启动模拟器。然后我们验证 [adb](连接电脑与设备的工具,位于 [%LOCALAPPDATA%\Android\Sdk\platform-tools])能否检测到它:

1
2
3
PS> adb devices
List of devices attached
emulator-5554   device

如果设备显示为 [offline],请等待启动过程完成,或重启 [adb](先执行 [adb kill-server],再执行 [adb start-server])。

2.3. 准备 Android 手机

要在真实手机上运行应用,必须将手机设置为允许由电脑控制:

  • 启用开发者选项:[Settings / About phone],连续点击 [Build number] 七次;
  • 在 [Developer options] 中启用 [USB debugging];
  • 使用可传输数据的 USB 线连接手机,并在手机上接受授权请求;
  • 验证 [adb devices] 是否显示该手机。

在 [Android Studio] 中,[Run] 按钮旁边的设备下拉列表随后会显示模拟器和手机。

2.4. 创建项目

在 [Compose] 项目通过 [Android Studio] 的 [File / New / New Project] 创建,使用 [Empty Activity] 模板:填写名称([Name])、应用 ID([Package name],例如 [fr.stahe.examples],像域名一样倒着写:安装在同一部手机上的两个应用必须有不同的 ID)以及配置语言 [Kotlin DSL]。向导会生成一个完整的、可直接运行的应用。示例项目就是这样创建的,然后手动补全;其配置文件在示例 01 中展示。