00-超级App软件平台@路由规则设计-【概述】

没有故事的Zhang同学
4 阅读5分钟

本目录下的文档围绕软件平台的路由规则设计展开，不限于移动端，涵盖：

  • 移动端：手机、平板（iOS、Android、HarmonyOS、Flutter、ReactNative 等）
  • Web：浏览器内的 SPA、多页应用、PWA
  • 电脑（桌面）：MacOS、WinOS 等桌面应用
  • 手表、手环等智能穿戴：WatchOS、HarmonyOS 穿戴、第三方手环/手表系统

路由设计同时考虑 页面跳转路由（打开整页、压栈/替换/模态）与 功能唤醒路由（调用能力、获取服务、打开弹窗/浮层、执行动作），统一 path 协议与路由表，按类型分发。同体系跨端跨平台协同纳入设计：同一产品在多端（手机、Web、电脑、手表等）共用 path 协议，一条链接多端一致打开，设备间可接力与路由状态同步；可结合鸿蒙超级终端思想（多设备一体、分布式任务调度与数据管理）理解跨端协同与 path 作为跨端契约的价值。从深链接、路由表到千万级路由体系，并给出通用路由管理工具组件的跨平台设计。软件体系覆盖 iOS、Android OS、HarmonyOS、Flutter、MacOS、WinOS、WebApp、ReactNative App、WatchOS 及智能穿戴形态；路由协议与适配层设计兼顾上述各端，详见 08-软件体系与多平台路由对照。

专题知识全景（思维导图）

mindmap
  root((软件平台路由规则设计))
    同体系跨端协同
      协议统一 同一链接多端一致 设备间同步
    设备与形态
      移动端 Web 电脑 手表手环等穿戴
    软件体系 多平台
      iOS Android HarmonyOS
      Flutter MacOS WinOS
      WebApp ReactNative WatchOS 穿戴
    01 总纲
      路由定义与三要素
      历史演进五阶段
      匹配算法与拦截器
      多平台概览
    02 URL Scheme / Intent Filter
      iOS Android HarmonyOS
      Flutter MacOS 等
      统一路由入口
    03 Universal Links / App Links
      AASA / assetlinks
      域名验证与无歧义打开
    04 组件化路由框架
      路由表与注册
      拦截器链
      多端实现
    05 声明式路由
      Navigator 2.0 go_router
      WebApp ReactNative
    06 超级 App 路由体系
      SPI 分层表 编译期校验
    07 通用路由组件设计
      统一协议 各端适配层
    08 软件体系与多平台对照
      九平台深链接与路由表

文档关系与阅读顺序（流程图）

flowchart LR
    subgraph 入门
        A[00 索引]
        B[01 总纲]
    end
    subgraph 深链接
        C[02 URL Scheme]
        D[03 Universal Links]
    end
    subgraph 框架与体系
        E[04 组件化路由]
        F[05 声明式路由]
        G[06 大规模与跨端体系]
    end
    subgraph 落地
        H[07 通用路由管理组件]
    end
    A --> B
    B --> C --> D
    B --> E --> F
    B --> G
    C --> H
    D --> H
    E --> H
    F --> H
    G --> H
    I[08 软件体系与多平台]
    B --> I
    I --> H

各文档图示与代码类型速查

文档思维导图流程图泳道图时序图伪代码示范性类/工具
01✓ 演进阶段✓ 深链接衔接、查找结构、执行流程—✓ 路由执行✓ 匹配算法—
02✓ 知识结构✓ 整体流程✓ 用户/系统/App 内✓ 点击到打开—AppRouter（Swift/Kotlin/Dart）
03✓ 知识结构✓ 校验与打开✓ 用户/iOS/Android/服务器✓ 校验与打开—handleOpenURL 多端
04✓ 知识结构✓ 架构与数据流✓ 调用方/核心/目标✓ 拦截器链—AppRouter、Postcard、Interceptor
05✓ 知识结构✓ Navigator 2.0、数据流✓ 系统/Parser/Delegate/状态✓ URL 同步—AppRouteState、Parser、Delegate
06✓ 知识结构✓ 六大设计、分层查找、冲突校验✓ 启动/首次访问、同步/异步拦截✓ 动态下发✓ SPI、拦截器、GradleensureModuleLoaded、validateRoutes
07✓ 概念模型✓ 分层架构、表来源与合并✓ 调用方/核心/平台✓ navigate 时序✓ 接口定义IRouteTable、IRouter、Adapter、各端调用示例
08✓ 九平台与路由✓ 深链接入口与统一———九平台对照表、适配要点

文档列表

序号文档内容概要
0101-软件平台路由规则设计-总纲总纲：软件平台路由定义（含移动端/Web/电脑/穿戴）、历史演进、核心概念、匹配算法、多端概览与参考文献
0202-URL-Scheme与Intent-Filter详解URL Scheme（iOS）与 Intent Filter（Android）的配置、接收、解析；Flutter 的 app_links/uni_links；流程图与泳道图；多端代码示例
0303-Universal-Links与App-Links详解Universal Links（iOS）与 App Links（Android）的 AASA/assetlinks 配置、校验流程、App 内处理；Flutter 对接；思维导图与泳道图
0404-组件化路由框架详解组件化路由表、拦截器链、iOS（MGJRouter/JLRoutes 风格）、Android（ARouter 风格）、Flutter（go_router + 门面）；流程图与时序图
0505-声明式路由与Navigator2.0详解状态驱动路由栈、Flutter RouterDelegate + RouteInformationParser、go_router、iOS/Android 声明式思路；多端代码与流程图
0606-大规模与跨端路由体系详解六大核心设计：动态 SPI、分层路由表、拦截器并行与熔断、编译期校验、动态下发与安全、体验与监控；流程图与泳道图
0707-通用路由管理组件设计跨平台可复用的路由组件：统一协议、IRouteTable/IRouter/拦截器/适配层、各端适配要点、与深链接/组件化/声明式的衔接；各端统一调用示例
0808-软件体系与多平台路由对照九大平台（iOS、Android、HarmonyOS、Flutter、MacOS、WinOS、WebApp、ReactNative、WatchOS）的定义、深链接与 App 内路由对照、适配层要点

学习路径建议

  1. 入门：先读 01-软件平台路由规则设计-总纲，建立 path、路由表、拦截器、深链接的整体概念，明确移动端、Web、电脑、手表与手环等智能穿戴的覆盖范围。
  2. 深链接：按顺序阅读 02（URL Scheme/Intent Filter） 与 03（Universal Links/App Links），配合各端代码与流程图实践。
  3. 组件化与声明式：阅读 04（组件化路由框架） 与 05（声明式路由与 Navigator 2.0），理解路由表来源与状态驱动栈。
  4. 大规模与跨端：阅读 06-大规模与跨端路由体系详解，了解千万级 DAU 与跨端下的性能、质量与运维设计。
  5. 落地：阅读 07-通用路由管理组件设计，在设计新项目或统一多端路由时作为抽象与适配层参考。
  6. 多端对照：阅读 08-软件体系与多平台路由对照，按 iOS、Android、HarmonyOS、Flutter、MacOS、WinOS、WebApp、ReactNative、WatchOS 九大平台查阅深链接与路由表、适配要点。

图示与图表类型说明

各文档中使用的图示类型：

  • 思维导图（mindmap）：知识结构、概念拆解。
  • 流程图（flowchart）：数据流、模块关系、分层架构。
  • 泳道图（flowchart 子图）：按职责/角色划分的步骤。
  • 时序图（sequenceDiagram）：调用顺序与交互。

所有 Mermaid 图可在支持 Mermaid 的 Markdown 预览或文档站点中直接渲染。

伪代码与示范代码说明

  • 伪代码：用于描述算法、流程和接口，与具体语言无关，便于多端实现时对齐语义。
  • 示范性类/管理工具：各文档中出现的 AppRouter、SchemeRouter、RouteManager、RouteMonitor、RouteTableImpl、InterceptorChain、Router 等，均为示例实现或接口骨架，实际项目可按需裁剪或替换为 ARouter、TheRouter、go_router 等现有方案。
avatar
文章
阅读
粉丝