Tiny Runtime Injector

一个帮助您为项目下载完整、轻量级运行时环境的库。它支持多种现代运行时，包括 Node.js、Bun 和 uv，非常适合在构建 Electron 等应用程序时包含轻量级运行时。

特性

• 🚀 支持多种运行时：Node.js、Bun、uv
• 📦 自动下载和配置最新版本
• 🎯 跨平台支持 (Windows, macOS, Linux)
• 🔧 可配置的清理选项（Node.js）
• 💻 命令行界面和编程 API
• 📝 TypeScript 支持

支持的运行时

运行时	描述	默认版本
Node.js	JavaScript 运行时环境	v22.9.0
Bun	快速的 JavaScript 运行时和工具包	v1.2.16
uv	Python 包管理器和解释器管理工具	0.7.13

安装

1npm install tiny-runtime-injector

使用方法

命令行界面

1# 安装 Node.js
2tiny-runtime-injector --type node --version v22.9.0 --dir ./runtime/node
3
4# 安装 Bun
5tiny-runtime-injector --type bun --version v1.2.16 --dir ./runtime/bun
6
7# 安装 uv
8tiny-runtime-injector --type uv --version 0.7.13 --dir ./runtime/uv
9
10# 查看所有选项
11tiny-runtime-injector --help

编程 API

1import { RuntimeInjector } from "tiny-runtime-injector";
2
3// 安装 Node.js
4const nodeInjector = new RuntimeInjector({
5  type: "node",
6  version: "v22.9.0",
7  targetDir: "./runtime/node",
8  cleanup: true,
9});
10await nodeInjector.inject();
11
12// 安装 Bun
13const bunInjector = new RuntimeInjector({
14  type: "bun",
15  version: "v1.2.16",
16  targetDir: "./runtime/bun",
17});
18await bunInjector.inject();
19
20// 安装 uv
21const uvInjector = new RuntimeInjector({
22  type: "uv",
23  version: "0.7.13",
24  targetDir: "./runtime/uv",
25});
26await uvInjector.inject();

配置选项

RuntimeOptions

1interface RuntimeOptions {
2  type?: "node" | "bun" | "uv"; // 运行时类型
3  version?: string; // 版本号
4  platform?: string; // 目标平台
5  arch?: string; // 目标架构
6  targetDir: string; // 安装目录
7  cleanup?: boolean | CleanupConfig; // 清理配置（仅 Node.js）
8}

清理配置（仅 Node.js）

1interface CleanupConfig {
2  removeDocs?: boolean; // 移除文档文件
3  removeDevFiles?: boolean; // 移除开发文件
4  removeSourceMaps?: boolean; // 移除源码映射
5  customRules?: CleanupRule[]; // 自定义规则
6}

使用示例

在 Electron 项目中使用

1import { RuntimeInjector } from "tiny-runtime-injector";
2import path from "path";
3
4async function setupRuntimes() {
5  const runtimeDir = path.join(__dirname, "resources", "runtimes");
6
7  // 设置 Node.js 用于后端处理
8  const nodeInjector = new RuntimeInjector({
9    type: "node",
10    version: "v22.9.0",
11    targetDir: path.join(runtimeDir, "node"),
12    cleanup: {
13      removeDocs: true,
14      removeDevFiles: true,
15      removeSourceMaps: true,
16    },
17  });
18
19  // 设置 Bun 用于快速脚本执行
20  const bunInjector = new RuntimeInjector({
21    type: "bun",
22    version: "v1.2.16",
23    targetDir: path.join(runtimeDir, "bun"),
24  });
25
26  // 设置 uv 用于 Python 包管理
27  const uvInjector = new RuntimeInjector({
28    type: "uv",
29    version: "0.7.13",
30    targetDir: path.join(runtimeDir, "uv"),
31  });
32
33  await Promise.all([
34    nodeInjector.inject(),
35    bunInjector.inject(),
36    uvInjector.inject(),
37  ]);
38
39  console.log("所有运行时设置完成！");
40}
41
42setupRuntimes().catch(console.error);

配置文件支持

创建 runtime-config.json：

1{
2  "type": "node",
3  "version": "v22.9.0",
4  "targetDir": "./runtime/node",
5  "cleanup": {
6    "removeDocs": true,
7    "removeDevFiles": true,
8    "removeSourceMaps": true,
9    "customRules": [
10      {
11        "pattern": "**/*.test.js",
12        "description": "Remove test files"
13      }
14    ]
15  }
16}

使用配置文件：

1tiny-runtime-injector --config runtime-config.json

平台支持

Node.js

• ✅ Windows (x64, x86, ARM64)
• ✅ macOS (x64, ARM64)
• ✅ Linux (x64, ARM64, ARMv7, PPC64LE, s390x)

Bun

• ✅ Windows (x64, ARM64)
• ✅ macOS (x64, ARM64)
• ✅ Linux (x64, ARM64)

uv

• ✅ Windows (x64, ARM64)
• ✅ macOS (x64, ARM64)
• ✅ Linux (x64, ARM64)

运行时特定说明

Node.js

• 包含完整的 Node.js 运行时和 npm
• 支持清理选项以减少文件大小
• 可执行文件：node.exe (Windows) 或 bin/node (Unix)

Bun

• 单个可执行文件，包含运行时和包管理器
• 无需额外清理，已经很轻量
• 可执行文件：bun.exe (Windows) 或 bun (Unix)

uv

• 包含 uv 和 uvx 两个可执行文件
• uv：Python 包管理器
• uvx：工具执行器
• 可执行文件：uv.exe/uvx.exe (Windows) 或 uv/uvx (Unix)

API 参考

RuntimeInjector 类

构造函数

1constructor(options: RuntimeOptions)

方法

1async inject(): Promise<void>

下载并设置指定的运行时环境。

故障排除

常见问题

1. 下载失败

   • 检查网络连接
   • 验证版本号是否正确
   • 确保目标目录有写入权限

2. 可执行文件无法运行

   • 在 Unix 系统上，检查文件权限（应该是 755）
   • 验证架构兼容性

3. 版本不匹配

   • 使用正确的版本格式：
     • Node.js: v22.9.0
     • Bun: v1.2.16
     • uv: 0.7.13

贡献

欢迎贡献！请查看我们的贡献指南。

许可证

MIT

更新日志

v1.0.0

• ✨ 添加对 Bun 和 uv 的支持
• 🔧 重构为支持多运行时架构
• 📝 更新文档和示例
• 🐛 修复跨平台兼容性问题