d3ro-voice/scripts/ci/fix-native-abi.mjs
Yun Chan 7fe49c437e chore: land in-progress workspace changes before 1.16.2
The tree carried uncommitted work from several areas (web push, mobile
screens, admin charts, test-hygiene cleanup, CI and map docs). It is landed
as one commit so the release pipeline can start from a clean tree; the
desktop transcript-correction behaviour shipped in the previous commit and
is unchanged here.
2026-11-05 21:58:44 +09:00

125 lines
4.9 KiB
JavaScript

// scripts/ci/fix-native-abi.mjs
// 패키징된 앱 트리에 Electron ABI 네이티브 모듈을 보장한다.
//
// 필요한가:
// - better-sqlite3는 V8 내부 API에 의존해 런타임별 ABI(NODE_MODULE_VERSION)가 다르다.
// 개발 PC에서 `npm install`을 돌리면 Node ABI로 재빌드되고, 그 상태로 패키징하면
// 설치본이 시작하자마자 "NODE_MODULE_VERSION 131 ... requires 130"으로 죽는다(실측 사고).
// - CI에서는 electron-builder의 npmRebuild가 이를 처리하지만, 로컬에서는 실행 중인 Electron이
// node_modules 파일을 잠그고 있어 재빌드가 EPERM으로 실패할 수 있다.
// 그래서 "패키징된 트리"에 정확한 ABI 바이너리를 직접 넣는다(원본 node_modules는 건드리지 않는다).
//
// 동작: 임시 사본에서 prebuild-install로 Electron용 프리빌드를 받아 패키징 트리에 복사한 뒤,
// 호스트 Node가 그 모듈을 거부하는지(= Electron ABI) 확인한다.
//
// 사용:
// node scripts/ci/fix-native-abi.mjs --dir <packagedDir>
import { spawnSync } from 'node:child_process'
import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs'
import { dirname, join, resolve } from 'node:path'
import { fileURLToPath } from 'node:url'
const root = join(dirname(fileURLToPath(import.meta.url)), '..', '..')
const inPlace = process.argv.includes('--in-place')
const dirFlagIndex = process.argv.indexOf('--dir')
const packagedDir =
dirFlagIndex >= 0 && process.argv[dirFlagIndex + 1]
? resolve(process.argv[dirFlagIndex + 1])
: null
if (!inPlace && (!packagedDir || !existsSync(packagedDir))) {
console.error('사용: node scripts/ci/fix-native-abi.mjs --dir <packagedDir> | --in-place')
process.exit(1)
}
const sourcePackageJson = JSON.parse(
readFileSync(join(root, 'apps', 'desktop', 'package.json'), 'utf8'),
)
const electronVersion =
sourcePackageJson.devDependencies?.electron?.replace(/[^0-9.]/g, '') ?? '33.4.11'
const arch = process.arch === 'arm64' ? 'arm64' : 'x64'
const relativeBinary = join(
'node_modules',
'better-sqlite3',
'build',
'Release',
'better_sqlite3.node',
)
const targetBinary = inPlace
? join(root, relativeBinary)
: join(packagedDir, 'resources', 'app.asar.unpacked', relativeBinary)
if (!existsSync(targetBinary)) {
console.error(`[native-abi] 패키징 트리에 better-sqlite3 바이너리가 없습니다: ${targetBinary}`)
process.exit(1)
}
/** 호스트 Node로 로드되면 Electron ABI가 아니다 */
function hostNodeLoads(binaryPath) {
const probe = spawnSync(process.execPath, ['-e', `require(${JSON.stringify(binaryPath)})`], {
encoding: 'utf8',
})
return probe.status === 0
}
if (!hostNodeLoads(targetBinary)) {
console.log('[native-abi] 이미 Electron ABI 바이너리입니다 — 수정 불필요')
process.exit(0)
}
console.log('[native-abi] 호스트 Node ABI로 빌드된 모듈을 찾았습니다 → Electron ABI로 교체합니다')
const scratchRoot = join(root, '.tmp', 'native-abi')
const scratchModule = join(scratchRoot, 'better-sqlite3')
// 임시 사본 준비 (원본 node_modules는 잠겨 있을 수 있으므로 복사해서 작업)
rmSync(scratchRoot, { recursive: true, force: true })
mkdirSync(scratchRoot, { recursive: true })
const copy = spawnSync(
process.platform === 'win32' ? 'cmd' : 'cp',
process.platform === 'win32'
? ['/c', 'xcopy', join(root, 'node_modules', 'better-sqlite3'), scratchModule, '/E', '/I', '/Q', '/Y']
: ['-r', join(root, 'node_modules', 'better-sqlite3'), scratchModule],
{ stdio: 'inherit' },
)
if (copy.status !== 0) {
console.error('[native-abi] better-sqlite3 사본 생성 실패')
process.exit(copy.status ?? 1)
}
const prebuild = spawnSync(
process.platform === 'win32' ? 'npx.cmd' : 'npx',
[
'--no-install',
'prebuild-install',
`--runtime=electron`,
`--target=${electronVersion}`,
`--arch=${arch}`,
'--force',
],
{ cwd: scratchModule, stdio: 'inherit', shell: process.platform === 'win32' },
)
const scratchBinary = join(scratchModule, 'build', 'Release', 'better_sqlite3.node')
if (prebuild.status !== 0 || !existsSync(scratchBinary)) {
console.error(
[
`[native-abi] Electron ${electronVersion} 프리빌드를 받지 못했습니다.`,
' 대안: CI에서 electron-builder의 npmRebuild=true로 빌드하세요(권장).',
' 로컬에서 계속하려면 실행 중인 Electron을 모두 종료한 뒤 다음을 실행하세요:',
` npx @electron/rebuild -v ${electronVersion} -m better-sqlite3`,
].join('\n'),
)
process.exit(1)
}
if (hostNodeLoads(scratchBinary)) {
console.error('[native-abi] 받은 프리빌드가 Electron ABI가 아닙니다(prebuild-install 결과를 확인).')
process.exit(1)
}
copyFileSync(scratchBinary, targetBinary)
console.log(`[native-abi] 교체 완료: ${targetBinary}`)
rmSync(scratchRoot, { recursive: true, force: true })