meta-mono is an OpenEmbedded layer that builds dotNet, the mono runtime and mono libraries to allow users to run .NET applications under linux built using OE. For more info about mono, see mono project's website. For more info on OpenEmbedded, see OE's website.
| Branch | Support Status* | Status of Build & Tests |
|---|---|---|
| nanbield | May 2024 |  |
| mickledore | EOL |  |
| langdale | EOL |  |
| kirkstone | Long Term Support (minimum Apr. 2024) |  |
| honister | EOL |  |
| hardknott | EOL |  |
| gatesgarth | EOL |  |
| dunfell | Supported - Long Term Support (until Apr. 2024) |  |
| zeus | EOL |  |
| warrior | EOL |  |
| thud | EOL |  |
| sumo | EOL |  |
| morty | EOL |  |
*support status as of 09/11/22, follows main Yocto release support schedule here
NOTE: 24/01/22 - This patch is needed to Poky for branch morty, sumo (and perhaps others) to fix a gcc version build error.
This layer depends on:
URI: git://git.openembedded.org/openembedded-core layers: meta branch: master
For Mono release notes please see here
The libgdiplus recipe has a soft dependency on the giflib recipe which is provided by the meta-oe layer. These dependencies can be controlled using the PACKAGECONFIG feature of yocto. libgdiplus recognizes the following options:
"jpeg exif gif tiff"
These can be controlled via the .bbappend mechanism or by adding: PACKAGECONFIG_pn-mono = "" PACKAGECONFIG_pn-mono-native = ""
directives to the local.conf
If this recipe is included in an image with gif enabled, for example when building core-image-mono, then conf/bblayers needs to be modified to include meta-oe, e.g.
BBLAYERS = "
..
/path/to/meta-oe
..
"
Otherwise an error of the following form will be seen:
ERROR: Required build target 'core-image-mono' has no buildable providers. Missing or unbuildable dependency chain was: ['core-image-mono', 'mono-helloworld', 'mono', 'libgdiplus', 'giflib']
On the host:
The host system must have the following packges: gcc g++ patch diffstat texi2html texinfo cvs subversion gawk chrpath make libgl1-mesa-dev libglu1-mesa-dev libsdl1.2-dev git libxml-parser-perl bison gettext flex unzip rpm2cpio
On the target:
So far, Windows Forms applications have been tested under Sato. Mono does not require Sato, it does require X if you want to run Windows Forms applications.
The meta-mono layer now includes basic image test support.
For details on configuring image For setup details see: https://wiki.yoctoproject.org/wiki/Image_tests
i.e.
- Add INHERIT += "testimage" in local.conf
- bitbake core-image-mono
- bitbake core-image-mono -c testimage
This will run some simple tests in Qemu (ensure MACHINE is configured appropriately)
- helloworld (command line executable)
- helloworldform (WinForms executable)
- helloworldgtk (GTK# executable
Python tests are defined in lib/oeqa/runtime/cases/mono.py
Currently only core-image-mono is working.
There are mono-helloworld and a mono-helloworld-xbuild recipes in recipes-mono
These show two ways of building C# projects for deployment to the target. Each downloads a tarball release from a git repository, although they could just as easily download and checkout a commit from the git repository.
mono-helloworld then implements the recommended autotools files for build with autoconf. This is based on the Mono example, mono-skel.
For a walkthrough on building .NET recipes from first principles see:
For details see:
mono-helloworld-xbuild implements a Visual Studio 2010 solution and projects which allow us to checkout and build using Visual Studio on a Windows host, or alternatively using Mono xbuild within a Yocto/OpenEmbedded recipe.
For a walkthrough on building Mono for Raspberry Pi see:
- Alex J Lennon
- Autif Khan
- Chris Morgan
- Enric Balletbo i Serra
- Khem Raj
- Richard Tollerton
- Fabio Berton
- Barry Grussling
- Zoltán Böszörményi
- Ioan-Adrian Ratiu
Follow Yocto change submission policy, detailed here, for formatting:
-
Create an issue on github.com/dynamicdevices/meta-mono
-
Fork master on github.com/dynamicdevices/meta-mono
-
Commit your changes to your fork referencing the issue number prefixed with #
-
Create a pull request (PR) to the main repository
-
Your PR will trigger a number of CI builds which will run tests to ensure nothing is broken. The CI builds must pass for your PR to be merged by a maintainer. If your PR does not build correctly please address and update the PR with a fix.
-
If the maintainer doesn't respond after a reasonable time email them a reminder
MIT/GPLv2 - following the lead of libgdiplus and mono
