Introduction to Android Automotive OS (AAOS) and Custom Navigation

Android Automotive OS (AAOS) represents a paradigm shift in in-car infotainment systems, providing a full-stack Android operating system directly integrated into the vehicle’s hardware. This open platform empowers developers to create bespoke applications tailored for the automotive environment, ranging from media players to critical navigation tools. While Google Maps is the default navigation solution, specific use cases — such as fleet management, remote area operations, or privacy-focused deployments — often necessitate custom navigation applications with robust offline mapping capabilities. This article will guide you through building a foundational AAOS custom navigation app, focusing on integrating offline map data using a popular mapping SDK.

Understanding the AAOS Navigation Ecosystem

Developing for AAOS is similar to traditional Android development but with key distinctions. Navigation apps on AAOS must adhere to strict driver distraction guidelines. This often means simplifying user interfaces, increasing target sizes, and prioritizing voice commands. While AAOS provides access to vehicle sensor data, for core mapping functionalities, you’ll leverage standard Android location services and third-party map SDKs. The primary challenge is ensuring a seamless, safe, and efficient user experience tailored for a vehicle context.

Why Offline Maps?

Offline maps are crucial for custom navigation apps in several scenarios:

• Remote Areas: Guiding drivers through regions with patchy or no cellular network coverage.
• Cost Efficiency: Reducing data usage, particularly in international roaming or large fleet operations.
• Reliability: Ensuring navigation functionality even during network outages or service disruptions.
• Performance: Faster map rendering and route calculations without relying on constant network requests.

Project Setup: Your AAOS Android Studio Project

First, ensure you have Android Studio installed. Create a new project and select the ‘Automotive’ tab. Choose ‘No Activity’ as the template for maximum control, or ‘Navigation’ if you want a basic structure to start from. For this tutorial, we’ll assume a ‘No Activity’ start.

Configure `build.gradle` (Module Level)

Add the necessary dependencies. We will use Mapbox SDK for our offline map integration due to its extensive features and offline capabilities. Remember to replace `x.y.z` with the latest stable versions.

android {    compileSdk 33    defaultConfig {        minSdk 29 // AAOS minimum API level is 29 (Android 10)        targetSdk 33    }    buildFeatures {        viewBinding true    } }  dependencies {    implementation 'androidx.core:core-ktx:1.9.0'    implementation 'androidx.appcompat:appcompat:1.6.1'    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'    implementation 'com.google.android.material:material:1.8.0'     // Mapbox dependencies    implementation 'com.mapbox.mapboxsdk:mapbox-android-sdk:10.11.0'    implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-annotation-v9:0.9.0'    implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-locationlayer-v9:0.11.0'    implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-offline-v9:0.7.0' } 

In your project-level `build.gradle`, ensure you have the Mapbox Maven repository:

allprojects {    repositories {        google()        mavenCentral()        maven { url 'https://api.mapbox.com/downloads/v2/releases/maven' }    } } 

AndroidManifest.xml Permissions

Your app will need internet access, location permissions, and storage permissions for offline maps. Add these to your `AndroidManifest.xml`:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"     package="com.example.aaosnavigationapp">      <uses-permission android:name="android.permission.INTERNET" />     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="28" />     <uses-feature android:name="android.hardware.location.gps" />     <uses-feature android:name="android.hardware.location.network" />      <application         ...         <activity android:name=".MainActivity"             android:exported="true">             <intent-filter>                 <action android:name="android.intent.action.MAIN" />                 <category android:name="android.intent.category.LAUNCHER" />                 <category android:name="android.intent.category.APP_CAR_LAUNCHER" />             </intent-filter>         </activity>     </application> </manifest> 

Note `APP_CAR_LAUNCHER` category is essential for AAOS. For Android 10 (API 29) and above, storage permissions for `WRITE_EXTERNAL_STORAGE` are generally deprecated for app-specific storage. Mapbox will manage its storage within your app’s dedicated internal storage, so explicit `WRITE_EXTERNAL_STORAGE` might only be needed for older Android versions or specific custom scenarios where you manage external files directly. We include them with `maxSdkVersion` for broader compatibility.

Mapbox Integration and Display

Before you can display a map, you need a Mapbox access token. Sign up on mapbox.com, go to your account dashboard, and retrieve your public access token. Add this to your `strings.xml` or directly in code (for simplicity here, we’ll use a direct string, but `strings.xml` is better practice).

`activity_main.xml` Layout

Create a layout file (e.g., `activity_main.xml`) with a `MapView`:

<?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"     xmlns:app="http://schemas.android.com/apk/res-auto"     xmlns:mapbox="http://schemas.android.com/apk/res-auto"     xmlns:tools="http://schemas.android.com/tools"     android:layout_width="match_parent"     android:layout_height="match_parent"     tools:context=".MainActivity">      <com.mapbox.mapboxsdk.maps.MapView         android:id="@+id/mapView"         android:layout_width="0dp"         android:layout_height="0dp"         mapbox:mapbox_cameraTargetLat="40.7128"         mapbox:mapbox_cameraTargetLng="-74.0060"         mapbox:mapbox_cameraZoom="12"         mapbox:mapbox_styleUrl="mapbox://styles/mapbox/navigation-day-v1"         app:layout_constraintBottom_toBottomOf="parent"         app:layout_constraintEnd_toEndOf="parent"         app:layout_constraintStart_toStartOf="parent"         app:layout_constraintTop_toTopOf="parent" />  </androidx.constraintlayout.widget.ConstraintLayout> 

`MainActivity.kt` Initialization

Initialize Mapbox and the `MapView` in your `MainActivity`.

package com.example.aaosnavigationapp  import android.Manifest import android.content.pm.PackageManager import android.os.Bundle import android.widget.Toast import androidx.appcompat.app.AppCompatActivity import androidx.core.app.ActivityCompat import androidx.core.content.ContextCompat import com.mapbox.mapboxsdk.Mapbox import com.mapbox.mapboxsdk.maps.MapView import com.mapbox.mapboxsdk.maps.MapboxMap import com.mapbox.mapboxsdk.maps.OnMapReadyCallback import com.mapbox.mapboxsdk.maps.Style  class MainActivity : AppCompatActivity(), OnMapReadyCallback {      private lateinit var mapView: MapView     private lateinit var mapboxMap: MapboxMap      private val REQUEST_CODE_LOCATION_PERMISSION = 1001     private val MAPBOX_ACCESS_TOKEN = "YOUR_MAPBOX_ACCESS_TOKEN" // Replace with your actual token      override fun onCreate(savedInstanceState: Bundle?) {         super.onCreate(savedInstanceState)         Mapbox.getInstance(applicationContext, MAPBOX_ACCESS_TOKEN)         setContentView(R.layout.activity_main)          mapView = findViewById(R.id.mapView)         mapView.onCreate(savedInstanceState)         mapView.getMapAsync(this)          checkLocationPermission()     }      override fun onMapReady(mapboxMap: MapboxMap) {         this.mapboxMap = mapboxMap         mapboxMap.setStyle(Style.NAVIGATION_DAY) {             // Map is set up and ready to be used             // You can add markers, routes, or location tracking here             Toast.makeText(this, "Map is ready!", Toast.LENGTH_SHORT).show         }     }      private fun checkLocationPermission() {         if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {             ActivityCompat.requestPermissions(                 this,                 arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),                 REQUEST_CODE_LOCATION_PERMISSION             )         }     }      override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {         super.onRequestPermissionsResult(requestCode, permissions, grantResults)         if (requestCode == REQUEST_CODE_LOCATION_PERMISSION) {             if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {                 Toast.makeText(this, "Location permission granted", Toast.LENGTH_SHORT).show             } else {                 Toast.makeText(this, "Location permission denied", Toast.LENGTH_LONG).show             }         }     }      // Lifecycle methods for MapView      override fun onStart() {         super.onStart()         mapView.onStart()     }      override fun onResume() {         super.onResume()         mapView.onResume()     }      override fun onPause() {         super.onPause()         mapView.onPause()     }      override fun onStop() {         super.onStop()         mapView.onStop()     }      override fun onSaveInstanceState(outState: Bundle) {         super.onSaveInstanceState(outState)         mapView.onSaveInstanceState(outState)     }      override fun onLowMemory() {         super.onLowMemory()         mapView.onLowMemory()     }      override fun onDestroy() {         super.onDestroy()         mapView.onDestroy()     } } 

Implementing Offline Maps with Mapbox

Mapbox allows you to define and download specific regions for offline use. This involves creating an `OfflineManager` and an `OfflineRegion`. Ensure you have the `mapbox-android-plugin-offline-v9` dependency added.

Downloading an Offline Region

To download a region, you’ll need to define its geographic bounds (e.g., a `LatLngBounds`), the zoom levels you want to include, and a style URL. It’s best to trigger this download from a user-initiated action, perhaps in a separate activity or dialog.

import com.mapbox.mapboxsdk.offline.OfflineManager import com.mapbox.mapboxsdk.offline.OfflineRegionDefinition import com.mapbox.mapboxsdk.offline.OfflineTilePyramidRegionDefinition import com.mapbox.mapboxsdk.geometry.LatLngBounds import com.mapbox.mapboxsdk.offline.OfflineRegion import com.mapbox.mapboxsdk.offline.OfflineRegionStatus import com.mapbox.mapboxsdk.offline.OfflineRegionError  // ... inside MainActivity or a dedicated OfflineMapManager class  private fun downloadOfflineRegion(name: String, bounds: LatLngBounds, minZoom: Double, maxZoom: Double, styleUrl: String) {     val definition = OfflineTilePyramidRegionDefinition(         styleUrl,         bounds,         minZoom,         maxZoom,         resources.displayMetrics.density     )      // Convert name to a byte array     val metadata = try {         "{"name":"$name"}".toByteArray(charset("UTF-8"))     } catch (e: Exception) {         null     }      OfflineManager.getInstance(this).createOfflineRegion(definition, metadata, object : OfflineManager.CreateOfflineRegionCallback {         override fun onCreate(offlineRegion: OfflineRegion) {             offlineRegion.setDownloadState(OfflineRegion.STATE_ACTIVE)             offlineRegion.setObserver(object : OfflineRegion.OfflineRegionObserver {                 override fun onStatusChanged(status: OfflineRegionStatus) {                     val percentage = status.percentageDownload().toInt()                     if (status.is =

        
        
        

            

                
            
            

                
Android Mobile Specs & Compare Directory
                
Are you researching mobile hardware properties, processor SoCs, GPU chipsets, or RAM configurations? Access our complete specs catalog to compare up to 5 devices side-by-side!
                Compare Devices Specs →