Heimdall v0.1.1-alpha.1

Heimdall 0.1.1 Alpha Release Notes

Release tag: v0.1.1-alpha.1

English | 简体中文

English

Update Guidance

• The official 0.1.1-alpha.1 APK is designed to update the existing public 0.1.0-alpha.1 package in place. Do not uninstall first unless troubleshooting requires it; uninstalling removes local App data.
• Export important Profiles before updating. New exports use a self-contained .heimdall-profile bundle with supported Profile icons, maps, file Guides, user Macro icons, and Canvas images. Older configuration-only JSON remains importable but cannot recover source assets that were never included.
• Accessibility, Shizuku, and MediaProjection authorization may need to be checked again after an Android or Shizuku state change.

Highlights

• Added validated, self-contained Profile bundles with content-addressed assets, size and type checks, atomic installation, legacy JSON compatibility, and snapshot-first protection for replace-all imports.
• Expanded Guides with long-text reading, saved reading position, bookmarks, and safer local file handling.
• Added a true circular lower-screen presentation option for the live magnifier while preserving its source-sized direct-Surface capture path, Profile crop, and Grid destination behavior.
• Added per-module Macro icon-only presentation and per-Canvas circular cropping. Legacy Profiles keep icon + label Macro buttons and rectangular Canvases by default.
• Added a Profile-owned Enhanced Touch controller-macro protection setting. Protection remains enabled by default; disable it only when Thor's built-in mapping is off. Screen steps continue to use the strict mapping-compatible touch route.
• Improved recorded Android Back, Home, and Recent controller Macro replay by keeping balanced navigation sequences together across the Shizuku boundary, with malformed-sequence and timeout guards.
• Reduced repeated touch-route error prompts and made normal touch-surface cancellation release and recenter quietly without hiding actionable failures.
• Added privacy-limited stability diagnostics and a fail-safe that suspends the optional Thor performance-compatibility compositor under memory, thermal, or lifecycle pressure.

Verification Scope

The included feature batches passed their recorded owner-operated AYN Thor checks in Debug builds, including Profile migration, Guide reading, circular magnifier behavior, Enhanced Touch protection, controller navigation replay, loading stability, Macro icon-only presentation, Canvas circular crop, and touch-surface cancellation. On August 12, 2026, the frozen runtime payload also completed the owner-operated release acceptance matrix in a real-signed 0.1.1-alpha.1 candidate. Build and static verification are recorded separately and do not substitute for that device evidence.

Known Limitations

• Heimdall targets AYN Thor and does not guarantee compatibility with every firmware, controller mode, game, emulator, or other dual-screen device.
• Mapping-compatible Enhanced Touch depends on the tested Thor vendor touch route and an authorized Shizuku UserService. A cold Shizuku connection can make the first attempt unavailable; wait for the service and retry. Do not assume other firmware provides the same route.
• Basic Accessibility touch and Thor's built-in mapper use separate touch streams and may cancel each other during simultaneous operation.
• Thor's mapper may hide mapped controller buttons from Heimdall's recorder. Controller identity, event path, and right-stick axes remain capability-resolved rather than fixed.
• One live magnifier is supported per Profile, and magnification cannot share MediaProjection with recording. After some lower-screen page transitions, a frozen magnifier can omit its Stop marker or retain the final frame after stopping; use Quick Actions or Settings if the overlay control is absent.
• Game-audio capture depends on whether the upper App permits Android Audio Playback Capture.
• Android platform backup remains disabled. Keep an exported .heimdall-profile bundle outside the App before uninstalling or replacing device data.

简体中文

更新说明

• 正式的 0.1.1-alpha.1 APK 设计为直接覆盖安装现有公开版 0.1.0-alpha.1。除非排障需要，请不要先卸载；卸载会清除 App 本地数据。
• 更新前请先导出重要 Profile。新版导出使用自包含 .heimdall-profile 迁移包，可包含受支持的 Profile 图标、地图、文件 Guide、用户 Macro 图标和 Canvas 图片。旧版仅配置 JSON 仍可导入，但无法恢复当时没有打包的源资源。
• Android 或 Shizuku 状态发生变化后，可能需要重新检查无障碍、Shizuku 和 MediaProjection 授权。

主要改进

• 新增经过完整校验的自包含 Profile 迁移包：资源按内容寻址，校验大小和类型，使用原子安装，兼容旧 JSON，并在“全部替换”前保留恢复快照。
• 改进 Guide：支持长文本阅读、阅读位置保存、书签以及更安全的本地文件处理。
• 为实时放大镜新增真正的下屏圆形显示，同时保留源尺寸直连 Surface 捕获、Profile 选区和 Grid 目标区域行为。
• 新增按 Macro 模块保存的“仅图标”显示，以及按 Canvas 保存的圆形裁剪。旧 Profile 默认仍为“图标 + 文字”和矩形 Canvas。
• 新增 Profile 级“增强触控手柄宏保护”。默认保持开启；只有在 Thor 自带映射关闭时才应主动关闭。屏幕步骤仍严格使用映射兼容触控路线。
• 改进录制的 Android 返回、主页和最近任务手柄宏：成对导航序列会整体通过 Shizuku 边界，并增加畸形序列与超时保护。
• 减少触控路线不可用时的重复提示；正常触控面退出现在会安静释放并回中，同时保留真正可操作的错误提示。
• 新增隐私受限的稳定性诊断；在内存、温度或生命周期压力下，会暂停可选的 Thor 性能兼容合成层以降低额外负载。

验证范围

本版本包含的功能批次均通过了已记录的 AYN Thor 机主 Debug 实机检查，覆盖 Profile 迁移、Guide 阅读、圆形放大镜、增强触控保护、系统导航手柄宏、游戏加载稳定性、Macro 仅图标、Canvas 圆形裁剪和触控面退出。2026 年 8 月 12 日，冻结的运行时载荷也通过一个真实签名的 0.1.1-alpha.1 candidate 完成了机主执行的 release 验收矩阵。Build 与静态检查会单独记录，不能替代这份实机证据。

已知限制

• Heimdall 面向 AYN Thor，不保证兼容所有固件、手柄模式、游戏、模拟器或其他双屏设备。
• 映射兼容的增强触控依赖已测试的 Thor 厂商触控路线和已授权的 Shizuku UserService。Shizuku 冷连接时首次操作可能暂不可用，请等待服务连接后重试；不要假设其他固件提供相同路线。
• 基础无障碍触控与 Thor 自带映射使用不同触控流，同时操作时可能互相取消。
• Thor 映射可能让已映射按键无法进入 Heimdall 录制流。手柄身份、事件路径和右摇杆轴仍按设备能力动态解析，不使用固定编号。
• 每个 Profile 当前支持一个实时放大镜，且不能与录屏同时占用 MediaProjection。某些下屏页面切换后，冻结画面可能缺少 Stop 标记，停止后也可能保留最后一帧；若悬浮控制缺失，请使用快捷操作或设置停止。
• 游戏声音能否录制取决于上屏 App 是否允许 Android Audio Playback Capture。
• Android 平台备份仍处于关闭状态。卸载或替换设备数据前，请把 .heimdall-profile 迁移包保存在 App 外部。

Build integrity

• Source commit: f94fc6abccfae038566cbe7f84507ce4bbfc48fa
• Package: com.mastercook777.heimdall
• Version code: 3
• Version: 0.1.1-alpha.1
• Signing certificate SHA-256: 7B779E4A082DDBC00FF47706B3B3A9E91B2594E33EA39DFE1376E1DBA538F458
• APK SHA-256: 79a0bbb2c9c4cb2f60076e738a74efa88e059f158f777a17683339a21e679ef2