Suduxu · Utils

Utility commands for managing Suduxu runtime versions and installed native binaries.

The utils command group is used to manage Suduxu runtime binaries (ABI/DLL layer), including listing available releases, importing specific versions, and upgrading existing installations.

These commands operate directly on the native Suduxu runtime files retrieved from the official release repository.

Available Releases

List all available Suduxu runtime versions.

suduxu utils list

This command fetches release metadata from the official repository and displays each release's version tag, release date, pre-release status, asset count, and download URL.

Import a Runtime Version

Install a specific Suduxu runtime version.

suduxu utils import latest

Or specify a version:

suduxu utils import 1.2.0

Target OS selection

suduxu utils import latest --os all

Downloads all available platform binaries.

suduxu utils import latest --os windows

Downloads only the Windows runtime (.dll).

suduxu utils import latest --os linux

Downloads only the Linux runtime (.so).

suduxu utils import latest --os mac-os

Downloads only the macOS runtime (.dylib).

Imported binaries are downloaded from the official Suduxu release repository and placed in the current working directory.

Upgrade Runtime

Upgrade an existing installation by replacing installed binaries.

suduxu utils upgrade latest

Or target a specific version:

suduxu utils upgrade 1.3.0

OS-specific upgrade

suduxu utils upgrade latest --os all

Updates all installed platform binaries.

suduxu utils upgrade latest --os linux

Updates only the specified runtime binary.

Upgrading will replace existing runtime binaries in the working directory. Locked files may be renamed as backup before replacement.

Notes on Behavior

If no runtime file exists, upgrade falls back to import
Existing binaries are deleted or renamed before replacement
Downloads are streamed directly from GitHub releases
Only assets matching the selected OS are installed

Default OS selection is all, which installs all available binaries. Use --os to target a specific platform.

Typical Workflow

suduxu utils import latest --os all

Installs all required runtime binaries for the current system.

suduxu utils upgrade latest

Safely updates existing binaries to the newest version.

suduxu utils import 1.2.0 --os all

Installs a specific known-compatible version across platforms.

Utils