Cellulo V1 Installation [macOS]

This guide covers the installation of the Cellulo framework on a macOS desktop for development on said macOS desktop and deployment to macOS.

Tested:

• On macOS 10.13.3
• With Qt 5.10.0

###libdots installation

This is to obtain the command-line tool to overlay the dot pattern on PDFs for localization.

1. Install Homebrew: https://brew.sh
2. Install git, cmake, freetype, openssl and podofo with brew.
3. Clone https://c4science.ch/diffusion/514/libdots.git, the tool is in tools/pdf-overlayer/.
4. Follow the build instructions at https://c4science.ch/diffusion/514/browse/master/tools/pdf-overlayer/README.md.
5. Use as libdots-pdf-overlayer -i mypage.pdf -o mypage-dotted.pdf.

###Qt framework installation

This is to set up the development environment necessary for Cellulo.

1. Install Xcode from the App Store.
2. Download Qt Open Source installer from the internet, it should be named something like qt-unified-mac-x64-3.0.2-online.dmg.
3. Launch and follow the installer.
4. Create an account or login.
5. Install in /opt/Qt. You can install somewhere else but you'll have to adapt the path accordingly in the future.
6. Select macOS from Qt 5.10.0, others are not necessary.
7. Finish install.
8. Important for the future: Run chmod 777 /opt/Qt/5.10.0/clang_64/qml for easier installation of the qml plugins. If you don't do this, you'll have to sudo make install.

###cellulo-qml-plugin installation

This installs the Cellulo QML plugin which provides the API to work with the robots.

1. Clone https://c4science.ch/diffusion/505/cellulo-qml-plugin.git.
2. Set up your github ssh keys on your machine, you can follow https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/ and then https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/.
3. Follow the build instructions for macOS desktop at https://c4science.ch/diffusion/505/browse/master/README.md.

###Other qml plugins installation

These are necessary plugins that work alongside cellulo-qml-plugin.

1. Clone the following:
   • https://github.com/chili-epfl/qml-bluetooth-extras
   • https://github.com/chili-epfl/qml-logger
   • https://github.com/chili-epfl/qml-cache
   • https://github.com/chili-epfl/qml-extra-data-structures
2. Follow the build instructions at the README.md files within the plugins, they are the exact same as cellulo-qml-plugin.

###Test an application on the macOS desktop

1. Launch Qt Creator.
2. From Open Project in the main screen, load cellulo-qml-plugin/samples/cellulo-hello-world/cellulo-hello-world.pro.
3. Select the desktop configuration.
4. When project is loaded, select desktop from the bottom left and click the big green arrow button to launch.