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§
- Runtime
Missing - No engine runtime was found in any place it is installed.
- Search
Roots - 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.