Community.MauiRust.Generators 1.0.0-pre11

Community.MauiRust.Generators

Build-time package for .NET MAUI + Rust projects.

Reads your rust/lib.rs, finds every #[no_mangle] pub extern "C" fn, and generates matching [LibraryImport] P/Invoke bindings into Rust.Generated.cs — automatically, on every build.

How it works

Add a Rust export:

#[no_mangle]
pub extern "C" fn compute(value: f32) -> f32 {
    value * 2.0
}

The generator emits:

// Rust.Generated.cs — do not edit
[LibraryImport(Lib, EntryPoint = "compute")]
[UnmanagedCallConv(CallConvs = new[] { typeof(System.Runtime.CompilerServices.CallConvCdecl) })]
public static partial float Compute(float value);

Call it from C#:

var result = Rust.Compute(3.14f);

Override a binding

Declare the same EntryPoint in your Rust.cs — the generator skips it:

// Rust.cs — your file, generator leaves this alone
[LibraryImport(Lib, EntryPoint = "compute")]
public static partial float Compute(float value);

Unknown types

If the generator cannot map a Rust type to C#, it emits a TODO comment instead of broken code:

// TODO: bind 'complex_func' — unrecognized type(s), declare manually in Rust.cs

Setup

Installed via Community.MauiRust.Templates

Zero config. The template package includes the generator and emits a fixed Community.MauiRust.Generators package reference in the scaffolded app.

Install into an existing app from NuGet

You can also add the package to an existing MAUI project with the CLI:

dotnet add package Community.MauiRust.Generators

After that, make sure your project follows the expected layout or set the relevant MSBuild overrides shown below.

Manual install

<PackageReference Include="Community.MauiRust.Generators" Version="1.0.0-pre11">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>

The package reads rust/Cargo.toml to infer the native library name and writes the generated Lib constant for you when Rust.cs does not already define one.

The package also wires the build-time generation logic from the repo-level build/Community.MauiRust.Generators.targets file. RustCrateDir defaults to the template layout, but you can override it.

Optional MSBuild properties

The package works with no required properties in template-generated projects, but it supports these optional overrides in your app .csproj:

For example, with a custom layout:

<PropertyGroup>
  <RustCrateDir>..\..\native\mycrate</RustCrateDir>
  <RustGeneratorSrcDir>..\..\rust</RustGeneratorSrcDir>
  <RustLibName>your_crate_name</RustLibName>
  <RustProfile>release</RustProfile>
  <RustGeneratedFile>Generated\RustBindings.g.cs</RustGeneratedFile>
</PropertyGroup>

Supported type mappings

Everything else → TODO comment.

Repo layout

Inside the combined Community.MauiRust repo the package lives here:

src/Community.MauiRust.Generators/
build/Community.MauiRust.Generators.targets
build/Community.MauiRust.Generators.props

The template package under src/Community.MauiRust.Templates/ consumes this package.

Both packages are released together from the combined repo via .github/workflows/nuget-release.yml.