如何在Nativescript 7.x新工作流中生成插件tgz压缩包供本地使用

前置准备 #

确保你的插件项目符合NS7+的标准结构：根目录包含package.json配置文件，原生代码分别放在platforms/ios、platforms/android目录，跨端源码放在src目录下，推荐使用官方插件脚手架生成的项目结构，无需额外调整配置。

第一步：构建插件产物 #

• 首先在插件根目录安装依赖：npm install
• 执行插件构建命令：npm run build

该命令会自动编译TypeScript源码、复制原生SDK资源、打包必要的配置文件到项目根目录的dist输出文件夹。如果是你手动搭建的插件结构，需要先在根目录package.json的scripts字段中配置build逻辑，确保所有需要分发的文件都被复制到dist目录内。

第二步：生成tgz压缩包 #

• 进入构建后的输出目录：cd dist
• 执行npm打包命令：npm pack
  执行完成后即可在dist目录下生成格式为[插件名]-[版本号].tgz的压缩包，比如你配置的插件名是my-plugin，版本是1.0.0，生成的包就是my-plugin-1.0.0.tgz。

本地安装使用方法 #

在需要使用该插件的NativeScript项目根目录，执行以下命令即可直接安装本地包，无需发布到npm：
ns plugin add /本地文件的绝对路径/my-plugin-1.0.0.tgz

如果后续修改了插件代码，需要重新执行build、pack步骤，然后在项目中先卸载旧插件ns plugin remove my-plugin，再重新安装新生成的tgz包即可生效。

与NS6.x版本的差异说明 #

NS6.x版本可以直接在插件根目录执行npm pack生成包，7+版本调整为构建后从dist目录打包，避免了将源码、开发依赖、本地测试文件等无关内容打包进分发包，大幅缩小了插件包体积。

内容的提问来源于stack exchange，提问作者Jubin Jose