OS | Version |
---|---|
Linux | Ubuntu 12.04 LTS (Precise) and later |
Mac | Mac OS X 10.7.1 Lion Mac OS X 10.8.3 Mountain Lion |
Windows | Microsoft Windows XP Service Pack 3, Microsoft Windows 7 and 8 |
Steps | comment |
---|---|
A - Compiler and IDE | Make sure you have the required tools. |
B - Cross-platform build system | |
C - SDK Installation | Follow step by step the installation guides |
D - qiBuild Installation | |
E - Compile and run an example |
OS | Compiler and IDE |
---|---|
Linux | GCC version 4.4 or higher and a recent version of QtCreator. |
Windows | Visual Studio 2008 or Visual Studio 2010. |
Mac | XCode, use the version corresponding to your Mac OS X (Snow Leopard or Lion), and a recent version of QtCreator. |
On Mac and Linux you can also use Eclipse if you are used to it.
Additionally to the C++ SDK, you will have to install qiBuild, a tool designed to generate cross-platform projects using CMake.
CMake generates makefiles and workspaces for any operating system, making the project able to be compiled simply on Windows, Mac, Linux and NAOqi OS.
The table below lists the prerequisites to qiBuild installation.
Requirement | Comments |
---|---|
CMake version 2.8.3 or higher | On Linux: Use the cmake package provided by your distribution. On Windows and Mac:
|
Python 2.7 | On Windows: To use scripts written in Python, you have to put in your PATH: C:\Python27 and c:\Python27\Scripts |
Step | Action |
---|---|
Checking SDK prerequisites Make sure you have installed one of the recommended compilers and IDE. For further details, see A - Compiler and IDE. |
|
Retrieving C++ SDK Retrieve the C++ SDK archive:
You can download the latest release from Aldebaran Community Website: https://community.aldebaran-robotics.com/ Be careful to select the archive corresponding to your Operating System (Windows, Mac or Linux). For Windows, choose win32-vs2008 if you are using Visual Studio 2008, or win32-vs2010 if you are using Visual Studio 2010. |
|
Extract it on your machine (we’ll assume that the extracted folder is called naoqi-sdk). | |
Create an EMPTY folder where you want to store your C++ SDK (let’s call it /path/to/SDKfolder). Open a Command Prompt and go to that folder. Type this command in order to create a worktree. $ qibuild init
|
|
Then copy your folder naoqi-sdk into your SDK folder. You should then have something like: /path/to/SDKfolder/naoqi-sdk |
Step | Action |
---|---|
Checking qiBuild prerequisites Make sure you have installed CMake and Python. For further details, see B - Cross-platform build system. |
|
Installing qiBuild Follow the Installation step of the: qiBuild documentation - Getting started, and only this step, then come back to this page. |
|
Configuring qiBuild Run: $ qibuild config --wizard
You will be prompted to specify:
It is advised to use ‘Unix Makefiles’ on Linux and Mac, and ‘Visual Studio’ on Windows. Note that you can still re-run the config wizard anytime you want. Result: a file is generated in ~/.config/qi/qibuild.xml. It is shared by all the worktrees you will create. |
Step | Action |
---|---|
In your SDK folder, enter the subfolder doc/dev/cpp/examples using your Command Prompt. $ cd /path/to/SDKfolder/naoqi-sdk/doc/dev/cpp/examples
For example, Windows users will do (for C++ SDK): |
|
Type this command in order to create a default toolchain using the feed from the C++ SDK: $ qitoolchain create mytoolchain /path/to/SDKfolder/naoqi-sdk/toolchain.xml --default
Where mytoolchain is the name you want to give to this specific toolchain (you could have several). |
|
Type these commands in order to configure and build the sayhelloworld project: $ cd core/sayhelloworld
$ qibuild configure
$ qibuild make
|
|
You can now run the resulting binary from: sayhelloworld/build-mytoolchain/sdk/bin Note On Mac, you should set the environment variable DYLD_LIBRARY_PATH to sayhelloworld/build-mytoolchain/sdk/lib first. |