Expand description
prebuilt: downloads a cdylib plus manifest straight from GitHub Releases.
This is an accelerator path, not the default. It goes through GitHub, which bypasses the cargo registry or mirror the user has configured, so it may not be reachable:
- the default stays build-host (
cargo build, which naturally picks up the mirror configuration); - prebuilt is only used when build-host is explicitly turned off, or when the caller wants to try saving a few minutes first;
- a
Nonefrom any step means “no usable prebuilt”, and the caller must fall back to build-host.
§Artifact naming convention
A release carries two bare files (not archives, which saves three dependencies — tar/gzip/zip):
{crate}-{version}-{target}.{so|dylib|dll} <-- the cdylib itself
{crate}-{version}-{target}.toml <-- the manifestExample: bmux-plugin-cargo-0.1.0-x86_64-pc-windows-msvc.dll
The repository URL comes from the crates.io repository field — at this point the
plugin is not installed yet, so the registry is the only thing we can ask.
Functions§
- parse_
github_ repo - Extracts
(owner, repo)from a GitHub URL. - try_
install - Tries to install a prebuilt.