模块兼容性：API 版本与废弃预警

API 版本现状速览

用户的体感是什么

• 老模块（基于 82 一系）在新框架上依然能装能跑，生态没有断层
• 曾短暂存在的 100 版本模块需要在框架更新后跟进迁移
• 管理器会在模块详情页给出兼容性警告：看到废弃预警的模块，去作者发布页确认是否有新版本

New XSharedPreferences 的倒计时

官方更新日志明确预告：New XSharedPreferences 计划在 2.3.0 正式移除。判断逻辑与消除方式官方已给出——模块要么迁移到 libxposed，要么按规范调整声明。对模块作者，这是一张明确的时间表；对用户，看到相关警告的模块要留意作者的迁移动态。

新版本的行为变化要读

大版本更新时官方会列出"重大行为变更"，历史上影响过不少模块的例子：

• 基于调用栈深度判断环境的模块可能在新框架下异常（责任在模块，需作者适配）
• 通过非正规方式探测框架实现的模块可能与新框架冲突

遇到"框架升级后某模块不工作"，先翻官方更新记录里的行为变更条目，再向模块作者反馈——多数时候该适配的是模块，不是框架。

给作者的一句话

框架更新节奏已恢复活跃，把"每次框架发版后跑一遍回归测试"写进你的维护流程，比用户来反馈了再修体面得多。