Run demo with Embedded Integration

Introduction

In four steps you will be able to run the navigation-integrating demo application on your Android device.
All available examples demonstrate the use of API functions for communicating with navigation core, and thus they illustrate designs of simple applications.
You need to have the Android Studio installed on your computer. If you don't have it please follow Download Android Studio.

Step 1 : Download package

Download the navigation+sdk package zip with our Contact form.
Make sure Android as Operating system is selected in the contact form.
You will receive the download link to your email in few seconds (use the one with suffix Integrated).
The package contains:

  • Navigation application as apk with resources files inside the folder Navigation
  • Demo application source code and supporting libraries inside the folder SDK/Examples

After downloading please unzip it locally on your computer. It should look as follows:

Navigation\
   Sygic3D\
       SygicLib\
SDK\
   Examples\
   Lib\
      3d.integ\
         SygicLib.aar

Step 2 : Build the demo example using Eclipse

Open any of the existing demo example projects contained in the package via Android Studio.
Each project represents single example and you can find it as a subfolder on the path SDK/Examples/.
Each project is preconfigured for a single click compilation, which generates .apk (e.g. IntegDemo3D.apk), in short Demo.apk.
Select one example for importing into Android Studio for compilation. The following demo examples are available:

  • SDK/Examples/IntegDemo3D
    demonstrates api usecases using 3D navigation engine
    The example is set to be bound to the product version Sygic Professional Navigation.

In case you have a problem with compilation there is a precompiled apk in the package inside SDK/Examples/XXX/precompiled.

Step 3 : Install apk's on your Android device

The previous step resulted in generating Demo.apk.
This step is to copy the apk and resources to Android device's SD card.
There are few alternatives depending on your Android OS and whether you have external SD card or not.

Alternative 1: With the Android OS versions up to 4.4.x Kitkat do the copy as follows:

  • copy SygicLib resources folder to sdcard root (e.g copy Navigation/Sygic3D/SygicLib to sdcard/)
  • copy Demo.apk to sdcard root (e.g. copy IntegDemo3D.apk to sdcard/)

The setup on your device might look as follows:

sdcard\
  IntegDemo3D.apk
  SygicLib\

Alternative 2: With the Android OS versions past 4.4.x KitKat do the copy as follows:

  • copy SygicLib resources folder to internal memory (e.g copy Navigation/Sygic3D/SygicLib to Android/data/com.sygic.integdemo3d/files/SygicLib)
  • copy Demo.apk to internal memory (e.g. copy IntegDemo3D.apk to Android/data/com.sygic.integdemo3d/files/)

The setup on your device might look as follows:

Android/data/com.sygic.integdemo3d/files/
  IntegDemo3D.apk
  SygicLib\

The all you need is to install the apk in a standard way by clicking on apk through e.g. a File Manager.
In case of installation question (install to internal memory or SD card), select internal memory.

Step 4 : Run the example

After successful installation of apk an icon appear on your Android device. Click on the Demo icon, which will run the navigation demo example.