nocobase/docs/zh-CN/development/your-fisrt-plugin.md

编写第一个插件

在此之前，需要先安装好 NocoBase：

• create-nocobase-app 安装
• Git 源码安装

安装好 NocoBase 之后，我们就可以开始插件开发之旅了。

创建插件

首先，你可以通过 CLI 快速的创建一个初始化的插件，命令如下：

yarn pm create hello

新建的插件，会放置在 packages/plugins/hello 目录下。

插件目录结构

|- /hello
  |- /src
    |- /client
    |- /server
  |- client.d.ts
  |- client.js
  |- package.json
  |- server.d.ts
  |- server.js

编写插件

插件的主体文件在 packages/plugins/hello/src/server/plugin.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;

注册插件

yarn pm add hello

激活插件

yarn pm enable hello

启动应用

# for development
yarn dev

# for production
yarn build
yarn start

体验插件功能

访问地址 http://localhost:13000/api/hello:get