Suduxu
Setup

Native Setup

Prepare the Suduxu runtime and project structure before launching the server.

Native Setup

Before Suduxu can run, the native runtime files and configuration must be placed in the expected project structure.

Required structure

Suduxu expects a DLL directory in your project root:

suduxu.json
suduxu.dll
suduxu.so
suduxu.dylib

Native runtime

The runtime provides the core Suduxu server implementation.

PlatformFile
Windowssuduxu.dll
Linuxsuduxu.so
macOSsuduxu.dylib

You only need to include the platforms you intend to support.

Configuration file

suduxu.json defines the runtime's startup behavior by controlling network configuration, security settings, logging behavior, device handling, and theme loading.

See the Configuration section for full details.

Theme directory

The Files directory contains all UI themes sent to connected devices.

Suduxu supports HTML and XML themes, which can be used interchangeably in the same project.

These files are loaded at runtime and can be updated without recompiling your application.

Theme selection is handled through configuration, not code.

Engine integrations

Some environments handle initialization automatically:

  • Unity SDK initializes Suduxu through the prefab/component
  • Other engines may provide similar wrappers in the future

For low-level integrations (Rust, C, C#), you must initialize the runtime manually before calling any API functions.

Next step

Continue with Configuration to adjust runtime behavior and networking options.

On this page