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
- 结果:构建通过