Installing the Pepper SDK plug-in

To develop an Android robot application, you need to set up your development environment as follows.

Check Compatibility

Make sure your computer runs one of the supported Operating System:

OS Version
Linux Ubuntu 16.04 Xenial Xerus - 64bits only
Windows Microsoft Windows 10 - 64bits only
Mac Mac OS X 10.12 Sierra

Install Android Studio

Robot application runs on the built-in Android tablet of the robot and therefore to develop the application, Android Studio must be installed.

Requirements
Android Studio

Version 2.3 or Higher

We recommend installing the latest stable version.

Java Development Kit (JDK) System Requirements of Android Studio

To install Android Studio, follow the installation guide available here: http://developer.android.com/sdk/index.html


Get Android SDK and Build-Tools

To develop an Android application, you need to install Android SDK and its Build-Tools:

Step Action

From Android Studio Tool bar, click the SDK Manager sdk. The SDK Manager appears.

../_images/sdk_manager_win.png

Download and install Android SDK version 6.0 (API 23, Marshmallow).

../_images/android_sdk_install.png

Note: As backwards compatibility is supported, you can install SDK version 6.0 (API 23) or lower.

Download and install SDK Build-Tools

SDK Build-tools such as Emulator/Android Debug Bridge are also required. Download and install the same version of SDK Build-tools as the installed Android SDK.

../_images/android_build_tools_install.png

Note: The system image for Android Virtual Device (AVD) environment is described in Get Robot SDK and tools section.

Virtualization tools installation

Warning

Virtualization tool is required to launch the Robot Emulator.

Enable Virtualization

Warning

Virtualization is required to launch the Robot Emulator.

Make sure virtualization Technology is enabled in BIOS.

Bonjour

You will need Bonjour to easily connect to a robot.

Make sure Bonjour version 2.0.2.0 or later is installed on your computer. On Mac and Ubuntu, it should be installed by default, but it is not the case on Windows.

On Windows, make sure you follow the Additional steps for Windows section.

Additional steps for Windows

Windows configuration requires additional actions:

Windows only: install Bonjour 2.0.2.0

To download and install Bonjour for Windows, please visit its official site: http://support.apple.com/kb/DL999

Windows only: check C++ Redistributable Packages

On windows 10, make sure you have installed:

Step Action

Microsoft Visual Studio C++ 2010 x64 Redistributable Package

You can download the vcredist_x64.exe package here:: Microsoft Visual C++ 2010 Redistributable Package (x64)

Microsoft Visual Studio C++ 2013 Redistributable Package (x64)

You can download the vcredist_x64.exe package here: Microsoft Visual C++ Redistributable Packages for Visual Studio 2013

Windows only: workaround for emulator issue

Step Action
In the C:\Users\[yourUserName]\.android folder, find or create a file called advancedFeatures.ini.

Add the following line to advancedFeatures.ini:

WindowsHypervisorPlatform = off


Get Pepper SDK Plugin

Reminder: before installing Pepper SDK Plugin, you should have downloaded and installed: Android Studio, Java Development Kit (JDK), Android Tools and Bonjour.

This section shows how to install Pepper SDK Plugin in Android Studio for developing robot applications.

Step Action

From Android Studio Settings/Preferences, select Plugins sub-menu,

then click the Browse repositories… button.

../_images/plugins_step1.png
Enter “Pepper” in the search bar, in order to find Pepper SDK.

Select Pepper SDK and click the Install plugin button.

../_images/plugins_step2.png
Restart Android Studio.

Check the File > New menu: robot plugin menus should appear.

../_images/plugins_step3.png

Note

Can’t see the Robot SDK Manager image7 icon?

Choose View / Toolbar and make sure it is checked.

Get Robot SDK and tools

Once Pepper SDK Plugin is installed, your last step for setting up the environment is to download the tools for developing robot application.

Step Action

From Android Studio menu bar, click the Robot SDK Manager image7.

Note

Can’t see the Robot SDK Manager image7 icon?

Choose View / Toolbar and make sure it is checked.

Check the target API version you want to develop your robot application in and click the Apply button.

../_images/robot_sdk_manager_win.png

Warning

Each time you download a new target API version, you must robotify your project again. For more details, see Creating a robot application.

Robot SDK Content

AVD

(Android Virtual Device):

AVD system image same as the robot tablet image. Provides x86 and armeabi architectures.

Tools Robot Emulator and tools for developing robot application, such as Robot Viewer, Robots Browser, Trajectory, etc.

You are ready!

It is now time to create a robot application.


Troubleshooting

On Ubuntu

  • The message /dev/kvm is not found appears.

    Go into the BIOS and enable virtualization Technology.

    For further details, see: Enable Virtualization.

On Windows 10

  • The following message appears:

    C:\Users\jdoe\AppData\Local\Android\Sdk\emulator\emulator-x86.exe: invalid option -- '-enable-whpx'

    Workaround

    Step Action
    In the C:\Users\[yourUserName]\.android folder, find or create a file called advancedFeatures.ini.

    Add the following line to advancedFeatures.ini:

    WindowsHypervisorPlatform = off

    For further details, see: Windows only: workaround for emulator issue.

  • Connection to a real or virtual robot is impossible and log contains:

    java.lang.UnsatisfiedLinkError: C:\Users\[yourUserName]\AppData\Local\Temp\qi.dll

    The error may be caused by space character your session name [yourUserName].

    Workaround

    Make sure that your session name [yourUserName] doesn’t contain any space character.

  • Black screen on AVD (virtual tablet)

    Latest HAXM version 7.3.0 prevents the launch of the virtual tablet.

    Workaround

    In SDK Manager, If HAXM is version 7.3.0:

    1. Uninstall it.

    2. Install previous HAXM version 7.2.0:

      https://github.com/intel/haxm/releases/download/v7.2.0/haxm-windows_v7_2_0.zip

    For further details, see: Get Android SDK and Build-Tools.

On Mac OS