pub struct CratePluginKit<T> { /* private fields */ }Expand description
通用插件管理库。
建一个、串行用。
Implementations§
Source§impl<T> CratePluginKit<T>
impl<T> CratePluginKit<T>
Sourcepub fn install(&self, name: &str, version: Option<&str>) -> KitResult<Installed>
pub fn install(&self, name: &str, version: Option<&str>) -> KitResult<Installed>
安装一个插件。
name 可以写短名("cargo",会自动补 KitConfig::crate_prefix),
也可以写完整 crate 名。version 给 None 就去 crates.io 查最新版。
§Errors
KitError::AlreadyInstalled:已经装过了。用Self::update替换。
Sourcepub fn update(&self, name: &str, version: Option<&str>) -> KitResult<Installed>
pub fn update(&self, name: &str, version: Option<&str>) -> KitResult<Installed>
更新(或重装)一个插件。已存在就替换,不存在就当安装。
Sourcepub fn uninstall(&self, name: &str) -> KitResult<()>
pub fn uninstall(&self, name: &str) -> KitResult<()>
卸载一个插件。
§Errors
KitError::NotInstalled:本来就没装。KitError::PluginPanicked之外的一个“正在使用“错误:本进程加载过它的库。 Windows 上正在dlopen的.dll删不掉;Linux 上删得掉但空间不回收。 与其赌,不如让用户换一个干净的进程。
Sourcepub fn list(&self) -> KitResult<Vec<PluginInfo>>
pub fn list(&self) -> KitResult<Vec<PluginInfo>>
列出已安装的插件。
以磁盘上的 manifest 为准,.plugins.json 只用来补充“来源 / 安装时间“
这类 manifest 里没有的信息。所以缓存丢了也不会漏插件。
Sourcepub fn manifest_of(&self, name: &str) -> KitResult<PluginManifest>
pub fn manifest_of(&self, name: &str) -> KitResult<PluginManifest>
读某个插件的 manifest。
Sourcepub fn load(&self, name: &str) -> KitResult<LoadedPlugin<T>>
pub fn load(&self, name: &str) -> KitResult<LoadedPlugin<T>>
加载插件,拿到 *const T。
加载过之后 Self::uninstall 会拒绝删除它,直到进程退出。
Auto Trait Implementations§
impl<T> !Freeze for CratePluginKit<T>
impl<T> !RefUnwindSafe for CratePluginKit<T>
impl<T> !Sync for CratePluginKit<T>
impl<T> Send for CratePluginKit<T>
impl<T> Unpin for CratePluginKit<T>
impl<T> UnsafeUnpin for CratePluginKit<T>
impl<T> UnwindSafe for CratePluginKit<T>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more