插件开发步骤

简介: 插件开发步骤

提示

我们是 pnpm 生态,因此以下的配置均基于 pnpm ,使用 npmyarn 的请按需自己修改。


Step1. 新建项目

$ nest new nestjs-mp-cluster
# 使用pnpm点击复制复制失败已复制


Step2. 修改 package.json 文件

package.json 文件中增加如下配置:

{
  "files": [
    "dist/**/*",
    "pnpm-lock.yaml"
  ],
  "main": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "keywords": [
    "nestjs",
    "微信小程序",
    "多个微信小程序",
    "typescript"
  ],
}点击复制复制失败已复制


说明: 其中 files , main , types 字段必填, keywords 可选。


修改 script 属性内容

{
  "scripts": {
    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
    "build:npm": "rimraf dist && nest build -p tsconfig.npm.build.json",
    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
    "test": "jest",
    "test:watch": "jest --watch",
    "test:cov": "jest --coverage",
    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand"
  },
  "peerDependencies": {
    "@nestjs/common": "8.x",
    "@nestjs/core": "8.x"
  },
}点击复制复制失败已复制


dependencies 中的依赖全部移到 devDependencies 中去。


删除 private 字段。因为我们发布的都是公共npm 包, private 包需要花钱购买服务,不删除此字段无法发布。


Step3. 修改tsconfig.json文件

{
  "compilerOptions": {
    "module": "commonjs",
    "declaration": true,
    "removeComments": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "allowSyntheticDefaultImports": true,
    "target": "es2021",
    "sourceMap": true,
    "outDir": "./dist",
    "baseUrl": "./",
    "incremental": true,
    "skipLibCheck": true,
    "strictNullChecks": false,
    "noImplicitAny": false,
    "strictBindCallApply": false,
    "forceConsistentCasingInFileNames": false,
    "noFallthroughCasesInSwitch": false,
    "esModuleInterop": true
  }
}点击复制复制失败已复制


提示

修改地方主要是 targetesModuleInterop ,因为我们目前都是 node16 环境,因此这里 target 写成了 es2021 ,如果需要兼容更低版本的 node 环境,这里需要相应调整。


Step4. 修改 tsconfig.build.json 文件

tsconfig.build.json 文件改为以下内容:

{
  "extends": "./tsconfig.json",
  "exclude": [
    "node_modules",
    "test",
    "dist",
    "**/*.d.ts",
    "**/*spec.ts"
  ]
}点击复制复制失败已复制


Step5. 新建 tsconfig.npm.build.json 文件

在项目根目录下新建文件 tsconfig.npm.build.json ,写入以下内容:

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "removeComments": false,
    "sourceMap": false,
    "incremental": false
  },
  "exclude": [
    "node_modules",
    "test",
    "dist",
    "**/*.d.ts",
    "**/*spec.ts"
  ]
}点击复制复制失败已复制


Step6. 开发

开始开发,调试等,具体见 开发详解


Step7. 编译

$ pnpm build:npm点击复制复制失败已复制


Step8. 发布

警告

发布之前一定要看看 package.json 文件中的 version 字段,npm会根据这个字段给包打上版本。

$ npm login # 注意,需要将npm源切换回npm
$ npm publish --access=public 点击复制复制失败已复制


扩展

可选操作

.eslintrc.js 文件配置

module.exports = {
    parser: '@typescript-eslint/parser',
    parserOptions: {
        project: 'tsconfig.json',
        sourceType: 'module',
    },
    plugins: ['@typescript-eslint/eslint-plugin'],
    extends: [
        'plugin:@typescript-eslint/recommended',
        'plugin:prettier/recommended',
        'prettier',
    ],
    root: true,
    env: {
        node: true,
        jest: true,
    },
    ignorePatterns: ['.eslintrc.js'],
    rules: {
        '@typescript-eslint/interface-name-prefix': 'off',
        '@typescript-eslint/explicit-function-return-type': 'off',
        '@typescript-eslint/explicit-module-boundary-types': 'off',
        '@typescript-eslint/no-explicit-any': 'off',
        "@typescript-eslint/no-empty-interface": 'off',
        "@typescript-eslint/ban-types": 'off',
        "@typescript-eslint/no-unused-vars": ['warn', {
            "argsIgnorePattern": "^_"
        }],
        'no-console': process.env.NODE_ENV === 'production' ? ['error', {
            allow: ['warn', 'error']
        }] : 'off',
        'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
        'no-var': 0,
        "no-unused-vars": ['warn', {
            "argsIgnorePattern": "^_"
        }],
        'prefer-rest-params': 0
    },
};点击复制复制失败已复制


.prettierrc 文件配置

{
  "singleQuote": true,
  "trailingComma": "none",
  "semi": true,
  "printWidth": 160,
  "bracketSpacing": true,
  "arrowParens": "avoid",
  "endOfLine": "auto"
}点击复制复制失败已复制


删除 test 文件夹

test 文件夹里面主要是 e2e 测试(汉语名称为: 端对端测试

一般插件用不到端对端测试,这部分可以删除。


提交代码前自动格式化代码

安装 huskylint-staged

$ pnpm add -D husky lint-staged cross-env 点击复制复制失败已复制


在项目根目录增加 .lintstagedrc.json 文件,写入如下内容:

{
  "src/**/*.ts": [
    "prettier --write \"src/**/*.ts\"",
    "cross-env NODE_ENV=production eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
    "git add ."
  ],
  "test/**/*.ts": [
    "prettier --write \"test/**/*.ts\"",
    "cross-env NODE_ENV=production eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
    "git add ."
  ]
}点击复制复制失败已复制


接下来配置 husky ,输入如下命令:

$ pnpm husky install
$ pnpm husky add .husky/pre-commit "npx lint-staged"点击复制复制失败已复制


警告

不要在 package.json 文件中配置 postinstall 脚本进行 husky install ,此脚本会影响插件的安装!


提示

husky 版本进化很快,还破坏性升级,这就有点难受了,如果发现不好使,可能就是升级了,目前版本: 6.0.0

目录
相关文章
|
JavaScript
若依代码生成自带导入功能
若依代码生成自带导入功能
517 0
|
SQL 数据库 Windows
若依代码生成详细教程
我觉得若依官方的代码生成教程过于简单,网上的教程很多连个效果图都没有。 本文要达到的效果如下:[学生管理] 下有个 [学生信息] 菜单,里面可以增删改查。
4969 0
若依代码生成详细教程
|
4月前
|
NoSQL Java Redis
若依如何使用(基本环境的配置)
若依如何使用(基本环境的配置)
|
5月前
|
开发框架 JSON .NET
初学者不会写接口怎么办?微软Visual Studio 2022无脑式API接口创建——Swagger一键导入APIKit快速测试
初学者不会写接口怎么办?微软Visual Studio 2022无脑式API接口创建——Swagger一键导入APIKit快速测试
252 0
|
11月前
|
移动开发 开发框架 小程序
基于mpvue的小程序项目搭建的步骤
基于mpvue的小程序项目搭建的步骤
87 0
|
11月前
|
移动开发 开发框架 小程序
基于mpvue的小程序项目搭建的步骤一
基于mpvue的小程序项目搭建的步骤一
86 0
|
前端开发 JavaScript C++
React框架创建项目详细流程-项目的基本配置-项目的代码规范(一)
React框架创建项目详细流程-项目的基本配置-项目的代码规范(一)
|
前端开发 JavaScript
React框架创建项目详细流程-项目的基本配置-项目的代码规范(二)
React框架创建项目详细流程-项目的基本配置-项目的代码规范(二)
|
存储 程序员 开发工具
IDEA插件开发.02之“异味”代码收集插件
许久没更新IDEA插件开发系列了。最近刚好在汇总日常开发中常见的代码“异味”,共享文档复制黏贴略显麻烦,所以想着是否可以搞一个IDEA插件来帮忙收集常见代码,毕竟IDEA作为后端程序员必备的开发工具,显然会方便很多。
188 1
IDEA插件开发.02之“异味”代码收集插件
|
程序员 Android开发 开发者
Android开发:往项目工程里面新引入工具包的步骤
在Android开发过程中,有些时候会根据实际需要,要往项目里面引入工具包,作为初级开发者或者刚开始入门的Android开发者来说会不太熟练怎么引入,所以往项目工程里面新引入工具包也是必备技能。那么本篇博文就来分享一下给项目工程里面引入工具包的步骤,只分享给有需要的人。
180 0
Android开发:往项目工程里面新引入工具包的步骤
下一篇
无影云桌面