Rhino for AutoJs6

语言

• 简体中文 [zh-Hans] # 当前
• 繁體中文 (香港) [zh-Hant-HK]
• 繁體中文 (台灣) [zh-Hant-TW]
• English [en]
• Français [fr]
• Español [es]
• 日本語 [ja]
• 한국어 [ko]
• Русский [ru]
• العربية [ar]

Rhino for AutoJs6 是面向 AutoJs6 的 Rhino JavaScript 引擎分支. 本仓库在 Mozilla Rhino 的基础上维护 Android 兼容性与宿主集成适配, 为 AutoJs6 提供引擎源码和完整 JAR 的构建入口.

原始 Rhino 官方文档

阅读原始 Rhino 官方 README. 该入口固定到提交 d878324a6f515c09d8ca49005fdd22b944b4df89, 保留上游原有语言与相对链接的上下文. 这份原始文档仅作留存, 不参与翻译; 本页及其其他语言版本介绍本分支.

另提供逐字节保存的 README 原始文本 与 来源及校验记录. 持续维护的资料可参阅 Rhino 官方仓库 和 官方文档站. 上游 RELEASE-NOTES.md 保留原文.

分支维护范围

• Android 反射, 线程上下文与旧版系统兼容性, 以及 AutoJs6 使用的作用域和 Java 互操作接口.
• XML/E4X 与 AutoJs6 UI 模式的适配, 保留宿主所需的 XML 解析行为.
• 引擎错误消息的多语言资源, 与本仓库 README/CHANGELOG 的多语言文档分别维护.
• 保留桌面 JVM 工具与服务资源的完整 rhino-all JAR, 供宿主进一步派生 Android 运行时包.

构建与验证

使用本仓库的 Gradle Wrapper 和 JDK 21 或更高版本. Java 源码按 Java 17 编译目标构建. 在仓库根目录运行以下命令, Windows 使用第二条命令:

./gradlew :rhino-all:shadowJar --console=plain --max-workers=4

.\gradlew.bat :rhino-all:shadowJar --console=plain --max-workers=4

完整产物位于 rhino-all/build/libs/rhino-all-<version>.jar, 版本取自 gradle.properties. 该产物包含核心引擎, 工具, XML/E4X 与 JLine. 宿主集成应使用此完整包.

以下命令初始化测试子模块, 运行主要模块与集成测试, 再执行完整检查. Windows 将 ./gradlew 替换为 .\gradlew.bat.

git submodule update --init
./gradlew :rhino:test :rhino-xml:test :rhino-tools:test :rhino-engine:test :tests:test
./gradlew check

与 AutoJs6 集成

AutoJs6 从 libs/org-mozilla-rhino-2_0_0-SNAPSHOT.jar 引用完整 JAR. 宿主的 slimRhinoJar 任务生成 Android 运行时包, 移除 JLine, JVM 优化编译器与 JFR 组件, 保留解释器, XML 和调试能力. 更新引擎时还需验证宿主的编译, D8/APK 打包与相关脚本行为; 单独构建 Rhino 成功不能替代这些验证.

相关项目与反馈

AutoJs6 仓库 / AutoJs6 脚本文档 / 本分支问题反馈. Rhino 通用 API 与上游贡献说明可从原始官方文档入口查阅.

分支维护记录

此处按日期记录本分支的维护变更. Rhino 官方发行历史继续保留在上游发行说明中, 不作为本分支的新版本记录.

2026-10-15

2026/10/15

• 修复 错误消息中的参数占位符及大括号转义, 避免本地化诊断丢失上下文或触发 MessageFormat 异常
• 优化 ArrayBuffer, DataView, TypedArray, 正则表达式及解构等 28 条引擎错误消息补齐 9 种非英语翻译

2026-10-13

2026/10/13

• 新增 分支专属介绍与维护记录支持 10 种语言, 各语言均保留原始 Rhino 官方文档入口
• 优化 README/CHANGELOG 支持从 JSON 和模板离线生成, 并通过只读检查与 CI 校验文档一致性

完整分支维护记录

多语言文档维护

修改 .readme/ 与 .changelog/ 中的语言 JSON 和模板, 然后重新生成文档. 简体中文为内容基准, 根目录 README 使用简体中文. 需要 Python 3.10 或更高版本, 无额外 Python 依赖; Windows 可用 py 替代 python. 生成与 --check 均离线运行, 检查模式不写文件. CI 在 Windows 与 Ubuntu 上检查译文结构, 引用, 原文快照完整性及生成产物.

python .python/generate_markdown.py
python .python/generate_markdown.py --check
python -m unittest discover -s .python/tests

许可证

Rhino 使用 MPL 2.0 许可证. 原始文档与源码保留上游版权及许可声明.