开发环境搭建：安装Android Studio、配置SDK与模拟器、使用车载模拟器镜像、创建第一个车载Android项目

车载Android应用开发与普通移动端开发最大的差异在于：目标系统不再是手机或平板，而是运行在车机硬件上的Android Automotive OS（AAOS）或定制化Android系统。开发环境的搭建因此需要兼顾标准Android工具链与车载特有的模拟器镜像、系统签名、硬件抽象层（HAL）接口等要素。本章将围绕环境搭建的完整链路展开，从Android Studio安装、SDK与模拟器配置，到车载模拟器镜像的加载，最终创建一个可运行的车载Android项目，帮助读者建立一套可复用的车载开发基础环境。

上图展示了车载Android开发环境搭建的完整链路：从基础工具链到SDK平台，再到车载模拟器镜像，最后创建项目。整个流程环环相扣，任何一个环节的缺失或配置错误都可能导致后续开发受阻。下面我们将逐一深入每个环节，讲解核心原理、操作步骤与实战要点。

2.1 核心原理：车载Android开发环境与传统移动开发环境的差异

车载Android系统（AAOS）虽然基于AOSP（Android Open Source Project），但其系统服务、硬件抽象层、用户界面框架都针对汽车场景做了深度定制。从开发环境角度看，主要差异体现在以下三个层面：

• 系统镜像差异：车载模拟器使用专门的AAOS系统镜像，该镜像包含车载特有的系统应用（如CarLauncher、CarSettings）、车辆属性服务（Vehicle Property Service）以及多屏显示支持。普通手机镜像无法模拟车载系统的这些特性。
• API差异：车载开发需要引入android.car.*包下的API，例如Car、CarInfoManager、CarUxRestrictionsManager等。这些API在标准Android SDK中并不包含，需要额外下载Android Automotive OS的SDK扩展包。
• 硬件抽象差异：车载系统需要与车辆CAN总线、传感器、多屏显示等硬件交互，模拟器通过虚拟化技术模拟这些硬件接口。开发者在模拟器上调试时，需要理解模拟器提供的虚拟硬件能力边界。

理解这些差异是搭建环境的前提。如果直接使用手机模拟器镜像进行车载开发，将无法调用车载专属API，也无法验证多屏交互逻辑，最终导致应用在真实车机上无法运行。

2.2 操作流程：从零搭建车载Android开发环境

本节将按照实际操作顺序，逐步讲解环境搭建的完整流程。整个过程大约需要30-60分钟，取决于网络速度和硬件性能。

2.2.1 安装JDK与Android Studio

车载Android开发要求JDK 17及以上版本。推荐使用OpenJDK 17或Oracle JDK 17。安装完成后，在终端执行java -version验证安装成功。Android Studio建议使用最新稳定版（截至2025年，推荐使用Ladybug或更高版本）。安装时勾选Android SDK、Android SDK Platform-Tools和Android Emulator组件。

# 验证JDK安装
java -version
# 输出示例
# openjdk version "17.0.9" 2023-10-17
# OpenJDK Runtime Environment (build 17.0.9+9-Ubuntu-122.04)
# OpenJDK 64-Bit Server VM (build 17.0.9+9-Ubuntu-122.04, mixed mode, sharing)

2.2.2 配置SDK Manager

打开Android Studio，进入Settings → Languages & Frameworks → Android SDK。在SDK Platforms标签页中，勾选以下组件：

在SDK Tools标签页中，确保勾选Android SDK Build-Tools、Android Emulator、Android SDK Platform-Tools。同时，建议安装Android Auto API和Android Automotive OS SDK扩展包，这些扩展包提供了车载开发所需的API库。

2.2.3 创建车载模拟器

打开AVD Manager（通过工具栏图标或Tools → AVD Manager），点击Create Virtual Device。在设备定义界面，选择Automotive分类下的参考设备，例如Automotive (1024p)或Automotive (1280x800)。这些设备定义已经预设了车载屏幕比例和分辨率。

在系统镜像选择界面，选择Android Automotive OS标签页，挑选对应API级别的镜像。推荐使用API 33或34的镜像，因为这两个版本对车载多屏支持更完善。点击Download完成镜像下载后，选择该镜像并点击Next。

在AVD配置界面，建议进行以下设置：

• Graphics：选择Hardware - GLES 2.0，确保GPU加速渲染。
• Device Frame：选择No Frame，避免模拟器窗口边框干扰。
• Memory and Storage：RAM建议分配2GB以上，内部存储8GB以上。
• Multi-Core：分配2-4个CPU核心，提升模拟器性能。

完成配置后，点击Finish。在AVD Manager列表中，点击启动按钮（绿色三角形）启动车载模拟器。首次启动可能需要3-5分钟，请耐心等待。

2.2.4 验证模拟器环境

模拟器启动后，通过adb命令验证连接状态：

# 查看设备列表
adb devices
# 输出示例
# List of devices attached
# emulator-5554   device

# 查看系统版本
adb shell getprop ro.build.version.release
# 输出示例
# 13

# 查看车载服务是否运行
adb shell service list | grep car
# 输出示例
# car_service: [android.car.ICarService]

如果car_service出现在服务列表中，说明车载系统服务已正常启动。此时，车载开发环境的基础部分已经搭建完成。

2.3 案例拆解：创建并运行第一个车载Android项目

本案例将创建一个最小化的车载Android应用，该应用能够读取车辆速度信息并显示在界面上。通过这个案例，读者可以验证整个开发环境是否正常工作，并了解车载API的基本调用方式。

2.3.1 项目创建与配置

在Android Studio中，选择New Project → Empty Activity，项目名称设为CarSpeedDemo，包名com.example.carspeed，语言选择Kotlin，最低SDK版本选择API 31（Android 12）。点击Finish完成创建。

创建完成后，需要修改build.gradle.kts（Module级）文件，添加车载依赖和配置：

android {
    compileSdk = 34
    defaultConfig {
        applicationId = "com.example.carspeed"
        minSdk = 31
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
}

dependencies {
    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.11.0")
    implementation("androidx.car.app:app-automotive:1.4.0")
    implementation("androidx.car.app:app-projected:1.4.0")
    // 车载API依赖
    implementation("com.android.car.ui:car-ui-lib:2.0.0")
    implementation("androidx.car:car:1.4.0")
}

同时，在AndroidManifest.xml中添加车载应用所需的权限和特性声明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.car.permission.CAR_SPEED" />
    <uses-permission android:name="android.car.permission.CAR_INFO" />
    <uses-feature android:name="android.hardware.type.automotive" android:required="true" />
    
    <application>
        <activity android:name=".MainActivity" android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

2.3.2 实现车载速度读取功能

在MainActivity.kt中，实现车载服务连接和速度读取逻辑：

package com.example.carspeed

import android.car.Car
import android.car.VehiclePropertyIds
import android.car.hardware.CarPropertyManager
import android.os.Bundle
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    private lateinit var car: Car
    private lateinit var carPropertyManager: CarPropertyManager
    private lateinit var speedText: TextView

    private val carServiceConnection = object : Car.CarServiceLifecycleListener {
        override fun onLifecycleChanged(car: Car, ready: Boolean) {
            if (ready) {
                carPropertyManager = car.getCarManager(Car.PROPERTY_SERVICE) as CarPropertyManager
                // 读取当前车速
                val speed = carPropertyManager.getProperty(
                    VehiclePropertyIds.PERF_VEHICLE_SPEED, 0
                )
                runOnUiThread {
                    speedText.text = "当前车速: ${speed?.value ?: 0.0f} km/h"
                }
            }
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        speedText = findViewById(R.id.speedText)
        car = Car.createCar(this, carServiceConnection)
        car.connect()
    }

    override fun onDestroy() {
        super.onDestroy()
        car.disconnect()
    }
}

在activity_main.xml中，添加一个居中显示的TextView用于展示速度信息。

2.3.3 部署与调试

确保车载模拟器已启动，点击Android Studio工具栏中的Run按钮（绿色三角形），选择目标设备为emulator-5554。应用将自动编译并部署到模拟器。部署成功后，模拟器屏幕上会显示应用界面，并展示当前模拟车速（模拟器默认车速为0）。

为了验证速度读取功能，可以通过adb命令模拟车速变化：

# 设置车速为60km/h
adb shell cmd car_service set-vehicle-property PERF_VEHICLE_SPEED 60.0

# 查看当前车速
adb shell cmd car_service get-vehicle-property PERF_VEHICLE_SPEED

执行上述命令后，应用界面上的速度值应更新为60 km/h。如果能够正常更新，说明车载环境搭建成功，车载API调用链路完整。

2.4 常见误区与总结复盘

在搭建车载开发环境的过程中，开发者经常遇到以下几类问题，这里进行集中说明：

总结来说，车载Android开发环境的搭建核心在于三点：正确的系统镜像、完整的SDK组件、合理的模拟器配置。三者缺一不可。建议开发者在搭建完成后，使用本章的案例进行验证，确保环境可用后再进行后续开发。