134 lines
4.8 KiB
Markdown
134 lines
4.8 KiB
Markdown
## 便携式 JRE/JDK8 集成指南
|
||
|
||
本指南介绍如何将 JRE 8 以“便携式”（解压即用、无需安装）的方式随应用打包，并在 Electron 主进程中通过绝对路径调用，从而避免要求用户在系统中安装 JDK/JRE。
|
||
|
||
### 为什么选择便携式 JRE
|
||
- 无需管理员权限与系统环境变量配置，用户无感知。
|
||
- 不污染系统环境（不写入 JAVA_HOME/PATH）。
|
||
- 跨平台一致，可精简体积、可控版本。
|
||
|
||
### 适用场景
|
||
- 运行 Java 程序或 JAR 包（仅需运行时）。
|
||
- 不需要 javac/jcmd/jmap 等开发/诊断工具（若需要，请改为随包便携式 JDK）。
|
||
|
||
### 推荐的 JRE 8 发行版（可再分发）
|
||
- Azul Zulu 8 JRE（可选 ZuluFX 含 JavaFX）：[下载页面](https://www.azul.com/downloads/?version=java-8-lts&package=jre)
|
||
- BellSoft Liberica 8 JRE（Standard/Full，Full 含 JavaFX）：[下载页面](https://bell-sw.com/pages/downloads/#/java-8-lts)
|
||
- Eclipse Temurin 8 JRE（Adoptium）：[下载页面](https://adoptium.net/temurin/releases/?version=8)
|
||
|
||
选择要点：
|
||
- 需要 AWT/Swing/字体/打印 → 选择非 headless 包。
|
||
- 需要 JavaFX → 选择 Liberica Full 或 ZuluFX。
|
||
- 仅命令行/服务端 → 任意 JRE 8（headless 也可）。
|
||
|
||
### 目录放置约定
|
||
将解压后的 JRE 放入项目的 `build/extraResources/jre`，保证内部存在 `bin/java(.exe)`：
|
||
|
||
```
|
||
build/
|
||
extraResources/
|
||
jre/
|
||
bin/
|
||
java(.exe)
|
||
lib/
|
||
...
|
||
```
|
||
|
||
构建后在生产环境可通过 `process.resourcesPath` 访问：
|
||
`<app>/resources/extraResources/jre/bin/java(.exe)`。
|
||
|
||
### 主进程调用示例
|
||
在 `electron/preload/lifecycle.js` 或你的业务模块中封装 Java 运行工具（开发/生产两种路径）：
|
||
|
||
```js
|
||
const path = require('path');
|
||
const { spawn } = require('child_process');
|
||
|
||
function getExtraResourcesDir() {
|
||
// 开发态：使用项目目录；生产态：使用 asar/resources 目录
|
||
const isDev = !!process.env.EE_DEV || process.env.NODE_ENV === 'development';
|
||
return isDev
|
||
? path.join(process.cwd(), 'build', 'extraResources')
|
||
: path.join(process.resourcesPath, 'extraResources');
|
||
}
|
||
|
||
function getJavaBinPath() {
|
||
const extraDir = getExtraResourcesDir();
|
||
const javaBinName = process.platform === 'win32' ? 'java.exe' : 'java';
|
||
return path.join(extraDir, 'jre', 'bin', javaBinName);
|
||
}
|
||
|
||
function runJavaJar(jarAbsPath, args = [], options = {}) {
|
||
const javaPath = getJavaBinPath();
|
||
const child = spawn(javaPath, ['-jar', jarAbsPath, ...args], {
|
||
stdio: 'inherit',
|
||
...options,
|
||
});
|
||
return child;
|
||
}
|
||
|
||
async function ensureJavaVersion(logger) {
|
||
return new Promise((resolve) => {
|
||
const child = spawn(getJavaBinPath(), ['-version']);
|
||
let out = '';
|
||
let err = '';
|
||
child.stdout && child.stdout.on('data', (d) => (out += d.toString()))
|
||
child.stderr && child.stderr.on('data', (d) => (err += d.toString()))
|
||
child.on('close', () => {
|
||
const text = (out + '\n' + err).trim();
|
||
logger && logger.info('[java] version check:', text);
|
||
resolve(text.includes('1.8.0'));
|
||
});
|
||
});
|
||
}
|
||
|
||
module.exports = { getJavaBinPath, runJavaJar, ensureJavaVersion };
|
||
```
|
||
|
||
在生命周期中调用（示例）：
|
||
|
||
```js
|
||
const { logger } = require('ee-core/log');
|
||
const path = require('path');
|
||
const { runJavaJar, ensureJavaVersion } = require('./java-runner');
|
||
|
||
class Lifecycle {
|
||
async ready() {
|
||
const ok = await ensureJavaVersion(logger);
|
||
if (!ok) {
|
||
logger.error('[java] 未检测到 JRE 8，请检查 extraResources/jre 是否存在');
|
||
}
|
||
}
|
||
|
||
async windowReady() {
|
||
const jarPath = path.join(process.resourcesPath || process.cwd(), 'extraResources', 'tools', 'your-app.jar');
|
||
// 示例：延后在某业务时机再启动 Java 进程
|
||
// const proc = runJavaJar(jarPath, ['--arg1', 'value']);
|
||
}
|
||
}
|
||
```
|
||
|
||
注意：示例中的 `java-runner` 为上文工具函数文件，实际请按你的项目结构放置。
|
||
|
||
### 验证清单
|
||
- 运行 `jre/bin/java -version` 输出包含 `1.8.0_xxx`。
|
||
- 若涉及 GUI/字体/打印，验证 AWT/Swing 中文渲染与打印。
|
||
- 若需 JavaFX，验证 JavaFX Demo 启动。
|
||
- 若涉及 TLS/HTTPS，验证 SSL 通信正常。
|
||
|
||
### 许可与合规
|
||
- Azul Zulu、Eclipse Temurin（Adoptium）、BellSoft Liberica 的 JRE/JDK 8 发行包均可免费再分发（GPLv2+CE 或厂商许可证）。
|
||
- 建议在应用的“关于/许可证”中附上所选发行版的许可证链接与致谢。
|
||
|
||
### 常见问题
|
||
1) 是否“阉割”？
|
||
— 上述 JRE 8 发行版均为标准运行时，通过兼容性测试；JRE 不包含开发者工具属于正常区别，不是删减。
|
||
|
||
2) 何时需要 JDK 而不是 JRE？
|
||
— 需要 `javac` 编译或 `jcmd/jmap` 等诊断工具，或你的 Java 组件依赖 `tools.jar` 时。
|
||
|
||
3) 体积如何优化？
|
||
— 选择 headless（若无 GUI 需求）、去除无用语言/字体包；或改用 JDK 9+ 使用 jlink（不适用于 8）。
|
||
|
||
|