bp3d-os

Operating system tools for BlockProject 3D.

This crate provides various platform specific tools to use by most BlockProject 3D software.

Features

assets provides access to files bundled within the application (eg: AppImage for Linux and Application bundles for Apple systems).
dirs provides access to various system directories to place application data, logs, config, etc.
fs provides a few utilities to extend the Rust standard library around the platform file system such as managing hidden files or getting the absolute path of a file or directory.
open provides utilities to open URLs and files using the default registered application.

Supported platforms

Currently, the following platforms are supported:

macOS.
macOS (with App sandbox).
iOS.
Linux.
Windows.
Other BSD like systems.

Support for Android is currently not planned due to drastic restrictions on file sizes and largely increased complexity of interacting with the platform (No native C API, everything goes through JVM with some custom main function).

Support for the assets feature

Platform	Tested	Notes
macOS	Yes	Uses NSBundle API.
macOS (with app sandbox)	Yes	Uses NSBundle API.
iOS	Yes	Uses NSBundle API.
Linux	Yes	-
Windows	No	Uses GetModuleFileNameW.
Other BSD like systems	No	-

Support for the dirs feature

Platform	Tested	Notes
macOS	Yes	Uses NSFileManager API.
macOS (with app sandbox)	Yes	Uses NSFileManager API.
iOS	Yes	Uses NSFileManager API.
Linux	Yes	-
Windows	No	Uses SHGetKnownFolderPath.
Other BSD like systems	Yes	-

Support for the fs feature

Platform	Tested	Notes
macOS	Yes	Uses NSFileManager API.
macOS (with app sandbox)	Yes	Uses NSFileManager API.
iOS	Yes	Uses NSFileManager API.
Linux	Yes	-
Windows	No	-
Other BSD like systems	Yes	-

Support for the open feature

Platform	Tested	Notes
macOS	Yes	Uses NSWorkspace API.
macOS (with app sandbox)	Yes	Uses NSWorkspace API.
iOS	No	Not yet implemented.
Linux	Yes	Uses dbus and xdg-open.
Windows	Yes	Uses ShellExecuteW.
Other BSD like systems	No	Uses the same code as Linux.