705b7449f0
* refactor: plugin manager page * fix: bug * feat: addByNpm api * fix: improve the addByNpm * feat: improve applicationPlugins:list api * fix: re-download npm package when restart app * fix: plugin delete api * feat: plugin detail api * feat: zipUrl add api * fix: upload api bug * fix: plugin detail info * feat: upgrade api * fix: upload api * feat: handle plugin load error * feat: support authToken * feat: muti lang * fix: build error * fix: self review * Update plugin-manager.ts * fix: bug * fix: bug * fix: bug * fix: bug * fix: bug * fix: bugs * fix: detail click and remove isOfficial * fix: upgrade no refresh * fix: file size and type check * fix: bug * fix: upgrade error * fix: bug * fix: bug * fix: plugin card layout * fix: handling exceptional cases * fix: tgz file support * fix: macos compress file * fix: bug * fix: bug * fix: bug * fix: bug * fix: add upgrade npm type * fix: bugs * fix: bug * fix: change plugins static expose url * fix: api prefix * fix: bug * fix: add nginx `/static/plugin/` path * fix: bugs and pr docker build no dts * fix: bug * fix: build tools bug * fix: improve code * fix: build bug * feat: improve plugin info * fix: ui bug * fix: plugin document bug * feat: improve code * feat: improve code * feat: process dev deps check * feat: improve code * feat: process.env.IS_DEV_CMD * fix: do not delete the plugin package * feat: plugin symlink * fix: tsx watch --ignore=./storage/plugins/** * fix: test error * fix: improve code * fix: improve code * fix: emitStartedEvent * fix: improve code * fix: type error * fix: test error * test: console.log * fix: createStoragePluginSymLink * fix: clientStaticMiddleware rename to clientStaticUtils * feat: build tools support plugins folder * fix: 350px * fix: error * feat: client dev support plugin folder * fix: clear cli options * fix: typeError: Converting circular structure to JSON * fix: plugin name * chore: restart application after command * feat: upgrade error & docs * Update v14-changelog.md * Update v14-changelog.md * Update v14-changelog.md * fix: gateway test * refactor(plugin-workflow): add ready state for gracefully tearing down * Revert "chore: restart application after command" This reverts commit 5015274f8e4e06e506e15754b672330330e8c7f8. * chore: stop application whe restart * T 1218 change plugin folder (#2629) * feat: change folder name * feat: change `pm create` command * feat: revert plugin name change * fix: delete samples * feat: change plugins folder * fix: pm create * feat: update docs * fix: link package error * fix: docs * fix: create command * fix: pm add error * fix: create add build * fix: pm creatre + add * feat: add tar command * fix: docs * fix: bug * fix: docs --------- Co-authored-by: chenos <chenlinxh@gmail.com> * feat: docs * Update your-fisrt-plugin.md * Update your-fisrt-plugin.md * chore: application reload * chore: test * fix: pm add error * chore: preset install skip exists plugin * fix: createIfNotExists --------- Co-authored-by: chenos <chenlinxh@gmail.com> Co-authored-by: chareice <chareice@live.com> Co-authored-by: Zhou <zhou.working@gmail.com> Co-authored-by: mytharcher <mytharcher@gmail.com>
102 lines
2.5 KiB
Markdown
102 lines
2.5 KiB
Markdown
# v0.14：全新的插件管理器，支持通过界面添加插件
|
||
|
||
v0.14 实现了生产环境下插件的即插即用，可以直接通过界面添加插件，支持从 npm registry（可以是私有的）下载、本地上传、URL 下载。
|
||
|
||
## 新特性
|
||
|
||
### 全新的插件管理器界面
|
||
|
||
<img src="https://demo-cn.nocobase.com/storage/uploads/6de7c906518b6c6643570292523b06c8.png" />
|
||
|
||
### 上传的插件位于 storage/plugins 目录
|
||
|
||
提供 storage/plugins 目录用于上传即插即用的插件，目录以 npm packages 的方式组织
|
||
|
||
```bash
|
||
|- /storage/
|
||
|- /plugins/
|
||
|- /@nocobase/
|
||
|- /plugin-hello1/
|
||
|- /plugin-hello2/
|
||
|- /my-nocobase-plugin-hello1/
|
||
|- /my-nocobase-plugin-hello2/
|
||
```
|
||
|
||
### 插件的更新
|
||
|
||
目前仅 storage/plugins 下的插件才有更新操作，如图：
|
||
|
||
<img src="https://demo-cn.nocobase.com/storage/uploads/703809b8cd74cc95e1ab2ab766980817.gif" />
|
||
|
||
备注：为了便于维护和升级，避免因为升级导致 storage 插件不可用，也可以直接将新插件放到 storage/plugins 目录下，再执行升级操作
|
||
|
||
## 不兼容的变化
|
||
|
||
### 插件目录变更
|
||
|
||
开发中的插件统一都放到 packages/plugins 目录下，以 npm packages 的方式组织
|
||
|
||
```diff
|
||
|- /packages/
|
||
- |- /plugins/acl/
|
||
+ |- /plugins/@nocobase/plugin-acl/
|
||
- |- /samples/hello/
|
||
+ |- /plugins/@nocobase/plugin-sample-hello/
|
||
```
|
||
|
||
全新的目录结构为
|
||
|
||
```bash
|
||
# 开发中的插件
|
||
|- /packages/
|
||
|- /plugins/
|
||
|- /@nocobase/
|
||
|- /plugin-hello1/
|
||
|- /plugin-hello2/
|
||
|- /my-nocobase-plugin-hello1/
|
||
|- /my-nocobase-plugin-hello2/
|
||
|
||
# 通过界面添加的插件
|
||
|- /storage/
|
||
|- /plugins/
|
||
|- /@nocobase/
|
||
|- /plugin-hello1/
|
||
|- /plugin-hello2/
|
||
|- /my-nocobase-plugin-hello1/
|
||
|- /my-nocobase-plugin-hello2/
|
||
```
|
||
|
||
### 插件名的变化
|
||
|
||
- 不再提供 PLUGIN_PACKAGE_PREFIX 环境变量
|
||
- 插件名和包名统一，旧的插件名仍然可以以别名的形式存在
|
||
|
||
### pm add 的改进
|
||
|
||
变更情况
|
||
|
||
```diff
|
||
- pm add sample-hello
|
||
+ pm add @nocobase/plugin-sample-hello
|
||
```
|
||
|
||
pm add 参数说明
|
||
|
||
```bash
|
||
# 用 packageName 代替 pluginName，从本地查找，找不到报错
|
||
pm add packageName
|
||
|
||
# 只有提供了 registry 时，才从远程下载，也可以指定版本
|
||
pm add packageName --registry=xx --auth-token=yy --version=zz
|
||
|
||
# 也可以提供本地压缩包，多次 add 用最后的替换
|
||
pm add /a/plugin.zip
|
||
|
||
# 远程压缩包，同名直接替换
|
||
pm add http://url/plugin.zip
|
||
```
|
||
|
||
## 插件开发指南
|
||
|
||
[编写第一个插件](/development/your-fisrt-plugin)
|