Android 组件化之路路由设计

关注

原创最新推荐文章于 2026-09-20 17:25:38 发布 1.4k 阅读 AI 写同款· GEO 优化 ›

Android组件化实战六：路由架构设计前言结合前面的模块之间的交互，主要分析了类加载、全局Map记录(跳转目标Class)两种交互方式，以及APT和JavaPoet技术生成类文件，本文分析组件化的路由架构，我们到底需要通过APT和JavaPoet生成什么样的类文件呢？ 组件化路由架构设计先来看这样一幅架构设计图，组文件记录是一对一的即一个子模块对应一个组文件记录，而一个组文件记录对应多个路径文件记录，第二点比较好理解，因为各个子模块有多个Activity，对应多个路径信息。对应第一点，为什么要生成一对一的组(名)文件记录呢？试想一下，如果阅读详情

基于公司业务发展，公司的APP需求不断增加，应用也略显“臃肿”。想着趁现在不那么“糟糕”，时间也比较宽裕，把项目结构整整，因而走上了组件化之路。

模块化 VS 组件化

模块化： 将一个程序按照其功能做拆分，分成相互独立的模块，以便于每个模块只包含与其功能相关的内容。

组件化： 基于可重用的目的，将一个大的软件系统按照分离关注点的形式，拆分成多个独立的组件。

区别：
模块化和组件化本质思想是一样的，都是“大化小”，两者的目的都是为了重用和解耦，只是叫法不一样。如果非要说区别，那么可以认为模块化粒度更小，更侧重于重用；而组件化粒度稍大于模块，更侧重于业务解耦。

为什么需要路由

路由主要的功能是实现模块化之间界面（Activity，网页）的跳转，那为什么不直接调显式跳转呢？

据我总结，主要有以下3点原因：

减少模块之间的依赖。因为显式跳转需要引用其他模块。
跳转时，参数不明确，沟通需要时间。因为显式调用时，需要知道目标Activity需要哪些参数，如果参数改了，如果沟通不到位或者文档没有及时更新，会出现错误等问题。
简化H5页面与应用页面之间的跳转。

虽然网上有很多库，如阿里的ARouter。我不是有轮子不用，只是想着能学习多点组件化的知识，出于这个目的，决定自定义路由。

跳转页面的方式

Activity之间的跳转有2种方式：显式和隐式，显式显然不行，我们来看看隐式（如果不知道，请参考Android开发艺术探索笔记（2）- Activity的启动模式）。

隐式跳转的条件是Intent要么匹配action，要么匹配data。我这里选择匹配data方式，理由是匹配data方式是利用URL Scheme页面跳转协议，可以非常方便跳转app中的各个页面，也可以通过H5页面跳转页面等。

什么是URL Scheme

Android中的scheme是一种页面内跳转协议，通过定义自己的scheme协议，可以非常方便跳转app中的各个页面；通过scheme协议，服务器可以定制化告诉App跳转那个页面，可以通过通知栏消息定制化跳转页面，可以通过H5页面跳转页面等。

URL Scheme格式

URL Scheme和Http的Uri很像，包括scheme，host，port，path，query。
例子：

app://user:8888/login?username=xiaoming

app：代表scheme，协议的名称
user：代表host，地址域
8888：代表port，端口号
login：代表path，路径
username：代表query，传递的参数

使用URL Scheme

manifest声明activity：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.johan.demo">
    <application
        <activity android:name=".SecondActivity">
            <intent-filter>
                <data android:scheme="app" android:host="user" android:port="8888" android:path="/login" />
                <!-- 一下几行必须设置 -->
                <action android:name="android.intent.action.VIEW" /> <!-- 隐式调用必须声明 -->
                <category android:name="android.intent.category.DEFAULT" /> <!-- 隐式调用必须声明 -->
                <category android:name="android.intent.category.BROWSABLE" /> <!-- BROWSABLE的意思就是浏览器在特定条件下可以打开你的Activity -->
            </intent-filter>
        </activity>
        ...
    </application>
</manifest>

activity跳转：

Intent intent = new Intent();
Uri uri = Uri.parse("app://user:8888/login?username=xiaoming");
intent.setData(uri);
startActivity(intent);

这种方式跳转Activity有个致命的缺点，如果找不到对应的Uri，程序就会Crash，所以在跳转之前要判断一下Uri是否存在：

PackageManager packageManager = getPackageManager();
Intent intent = new Intent();
Uri uri = Uri.parse("app://user:8888/login?username=xiaoming");
intent.setData(uri);
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
boolean isValid = !activities.isEmpty();
if (isValid) {
    startActivity(intent);
}

设计路由

既然跳转方式选定了，但是还存在问题，就是参数不明确问题。如果能像retrofit那样，方法决定参数，这样就不用担心参数不明确问题了。

稍微看过retrofit源码都知道，retrofit运用的动态代理模式，so我们模仿一下，Like This，代码如下：(dome，仅供参考)

public class SimpleRouter {

    // ApplicationContext
    private static Context routerContext;

    /**
     * 初始化
     * @param context
     */
    public static void init(Context context, int cacheSize) {
        routerContext = context.getApplicationContext();
    }

    @SuppressWarnings("unchecked")
    public static <T> T create(final Class<T> iRouter) {
        return (T) Proxy.newProxyInstance(iRouter.getClassLoader(), new Class[]{iRouter}, new InvocationHandler() {
            @Override
            public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
                // 开始解析
                // 域名，可以不写
                String domain = null;
                if (iRouter.isAnnotationPresent(RouterDomain.class)) {
                    RouterDomain routerDomain = iRouter.getAnnotation(RouterDomain.class);
                    domain = routerDomain.value();
                }
                // 路径，必须有，否则报错
                if (!method.isAnnotationPresent(RouterPath.class)) {
                    throw new RuntimeException(iRouter.getName() + " " + method.getName() + " should has RouterPath Annotation");
                }
                RouterPath uriPath = method.getAnnotation(RouterPath.class);
                String path = uriPath.value();
                StringBuilder urlBuilder = new StringBuilder();
                if (domain != null) urlBuilder.append(domain);
                urlBuilder.append(path);
                // 参数
                Annotation[][] paramAnnotations = method.getParameterAnnotations();
                for (int index = 0; index < paramAnnotations.length; index++) {
                    Annotation[] paramAnnotation = paramAnnotations[0];
                    if (paramAnnotation == null || paramAnnotation.length == 0) {
                        continue;
                    }
                    if (paramAnnotation[0] instanceof RouterParam) {
                        RouterParam uriParam = (RouterParam) paramAnnotation[0];
                        String param = uriParam.value();
                        String connector = index == 0 ? "?" : "&";
                        urlBuilder.append(connector).append(param).append("=").append(args[index]);
                    }
                }
                // 打开Activity
                openActivity(urlBuilder.toString());
                return null;
            }
        });
    }

    /**
     * 打开Activity
     * @param url
     * @return
     */
    private static boolean openActivity(String url) {
        PackageManager packageManager = routerContext.getPackageManager();
        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
        List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
        boolean isValid = !activities.isEmpty();
        if (isValid) {
            routerContext.startActivity(intent);
        }
        return isValid;
    }

}

应用动态代理模式，由接口生成代理类，调用接口方法时，就会执行代理类的invoke方法，打开对应的Activity！

使用方法：比如我们有2个module，app和user-module。

先在user-module的manifest文件声明activity：

<activity android:name=".UserLoginActivity">
    <intent-filter>
        <data android:scheme="app" android:host="user" android:path="/login" />
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
    </intent-filter>
</activity>

然后在app跳转到user-module的界面：

// 我在Application初始化SimpleRouter，也可以在Activity中初始化
public class MainApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        SimpleRouter.init(this);
    }
}
// UserRouter接口
@RouterDomain("app://user")
public interface UserRouter {
    @RouterPath("/login")
    void goLogin();
}
// MainActivity跳转
public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
    public void goToUserLogin(View view) {
        // 跳转
        SimpleRouter.create(UserRouter.class).goLogin();
    }
}