README
A source xPack with files to help µOS++ builds
This project provides files to be included during builds.
The project is hosted on GitHub as micro-os-plus/build-helper-xpack.
Maintainer info
This page is addressed to developers who plan to include this package into their own projects.
For maintainer infos, please see the README-MAINTAINER file.
Install
As a source xPacks, the easiest way to add it to a project is via xpm, but it can also be used as any Git project, for example as a submodule.
Prerequisites
A recent xpm, which is a portable Node.js command line application.
For details please follow the instructions in the install page.
xpm
Note: the package will be available from npmjs.com at a later date.
For now, it can be installed from GitHub:
cd my-project
xpm init # Unless a package.json is already present
xpm install github:micro-os-plus/build-helper-xpack
When ready, this package will be available as
@micro-os-plus/build-helper
from the npmjs.com
registry:
cd my-project
xpm init # Unless a package.json is already present
xpm install @micro-os-plus/build-helper@latest
Git submodule
If, for any reason, xpm is not available, the next recommended
solution is to link it as a Git submodule below an xpacks
folder.
cd my-project
git init # Unless already a Git project
mkdir -p xpacks
git submodule add https://github.com/micro-os-plus/build-helper-xpack.git \
xpacks/micro-os-plus-build-helper
Branches
Apart from the unused master
branch, there are two active branches:
xpack
, with the latest stable version (default)xpack-develop
, with the current development version
All development is done in the xpack-develop
branch, and contributions via
Pull Requests should be directed to this branch.
When new releases are published, the xpack-develop
branch is merged
into xpack
.
User info
The current plan for µOS++ is to use the future xPack build tools, but for now the builds will use CMake, and initially this project will include CMake scripts, mainly used to build the tests, but the same scripts should also help integrating source xPacks in application builds.
In a second step it is planned to add support for meson.
Build & integration info
TBD
Known problems
- none
Examples
TBD
Toolchains
µOS++ sources should comply with C++ 17 and C 11
- GCC:
-std=c++-17
or-std=c11
- clang:
-std=c++-17
or-std=c11
It should be possible to compile it with:
- GCC 8 or newer (https://gcc.gnu.org/projects/cxx-status.html)
- LLVM clang 7 or newer (https://clang.llvm.org/cxx_status.html)
The recommended versions are GCC 10, AppleClang 12.
License
The original content is released under the MIT License, with all rights reserved to Liviu Ionescu.