Explore AutoAPIs

This is a sample app that shows a possible use case for HMKit. We connect to a vehicle/emulator via Bluetooth or Telematics and send some commands like lock doors and turn on lights.

Requirements

Android 5.0 Lollipop or higher.

Dependencies

hmkit-android
auto-api-java
command-queue-android
sandbox-ui

Dependencies are managed via gradle repositories.

Install

run git submodule update --init --recursive
Import the Gradle project with Android Studio 3+.
Initialise the HMKit with a certificate from the Developer Center. The flow is described in the comments of the BaseActivity.java
Run BaseActivity.java.

After initialisation, the sandboxui module is loaded. All of the app logic is in that package.

Instrumentation tests

Instrumentation tests cover bluetooth and telematics commands. For them to work, ble-explorer-app/src/main/java/res/values/credentials.xml should have the following keys:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="environment">prod</string> <!-- dev or prod -->
    <!-- name prefix is either dev or prod, according to the environment  -->
    <string name="prodAccessToken"></string>
    <string name="prodDeviceCert"></string>
    <string name="prodPrivateKey"></string>
    <string name="prodIssuerPublicKey"></string>
    <string name="prodWebUrl"></string>
    <string name="prodVehicleSerial"></string>
</resources>

An emulator should be opened with these credentials. If the phone vibrates, bluetooth should manually be connected in the emulator.

Questions or Comments ?