Skip to main content

Module runtime

Module runtime 

Expand description

Where the Chromium engine lives.

On Linux the engine — the tilo-chromium-host process and the Chromium Embedded Framework it loads — is its own signed Tilo runtime bundle, RUNTIME_REF. It is installed the way every runtime bundle is: by the image at /usr/lib/tilo-runtime/<version>, or for one user under the per-user runtime directory. An app that embeds the engine names the bundle in its manifest’s [package].optional-runtimes, and the launcher verifies the bundle’s signature and mounts it read-only at /run/tilo-runtime/<version> inside the app’s sandbox. Outside the launcher the installed bundle is used directly.

On macOS the packaged app carries the engine as a nested application in its Contents/Frameworks directory.

A missing engine is an ordinary state: locate reports it as RuntimeMissing, which an app shows as “not installed” and logs with RuntimeMissing::developer_hint.

Structs§

RuntimeMissing
No engine runtime was found in any place it is installed.
SearchRoots
The places the engine is looked for, in order.

Constants§

FAILED_MESSAGE
What a person sees when an installed engine fails to start. The cause goes to the log.
HOST_IN_BUNDLE
The host executable, relative to the bundle root.
HOST_OVERRIDE_ENV
Names a host executable directly, for a developer running a locally built engine. Release images never set it.
MOUNT_ROOT
Where the launcher mounts runtime bundles inside an app’s sandbox.
NOT_INSTALLED_MESSAGE
What a person sees when the engine is not installed.
RUNTIME_DIR_ENV
Overrides the per-user runtime root, as it does for every runtime bundle.
RUNTIME_REF
The runtime reference an app manifest lists in [package].optional-runtimes.
RUNTIME_VERSION
The engine runtime’s version: the directory name of its bundle and of its mount. Bump it whenever the host’s protocol or its pinned CEF build changes, or when a host repair must reach an already installed bundle. The Store keeps a verified bundle already present at this version.
SYSTEM_ROOT
Where the image installs system runtime bundles.

Functions§

locate
The engine host of the running process.