2、开发环境搭建:安装 Android Studio、配置 Automotive SDK、创建第一个 Automotive 模拟器并运行 Hello World 应用
说实话,很多初学者一上来就急着写代码,结果环境没配好,折腾半天连模拟器都跑不起来。我见过不少同事在这上面浪费了一整天。咱们先把地基打牢,后面才能走得顺。
这一章我会带你走完整个流程:从安装工具到跑出第一个 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 扩展包。具体步骤:
- 打开 SDK Manager(Tools → SDK Manager)。
- 切换到 SDK Platforms 标签页。
- 勾选 Android Automotive OS 对应的 API Level(目前主流是 API 33 或 34)。
- 切换到 SDK Tools 标签页。
- 展开 Android Automotive OS Emulator Support,勾选最新版本。
- 点击 Apply 开始下载。
⚠️ 我曾经踩过的坑:有一次我忘了勾选 Automotive Emulator Support,结果模拟器启动后没有车载界面,只有普通手机界面。折腾了两小时才发现。所以这一步千万别漏。
下载完成后,验证一下配置是否成功。打开项目结构(File → Project Structure),在 SDK Location 里能看到 Automotive SDK 的路径。如果你看到类似 $ANDROID_HOME/extras/automotive 的目录,说明配好了。
2.3 创建第一个 Automotive 模拟器
模拟器是调试的主力。真车机太贵,而且每次刷机都麻烦。我个人习惯用模拟器做 80% 的调试工作。
创建步骤:
- 打开 AVD Manager(Tools → AVD Manager)。
- 点击 Create Virtual Device。
- 在 Category 里选择 Automotive。
- 选一个设备定义。我推荐 Automotive Large (10.1 inch),屏幕够大,看得清楚。
- 点击 Next,选择你刚才下载的 Automotive 系统镜像(比如 API 33)。
- AVD Name 改成
Automotive_Test,方便识别。 - 点击 Finish。
模拟器启动后,你会看到车载主界面,有导航、媒体、电话等卡片。如果看到的是普通手机界面,说明镜像选错了。
性能调优建议:模拟器默认分配 1.5GB 内存。如果你的电脑内存够(16GB+),我建议改成 2GB 或 3GB。在 AVD 高级设置里改,车机应用比手机应用更吃内存。
2.4 运行 Hello World 应用
环境搭好了,咱们写个最简单的应用验证一下。
创建一个新项目:
- File → New → New Project。
- 选择 Empty Activity。
- 项目名填
HelloAutomotive。 - Package name 保持默认。
- Language 选 Kotlin(现在新项目都用 Kotlin 了)。
- Minimum SDK 选 API 33: Android 13.0 (Automotive)。
- 点击 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 应用了。记住这个流程,以后创建新项目时能省不少时间。