CarLibFundamentals - Android Car App Library Codelab

This project is built following the Android Car App Library Fundamentals Codelab. It demonstrates how to build a simple "Places" app that runs on Android Auto and Android Automotive OS using the Google-provided templates.

Overview

The application provides a list of places, displays them on a map, and allows users to see details for a specific location and initiate navigation.

Key Features

• Multi-Platform Support: Runs on both Android Auto and Android Automotive OS.
• Template-Based UI: Uses the Car App Library's specialized templates (PaneTemplate, PlaceListMapTemplate) to ensure a safe and consistent user experience while driving.
• Navigation Integration: Allows users to start navigation to a selected place using the CarContext.ACTION_NAVIGATE action.
• Bookmarking: Simple state management within the DetailScreen to toggle bookmarks for locations.
• Projection Status: A mobile app component that monitors and displays the current car connection status (Not connected, Projecting, or Native).

Screenshots

1. Hello World on Android Automotive

The initial implementation using a simple PaneTemplate to display a "Hello, world!" message.

2. Map on Android Automotive

Displaying a list of places alongside a map using the PlaceListMapTemplate. Each item includes a DistanceSpan and Metadata for map markers.

3. Location Details Screen

Detailed view of a selected place using PaneTemplate, showing coordinates, description, and actions for navigation and bookmarking.

Project Structure

• :app: The mobile application module. Contains the UI to show connection status.
• :automotive: The Automotive OS specific module.
• :common:car-app-service: A library module containing the CarAppService, Session, and Screen implementations shared across platforms.

Technologies Used

• Kotlin
• Jetpack Compose (for the mobile app UI)
• Android Car App Library
• Gradle Version Catalog (libs.versions.toml)

---

Based on the Google Developers Codelab.