Skip to content

v1.8.0

Choose a tag to compare

@github-actions github-actions released this 15 Oct 08:28
a812a70

Shellsmith v1.8.0

这是当前的 正式版本。本版本的具体变更见下方自动生成列表。

This is the current stable release. See the generated changelog below for version-specific changes.

下载 / Downloads

  • Windows:Shellsmith_1.8.0_windows_x64_setup.exe
  • macOS:Shellsmith_1.8.0_macos_universal.dmg
  • Linux:选择 .AppImage 或 .deb 安装包 / Choose the .AppImage or .deb package
  • Android:Shellsmith_1.8.0_android-runtime.zip,包含桌面加固 APK/AAB 所需的 Stub、API 19 兼容资源与 PVM2 Packer;它不是可直接安装在手机上的 GUI / Android runtime resources for desktop APK/AAB protection; not an installable Android GUI

使用须知 / Notes

  • 需要完整 JDK 8 或更高版本(含 java 与 keytool) / A full JDK 8 or later with java and keytool is required
  • 加固、签名和证书资料均在本地处理,不会上传用户文件 / APKs, signing keys, and certificates are processed locally and never uploaded
  • 安装包尚未进行商业代码签名或公证;首次运行请参考 README / Installers are not currently code-signed or notarized; see the README before the first launch
  • 当前桌面 GUI/CLI 支持 APK 与 AAB;Android runtime zip 是桌面加固所需资源,不是可直接安装在手机上的 GUI / The desktop GUI/CLI support APK and AAB; the Android runtime zip contains protection resources and is not an installable Android GUI

本次变更 / What's Changed

以下列表由 GitHub 根据本版本与上一正式版本之间的拉取请求和提交自动生成,完整覆盖本次正式版本周期。

The following changelog is generated by GitHub from pull requests and commits since the previous stable release, covering the complete release cycle.

离线项目资料与方法级保护

  • 加固时按包名与运行证书自动生成、复用项目专属保护资料,每次构建派生不同材料;设置页支持查看身份、导出与恢复备份。默认完全离线,手机安装即用。
  • APK/AAB 支持必保方法清单与逐产物报告,区分选择、转换、产物核验和未覆盖原因;签名后绑定最终文件摘要。未转换的方法不会计入 VMP 覆盖,必保项失败会阻断交付。
  • 扩展 PVM2 参数类型和异常路径验证,修复包装对象跨 JNI 传递的语义;加强并发调用结束后的镜像、解析副本和寄存器清理,以及运行时完整性核验。
  • Native VMP 源码 SDK 扩展整数、float/double、分支/循环、min/max 和漏斗移位,并增加对象、最终 ELF 及 APK/AAB 条目的构建证据核验;修复 CMake 接入与增量构建问题。
  • 从仓库源码重建 PVM2 打包器并核对依赖摘要;修复默认 Application 的自闭合 Manifest 标签属性写入,减少普通 APK 接入失败。

使用与验证范围

  • Native VMP 需要业务源码或兼容 LLVM bitcode,通过函数标注接入;当前仍不支持指针、内存访问、通用调用、异常、原子和向量,不能自动虚拟化任意预编译 SO。推荐 LLVM 21、NDK r29 与 Ninja。
  • 111 个 Native 语义测试函数通过宿主检查及单台 Android 15 设备 ARM64/ARMv7 对照。授权业务样本验证了 19 个 DEX 方法及 1 个 SO 内的 1 个 Native 函数;这不是整包或全部业务覆盖。
  • 项目私有种子保存在本机,备份包含私有材料,应妥善保存。安装即用的 APK 仍有公开恢复路径;本版不承诺无法静态还原,也不宣称达到某个加固代数。
  • 新 SO 产物尚未完成正式整包性能与跨设备验收;无资源 APK 重打包及 AAB 业务全流程仍需按项目验证。升级后请重新加固并进行业务回归,已有 APK 不会自动获得新保护。
  • 方法保护需要 JDK 17。详细接入与边界见使用指南和Native SDK。

本次自动构建 / This automated build

  • 提交 / Commit: a812a70 — fix: 兼容新版 Clippy 并前置发布质量检查 (#24)

文件变更统计 / File change summary

.github/workflows/ci.yml | 1 -
crates/shield-core/src/local_secret.rs | 2 +-
docs/process/release.md | 4 ++--
scripts/tests/test_android_api19_build_contract.py | 4 +++-
4 files changed, 6 insertions(+), 5 deletions(-)


其他变更

  • feat: 发布 1.8.0 离线代码保护升级 by @kairowan in #23
  • fix: 修复 1.8.0 发布质量检查 by @kairowan in #24

Full Changelog: v1.7.0...v1.8.0