Apache Newt is a smart build and package management tool, designed for C and C++ applications in embedded contexts. Newt was developed as a part of the Apache Mynewt Operating System, more information on Apache Mynewt can be found at https://mynewt.apache.org/.
Newt is a build system that can read a directory tree, build a dependency tree, and emit the right build artifacts. It then allows you to do the following:
- Download built target to board
- Generate full flash images
- Download debug images to a target board using a debugger
- Conditionally compile libraries & code based upon build settings
- Generate and download manufacturing flash images
Newt is also a source management system that allows you to do the following:
- Create reusable source distributions (called repos) from a collection of code.
- Use third-party components with licenses that are not comptatible with the ASF (Apache Software Foundation) license
- Upgrade repos
When Newt sees a directory tree that contains a "project.yml" file, it recognizes it as the base directory of a project, and automatically builds a package tree. More information can be found in the "Newt Tool Manual" under Docs at https://mynewt.apache.org/.
To build Apache Newt, simply run the included build.sh script. For more information on building and installng Apache Newt, please read INSTALLING or the documentation on https://mynewt.apache.org/
Once you've installed newt, you can get started by creating a new project:
$ newt new your_project
For more information, and a tutorial for getting started, please take a look at the Apache Mynewt documentation.
Anybody who works with Apache Mynewt can be a contributing member of the community that develops and deploys it. The process of releasing an operating system for microcontrollers is never done: and we welcome your contributions to that effort.
Apache Mynewt welcomes pull request via Github. Discussions are done on Github, but depending on the topic, can also be relayed to the official Apache Mynewt developer mailing list dev@mynewt.incubator.apache.org.
If you are suggesting a new feature, please email the developer list directly, with a description of the feature you are planning to work on.
We do not merge pull requests directly on Github, all PRs will be pulled and pushed through https://git.apache.org/.
Bugs can be filed on the Apache Mynewt Bug Tracker.
Where possible, please include a self-contained reproduction case!
Feature requests should also be filed on the Apache Mynewt Bug Tracker. Please introduce it as a ticket type "Wish."
We love getting newt tests! Apache Mynewt is a huge undertaking, and improving code coverage is a win for every Apache Mynewt user.
Contributing to documentation (in addition to writing tests), is a great way to get involved with the Apache Mynewt project.
Pull requests to the apache-mynewt-site repository on Github are the best way to submit documentation. For more information on contributing to the documentation, the FAQ has some more information.
If you are having trouble contributing to Apache Mynewt, or just want to talk to a human about what you're working on, you can contact us via the developers mailing list.
Although not a formal channel, you can also find a number of core developers on the #mynewt channel on Freenode.