2、开发环境搭建:安装 Android Studio、配置 Automotive SDK、创建第一个 Automotive 模拟器并运行 Hello World 应用

说实话,很多初学者一上来就急着写代码,结果环境没配好,折腾半天连模拟器都跑不起来。我见过不少同事在这上面浪费了一整天。咱们先把地基打牢,后面才能走得顺。

这一章我会带你走完整个流程:从安装工具到跑出第一个 Hello World。你跟着做就行,不用跳步。

开发环境搭建流程 安装 Android Studio 配置 Automotive SDK 创建模拟器 运行 Hello World 💡 核心要点:每一步都依赖上一步,不要跳步。 建议先通读一遍流程,再动手操作。

2.1 安装 Android Studio

Android Studio 是官方 IDE,没有它你什么都干不了。我建议直接从 developer.android.com/studio 下载最新稳定版。别用预览版,坑太多。

安装时有几个选项要注意:

  • SDK 组件:默认勾选的 Android SDK Platform、Intel HAXM(Windows)或 Apple Hypervisor(macOS)都留着。
  • 安装路径:别放中文目录。我见过有人放「桌面/安卓开发」,结果编译报错找半天原因。
  • 代理设置:如果你在公司内网,提前配好 HTTP 代理。否则 SDK 下载会卡住。

我的小技巧:第一次启动后,Android Studio 会自动下载最新 SDK。这时候去泡杯咖啡,大概 10-15 分钟。别中途关掉,否则下次启动还得重来。

2.2 配置 Automotive SDK

普通 Android SDK 不包含 Automotive 的 API。你需要额外下载 Automotive 扩展包。具体步骤:

  1. 打开 SDK Manager(Tools → SDK Manager)。
  2. 切换到 SDK Platforms 标签页。
  3. 勾选 Android Automotive OS 对应的 API Level(目前主流是 API 33 或 34)。
  4. 切换到 SDK Tools 标签页。
  5. 展开 Android Automotive OS Emulator Support,勾选最新版本。
  6. 点击 Apply 开始下载。

⚠️ 我曾经踩过的坑:有一次我忘了勾选 Automotive Emulator Support,结果模拟器启动后没有车载界面,只有普通手机界面。折腾了两小时才发现。所以这一步千万别漏。

下载完成后,验证一下配置是否成功。打开项目结构(File → Project Structure),在 SDK Location 里能看到 Automotive SDK 的路径。如果你看到类似 $ANDROID_HOME/extras/automotive 的目录,说明配好了。

2.3 创建第一个 Automotive 模拟器

模拟器是调试的主力。真车机太贵,而且每次刷机都麻烦。我个人习惯用模拟器做 80% 的调试工作。

创建步骤:

  1. 打开 AVD Manager(Tools → AVD Manager)。
  2. 点击 Create Virtual Device。
  3. 在 Category 里选择 Automotive。
  4. 选一个设备定义。我推荐 Automotive Large (10.1 inch),屏幕够大,看得清楚。
  5. 点击 Next,选择你刚才下载的 Automotive 系统镜像(比如 API 33)。
  6. AVD Name 改成 Automotive_Test,方便识别。
  7. 点击 Finish。

模拟器启动后,你会看到车载主界面,有导航、媒体、电话等卡片。如果看到的是普通手机界面,说明镜像选错了。

性能调优建议:模拟器默认分配 1.5GB 内存。如果你的电脑内存够(16GB+),我建议改成 2GB 或 3GB。在 AVD 高级设置里改,车机应用比手机应用更吃内存。

2.4 运行 Hello World 应用

环境搭好了,咱们写个最简单的应用验证一下。

创建一个新项目:

  1. File → New → New Project。
  2. 选择 Empty Activity。
  3. 项目名填 HelloAutomotive。
  4. Package name 保持默认。
  5. Language 选 Kotlin(现在新项目都用 Kotlin 了)。
  6. Minimum SDK 选 API 33: Android 13.0 (Automotive)。
  7. 点击 Finish。

项目创建后,打开 MainActivity.kt。默认代码已经有一个 Hello World 的 TextView。但车机应用需要额外配置才能在模拟器上正常显示。

打开 AndroidManifest.xml,在 <application> 里添加:

<meta-data
    android:name="android.automotive"
    android:resource="@xml/automotive_app_desc" />

然后在 res/xml/ 目录下创建 automotive_app_desc.xml:

<?xml version="1.0" encoding="utf-8"?>
<automotiveApp>
    <uses name="template" />
</automotiveApp>

这个文件告诉系统:我这个应用是 Automotive 应用,使用模板布局。

最后,点击 Run 按钮,选择刚才创建的 Automotive_Test 模拟器。等几秒钟,你应该能看到模拟器上出现 "Hello World!" 的文字。

如果没显示怎么办? 检查两点:一是模拟器是否真的启动了 Automotive 镜像(看界面是不是车载风格);二是 manifest 里有没有加 automotive 元数据。我遇到过好几次忘记加元数据,应用直接崩溃。

2.5 常见问题与避坑指南

问题 原因 解决方案
模拟器启动后黑屏 显卡驱动不兼容或内存不足 更新显卡驱动;在 AVD 设置里增加内存到 2GB
应用安装失败:INSTALL_FAILED_MISSING_FEATURE Manifest 缺少 automotive 声明 添加 <meta-data> 和 automotive_app_desc.xml
SDK 下载速度极慢 网络问题或镜像源不对 使用国内镜像(如腾讯云、阿里云)或配置代理
模拟器没有车载界面 选错了系统镜像 重新创建 AVD,选择 Automotive 分类下的镜像

⚠️ 我曾经踩过的坑:有一次我升级了 Android Studio,结果 Automotive SDK 路径变了,所有项目都找不到 Automotive API。解决办法是重新在 SDK Manager 里勾选 Automotive 组件,然后同步项目。所以升级 IDE 后一定要检查 SDK 配置。

好了,环境搭好了,第一个应用也跑起来了。后面咱们就可以正式开始写 Automotive 应用了。记住这个流程,以后创建新项目时能省不少时间。