English

First of all, wishing all users a Happy International Labor Day 5.1! Thank you for your continued support, feedback, and patience 🎉

We previously released v1.0.0 on our Telegram channel, but later discovered severe bugs affecting core functionality. We immediately pulled the version from GitHub and did not publish an official release for it. We strongly advise all users against using v1.0.0. This v1.0.1 release fully inherits all architectural upgrades and new features from v1.0.0, and completely fixes all critical issues, making it the first stable and usable official version of the v1.0 series.

We would also like to express our special thanks to community users who have long supported v0.7.4. As a long-term community-recommended stable build, it has been validated in extensive real-world scenarios and laid a solid foundation for project iteration. NPatch v1.0.1 delivers a full-dimensional leap forward, bringing a transformative interactive experience, stronger core capabilities, and more stable performance.

🎨 【Core Major Upgrade】Full Interface Reconstruction Based on Miuix (Inherited from v1.0.0)

This is the most representative upgrade of the v1.0 series. We have completely rebuilt the entire manager interface from scratch and fully migrated to the Miuix design system, delivering a unified, modern, and smooth visual and interactive experience:

1. Full design system overhaul: Refactored the homepage, patching page, app management page, module management page, settings page, repository page, and all other core pages based on Miuix. Unified visual specifications, corner radius constants, spacing standards, and component styles to eliminate the cluttered design of the old version.
2. Page architecture and logic decoupling: Split the heavily coupled code of the old NewPatchScreen, fully separated UI rendering from business logic, and extracted DoPatchBody and PatchOptionsBody as independent modules. Greatly improved page rendering performance, code maintainability, and future iteration efficiency.
3. State management and lifecycle optimization: Refactored the full-page state management mechanism and elevated Scaffold to the top level of NewPatchScreen to fix black screens during state switching. Improved DisposableEffect and BackHandler lifecycle control to automatically clean up temporary files and patching configurations asynchronously on page exit, preventing memory leaks and state residue. Refactored embedded module state management with by mutableStateOf to ensure Compose fully tracks state changes and resolves state loss.
4. Core interaction upgrade: Refactored the search component on the app selection page; added a 300 ms click cooldown to prevent rapid repeated taps and duplicate dialogs; supported RTL layout, replaced global back icons, and completed accessibility descriptions; added component clipping to fix visual overflow of rounded corners for polished details.
5. Full refactor and standardization of base components: Refactored core base components including AppItem, SuperSearchBar, SelectionColumn, and SelectionItem to unify design language and interaction behavior; added a global super search bar for fast app and module searching, significantly improving operational efficiency.

🔌 【v1.0.1 Core Focus】Full Vector Framework Compatibility & Underlying Adaptation

v1.0.1 prioritizes full integration of the Vector framework, with end-to-end adaptation and optimization. We unified underlying dependencies, build processes, and runtime compatibility to resolve multiple compilation and runtime anomalies caused by framework integration:

1. Underlying code adaptation: Fixed architectural compatibility issues in the C++ code of patch-loader, adjusted core definitions in config_impl.h and patch_loader.h, and resolved JNI runtime crashes and logic errors.
2. Build process compatibility: Corrected CMake parameter passing and legacy dependency resolution failures, ensuring Vector dependencies link and compile correctly across all build modes.
3. Project-wide package and namespace unification: Fully adopted the org.lsposed.npatch package convention, updated imports and references across manager, patch, and patch-loader modules to eliminate namespace conflicts and ensure full Vector compatibility.
4. Upper-layer call logic adaptation: Updated core calling logic between the Patcher and ViewModel layers to align with Vector framework API specifications, ensuring stable execution of the entire patching workflow without parameter or call exceptions.

🚨 【v1.0.1 Core Fixes】All Critical Bugs in v1.0.0 Resolved

We have fully fixed the severe usability-breaking bugs that led to the retraction of v1.0.0, guaranteeing 100% stability of core processes:

1. Fixed Dex loss and startup crashes in low-level signature modes: Corrected the logic in NPatch.java that unconditionally removed original classes*.dex during packaging. Removal now only occurs when sigBypassLevel ≥ 2; original dex files are preserved in lv0/lv1 modes to ensure native app execution.
2. Fixed LSPApplication startup crashes: Added protection for origin.apk extraction in lv0/lv1 modes to resolve IOException crashes caused by attempting to extract a non-existent installation package.
3. Optimized Metaloader injection: Adjusted loader dex naming to append as classes{N+1}.dex in lv0/lv1 modes to avoid conflicts with original dex files; fixed injectProvider’s dependency on origin.apk by extracting provider.dex to a dedicated fixed path, ensuring normal injection functionality across all signature levels.
4. Fixed patching config parameter sync issues: Corrected the PatchConfig constructor logic to properly synchronize the outer sigBypassLevel to the inner LSPConfig, fully resolving the bug where the signature bypass level incorrectly reverts to lv0 when generating config.json.
5. Fixed embedded module dialog display anomalies in Miuix: Resolved SuperDialog visibility issues caused by Composition-scope isolation by moving the dialog into the Scaffold content scope, ensuring state changes properly trigger page recomposition.
6. Fixed page state race conditions: Resolved the unexpected file picker opening when returning from SelectAppsScreen; optimized page back navigation and state cleanup triggered by BackHandler and TopAppBar actions to prevent memory leaks and state residue.

🔐 Core Engine & Signature Bypass Capability Upgrade (Inherited from v1.0.0)

1. Refactored signature bypass tiered architecture: Added a new LV3 "IO Redirection" signature bypass scheme, integrated the SRPatch tech stack for deep Context spoofing, PackageInfo interception, and Java framework path redirection; renamed the original LV3 (SVC/Seccomp Hook) to LV4, fully supporting configurable 0–4 level bypass capabilities.
2. Added advanced protection bypass: LV3/LV4 modes now support appComponentFactory detection bypass with a dynamic attribute restoration mechanism, perfectly defending against static file reading on stubs and dynamic API query detection.
3. Adjusted system version requirement: Raised the minimum supported version to Android 9.0 (API 28) to improve signature verification removal effectiveness; Android 8.1 is no longer supported.
4. Underlying stability optimization: Rewrote SVC redirection logic using async-signal-safe primitives instead of non-signal-safe synchronization to fully resolve deadlocks and undefined behavior; fixed JNI compilation and linking errors, optimized Native Library loading to resolve failures caused by permission denials.
5. Compatibility extension: Adjusted .so file alignment in APKs from 4 KB to 16 KB to meet Android 15+ 16 KB page alignment requirements; optimized DexFile and XResources calls via reflection to fix class resolution failures and deprecated API compatibility issues on newer Android versions.

🆕 New Features (Inherited from v1.0.0)

1. Complete online module repository: Full-featured module repository including list, detail pages, GitHub Markdown rendering, version history, and contributor display; one-click installation of high-quality community Xposed modules to complete the ecosystem.
2. Native MicroG support: Added lightweight MicroG integration and GMS request redirection; patched Google apps run properly with community MicroG; automatically injects required permissions and components for signature spoofing, enabling full-link interception and redirection for Intent, ContentResolver, and PackageManager.
3. In-app language switching: Added a language selector in Settings, supporting system default and 40+ languages; changes take effect immediately with a page restart (no app restart required).
4. Experience improvements: Auto-refresh module list after app uninstall; redesigned homepage layout with improved patching guidance and status feedback; fixed non-responsive embed button; standardized global code structure and import ordering.

🛠️ Engineering System & Code Optimization

1. Unified logging specification & storage: Added XLog utility with improved whitelist filtering, standardized project-wide logging; all NP startup, patch debugging, and module runtime logs are stored in /sdcard/Android/media/{PackageName}/npatch/log/ for centralized management and faster troubleshooting; removed redundant manual log prints.
2. Standardized troubleshooting guide: For crashes in apps patched with old versions, first re-patch with v1.0.1; if issues persist, enable logging and submit the latest log archive from the above path for quick diagnosis.
3. Dependency & build optimization: Cleaned up Version Catalog, removed obsolete dependencies such as Accompanist; upgraded Gradle to 8.14.4 and Kotlin to 2.3.21; optimized build rules and excluded redundant artifacts to reduce APK size.
4. Multilingual completion & standardization: Completed translations for logging, module repository, homepage tags, covering 12+ major languages; unified string resource naming for consistent multilingual display.
5. Code refinement: Removed redundant debug logs, unused imports, and dead code project-wide; standardized import ordering and structure for better readability and maintainability.

📋 Upgrade Recommendations

• All users on the classic stable v0.7.4 build are strongly recommended to upgrade directly to v1.0.1 for the new Miuix interface, full Vector framework support, and enhanced signature bypass capabilities.
• Users who installed v1.0.0 must upgrade to v1.0.1 immediately to resolve all critical crashes and functional anomalies.
• Minimum system requirement: Android 9.0 (API 28) or above.

中文

首先祝各位用户 5.1 国际劳动节快乐！感谢大家一直以来的支持、反馈与耐心等待 🎉

关于版本说明：此前我们曾在 TG 频道发布过 v1.0.0 版本，后续发现该版本存在影响核心使用的严重 Bug，因此第一时间从 GitHub 完成撤包，未对外保留正式 Release，强烈不建议任何用户继续使用 v1.0.0。本次发布的 v1.0.1，完整继承了 v1.0.0 的全部架构升级与新特性，同时彻底修复了所有致命问题，是 v1.0 系列首个正式稳定可用版本。

在此也特别致谢长期支持与使用 v0.7.4 的社区用户——该版本作为社区长期推荐的稳定版，历经海量场景验证，为项目迭代奠定了坚实基础。本次 v1.0.1 在其之上完成了全维度的能力跃升，带来了颠覆性的交互体验、更强的核心能力与更稳定的运行表现。

🎨 【核心重磅升級】基於 Miuix 的全量介面重構（繼承自 v1.0.0）

这是 v1.0 系列最具代表性的升级，我们对管理器全页面进行了从零到一的彻底重做，全面迁移至 Miuix 设计体系，带来统一、现代、流畅的视觉与交互体验：

1. 全页面设计体系重做：基于 Miuix 重构主页、修补页、应用管理页、模组管理页、设置页、仓库页等全量核心页面，统一视觉规范、圆角常量、间距标准与组件样式，彻底告别旧版杂乱的设计风格。
2. 页面架构与逻辑解耦重构：拆分旧版 NewPatchScreen 庞杂的耦合代码，将 UI 渲染与业务逻辑彻底分离，抽离出 DoPatchBody 与 PatchOptionsBody 独立模块，大幅提升页面渲染性能、代码可维护性与后续迭代效率。
3. 状态管理与生命周期全面优化：重构全页面状态管理机制，将 Scaffold 提升至 NewPatchScreen 顶层，解决状态切换过程中的黑屏问题；完善 DisposableEffect 与 BackHandler 生命周期管控，页面退出时自动异步清理临时文件与修补配置，避免内存泄露与状态残留；使用 by mutableStateOf 重构嵌入模组状态管理，确保 Compose 可完整跟踪状态变更，解决状态丢失问题。
4. 核心交互体验全面升级：重构应用选择页搜索组件；新增防快速点击机制，引入 300 ms 点击冷却检查，避免对话框重复开启；适配 RTL 布局，替换全局返回图标并补全无障碍描述；为组件新增 clip 裁剪，修复圆角视觉溢出问题，细节体验全面优化。
5. 基础组件全量重构与规范化：重构 AppItem、SuperSearchBar、SelectionColumn、SelectionItem 等核心基础组件，统一设计语言与交互行为；新增全域超级搜索栏，实现应用与模组的全域快速搜索，大幅提升操作效率。

🔌 【v1.0.1 核心重點】Vector 框架全量相容與底層適配

本次 v1.0.1 将 Vector 框架完整兼容作为核心环节，完成了全链路的适配与优化，打通了底层依赖、构建流程与运行时兼容，解决了多项框架整合导致的编译与运行异常：

1. 完成底层代码适配：修正 patch-loader 底层 C++ 代码的架构兼容问题，调整 config_impl.h、patch_loader.h 中的核心定义，修复 JNI 层运行时崩溃与逻辑异常。
2. 修复构建流程兼容问题：修正 CMake 参数传递与 legacy 依赖解析异常，确保 Vector 依赖在全构建模式下可正常链接与编译。
3. 全项目包名与命名空间统一：全面转向 org.lsposed.npatch 包名规范，更新 manager、patch、patch-loader 全模块的导入与引用，确保与 Vector 框架的命名空间无冲突、完全兼容。
4. 上层调用逻辑适配：更新 Patcher 与 ViewModel 层的核心调用逻辑，对齐 Vector 框架的 API 规范，确保修补全流程可正常执行，无参数传递与调用异常。

🚨 【v1.0.1 核心修復】v1.0.0 致命 Bug 全數解決

针对 v1.0.0 撤包的核心原因——影响使用的严重 Bug，本次 v1.0.1 进行了彻底修复，确保核心流程 100% 稳定可用：

1. 修复低等级签名模式 Dex 遗失与启动崩溃：修正 NPatch.java 打包时无条件移除原始 classes*.dex 的逻辑，仅在 sigBypassLevel >= 2 时执行移除，lv0/lv1 模式下完整保留原始 dex 文件，确保应用原生正常运行。
2. 修复 LSPApplication 启动崩溃：为 lv0/lv1 模式下 origin.apk 提取逻辑新增防护，解决因尝试提取不存在的安装包导致的 IOException 崩溃。
3. 优化 Metaloader 注入机制：调整加载器 dex 命名规则，lv0/lv1 模式下以 classes{N+1}.dex 形式追加，避免与原始 dex 命名冲突；修复 injectProvider 注入功能依赖 origin.apk 的异常，provider.dex 解压至独立固定路径，确保所有签名等级下注入功能正常运行。
4. 修复修补配置参数同步异常：修正 PatchConfig 构造函数逻辑，确保外层 sigBypassLevel 正确同步至内层 LSPConfig，彻底解决生成 config.json 时去签等级异常退回 lv0 的 Bug。
5. 彻底修复 Miuix 界面内嵌模组对话框显示异常：解决 Composition-scope 隔离导致的 SuperDialog 点击后不显示、显示异常的核心问题，将对话框移入 Scaffold content 作用域，确保状态变更可正常驱动页面重组。
6. 修复页面状态竞态问题：解决从 SelectAppsScreen 返回时文件选择器意外开启的 Race Condition 问题；优化页面返回与导航逻辑，由 BackHandler 与 TopAppBar 导航动作主动触发状态清理，避免内存泄露与状态残留。

🔐 核心引擎與簽名繞過能力升級（繼承自 v1.0.0）

1. 重构签名绕过等级架构：新增 LV3「IO 重定向」去签方案，整合 SRPatch 技术栈实现 Context 深度欺骗、PackageInfo 拦截与 Java 框架层路径重定向；将原有 LV3 (SVC/Seccomp Hook) 调整为 LV4，完整支持 0-4 级可配置绕过能力。
2. 新增高阶防护绕过能力：LV3/LV4 模式新增 appComponentFactory 检测绕过，实现动态属性还原机制，可完美防御针对 Stub 的静态文件读取与动态 API 查询检测。
3. 系统版本边界调整：为提升签名校验去除效果，最低支持版本提升至 Android 9.0 (API 28)，不再支持 Android 8.1。
4. 底层稳定性优化：重写 SVC 重定向逻辑，使用 Async-Signal-Safe 原语替代非信号安全的同步机制，彻底解决死锁与未定义行为问题；修复 JNI 编译与链接错误，优化 Native Library 加载机制，解决权限拒绝导致的加载失败问题。
5. 兼容性扩展：修补 APK 中的 .so 文件对齐规则从 4 KB 调整为 16 KB，兼容 Android 15+ 16 KB 页面对齐要求；通过反射优化 DexFile 与 XResources 调用，解决高版本 Android 上的类解析失败与弃用 API 兼容性问题。

🆕 全新功能上線（繼承自 v1.0.0）

1. 完整在线模组仓库：实现模组仓库全流程功能，包含模组列表、详情页、GitHub Markdown 文档渲染、版本发布记录与协作者展示，一键获取并安装社区优质 Xposed 模组，补全了生态闭环。
2. 原生 MicroG 支持：新增轻量级 MicroG 整合与 GMS 请求重定向机制，修补后的 Google 应用可通过社群版 MicroG 正常运行；自动注入签名欺骗所需权限与节点，实现 Intent、ContentResolver、PackageManager 的全链路拦截与重定向。
3. 应用内多语言切换：在设置页新增语言选择器，支持系统默认与 40+ 种语言手动切换，切换后立即重启页面生效，无需重启应用，满足全球用户使用需求_（未來考慮加入趣味語言如喵喵語和文言文）_。
4. 体验优化细节：新增应用卸载后自动刷新模组列表功能；重构主页布局，优化修补全流程引导与状态反馈；修复新增嵌入按钮点击失效问题，规范全局代码结构与导入排序。

🛠️ 工程體系與代碼優化

1. 统一日志输出规范与存储体系：新增 XLog 工具类，完善白名单过滤机制，统一全项目日志输出逻辑；新版本中，所有与 NP 启动相关的日志、补丁调试日志、模块运行日志，将统一存放至对应应用的 /sdcard/Android/media/{PackageName}/npatch/log/ 目录下，实现日志集中化管理，大幅提升问题排查效率；移除冗余的手动日志打印代码，精简代码的同时提升日志管理的统一性与可维护性。
2. 新增标准化问题排查指引：若旧版本修补的应用出现闪退，建议先尝试使用 v1.0.1 新版重新修补；若仍存在异常，可开启日志输出功能，提交上述日志路径下的最新日志档案，便于开发团队快速定位与修复问题。
3. 依赖与构建优化：清理 Version Catalog，移除 Accompanist 等过时、未使用的依赖项；更新 Gradle 至 8.14.4，更新 Kotlin 至 2.3.21，优化构建规则，排除无用产物，进一步缩减安装包体积。
4. 多语言补全与规范：补全日志输出、模组仓库、主页标签等场景的翻译，覆盖简体中文、繁体中文、英文、日文、法文、德文、意大利语等 12+ 主流语言；统一字符串资源命名规范，确保多语言展示一致性。
5. 代码精简与规范：移除全项目冗余的 debug 日志、无效导入与未使用代码，规范导入排序与代码结构，提升可读性与可维护性。

📋 升級建議

• 所有仍在使用 v0.7.4 经典稳定版的用户，强烈推荐直接升级至 v1.0.1 正式版，体验全新 Miuix 界面、Vector 框架兼容支持与更强的签名绕过能力；
• 此前安装过 v1.0.0 的用户，请务必立即升级至 v1.0.1，彻底解决核心崩溃与功能异常问题；
• 最低运行要求：Android 9.0 (API 28) 及以上版本。

再次祝各位劳动节快乐，愿大家度过一个愉快的假期！🎊