Home

Awesome

UnityRustPlugin

Mandelbrot

This Unity sample project shows how to write a native plugin in the Rust language.

The sample plugin constructs the Mandelbrot set in a big array (1024x1024x4 byte) shared from a C# script. Then the C# script converts it into a 2D texture to draw on the screen. See the plugin code and the caller script for further details.

This project was inspired by Jim Flemming's article. It's recommended to check the article if interested in the topic.

How to build the plugin

The source code for the plugin is contained in the Plugin directory.

macOS/Linux

You can simply run build.sh to build the plugin.

Windows

There are some different approaches for Windows. I prefer using WSL2 and the cross-compilation target.

For cross-compilation from WSL2 to Windows, you have to install MinGW-w64 and the x86_64-pc-windows-gnu target.

sudo apt install gcc-mingw-w64-x86-64
rustup target add x86_64-pc-windows-gnu

Now you can run build.sh.

iOS

Install the aarch64-apple-ios target.

rustup target add aarch64-apple-ios

Run build.sh with passing ios to build the plugin.

./build.sh ios

Android

You have to install NDK and set the ANDROID_NDK environment variable to specify the installation directory.

Then, install the aarch64-linux-android target.

rustup target add aarch64-linux-android

Run build.sh with passing android to build the plugin.

./build.sh android