Files
ElderlyDialer/docs/ICON_PACKS.md
T

2.3 KiB

图标包管理

入口:桌面设置 → 图标包管理。选择即应用,选择“原始图标”恢复;默认选择由 iconloader 持久保存。

支持以 action 或 MAIN + category 声明的常见 Nova/ADW/Apex/GO 图标包。页面列出已安装包;所选包卸载后显示缺失状态并回退原图。安装、卸载、更新会刷新打开的列表;从安装界面返回时也会刷新。没有匹配映射的应用使用原始图标。

应用列表和快捷方式、Dock、移动应用弹窗均通过 AppIconRepository 加载。列表按视图取消异步请求,回收或离开窗口时取消订阅,主题变化后重新绑定。应用原始图标上传逻辑保持独立。

共享库构建

默认依赖已发布的 com.ttstd:iconloader:1.0.6,本地及 CI 构建均通过 Maven 仓库解析。需要共享源码联调时,可显式传入 -PiconloaderSourceDir=路径 指向 IconLoader_ttstd 仓库,settings.gradle 将通过组合构建替换该依赖;不再自动使用本机相邻目录。

远程获取和设置默认图标包继续由共享库预留接口承接,本次不新增后端接口或推送协议。动态日历、时钟和遮罩合成仍以共享库的支持范围为准。

验证

本项目 app/libs/framework.jar 含 Java 21 字节码,命令行构建需使用 JDK 21(例如 Android Studio 自带的 jbr)。验证命令:gradlew.bat :app:compileDebugJavaWithJavac --offline --max-workers=2。

真机复测:安装兼容图标包 → 在管理页选择 → 检查首页、更多应用及三个应用弹窗 → 恢复原始图标 → 重启检查选择持久化 → 卸载所选包检查回退 → 重新安装检查恢复。快速切换图标包、滚动应用列表和重排应用时应始终显示当前组件的图标。

1.0.6 显示策略

已适配图标保留图标包设计并进行 AOSP 可见面积归一化。未适配图标优先使用图标包的底板、反向 alpha 遮罩、覆盖层和缩放规则;没有合成规则时使用系统自适应图标包装,API 23-25 使用圆角方形兼容底板。缓存版本自动隔离旧结果,应用列表使用 fitCenter 显示最终图标。

AOSP 正式包使用现有 CrosshatchRelease 构建变体及 AospCrosshatch 签名,构建任务为 :app:assembleCrosshatchRelease。