1. 主题资源全景：Material 3设计体系与云分发基础

1.1 核心概念：设计 三层体系

Material 3（M3）设计体系将主题抽象为结构化的 层次，从底层原始值到顶层语义映射，构成了云分发的数据基础。理解三层体系是实现动态主题资源管理的前提。

1.2 资源文件类型与组织结构

M3 主题资源在工程中表现为多种文件格式，云分发需要统一管理和版本化这些资源。

云分发标准载体通常采用 JSON 映射表，原因如下：

• 易于在 CDN 与客户端之间传输和缓存。
• 可直接映射到 M3 Compose MaterialTheme 或 View 系统 ThemeOverlay。
• 支持差异更新，仅下发变更的 条目。

// tokens/light/color/primary.json
{
  "light": {
    "color": {
      "primary": {
        "value": "#6750A4",
        "type": "color"
      }
    }
  }
}

// 编译后的 res/values/colors.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="md_theme_light_primary">#6750A4</color>
    <color name="md_theme_dark_primary">#D0BCFF</color>
</resources>

1.3 云分发的价值与核心挑战

常见挑战还包括：

• 缓存失效： 需要精确的版本号控制或 ETag 策略避免陈旧资源上线。
• 离线回退： 必须保证默认内置主题与线上高可用缓存结合，确保弱网环境基本可用。
• 解析性能： JSON 解析及主题重构不能阻塞主线程，应使用异步加载 + 内存缓存。

1.4 云分发的数据结构设计

客户端与服务端约定的 交换协议应当包含版本、平台、主题模式和具体 列表。以下是一个典型的三层包裹结构：

{
  "version": 7,
  "minAppVersion": 20250315,
  "platform": "android",
  "themes": {
    "light": {
      "color": {
        "primary": "#6750A4",
        "onPrimary": "#FFFFFF",
        "primaryContainer": "#EADDFF",
        "surface": "#FFFBFE"
      },
      "typography": {
        "displayLarge": {
          "fontFamily": "GoogleSans-Bold",
          "fontSize": 57.0,
          "lineHeight": 64.0
        }
      }
    },
    "dark": {
      "color": {
        "primary": "#D0BCFF",
        "onPrimary": "#381E72",
        "primaryContainer": "#4F378B",
        "surface": "#1C1B1F"
      }
    }
  }
}