深入理解CC组件化框架：进阶使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00613/article/details/148549625

深入理解CC组件化框架：进阶使用指南

CC 业界首个支持渐进式组件化改造的Android组件化开源框架，支持跨进程调用。Componentize your android project gradually. 项目地址: https://gitcode.com/gh_mirrors/cc/CC

前言

CC（Component Caller）是一个轻量级的Android组件化开发框架，它通过简洁的API设计解决了Android组件化开发中的通信问题。本文将深入探讨CC框架的进阶使用技巧，帮助开发者更好地掌握这一强大工具。

安全配置与日志管理

生产环境安全配置

在正式上线时，建议禁用跨app组件调用功能以防止潜在的安全风险。可以在主应用的Application.onCreate方法中添加以下代码：

// 跨app调用支持：debug时启用，release时禁用
CC.enableRemoteCC(BuildConfig.DEBUG);

日志控制

CC框架提供了灵活的日志控制机制：

// 开启/关闭调试日志
CC.enableDebug(trueOrFalse);

// 开启/关闭详细跟踪日志（记录调用执行过程）
CC.enableVerboseLog(trueOrFalse);

组件调用与控制

链式调用参数设置

CC采用链式调用设计，支持多种参数配置：

// 基础调用示例
CC.obtainBuilder("ComponentA")
    .setContext(context)  // 设置Context
    .cancelOnDestroyWith(activity)  // 关联Activity生命周期
    .setActionName("actionName")  // 设置Action名称
    .setTimeout(1000)  // 设置超时时间(毫秒)
    .addParam("name", "billy")  // 添加参数
    .addParam("id", 12345)
    .addInterceptor(new MyInterceptor())  // 添加拦截器
    .build()
    .callAsync();  // 异步调用

调用取消机制

可以通过callId取消正在进行的组件调用：

CC.cancel(callId);

组件实现与结果处理

组件返回结果

在组件实现中，可以通过CCResult返回处理结果：

// 成功结果
CCResult ccResult = CCResult.success(key1, value1)
                    .addData(key2, value2);

// 错误结果
CCResult ccResult = CCResult.error(message)
                    .addData(key, value);

// 发送结果给调用方
CC.sendCCResult(cc.getCallId(), ccResult);

结果解析

调用方可以这样解析返回结果：

// 检查调用是否成功
boolean success = ccResult.isSuccess();

// 获取状态码
int code = ccResult.getCode();

// 获取错误信息
String errorMsg = ccResult.getErrorMessage();

// 获取返回数据
Map<String, Object> data = ccResult.getDataMap();

// 便捷获取特定类型数据
User user = ccResult.getDataItem(key);

无键参数处理

从2.1.2版本开始，CC支持无键参数传递：

// 设置无键参数
CC.obtainBuilder("ComponentA")
    .setParamWithNoKey("billy")
    .build()
    .callAsync();

// 获取无键参数
String name = cc.getParamItemWithNoKey();

同样支持无键返回值：

// 构建无键返回值
CCResult.successWithNoKey("billy");

// 获取无键返回值
String name = result.getDataItemWithNoKey();

拦截器机制

自定义拦截器

CC提供了强大的拦截器机制，允许开发者干预调用流程：

public class MyInterceptor implements ICCInterceptor {
    @Override
    public CCResult intercept(Chain chain) {
        CC cc = chain.getCC();
        // 修改参数
        cc.getParams().put(key, value);
        
        // 继续执行调用链
        CCResult result = chain.proceed();
        
        // 修改返回结果
        if(result != null) {
            result.addData(key, value);
        }
        return result;
    }
}

拦截器执行顺序

CC框架内拦截器的执行顺序为：

自定义全局拦截器（按priority从大到小排序）
自定义拦截器（按添加顺序）
验证拦截器(ValidateInterceptor)
本地/子进程/远程拦截器
结果等待拦截器(Wait4ResultInterceptor)

动态组件管理

CC支持动态组件的注册与反注册：

// 注册动态组件
CC.registerComponent(component);

// 反注册动态组件
CC.unregisterComponent(component);

动态组件需要实现IDynamicComponent接口，其使用方式与静态组件相同。

多进程支持

启用多进程支持

在cc-settings-2.gradle中添加配置：

ccregister.multiProcessEnabled = true

进程注解

@SubProcess(":yourProcessName") // 指定组件在特定子进程运行
public class DemoComponentA implements IComponent{}

@AllProcess // 组件在所有进程都存在
public class DemoComponentC implements IComponent{}

线程控制

通过实现IMainThread接口可以控制组件方法运行的线程：

public class ComponentB implements IComponent, IMainThread {
    @Override
    public Boolean shouldActionRunOnMainThread(String actionName, CC cc) {
        if ("login".equals(actionName)) {
            return true; // 强制在主线程运行
        }
        return null; // 默认行为
    }
}

实用工具类

CCUtil提供了便捷的页面跳转方法：

// 跳转到指定Activity
CCUtil.navigateTo(cc, TargetActivity.class);

// 在Activity中获取跳转参数
String param = CCUtil.getNavigateParam(activity, "key", "default");

// 获取callId
String callId = CCUtil.getNavigateCallId(activity);