# 08 Android SDK 说明

## 当前模块拆分

- `commonsdk-core`
  - 网络能力：`HttpManager`、`RetrofitManager`
  - 下载能力：`DownloadManager`
  - 文件能力：`FileHelper`
  - 权限能力：`PermissionManager`
  - 缓存能力：`GlobalCache`、`SharedCacheManager`
  - 通信能力：`PluginMessenger`
  - 通用 UI 能力：`ToastCenter`、`DialogCenter`
  - 工具能力：`Logger`、`DateTimeUtils`
- `commonsdk-compose`
  - 下拉刷新：`SwipeRefreshContainer`、`RefreshableLazyColumn`
  - 折叠面板：`AccordionPanel`、`RefreshableAccordionList`
  - 左滑操作：`SwipeActionItem`
  - WebView：`CommonWebView`、`WebViewPageActivity`
  - 图片：`AdaptiveImage`、`CircleImage`
- `commonsdk-update`
  - 宿主更新：`AppUpdater`
  - 插件更新：`PluginPackageManager`
  - SDK 门面：`UpdateSDK`
  - 版本比较：`VersionComparator`

## 设计原则

- 下载与文件安装归 `core`，保证后续任意业务 SDK 都能复用。
- 宿主更新和插件更新归 `commonsdk-update`，避免核心模块承担业务升级策略。
- Compose 组件保持业务无关，App 可直接引用或二次封装。

## 接入方式

### 宿主应用

- 初始化基础 SDK：`CoreSDK.init(context, CoreSDK.SDKConfig(...))`
- 使用更新能力：`UpdateSDK.appUpdater()`、`UpdateSDK.pluginPackageManager()`
- 使用公共能力：`CoreSDK.fileHelper()`、`CoreSDK.cache()`、`CoreSDK.dialogCenter()`

### WebView 页面

- 内嵌组件：直接使用 `CommonWebView(url = "...")`
- 独立页面：通过 `WebViewPageActivity.createIntent(context, url, title)` 跳转

### 权限申请

- 通过 `PermissionManager.register(...)` 注册权限请求器
- 请求时传入权限标题和描述，框架会先弹出确认说明，再真正调用系统权限弹窗

## 当前验证

- 2026-03-27 已执行：
  - `./gradlew --no-daemon --no-configuration-cache :sample-app:assembleDebug :plugins:plugin-ui:assembleDebug`
- 结果：构建通过