HMSPush源码架构解析：三模块设计（app、common、xposed）的巧妙之处

HMSPush源码架构解析三模块设计app、common、xposed的巧妙之处【免费下载链接】HMSPush让非华为设备支持 HMS 推送同时避免唤醒目标应用项目地址: https://gitcode.com/gh_mirrors/hm/HMSPushHMSPush是一个创新的Android模块它让非华为设备也能支持HMS推送服务同时避免唤醒目标应用。这个项目的巧妙之处在于其清晰的三模块架构设计app模块提供用户界面common模块封装共享逻辑xposed模块实现核心Hook功能。本文将深入解析HMSPush的架构设计揭示其如何通过模块化设计实现高效的系统级推送支持。模块化架构概述HMSPush采用经典的模块化设计将不同功能职责清晰地分离到三个独立模块中app模块 - 用户界面层app模块是HMSPush的用户界面部分基于Android应用架构构建。它负责提供配置界面、应用管理、设备伪装设置等用户交互功能。该模块位于app/目录下包含完整的Android应用组件。主要文件结构app/src/main/java/one/yufz/hmspush/app/MainActivity.kt - 主活动入口app/src/main/java/one/yufz/hmspush/app/home/ - 主页相关组件app/src/main/java/one/yufz/hmspush/app/fake/ - 设备伪装功能common模块 - 共享逻辑层common模块是整个项目的核心共享库包含所有模块都需要使用的通用工具类、数据模型和常量定义。这个模块的设计体现了代码复用的最佳实践。关键文件common/src/main/java/one/yufz/hmspush/common/Constant.kt - 定义所有常量common/src/main/java/one/yufz/hmspush/common/model/ - 数据模型定义common/src/main/java/one/yufz/hmspush/common/content/ - 内容提供相关工具xposed模块 - Hook实现层xposed模块是HMSPush的技术核心通过Xposed框架实现对系统服务和HMS Core的Hook操作。这个模块实现了推送转发、设备伪装、通知处理等关键功能。核心文件xposed/src/main/java/one/yufz/hmspush/hook/XposedMod.kt - Xposed模块入口xposed/src/main/java/one/yufz/hmspush/hook/hms/ - HMS核心Hook实现xposed/src/main/java/one/yufz/hmspush/hook/fakedevice/ - 设备伪装功能模块间依赖关系HMSPush的模块依赖关系设计得非常巧妙app模块→common模块app模块依赖common模块使用其中定义的常量、模型和工具类xposed模块→common模块xposed模块同样依赖common模块共享核心逻辑app模块与xposed模块相互独立这两个模块通过common模块间接通信保持了良好的解耦这种依赖关系在settings.gradle.kts中明确配置确保了构建系统的清晰性。核心工作原理解析推送转发机制HMSPush的核心功能是通过Hook技术拦截HMS Core的推送请求并将其转换为系统通知。在xposed/src/main/java/one/yufz/hmspush/hook/hms/HookHMS.kt中项目Hook了HMS Core的关键方法class HookHMS { fun hook(lpparam: XC_LoadPackage.LoadPackageParam) { // Hook PendingIntent.getActivity方法 PendingIntent::class.java.hookMethod(getActivity) { doBefore { // 拦截特定Activity的创建 } } // Hook DexClassLoader加载过程 DexClassLoader::class.java.hookAllConstructor { doAfter { // 检测并处理推送相关的Dex加载 } } } }设备伪装系统为了让非华为设备能够使用HMS推送HMSPush实现了完整的设备伪装系统。在xposed/src/main/java/one/yufz/hmspush/hook/fakedevice/FakeDevice.kt中项目通过Hook系统属性读取方法将设备信息伪装成华为设备object FakeDevice { fun fake(lpparam: LoadPackageParam) { // 伪装设备制造商为华为 // 伪装设备型号为华为设备 // 伪装系统构建信息 } }通知处理链HMSPush实现了一个完整的通知处理链确保推送通知能够正确显示。在xposed/src/main/java/one/yufz/hmspush/hook/hms/nm/目录下定义了多个通知处理器NotificationHandler- 通知处理基类IconHandler- 图标处理LabelHandler- 标签处理GroupNotificationHandler- 分组通知处理架构设计的巧妙之处1. 职责分离清晰HMSPush的三模块设计将用户界面、业务逻辑和技术实现完全分离app模块专注于用户体验common模块提供通用基础设施xposed模块处理底层Hook技术2. 代码复用最大化通过common模块项目避免了代码重复确保常量定义一致数据模型统一工具类共享3. 可维护性高模块化设计使得每个模块可以独立开发和测试修改一个模块不会影响其他模块新功能可以方便地添加到相应模块4. 扩展性强架构设计支持轻松扩展新增Hook功能只需在xposed模块添加新UI功能在app模块实现共享逻辑在common模块集中管理实际应用场景应用选择与配置用户通过app模块的界面选择需要支持HMS推送的应用配置设备伪装参数。这些设置通过common模块的数据模型持久化存储。运行时Hook当目标应用启动时xposed模块根据配置进行Hook伪装设备信息让应用认为运行在华为设备上拦截HMS推送请求转发为系统通知处理通知图标、标签等显示细节推送流程完整的推送流程如下应用向HMS Core请求推送服务HMS Core准备发送推送通知HMSPush拦截推送请求转换为系统通知并显示用户点击通知进入应用技术亮点总结跨进程通信HMSPush通过ContentProvider实现模块间通信在xposed/src/main/java/one/yufz/hmspush/hook/bridge/BridgeContentProvider.kt中定义了完整的通信协议。版本兼容性项目支持多个Android版本通过条件编译和版本检测确保兼容性。在common/src/main/java/one/yufz/hmspush/common/Constant.kt中定义了版本相关的常量。错误处理机制完善的错误处理确保模块稳定性Hook失败时的回退机制异常情况的日志记录用户友好的错误提示最佳实践借鉴HMSPush的架构设计为Android模块化开发提供了优秀范例明确模块边界每个模块有清晰的职责范围依赖管理规范通过common模块避免循环依赖接口设计简洁模块间通过定义良好的接口通信配置集中管理所有配置在common模块统一管理总结HMSPush的三模块架构app、common、xposed展示了Android模块化开发的精髓。这种设计不仅提高了代码的可维护性和可扩展性还为类似的技术实现提供了参考模板。通过清晰的职责分离、高效的代码复用和灵活的技术实现HMSPush成功解决了非华为设备支持HMS推送的技术难题。对于Android开发者来说研究HMSPush的源码架构不仅能够学习Xposed框架的高级用法还能深入理解模块化设计在复杂项目中的应用价值。无论是开发系统级Hook应用还是构建复杂的Android模块化项目HMSPush的架构设计都值得借鉴和学习。通过深入分析HMSPush的源码我们可以看到优秀的架构设计如何让复杂的功能变得清晰可维护这也是该项目能够在开源社区获得广泛认可的重要原因之一。【免费下载链接】HMSPush让非华为设备支持 HMS 推送同时避免唤醒目标应用项目地址: https://gitcode.com/gh_mirrors/hm/HMSPush创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考