7 releases

new 0.9.6 Apr 26, 2024
0.9.5 Apr 17, 2024
0.9.3 Mar 26, 2024

#161 in Build Utils

Download history 143/week @ 2024-03-04 155/week @ 2024-03-11 179/week @ 2024-03-18 140/week @ 2024-03-25 19/week @ 2024-04-01 270/week @ 2024-04-15

433 downloads per month

MulanPSL-2.0

180KB
4K SLoC

Ruxgo

Ruxgo is a Cargo-like build tool for building C/C++ applications that relies solely on a Toml file.

It is also a companion command-line tool for RuxOS and has the explicit aim of making it easy to build and manage your C/C++ applications.

To start using Ruxgo, learn more at The Ruxgo Book.

Installation

Ruxgo currently requires at least Rust version 1.75. You can install it with Cargo:

cargo install ruxgo

Usage

Ruxgo supports building self-developed applications to run on linux or windows platforms, and also supports assembling and building Unikernel-based RuxOS and running applications on it. You just need to Write a config_linux.toml for linux or config_win32.toml for windows in the project directory.

The ruxgo/apps/ directory places all the Toml files that have been tested, you can switch to either directory and follow the instructions to build the application.

  • If you are developing your own application and want to build and run it, you can refer to the template to write a Toml file, then put it in your project directory, and use ruxgo to build and run it.

  • If you want to build an already supported app on ruxos, you need to copy config_<platform>.toml from ruxgo/apps/<name>/ruxos into ruxos/apps/c/<name>, then refer to the instructions and use ruxgo to build and run it.

  • If you have your own app executable and want to run it on RuxOS, you can refer to the template under ruxgo/apps/loader_app and configure your own, then use ruxgo to build and run it.

Note: Refer to the README.md in each app directory for details. The following applications are already supported:

Dependencies

~11–23MB
~375K SLoC