A tool to help manage a yocto project with layers spread across repositories.
I work with several yocto projects where each layer is a repo. Searching did not turn up tools that met my needs.
Google's repo tool works for projects like Freescale's yocto layers where the project is static. However, the yocto projects I have been involved with have some dynamic elements to them (eg. recipes change as new versions of code are ready for testing). Various maintenance tasks become a burden - updating the config file with the right layer revision, adding/removing layers, etc.
There is substantial overlap between the problems that the dev-pipeline project solves and the needs of a yocto project maintainer. This project utilizes the devpipeline library and provides a yocto project oriented porcelain.
In particular, bootstrap supports the following features:
- Defining required layers (repo + revision) and layer dependencies
- Defining project filesystem layout via configuration file
- Updating of configuration file - including add/remove layers
You must first install devpipeline (devpipeline).
The simplest way to install is using pip (adding the --user installs to your home directory).
$ cd /path/to/bootstrap
$ pip install [--user]If you don't have pip available, you can run setup.py directly (adding the --user installs to your home directory).
$ cd /path/to/bootstrap
$ python setup.py install [--user]If the install completes you're good to go. Depending on your project configuration you may need to install additional tools such as cmake or git; installing those tools is beyond the scope of this document.
The first thing you'll need to do is write a project configuration. Once you're ready, checkout the project sources.
# checkout with default settings
$ bs checkoutThat's it. Check the tool documentation for information on what's available.
- checkout - Fetch sources in dependecy order.