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 ?

If you have questions or if you would like to send us feedback, join our Slack Channel or email us at support@high-mobility.com.