Android Auto Dashboard: Production-Ready Car App Rehberi 2026

1// build.gradle.kts (app modülü)
2dependencies {
3    // Car App Library core
4    implementation("androidx.car.app:app:1.5.0-beta01")
5 
6    // Navigation extension (RoutingTemplate için)
7    implementation("androidx.car.app:app-navigation:1.5.0-beta01")
8 
9    // Test utilities
10    testImplementation("androidx.car.app:app-testing:1.5.0-beta01")
11    androidTestImplementation("androidx.car.app:app-testing:1.5.0-beta01")
12}
13 
14android {
15    defaultConfig {
16        // Min API 23 (Android Auto), AAOS için 29+
17        minSdk = 23
18        targetSdk = 34
19    }
20}

1
2
3    android:name=".auto.MyCarAppService"
4    android:exported="true">
5    
6        
7        
8        
9    
10
11 
12
13
14    android:name="androidx.car.app.minCarApiLevel"
15    android:value="3" />

1class MyCarAppService : CarAppService() {
2 
3    override fun createHostValidator(): HostValidator {
4        // Production'da ALLOWED_HOSTS_SYSTEM_RELEASE kullan
5        // Debug'da ALLOW_ALL_HOSTS_VALIDATOR
6        return if (BuildConfig.DEBUG) {
7            HostValidator.ALLOW_ALL_HOSTS_VALIDATOR
8        } else {
9            HostValidator.Builder(applicationContext)
10                .addAllowedHosts(R.array.hosts_allowlist_sample)
11                .build()
12        }
13    }
14 
15    override fun onCreateSession(): Session {
16        return MySession()
17    }
18}
19 
20class MySession : Session() {
21 
22    override fun onCreateScreen(intent: Intent): Screen {
23        // İlk screen'i döndür
24        return MainMenuScreen(carContext)
25    }
26 
27    override fun onNewIntent(intent: Intent) {
28        // Deep link veya notification tap handling
29        val action = intent.action
30        if (action == "com.myapp.ACTION_NAVIGATE") {
31            val destination = intent.getStringExtra("destination")
32            screenManager.push(NavigationScreen(carContext, destination))
33        }
34    }
35 
36    override fun onCarConfigurationChanged(newConfiguration: Configuration) {
37        // Araç config değişti (gece/gündüz modu, vs.)
38        screenManager.top.invalidate()
39    }
40}
41 
42class MainMenuScreen(carContext: CarContext) : Screen(carContext) {
43 
44    override fun onGetTemplate(): Template {
45        val listBuilder = ItemList.Builder()
46 
47        listBuilder.addItem(
48            Row.Builder()
49                .setTitle("Navigasyon")
50                .setImage(
51                    CarIcon.Builder(
52                        IconCompat.createWithResource(carContext, R.drawable.ic_navigation)
53                    ).build()
54                )
55                .setOnClickListener { screenManager.push(NavigationScreen(carContext, null)) }
56                .build()
57        )
58 
59        listBuilder.addItem(
60            Row.Builder()
61                .setTitle("Müzik")
62                .setOnClickListener { screenManager.push(MediaScreen(carContext)) }
63                .build()
64        )
65 
66        return ListTemplate.Builder()
67            .setTitle("Ana Menü")
68            .setHeaderAction(Action.APP_ICON)
69            .setSingleList(listBuilder.build())
70            .build()
71    }
72}

1class MusicService : MediaBrowserServiceCompat() {
2 
3    private lateinit var mediaSession: MediaSessionCompat
4    private lateinit var notificationManager: MediaNotificationManager
5 
6    companion object {
7        const val ROOT_ID = "root"
8        const val CATEGORY_SONGS = "songs"
9        const val CATEGORY_ALBUMS = "albums"
10        const val CATEGORY_PLAYLISTS = "playlists"
11    }
12 
13    override fun onCreate() {
14        super.onCreate()
15 
16        mediaSession = MediaSessionCompat(this, "MusicService").apply {
17            setCallback(MediaSessionCallback())
18            isActive = true
19        }
20        sessionToken = mediaSession.sessionToken
21    }
22 
23    override fun onGetRoot(
24        clientPackageName: String,
25        clientUid: Int,
26        rootHints: Bundle?
27    ): BrowserRoot? {
28        // Android Auto host'unu doğrula
29        val isAndroidAuto = rootHints
30            ?.getBoolean(MediaConstants.BROWSER_ROOT_HINTS_KEY_MEDIA_ART_SIZE_PIXELS) != null
31 
32        return if (isAndroidAuto || isValidCaller(clientPackageName, clientUid)) {
33            BrowserRoot(ROOT_ID, null)
34        } else {
35            // Bilinmeyen client → sadece root ver
36            BrowserRoot(ROOT_ID, Bundle().apply {
37                putBoolean(MediaConstants.BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED, false)
38            })
39        }
40    }
41 
42    override fun onLoadChildren(
43        parentId: String,
44        result: Result>
45    ) {
46        result.detach() // Async yükleme için
47 
48        when (parentId) {
49            ROOT_ID -> loadRootItems(result)
50            CATEGORY_SONGS -> loadSongs(result)
51            CATEGORY_ALBUMS -> loadAlbums(result)
52            CATEGORY_PLAYLISTS -> loadPlaylists(result)
53            else -> result.sendResult(emptyList())
54        }
55    }
56 
57    private inner class MediaSessionCallback : MediaSessionCompat.Callback() {
58        override fun onPlay() {
59            // Playback başlat
60            mediaSession.isActive = true
61            startForeground()
62        }
63 
64        override fun onSkipToNext() { /* Sonraki şarkı */ }
65        override fun onSkipToPrevious() { /* Önceki şarkı */ }
66        override fun onSeekTo(pos: Long) { /* Seek */ }
67 
68        override fun onPlayFromMediaId(mediaId: String?, extras: Bundle?) {
69            // Belirli bir şarkıyı oynat
70            val track = repository.getTrack(mediaId ?: return)
71            playTrack(track)
72        }
73    }
74}

1class NavigationScreen(
2    carContext: CarContext,
3    private val destination: String?
4) : Screen(carContext) {
5 
6    private var isNavigating = false
7    private var places: List = emptyList()
8 
9    override fun onGetTemplate(): Template {
10        return if (isNavigating) {
11            buildRoutingTemplate()
12        } else {
13            buildPlaceListMapTemplate()
14        }
15    }
16 
17    private fun buildPlaceListMapTemplate(): Template {
18        val itemListBuilder = ItemList.Builder()
19 
20        places.forEach { place ->
21            itemListBuilder.addItem(
22                Row.Builder()
23                    .setTitle(place.name)
24                    .addText(place.address)
25                    .addText("${place.distanceKm} km")
26                    .setMetadata(
27                        Metadata.Builder()
28                            .setPlace(
29                                Place.Builder(
30                                    CarLocation.create(place.lat, place.lng)
31                                )
32                                .setMarker(
33                                    PlaceMarker.Builder()
34                                        .setColor(CarColor.PRIMARY)
35                                        .build()
36                                )
37                                .build()
38                            )
39                            .build()
40                    )
41                    .setOnClickListener { startNavigation(place) }
42                    .build()
43            )
44        }
45 
46        return PlaceListMapTemplate.Builder()
47            .setTitle("Yakındaki Yerler")
48            .setItemList(itemListBuilder.build())
49            .setHeaderAction(Action.BACK)
50            .setCurrentLocationEnabled(true)
51            .build()
52    }
53 
54    private fun buildRoutingTemplate(): Template {
55        val navigationInfo = NavigationTemplate.NavigationInfo.Builder()
56            .setCurrentStep(
57                Step.Builder("500m sonra sağa dönün")
58                    .setManeuver(
59                        Maneuver.Builder(Maneuver.TYPE_TURN_RIGHT).build()
60                    )
61                    .setStepIconType(Step.MANEUVER_ICON_TYPE_TURN_NORMAL)
62                    .build()
63            )
64            .setDistanceToStep(
65                Distance.create(500.0, Distance.UNIT_METERS)
66            )
67            .build()
68 
69        return NavigationTemplate.Builder()
70            .setNavigationInfo(navigationInfo)
71            .setActionStrip(
72                ActionStrip.Builder()
73                    .addAction(
74                        Action.Builder()
75                            .setTitle("Bitir")
76                            .setOnClickListener { stopNavigation() }
77                            .build()
78                    )
79                    .build()
80            )
81            .build()
82    }
83 
84    private fun startNavigation(place: Place) {
85        isNavigating = true
86        // Navigasyon servisini başlat
87        invalidate()
88    }
89 
90    private fun stopNavigation() {
91        isNavigating = false
92        invalidate()
93    }
94}

1// Yalnızca araç park halindeyken çalışacak listener
2Row.Builder()
3    .setTitle("Detaylı Ayarlar")
4    .setOnClickListener(
5        ParkedOnlyOnClickListener.create {
6            screenManager.push(SettingsScreen(carContext))
7        }
8    )
9    .build()
10 
11// Araç hız durumunu kontrol etme
12val carHardwareManager = carContext.getCarService(CarHardwareManager::class.java)
13carHardwareManager.carSensors.addCarSpeedListener(
14    CarExecutor.create(mainExecutor)
15) { speed ->
16    val isParked = speed.speed.value?.let { it < 0.5f } ?: true
17    updateUIForDrivingState(!isParked)
18}

1class HardwareButtonHandler(private val carContext: CarContext) {
2 
3    private val carHardwareManager =
4        carContext.getCarService(CarHardwareManager::class.java)
5 
6    fun registerButtonCallbacks() {
7        // Ses kontrol butonları
8        carHardwareManager.carAudioCallback.addVolumeChangeCallback(
9            CarExecutor.create(mainExecutor)
10        ) { volumeState ->
11            handleVolumeChange(volumeState)
12        }
13 
14        // Merkez buton (rotary knob tıklama)
15        // Bu işlem template action'ları üzerinden dolaylı yönetilir
16        // Direkt hardware button mapping sadece AAOS'ta desteklenir
17    }
18 
19    private fun handleVolumeChange(state: CarVolume) {
20        // Volume bar update
21        currentVolume = state.muted?.value?.let {
22            if (it) 0f else (state.volumePercentage?.value ?: 50f)
23        } ?: 50f
24    }
25}
26 
27// Theming: CarColor system
28object AppCarColors {
29    val primaryColor = CarColor.createCustom(
30        Color.parseColor("#6200EE"), // Light mode
31        Color.parseColor("#BB86FC")  // Dark mode (araç gece modu)
32    )
33 
34    val accentColor = CarColor.createCustom(
35        Color.parseColor("#03DAC6"),
36        Color.parseColor("#018786")
37    )
38}

1fun isAndroidAutomotiveOS(carContext: CarContext): Boolean {
2    return carContext.packageManager.hasSystemFeature(
3        PackageManager.FEATURE_AUTOMOTIVE
4    )
5}
6 
7// Veya API level kontrolü ile
8fun supportsAdvancedFeatures(carContext: CarContext): Boolean {
9    return carContext.carAppApiLevel >= 7 // Car App 1.5+
10}
11 
12// AAOS'a özel: araç sensörleri
13fun readFuelLevel(carContext: CarContext): Flow = flow {
14    if (!isAndroidAutomotiveOS(carContext)) return@flow
15 
16    val carHardwareManager = carContext.getCarService(CarHardwareManager::class.java)
17    carHardwareManager.carInfo.addFuelLevelListener(
18        CarExecutor.create(Dispatchers.IO.asExecutor())
19    ) { fuelLevel ->
20        fuelLevel.percent.value?.let { trySend(it) }
21    }
22    awaitClose()
23}