99 lines
1.6 KiB
Markdown
99 lines
1.6 KiB
Markdown
# 编写第一个插件
|
||
|
||
在此之前，需要先安装好 NocoBase：
|
||
|
||
- [create-nocobase-app 安装](/getting-started/installation/create-nocobase-app)
|
||
- [Git 源码安装](/getting-started/installation/git-clone)
|
||
|
||
安装好 NocoBase 之后，我们就可以开始插件开发之旅了。
|
||
|
||
## 创建插件
|
||
|
||
首先，你可以通过 CLI 快速的创建一个初始化的插件，命令如下：
|
||
|
||
```bash
|
||
yarn pm create hello
|
||
```
|
||
|
||
新建的插件，会放置在 `packages/plugins/hello` 目录下。
|
||
|
||
## 插件目录结构
|
||
|
||
```ts
|
||
|- /hello
|
||
|- /src
|
||
|- /client
|
||
|- /server
|
||
|- client.d.ts
|
||
|- client.js
|
||
|- package.json
|
||
|- server.d.ts
|
||
|- server.js
|
||
```
|
||
|
||
## 编写插件
|
||
|
||
插件的主体文件在 `packages/plugins/hello/src/server/plugin.ts`，修改为：
|
||
|
||
```ts
|
||
import { InstallOptions, Plugin } from '@nocobase/server';
|
||
|
||
export class Hello extends Plugin {
|
||
initialize() {
|
||
// TODO
|
||
}
|
||
|
||
beforeLoad() {
|
||
// TODO
|
||
}
|
||
|
||
async load() {
|
||
// TODO
|
||
// Visit: http://localhost:13000/api/hello:get
|
||
this.app.resource({
|
||
name: 'hello',
|
||
actions: {
|
||
async get(ctx, next) {
|
||
ctx.body = `Hello plugin1!`;
|
||
next();
|
||
},
|
||
},
|
||
});
|
||
this.app.acl.allow('hello', 'get');
|
||
}
|
||
|
||
async install(options: InstallOptions) {
|
||
// TODO
|
||
}
|
||
}
|
||
|
||
export default Hello;
|
||
```
|
||
|
||
## 注册插件
|
||
|
||
```bash
|
||
yarn pm add hello
|
||
```
|
||
|
||
## 激活插件
|
||
|
||
```bash
|
||
yarn pm enable hello
|
||
```
|
||
|
||
## 启动应用
|
||
|
||
```bash
|
||
# for development
|
||
yarn dev
|
||
|
||
# for production
|
||
yarn build
|
||
yarn start
|
||
```
|
||
|
||
## 体验插件功能
|
||
|
||
访问地址 http://localhost:13000/api/hello:get
|