YukiHookAPI中实现Compose与模块化Activity的继承方案

背景介绍

在Android开发中，随着Jetpack Compose的普及，越来越多的开发者开始使用ComponentActivity作为Compose页面的宿主。同时，在模块化开发场景下，我们常常需要让模块中的Activity继承自宿主的特定基类。本文将探讨如何在YukiHookAPI框架下解决Compose与模块化Activity继承的问题。

核心问题分析

当开发者尝试在模块中创建继承自ComponentActivity的类时，会遇到几个关键挑战：

1. Compose兼容性：需要确保ComponentActivity能够正常支持Jetpack Compose的setContent等特性
2. 模块化继承：在模块化架构中，模块Activity需要能够继承宿主定义的基类
3. 边缘到边缘设计：实现现代化的全屏UI设计，包括导航栏和状态栏的透明处理

解决方案

YukiHookAPI从1.3.0版本开始提供了自定义继承者接口的能力，开发者可以通过以下方式解决上述问题：

基础实现方案

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge(
            navigationBarStyle = SystemBarStyle.auto(
                Color.TRANSPARENT, 
                Color.TRANSPARENT
            ) { true }
        )
        
        setContent {
            // Compose UI内容
        }
    }
}

模块化进阶方案

对于模块化项目，更推荐创建一个自定义的基类：

abstract class ModuleAppCompatActivity : ComponentActivity() {
    // 可在此处定义模块通用的功能
    // 例如边缘到边缘的默认实现
    protected fun applyEdgeToEdge() {
        enableEdgeToEdge(
            navigationBarStyle = SystemBarStyle.auto(
                Color.TRANSPARENT,
                Color.TRANSPARENT
            ) { true }
        )
    }
}

// 模块中的Activity继承自定义基类
class FeatureActivity : ModuleAppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        applyEdgeToEdge()
        
        setContent {
            // 模块特定的Compose UI
        }
    }
}

技术细节解析

1. 边缘到边缘实现：通过SystemBarStyle.auto方法自动适配浅色/深色主题，使用透明颜色实现真正的全屏效果

2. 模块化基类设计：

   • 将通用功能封装在基类中
   • 子类只需关注自身特定的UI和逻辑
   • 保持与Compose的完美兼容

3. YukiHookAPI集成：在1.3.0及以上版本中，可以通过注册模块Activity的方式实现更灵活的继承关系管理

最佳实践建议

1. 基类设计原则：

   • 将通用的UI配置（如边缘到边缘）放在基类中
   • 提供必要的扩展点供子类定制
   • 保持与Compose API的兼容性

2. 主题适配：

   • 考虑不同主题下的系统栏表现
   • 提供动态切换主题的能力

3. 模块化注意事项：

   • 确保基类在宿主和模块间的可见性
   • 处理好资源ID冲突等问题

总结

通过结合YukiHookAPI的模块化Activity注册能力和自定义Compose基类，开发者可以构建出既支持现代化UI设计又符合模块化架构要求的Activity结构。这种方案不仅解决了技术兼容性问题，还为项目的长期维护提供了良好的扩展性基础。