Skip to content

Getting started

This guide takes you from zero to your first uploaded build on the vehicle app store.

1. Register an account

Open the developer portal and register with your email address. After verifying your email, you can sign in and start creating apps. Each developer sees and manages only their own apps.

2. Create an app

In the portal, create a new app and provide its package name (the Android applicationId, e.g. com.example.myapp). The package name is unique per store and cannot be changed later, so choose it carefully.

3. Project structure overview

A typical Android Automotive OS app you publish here looks like this:

myapp/
├── build.gradle.kts # applicationId, versionCode/versionName, signing, R8
├── src/main/
│ ├── AndroidManifest.xml # automotive feature + permissions (see "Building for AAOS")
│ └── res/ # icons, strings, automotive descriptor
└── ...

4. Upload your first build

You can upload a build in two ways:

  • Portal UI — drag and drop your APK; validation runs immediately.
  • CI upload API — push a new revision from your pipeline with a token (see Upload process).

After upload, the platform runs automated validation and pre-fills version fields from the build’s manifest. Fix any findings, complete your store listing, and submit the version for review.

Next steps