refactor(build): 统一编译与发布的平台清单

Author: Vanisper

.github/workflows/release.yaml

@@ -10,6 +10,7 @@ on:
       - '.github/workflows/release.yaml'
       - '.github/workflows/check.yaml'
       - 'scripts/compile.ts'
+      - 'scripts/platforms.ts'
       - 'scripts/release.ts'
       - 'scripts/smoke.ts'
       - 'docs/installation.md'

CONTRIBUTING.md

@@ -114,7 +114,7 @@ docs: 说明参数传递规则
 
 每个任务使用 `bun run compile` 生成一次待分发的压缩二进制，在 JDK 21 下执行完整 smoke。随后将该文件打包，不重新构建：Linux / macOS 使用 `zip`，Windows 使用 PowerShell `Compress-Archive`。实际 ZIP 会在原生环境中解压，核对其中二进制与已验收文件的字节一致，再使用 JDK 17 对解压出的文件执行 quick 启动验收。
 
-每份 ZIP 包含一个 `java-run-<平台>/` 目录，目录内为固定名称的 `java-run` 或 `java-run.exe`、从 [安装指南](docs/installation.md) 复制的 `INSTALL.md`，以及存在的许可证文件。平台清单、包内目录和公开资产名称由 [发布脚本](scripts/release.ts) 统一生成。公开名称不带版本号，版本由 `/releases/download/v<版本>/` URL 表达；`/releases/latest/download/` 提供最新稳定版的固定下载入口。
+每份 ZIP 包含一个 `java-run-<平台>/` 目录，目录内为固定名称的 `java-run` 或 `java-run.exe`、从 [安装指南](docs/installation.md) 复制的 `INSTALL.md`，以及存在的许可证文件。编译参数、发布矩阵、包内目录和公开资产名称共用 [平台清单](scripts/platforms.ts)。公开名称不带版本号，版本由 `/releases/download/v<版本>/` URL 表达；`/releases/latest/download/` 提供最新稳定版的固定下载入口。
 
 汇总步骤要求恰好包含上述五种非空 ZIP，拒绝缺失、多余或无效产物，然后生成并核对覆盖五个 ZIP 的 `SHA256SUMS`。源码 Check 的双 JDK 完整回归与发布文件的 JDK 21 full / JDK 17 quick 范围分别声明，不能将 quick 扩大为完整验收。Linux 验收采用 Ubuntu 24.04 的 glibc 环境，不代表 musl 或其他系统版本已通过验收。
 

scripts/compile.ts

@@ -1,18 +1,12 @@
 import { spawnSync } from 'node:child_process';
 import { resolve } from 'node:path';
+import { platforms, type BuildTarget } from './platforms';
 
 const projectRoot = resolve(import.meta.dir, '..');
-const targets = [
-  'bun-windows-x64',
-  'bun-linux-x64',
-  'bun-linux-arm64',
-  'bun-darwin-arm64',
-  'bun-darwin-x64',
-] as const;
 
 /** 本机或指定平台的独立二进制构建配置 */
 export interface CompileOptions {
-  target?: typeof targets[number];
+  target?: BuildTarget;
   outfile: string;
 }
 
@@ -33,8 +27,9 @@ export function parseCompileOptions(argv: readonly string[], cwd = projectRoot):
     const value = separator < 0 ? '' : argument.slice(separator + 1);
     if (!value.trim() || /[\r\n\0]/.test(value)) throw new Error(`${name} 必须使用 ${name}=<value> 指定有效值`);
     if (name === '--target') {
-      if (!targets.includes(value as typeof targets[number])) throw new Error(`--target 仅支持 ${targets.join('、')}`);
-      options.target = value as typeof targets[number];
+      const platform = platforms.find(platform => platform.target === value);
+      if (!platform) throw new Error(`--target 仅支持 ${platforms.map(platform => platform.target).join('、')}`);
+      options.target = platform.target;
     } else {
       options.outfile = resolve(cwd, value);
     }

scripts/platforms.ts

@@ -0,0 +1,24 @@
+const definitions = [
+  { name: 'windows-x64', runner: 'windows-2025', target: 'bun-windows-x64', binary: 'java-run.exe', label: 'Windows x64' },
+  { name: 'linux-x64', runner: 'ubuntu-24.04', target: 'bun-linux-x64', binary: 'java-run', label: 'Linux x64' },
+  { name: 'linux-arm64', runner: 'ubuntu-24.04-arm', target: 'bun-linux-arm64', binary: 'java-run', label: 'Linux ARM64' },
+  { name: 'darwin-arm64', runner: 'macos-15', target: 'bun-darwin-arm64', binary: 'java-run', label: 'macOS Apple Silicon' },
+  { name: 'darwin-x64', runner: 'macos-15-intel', target: 'bun-darwin-x64', binary: 'java-run', label: 'macOS Intel' },
+] as const;
+
+/** 编译、发布矩阵、归档和下载说明共用的平台清单 */
+export const platforms = definitions.map(platform => ({
+  ...platform,
+  folder: `java-run-${platform.name}`,
+  archive: `java-run-${platform.name}.zip`,
+}));
+
+/** 支持的 Bun 编译目标 */
+export type BuildTarget = typeof platforms[number]['target'];
+
+/** 查找发布平台，未知名称时拒绝继续构建或打包 */
+export function platformFor(name: string) {
+  const platform = platforms.find(platform => platform.name === name);
+  if (!platform) throw new Error(`不支持的发布平台：${name}`);
+  return platform;
+}

scripts/release.ts

@@ -4,15 +4,9 @@ import { chmod, copyFile, lstat, mkdir, mkdtemp, readdir, rename, rm, writeFile
 import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { spawnSync } from 'node:child_process';
+import { platforms, platformFor } from './platforms';
 
 const projectRoot = resolve(import.meta.dir, '..');
-const platforms = [
-  { name: 'windows-x64', runner: 'windows-2025', target: 'bun-windows-x64', binary: 'java-run.exe', label: 'Windows x64' },
-  { name: 'linux-x64', runner: 'ubuntu-24.04', target: 'bun-linux-x64', binary: 'java-run', label: 'Linux x64' },
-  { name: 'linux-arm64', runner: 'ubuntu-24.04-arm', target: 'bun-linux-arm64', binary: 'java-run', label: 'Linux ARM64' },
-  { name: 'darwin-arm64', runner: 'macos-15', target: 'bun-darwin-arm64', binary: 'java-run', label: 'macOS Apple Silicon' },
-  { name: 'darwin-x64', runner: 'macos-15-intel', target: 'bun-darwin-x64', binary: 'java-run', label: 'macOS Intel' },
-] as const;
 const licenseNames = ['LICENSE', 'LICENSE.md', 'LICENSE.txt'];
 const repository = 'https://github.com/Vanisper/java-run';
 
@@ -38,16 +32,16 @@ export function releaseMetadata(version: string, requestedTag?: string): Release
     version, tag, prerelease: match[4] !== undefined,
     matrix: { include: platforms.map(platform => ({
       name: platform.name, runner: platform.runner, target: platform.target,
-      binary: platform.binary, archive: `java-run-${platform.name}.zip`,
+      binary: platform.binary, archive: platform.archive,
     })) },
   };
 }
 
 /** 为当前版本生成固定下载链接、安装要求和升级说明 */
 export function releaseNotes(version: string): string {
-  const { tag, matrix } = releaseMetadata(version);
+  const { tag } = releaseMetadata(version);
   const download = `${repository}/releases/download/${encodeURIComponent(tag)}`;
-  const rows = matrix.include.map((platform, index) => `| ${platforms[index]!.label} | [${platform.archive}](${download}/${platform.archive}) |`);
+  const rows = platforms.map(platform => `| ${platform.label} | [${platform.archive}](${download}/${platform.archive}) |`);
   return `## 下载与安装
 
 下载对应系统与处理器的 ZIP 后解压，无需安装 Bun。本机需要满足 Java 项目要求的 JDK；优先使用项目的 Maven / Gradle Wrapper，没有 Wrapper 时需安装对应构建工具。
@@ -66,12 +60,6 @@ ${rows.join('\n')}
 `;
 }
 
-function platformFor(name: string) {
-  const platform = platforms.find(platform => platform.name === name);
-  if (!platform) throw new Error(`不支持的发布平台：${name}`);
-  return { ...platform, folder: `java-run-${platform.name}`, archive: `java-run-${platform.name}.zip` };
-}
-
 async function assertFile(path: string): Promise<void> {
   const stat = await lstat(path);
   if (!stat.isFile() || stat.size === 0) throw new Error(`文件不是非空普通文件：${path}`);