Crate millennium

Expand description

Millennium is a framework for building tiny, blazing fast binaries for all major desktop platforms. Developers can integrate any front-end framework that compiles to HTML, JS and CSS for building their user interface. The backend of the application is a rust-sourced binary with an API that the front-end can interact with.

Cargo features

The following are a list of Cargo features that can be enabled or disabled:

millennium_webview (enabled by default): Enables the Millennium Webview runtime. Only disable it if you want a custom runtime.
dox: Internal feature to generate Rust documentation without linking on Linux.
objc-exception: Wrap each msg_send! in a @try/@catch and panics if an exception is caught, preventing Objective-C from unwinding into Rust.
isolation: Enables the isolation pattern. Enabled by default if the millennium > pattern > use config option is set to isolation in the .millenniumrc file.
custom-protocol: Feature managed by the Millennium CLI. When enabled, Millennium assumes a production environment instead of a development one.
updater: Enables the application auto updater. Enabled by default if the updater config is defined in the .millenniumrc file.
devtools: Enables the developer tools (Web inspector) and Window::open_devtools. Enabled by default on debug builds. On macOS it uses private APIs, so you can’t enable it if your app will be published to the App Store.
shell-open-api: Enables the api::shell module.
http-api: Enables the api::http module.
http-multipart: Adds support for multipart/form-data HTTP requests.
reqwest-client: Uses reqwest as HTTP client on the http APIs. Improves performance, but increases the bundle size.
process-command-api: Enables the api::process::Command APIs.
global-shortcut: Enables the global shortcut APIs.
clipboard: Enables the clipboard APIs.
process-relaunch-dangerous-allow-symlink-macos: Allows the api::process::current_binary function to allow symlinks on macOS. This is dangerous, see the Security section in the function’s documentation.
dialog: Enables the api::dialog module.
notification: Enables the api::notification module.
fs-extract-api: Enables the api::file::Extract API.
cli: Enables usage of clap for CLI argument parsing. Enabled by default if the cli config is defined on the .millenniumrc file.
system-tray: Enables application system tray API. Enabled by default if the systemTray config is defined on the .millenniumrc file.
macos-private-api: Enables features only available in macOS’s private APIs, currently the transparent window functionality and the fullScreenEnabled preference setting to true. Enabled by default if the millennium > macosPrivateApi config flag is set to true on the .millenniumrc file.
window-data-url: Enables usage of data URLs on the webview.
compression: Enables asset compression. You should only disable this if you want faster compile times in release builds, though it produces larger binaries.
icon-ico: Adds support to set .ico window icons. Enables Icon::File and Icon::Raw variants.
icon-png: Adds support to set .png window icons. Enables Icon::File and Icon::Raw variants.

Cargo allowlist features

The following are a list of Cargo features that enables commands for Millennium’s API package. These features are automatically enabled by the Millennium CLI based on the allowlist configuration under .millenniumrc.

api-all: Enables all API endpoints.

Clipboard allowlist

clipboard-all: Enables all Clipboard APIs.
clipboard-read-text: Enables the readText API.
clipboard-write-text: Enables the writeText API.

Dialog allowlist

dialog-all: Enables all Dialog APIs.
dialog-ask: Enables the ask API.
dialog-confirm: Enables the confirm API.
dialog-message: Enables the message API.
dialog-open: Enables the open API.
dialog-save: Enables the save API.

Filesystem allowlist

fs-all: Enables all Filesystem APIs.
fs-copy-file: Enables the copyFile API.
fs-create-dir: Enables the createDir API.
fs-read-dir: Enables the readDir API.
fs-read-file: Enables the readTextFile API and the readBinaryFile API.
fs-remove-dir: Enables the removeDir API.
fs-remove-file: Enables the removeFile API.
fs-rename-file: Enables the renameFile API.
fs-write-file: Enables the writeFile API and the writeBinaryFile API.

Global shortcut allowlist

global-shortcut-all: Enables all GlobalShortcut APIs.

HTTP allowlist

http-all: Enables all HTTP APIs.
http-request: Enables the request APIs.

Notification allowlist

notification-all: Enables all Notification APIs.

OS allowlist

os-all: Enables all OS APIs.

Path allowlist

path-all: Enables all Path APIs.

Process allowlist

process-all: Enables all Process APIs.
process-exit: Enables the exit API.
process-relaunch: Enables the relaunch API.

Protocol allowlist

protocol-all: Enables all Protocol APIs.
protocol-asset: Enables the asset custom protocol.

Shell allowlist

shell-all: Enables all Clipboard APIs.
shell-execute: Enables executing arbitrary programs.
shell-sidecar: Enables executing a sidecar program.
shell-open: Enables the open API.

Window allowlist

window-all: Enables all Window APIs.
window-create: Enables the API used to create new windows.
window-center: Enables the center API.
window-request-user-attention: Enables the requestUserAttention API.
window-set-resizable: Enables the setResizable API.
window-set-title: Enables the setTitle API.
window-maximize: Enables the maximize API.
window-unmaximize: Enables the unmaximize API.
window-minimize: Enables the minimize API.
window-unminimize: Enables the unminimize API.
window-show: Enables the show API.
window-hide: Enables the hide API.
window-close: Enables the close API.
window-set-decorations: Enables the setDecorations API.
window-set-always-on-top: Enables the setAlwaysOnTop API.
window-set-size: Enables the setSize API.
window-set-min-size: Enables the setMinSize API.
window-set-max-size: Enables the setMaxSize API.
window-set-position: Enables the setPosition API.
window-set-fullscreen: Enables the setFullscreen API.
window-set-focus: Enables the setFocus API.
window-set-icon: Enables the setIcon API.
window-set-skip-taskbar: Enables the setSkipTaskbar API.
window-set-cursor-grab: Enables the setCursorGrab API.
window-set-cursor-visible: Enables the setCursorVisible API.
window-set-cursor-icon: Enables the setCursorIcon API.
window-set-cursor-position: Enables the setCursorPosition API.
window-start-dragging: Enables the startDragging API.
window-print: Enables the print API.

Re-exports

pub use millennium_utils as utils;

pub use self::window::Monitor;

pub use self::window::Window;

pub use self::window::WindowBuilder;

pub use scope::*;

Modules

api

The Millennium API interface.

async_runtime

The singleton async runtime used by Millennium and exposed to users.

command

The Millennium custom commands types and traits.

http

plugin

The Millennium plugin extension to expand Millennium functionality.

scope

The allowlist scopes.

updaterupdater

The Millennium updater.

window

The Millennium window types and functions.

Macros

generate_context

Reads the config file at compile time and generates a Context based on its content.

generate_handler

Accepts a list of commands functions. Creates a handler that allows commands to be called from JS with invoke().

millennium_build_context

Include a Context that was generated by [millennium-build] inside your build script.

Structs

AboutMetadata

Application metadata for the MenuItem::About action.

App

The instance of the currently running application.

AppHandle

A handle to the currently running application.

Asset

A resolved asset.

AssetResolver

The asset resolver is a helper to access the millennium_utils::assets::Assets interface.

Builder

Builds a Millennium application.

CloseRequestApi

Api exposed on the CloseRequested event.

Config

The .millenniumrc file is generated by the millennium init command. It controls how your app behaves, what windows it launches, and how the app is bundled.

Context

User supplied data required inside of a Millennium application.

CustomMenuItem

A custom menu item.

Env

Information about environment variables.

Event

An event that was triggered.

EventHandler

Represents an event handler.

GlobalWindowEvent

A window event that was triggered on the specified window.

Invoke

The message and resolver given to a custom command.

InvokeError

Error response from an InvokeMessage.

InvokeMessage

An invoke message.

InvokePayload

The payload used on the IPC invoke.

InvokeResolver

Resolver of a invoke message.

LogicalPosition

A position represented in logical pixels.

LogicalSize

A size represented in logical pixels.

Menu

A window menu.

MenuEvent

The window menu event.

PackageInfo

millennium::App package information.

PageLoadPayload

The payload for the OnPageLoad hook.

PathResolver

The path resolver is a helper for the application-specific crate::api::path APIs.

PhysicalPosition

A position represented in physical pixels.

PhysicalSize

A size represented in physical pixels.

RunIteration

Metadata for a runtime event loop iteration on run_iteration.

State

A guard for a state value.

StateManager

The Millennium state manager.

Submenu

SystemTraysystem-tray

SystemTrayHandle

A handle to a system tray. Allows updating the context menu items.

SystemTrayMenusystem-tray

A system tray menu.

SystemTraySubmenusystem-tray

WebviewAttributes

The attributes used to create an webview.

WindowMenuEvent

A menu event that was triggered on a window.

Enums

ActivationPolicymacOS

Application’s activation policy. Corresponds to NSApplicationActivationPolicy.

CursorIcon

Describes the appearance of the mouse cursor.

Error

Runtime errors that can happen inside a Millennium application.

EventLoopMessage

The user event type.

FileDropEvent

The file drop event payload.

Icon

An icon definition.

InvokeResponse

Response from a InvokeMessage passed to the InvokeResolver.

MenuEntry

An entry on the system tray menu.

MenuItem

A menu item, bound to a pre-defined action or Custom emit an event. Note that status bar only supports Custom menu item variants. And on the menu bar, some platforms might not support some of the variants. Unsupported variant will be no-op on such platform.

NativeImagemacOS

Named images defined by the system.

Pattern

An application pattern.

Position

A position that’s either physical or logical.

RunEvent

An application event, triggered from the event loop.

Size

A size that’s either physical or logical.

SystemTrayEventsystem-tray

System tray event.