外部库

了解如何安装和使用外部库。

Activepieces 仓库结构为 monorepo，使用 Turbo 作为构建工具。

为了保持主 package.json 尽可能轻量，我们将仅用于某个 Piece 的库放在该 Piece 的 package.json 中。这意味着添加新库时，你应该进入 Piece 文件夹并使用我们的包管理器 bun 安装该库。

cd packages/pieces/<piece-path> 
bun install --save <library-name>

• 将库导入你的 Piece。

指导原则：

• 确保使用维护良好的库。
• 确保库大小不会太大，避免膨胀打包体积；这样可以加快 Piece 在沙箱中的加载速度。

依赖锁定

当 Piece 被构建发布时，所有依赖版本——包括传递性依赖（你依赖项的依赖项）——会自动锁定到 monorepo 的 bun.lock 文件中解析的确切版本。

这意味着：

• 你无需担心手动锁定传递性依赖的版本。
• 发布的 Piece 将始终安装与开发期间测试的相同的依赖树。
• 这可以防止供应链攻击，防止在安装时静默引入受损的传递性依赖。