From 7ba29790c39368512d0f51a6174b6fee14d180c2 Mon Sep 17 00:00:00 2001 From: lick <2188718831@qq.com> Date: Fri, 13 Nov 2026 18:53:17 -0800 Subject: [PATCH] release: prepare Java 1.1.0 preview packages for macOS and Windows --- .github/workflows/release.yml | 82 ++++++++++++++++++------------- README.md | 12 ++--- docs/releases/v1.1.0.md | 51 +++++++++++++++++++ scripts/package/build-windows.mjs | 3 +- 4 files changed, 107 insertions(+), 41 deletions(-) create mode 100644 docs/releases/v1.1.0.md diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index a34aeb0..c3952dc 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -1,30 +1,9 @@ name: Release -# Push a tag v matching plugin.json to publish a GitHub Release with -# one unsigned plugin archive per macOS architecture and its SHA-256 file. -# -# No step receives a signing key. Checkouts do not keep the workflow token. -# -# Releases stay pre-releases, which Lithe Store's tracker skips, for these -# reasons: -# 1. Lithe still bundles Java Support under the old ID -# dev.lithe.plugin.java-support. -# 2. The package declares the Rust backend (backend 2), plugin-owned -# language server sessions (languageServers 3, requestMethods and -# commands) and plugin functions (pluginFunctions 1), and the backend -# links the Rust plugin SDK 0.3.0 (plugin function protocol 4). A host -# that predates the Lithe changes #1745 and #1746 does not offer them and -# rejects the package. Only the latest Lithe preview contains them so far; -# no stable Lithe does. The SDK also requires the host to offer -# litheLogging 1 and refuses to start without it. -# 3. The Maven and Gradle project templates have moved to lithe-plugin-maven -# and lithe-plugin-gradle. Until those plugins carry them, a release -# would drop the Maven and Gradle choices from New Project. -# Remove --prerelease below once a stable Lithe accepts the package (stage E in -# MIGRATION.md), stops bundling Java Support, and offers backend 2, -# languageServers 3, pluginFunctions 1 and litheLogging 1, and once the Maven -# and Gradle plugins are published. The Store then lists stable releases of -# this repository automatically. +# Tags must match plugin.json. Build unsigned macOS arm64/x64 and Windows +# x64 packages from the same source revision, then upload a draft prerelease. +# The maintainer verifies the downloaded assets before publishing the draft. +# Contract 0 currently requires the matching Viva preview, not stable Lithe. on: push: tags: ["v*"] @@ -57,9 +36,32 @@ jobs: - name: Check the pinned plugin SDK release run: scripts/verify-sdk-lock.sh --download + windows: + name: Build Windows x64 backend + runs-on: windows-latest + timeout-minutes: 30 + steps: + - uses: actions/checkout@v4 + with: + persist-credentials: false + - uses: dtolnay/rust-toolchain@stable + with: + targets: x86_64-pc-windows-msvc + - uses: Swatinem/rust-cache@v2 + - name: Test the native Windows backend + run: cargo test --workspace --locked --target x86_64-pc-windows-msvc + - name: Build the native Windows backend + run: cargo build --release --locked -p lithe-java-backend --target x86_64-pc-windows-msvc + - uses: actions/upload-artifact@v4 + with: + name: windows-backend + path: target/x86_64-pc-windows-msvc/release/lithe-java-backend.exe + if-no-files-found: error + retention-days: 7 + release: name: Publish ${{ github.ref_name }} - needs: test + needs: [test, windows] runs-on: macos-26 timeout-minutes: 60 permissions: @@ -73,6 +75,13 @@ jobs: - uses: dtolnay/rust-toolchain@stable with: targets: aarch64-apple-darwin, x86_64-apple-darwin + - uses: actions/setup-node@v4 + with: + node-version: 22 + - uses: actions/download-artifact@v4 + with: + name: windows-backend + path: .artifacts/windows-backend - name: Check the tag matches plugin.json run: | set -euo pipefail @@ -87,6 +96,12 @@ jobs: for arch in arm64 x86_64; do scripts/build-package.sh --arch "$arch" done + - name: Assemble the Windows archive + run: | + set -euo pipefail + archive=$(node scripts/package/build-windows.mjs .artifacts/windows-backend/lithe-java-backend.exe) + mkdir -p dist + cp "$archive" "$archive.sha256" dist/ - name: Archive and publish env: GH_TOKEN: ${{ github.token }} @@ -98,17 +113,16 @@ jobs: scripts/archive-package.sh --package ".artifacts/package/$arch/io.github.lithe-idea.java-support" \ --arch "$arch" >> "$checksums" done + notes="docs/releases/$GITHUB_REF_NAME.md" + test -s "$notes" + cp "$notes" "$RUNNER_TEMP/notes.md" { - echo "Java Support（\`io.github.lithe-idea.java-support\`）${GITHUB_REF_NAME#v}。每个 macOS 架构一个归档，附 SHA-256 文件。" - echo - echo "兼容性：目前的 Lithe 仍内置 Java Support；这个包还需要宿主提供 \`backend\` 2、\`languageServers\` 3、\`pluginFunctions\` 1 和 \`litheLogging\` 1（含 #1745、#1746 的 Lithe 预览版之后），不满足的版本会拒绝安装；稳定版要等 Lithe 主仓库完成 Java 拆分的阶段 E。Maven 与 Gradle 的新建项目模板已移交 lithe-plugin-maven 和 lithe-plugin-gradle，这两个插件接手前，这个包的新建项目里没有 Maven 和 Gradle 选项。" - echo - echo "安装：预发布版本，Lithe Store 自动追踪会跳过。宿主支持后下载对应架构的 ZIP，在 设置 → 插件 的 ⚙ 菜单中选择 从磁盘安装插件…。" echo - echo "SHA-256：" + echo '### SHA-256' echo '```' sed 's# dist/# #' "$checksums" + cat dist/*windows-x64.zip.sha256 echo '```' - } > "$RUNNER_TEMP/notes.md" - gh release create "$GITHUB_REF_NAME" dist/*.zip dist/*.zip.sha256 --verify-tag --prerelease \ + } >> "$RUNNER_TEMP/notes.md" + gh release create "$GITHUB_REF_NAME" dist/*.zip dist/*.zip.sha256 --verify-tag --draft --prerelease \ --title "Java Support $GITHUB_REF_NAME" --notes-file "$RUNNER_TEMP/notes.md" diff --git a/README.md b/README.md index 5f8fecb..679180b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Java Support for Lithe -> **Viva 最小 Maven 工作流（本地验证，尚未发布）**：清单已迁到当前契约 0，后端使用 Core +> **Viva 预览版 Java 支持（1.1.0）**：清单已迁到当前契约 0，后端使用 Core > `65cf82343c5e315aae2e335b2e8f0217b703e89a` 中的 Rust SDK 0.4.0（尚无对应发布标签）。 > 本轮验证含第三方 JAR 依赖的普通 Maven 工程：JDT 补全、Maven 编译、main 运行和断点调试，包含变量读取、继续和退出。 > 需要同时包含 Lithe 客户端的动作注册解码、动作刷新与首次调试加载修复；未修改这些行为的旧 preview 不能直接使用本包。 @@ -24,7 +24,7 @@ > SDK. Maven and Gradle import settings come from the Maven and Gradle plugins through a function interface that > Lithe Core relays between plugins. -当前源码面向配套 Viva preview，尚未发布。API / 能力与传输版本以 `plugin.json`、`sdk.lock.json` +1.1.0 面向包含主仓库 [#1884](https://github.com/1lck/Lithe-IDEA/pull/1884) 的配套 Viva preview（客户端修订 `607f00967d70a7017d49805183d0d2e6ffdf1c0d` 或更新版本）。API / 能力与传输版本以 `plugin.json`、`sdk.lock.json` 和固定 Core 中的[插件资料](https://github.com/Lithe-IDEA/Lithe-core-rust/tree/65cf82343c5e315aae2e335b2e8f0217b703e89a/shared/plugins)为准。 `MIGRATION.md` 保留迁移历史，不能用其中旧宿主、旧 API 数字推断当前兼容性。 @@ -187,7 +187,7 @@ Spring/MyBatis 等既有能力不属于本轮 Maven 验收范围。 后端把日志交给宿主的统一日志 `litheLogging` 0，不写 stderr。函数 ID 都是编译期常量，注册只会因 ID 写错、重复或超出 SDK 上限而失败，单元测试 `the_backend_builds_with_every_command_registered` 在 CI 里挡住这种构建；万一发生，进程在握手前以状态 1 退出， 由宿主记录启动失败（`backend/src/main.rs`）。当前固定的 Rust SDK 0.4.0 要求宿主提供 `litheLogging` 0， -不提供的 Lithe 版本会拒绝启动后端；本次只验证上述配套 Viva 检出，尚未发布。 +不提供的 Lithe 版本会拒绝启动后端；本次验证范围以本文列出的配套 Viva 检出为准。 | 事实 | 级别 | 来源 | 内容 | | --- | --- | --- | --- | @@ -260,7 +260,7 @@ scripts/archive-package.sh --package <上一步打印的目录> --arch arm64 # `plugin.json` 的完整格式只在固定 Core 的 `shared/plugins/contract/v1/`，不在本仓库维护副本。 -### Windows 开发包 +### Windows 包 在 Windows 从同一源码以 `--locked` 编译 x64 后端后，可在 macOS 组装用于原生验证的包： @@ -269,12 +269,12 @@ node scripts/package/build-windows.mjs /path/to/lithe-java-backend.exe ``` 脚本验证 x64 PE 与锁定 JDK 的 SHA-256，复用 JDT 构建入口，写入 `.artifacts/` 并清理组装临时目录。 -这是开发验证入口，不是 Windows 正式签名、安装器或发布工作流，也不能代替 Windows 运行验收。 +发布工作流在 Windows 从同一标签构建并测试 x64 后端，再通过此入口组装 ZIP；本地验证复用相同入口。包不带发布者签名，不含安装器，打包成功也不能代替 Windows 运行验收。 ## 发布新版本 构建和发布由现有工作流执行，正式发布前按 Lithe 的版本规则决定版本并核验兼容宿主。 -当前依赖 Viva preview，只能作为预发布；Windows 开发包尚未接入发布工作流。 +当前依赖 Viva preview，只能作为预发布。推送匹配版本的标签后，工作流为 macOS arm64/x64 与 Windows x64 生成 ZIP 和 SHA-256，并创建草稿预发布；维护者下载核对后再公开草稿。发布说明必须位于 `docs/releases/v<版本>.md`，缺失则终止发布。 不得覆盖已发布 ZIP，也不得将本地隔离试验的 JDT/JDK 资源当作生产升级：本轮生产仍固定 JDT LS 1.61 和 Temurin 21。 ## 许可 diff --git a/docs/releases/v1.1.0.md b/docs/releases/v1.1.0.md new file mode 100644 index 0000000..512abc5 --- /dev/null +++ b/docs/releases/v1.1.0.md @@ -0,0 +1,51 @@ +## 中文 + +Java Support 1.1.0 为配套 Viva 预览版提供 Java 项目支持。本版本是预发布，插件包不带发布者签名。 + +### 下载与安装 + +下载本页对应系统的 ZIP：macOS Apple Silicon（`darwin-arm64`）、macOS Intel（`darwin-x64`）或 Windows x64（`windows-x64`）。在兼容 Viva 客户端的插件设置中选择从文件安装 ZIP。 + +需要包含 [Lithe #1884](https://github.com/1lck/Lithe-IDEA/pull/1884) 的客户端（修订 `607f00967d70a7017d49805183d0d2e6ffdf1c0d` 或更新版本）及 Core #29。旧版 macOS Lithe 和未包含这些修复的 Viva preview 不受支持。插件使用契约/API/能力版本 0；语言服务器使用随包 Temurin 21，项目运行仍使用用户选择的 JDK。 + +Maven 项目配合 Maven 0.0.1；Gradle 项目配合 Gradle 1.0.0。构建工具由用户安装或由项目 Wrapper 提供。 + +### 更新 + +- 跑通普通 Maven、Gradle 和普通 Java 目录的补全、编译、运行及断点调试，Java 8 项目保留正确的编译目标。 +- 修复 Windows 可执行路径、中文/UNC 文件 URI、Lombok 加载及过长 classpath；退出后清理临时 classpath JAR。 +- 冷索引暂时无法返回运行动作时，在索引任务完成后有界恢复，不增加后台轮询。 +- 已在 macOS 与 Windows 无头验证断点变量、继续/停止、编译错误阻止运行旧 class、暂停时关闭及插件安装目录只读。 + +### 兼容性与已知限制 + +尚未完整验收原生窗口、全部日志/取消路径、JUnit/TestNG 行内运行器和 Spring/MyBatis。JSP HTTP/Servlet 调试通过不代表 JSP 源码补全或 JSP 断点；Ant 源码布局不代表执行 Ant target。Java 5/7 源码级别、长 module-path、JavaCC 生成模型、多版本 JAR 和部分旧泛型项目仍有限制，详见 README 与主仓库 #1881–1883。 + +实测 JDT 内存与补全延迟没有显著改善，本版本不宣称整体性能提升。Windows 的真实工作流在 ARM Windows 上使用 x64 工具验证，其耗时不代表原生 AMD64 性能。 + +--- + +## English + +Java Support 1.1.0 targets the matching Viva preview. This is a prerelease with unsigned plugin archives. + +### Download and installation + +Choose the ZIP for macOS Apple Silicon (`darwin-arm64`), macOS Intel (`darwin-x64`), or Windows x64 (`windows-x64`), then install it from a file in the compatible Viva client's plugin settings. + +The client must include [Lithe #1884](https://github.com/1lck/Lithe-IDEA/pull/1884), revision `607f00967d70a7017d49805183d0d2e6ffdf1c0d` or newer, and Core #29. Legacy macOS Lithe and earlier Viva previews are unsupported. Contract, API and capability versions are 0. Bundled Temurin 21 runs the language server; project execution uses the selected project JDK. + +Use Maven 0.0.1 for Maven projects and Gradle 1.0.0 for Gradle projects. Supply the build tool yourself or through the project's wrapper. + +### Changes + +- Validated completion, compilation, execution and breakpoint debugging for ordinary Maven, Gradle and plain Java projects, preserving Java 8 compilation targets. +- Fixed Windows executable paths, Unicode/UNC file URIs, Lombok loading and long classpaths; temporary classpath JARs are removed after execution. +- Recover run actions after cold-index jobs finish, with bounded retries and no background polling. +- Headless macOS and Windows workflows cover breakpoint locals, continue/stop, refusal to run stale classes after compilation errors, closing paused sessions and read-only installed packages. + +### Compatibility and known limitations + +Native windows, all logging/cancellation paths, inline JUnit/TestNG and Spring/MyBatis have not been fully accepted. JSP HTTP/Servlet debugging does not cover JSP-source completion or JSP breakpoints; Ant source layouts do not cover Ant targets. Java 5/7 source levels, long module-paths, JavaCC models, multi-release JARs and some older generic code remain limited; see README and Lithe #1881–1883. + +Measurements found no significant JDT memory or completion-latency improvement. Windows workflows used x64 tools on ARM Windows, so their timings do not represent native AMD64 performance. diff --git a/scripts/package/build-windows.mjs b/scripts/package/build-windows.mjs index e9e2f74..fd68d5c 100644 --- a/scripts/package/build-windows.mjs +++ b/scripts/package/build-windows.mjs @@ -1,7 +1,8 @@ #!/usr/bin/env node // Assemble on macOS, using the backend built from this checkout on Windows. // All runtime inputs come from the committed manifests; installed packages are -// never written. This is a development package, not a release/publishing entry. +// never written. Release CI supplies the backend artifact built from the same tag; +// the resulting unsigned ZIP is also used for native development validation. import { createHash } from 'node:crypto'; import { createReadStream, createWriteStream } from 'node:fs'; import { cp, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';