This document contains instructions, guidelines, and requirements for developing this tool.
For easiest development, use virtualenv
to manage the dependency environment.
# create a virtualenv
virtualenv venv
# use it
source venv/bin/activate
# install this package in the virtualenv to get dependencies
pip install -e .
# now you can run your work
ros_cross_compile
These are testing entrypoints:
- Unit tests via
tox
- run
tox -e py
- run
- End-to-end shell script
- run
./test/run_e2e_test.sh
- run
The target host platforms for this tool are the Tier 1 platforms specified by non-EOL ROS 2 LTS distributions, on x86_64. Cross-compiling on ARM host platforms is out of scope.
See REP 2000 for this list, which is now:
- Dashing Diademata
- Ubuntu Bionic 18.04
- support installation via
pip
andapt
- support installation via
- MacOS Sierra (10.12)
- support installation via
pip
- support installation via
- Windows 10 (VS2019)
- support installation via
pip
- support installation via
- Ubuntu Bionic 18.04
Though not all of these targets may be fully supported yet, design decisions may not be made that rule out support for those platforms in the future.