# qiBuild documentation

# qipkg tutorial

`qipkg` lets you make packages the same way Choregraphe does, but from the command line, and also lets you embed code written in C++ or Python inside the package

## Usage

First, you need a `.pml` file. Those are written by Choregraphe when you save your project and look like this:

    <Package name="my-package">

      <!-- Some tags written and read by Choregraphe -->

    </Package>

A `manifest.xml` should exist next to the pml file and should at least contain

    <package version="0.0.1" uuid="my-package">

Those are the id and the version number used by the `PackageManager` on the robot

After that, just use:

    qipkg make-package my-package.pml

to generate a package, and then (if `libqi` python bindings are available)

    qipkg deploy-package /path/to/my-package.pkg --url nao@nao.local

to deploy and install the package on the robot.

If you need to include code written in C++ or Python, just add them to the `.pml` file, like this:

    <Package>

    <!-- choregraphe tags -->

      <qibuild name="foo" />
      <qipython name="bar" />

    </Package>

This assumes you have a `qibuild` CMake project named `foo` and a `qipy` project named `bar` in your worktree.

Also note that to include python projects in your package, you should have called `qipy bootstrap` at least once.

Changelog CMake index Python index Index