This directory contains sample apps that use Android for Cars App Library. Please find the library documentation at https://developer.android.com/training/cars/navigation.
In order to build app APKs,
Open the project in Android Studio: File -> Open -> Select this directory and click OK.
Select a sample app directory (e.g. showcase
) in the Project Structure
UI on the top left. Each sample app has two build targets, showcase/mobile
is for the projected
platform and showcase/automotive
is for the embedded
platform.
Go to Build -> Make Module 'androidx.car.app.app-samples.<sample_app>.<platform>'
. The apks will be generated in <sample_app>/<platform>/build/outputs/apk
.
In order to install and run the apps,
Open the AndroidX project in Android Studio.
Go to Run -> Edit Configurations
, select a sample app target (e.g. car.app.app-samples .showcase-mobile
). If you are building for the mobile
platform, also select Launch: Nothing
in General -> Launch Options
. Click OK
to close the dialog.
Select Run -> Run <sample_app>
, to run the app, which will just install it in the selected device.
Open the project in Android Studio to download the gradle wrapper files.
Run ./gradlew :<sample_app>:<platform>:assemble
to assemble the APKs. E.g.
./gradlew :showcase:mobile:assemble ./gradlew :showcase:automotive:assemble
The APK should be generated under the sample app’s build directory, e.g. <sample_app>/<platform>/build/outputs/apk/debug
.
If you see this error during the build:
```shell > SDK location not found. Define location with an ANDROID_SDK_ROOT environment variable or by setting the sdk.dir path in your projects local properties file at <project_path >/local.properties ```
Create local.properties
file under the project directory, and copy the following line:
``` sdk.dir = <your android sdk directory path> ```
adb install <path_to_sample_app_apk>
Follow the instructions in Test Android apps for cars to run the sample apps in the DHU.
In short, do the following:
Note: In Android Q, there is no Android Auto app in the launcher. The way to get to the settings in that case is through Settings -> Apps & Notifications -> See all apps -> Android Auto -> Advanced -> Additional settings in the app.
In order to use the Automotive OS emulator, download the Android Studio 4.2 or higher (currently only available in the Beta and Canary tracks), and do the following: