diff --git a/apps/quanxue/android/app/src/main/res/drawable-hdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-hdpi/android12splash.png index 80189a2..093727a 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-hdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-hdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png b/apps/quanxue/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png index 43c8bfc..9054ac5 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png and b/apps/quanxue/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-hdpi/splash.png b/apps/quanxue/android/app/src/main/res/drawable-hdpi/splash.png index 80189a2..093727a 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-hdpi/splash.png and b/apps/quanxue/android/app/src/main/res/drawable-hdpi/splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-mdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-mdpi/android12splash.png index ebc6c1a..21677fe 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-mdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-mdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png b/apps/quanxue/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png index 1be13bd..78c4b1a 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png and b/apps/quanxue/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-mdpi/splash.png b/apps/quanxue/android/app/src/main/res/drawable-mdpi/splash.png index ebc6c1a..21677fe 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-mdpi/splash.png and b/apps/quanxue/android/app/src/main/res/drawable-mdpi/splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-night-hdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-night-hdpi/android12splash.png index 80189a2..093727a 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-night-hdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-night-hdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-night-mdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-night-mdpi/android12splash.png index ebc6c1a..21677fe 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-night-mdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-night-mdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-night-xhdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-night-xhdpi/android12splash.png index 0506459..f86ccfb 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-night-xhdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-night-xhdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-night-xxhdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-night-xxhdpi/android12splash.png index 205ee70..ec5e150 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-night-xxhdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-night-xxhdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-night-xxxhdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-night-xxxhdpi/android12splash.png index 003f7e1..fb0ffb9 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-night-xxxhdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-night-xxxhdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xhdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-xhdpi/android12splash.png index 0506459..f86ccfb 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xhdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-xhdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png b/apps/quanxue/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png index dc8f258..0aafa46 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png and b/apps/quanxue/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xhdpi/splash.png b/apps/quanxue/android/app/src/main/res/drawable-xhdpi/splash.png index 0506459..f86ccfb 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xhdpi/splash.png and b/apps/quanxue/android/app/src/main/res/drawable-xhdpi/splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/android12splash.png index 205ee70..ec5e150 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png b/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png index 7e4ac6f..fab1938 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png and b/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/splash.png b/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/splash.png index 205ee70..ec5e150 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/splash.png and b/apps/quanxue/android/app/src/main/res/drawable-xxhdpi/splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/android12splash.png b/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/android12splash.png index 003f7e1..fb0ffb9 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/android12splash.png and b/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/android12splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png b/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png index 0598067..9f56d26 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png and b/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png differ diff --git a/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/splash.png b/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/splash.png index 003f7e1..fb0ffb9 100644 Binary files a/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/splash.png and b/apps/quanxue/android/app/src/main/res/drawable-xxxhdpi/splash.png differ diff --git a/apps/quanxue/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/apps/quanxue/android/app/src/main/res/mipmap-hdpi/ic_launcher.png index 24ab9c5..9960f24 100644 Binary files a/apps/quanxue/android/app/src/main/res/mipmap-hdpi/ic_launcher.png and b/apps/quanxue/android/app/src/main/res/mipmap-hdpi/ic_launcher.png differ diff --git a/apps/quanxue/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/apps/quanxue/android/app/src/main/res/mipmap-mdpi/ic_launcher.png index a4f56a1..398bcb9 100644 Binary files a/apps/quanxue/android/app/src/main/res/mipmap-mdpi/ic_launcher.png and b/apps/quanxue/android/app/src/main/res/mipmap-mdpi/ic_launcher.png differ diff --git a/apps/quanxue/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png b/apps/quanxue/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png index f7b8f9b..3818b9a 100644 Binary files a/apps/quanxue/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png and b/apps/quanxue/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png differ diff --git a/apps/quanxue/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/apps/quanxue/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png index c77c8f9..e7e712e 100644 Binary files a/apps/quanxue/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png and b/apps/quanxue/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png differ diff --git a/apps/quanxue/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/apps/quanxue/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png index 3e9dbef..eb17a16 100644 Binary files a/apps/quanxue/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png and b/apps/quanxue/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ diff --git a/apps/quanxue/assets/branding/icon.png b/apps/quanxue/assets/branding/icon.png index 774f0b6..f19711a 100644 Binary files a/apps/quanxue/assets/branding/icon.png and b/apps/quanxue/assets/branding/icon.png differ diff --git a/apps/quanxue/assets/branding/icon_foreground.png b/apps/quanxue/assets/branding/icon_foreground.png index 63025db..977ad82 100644 Binary files a/apps/quanxue/assets/branding/icon_foreground.png and b/apps/quanxue/assets/branding/icon_foreground.png differ diff --git a/apps/quanxue/assets/branding/splash.png b/apps/quanxue/assets/branding/splash.png index bfc6171..1a95930 100644 Binary files a/apps/quanxue/assets/branding/splash.png and b/apps/quanxue/assets/branding/splash.png differ diff --git a/doc/images/foreground_spec.png b/doc/images/foreground_spec.png new file mode 100644 index 0000000..41c929f Binary files /dev/null and b/doc/images/foreground_spec.png differ diff --git a/doc/images/icon_spec.png b/doc/images/icon_spec.png new file mode 100644 index 0000000..3d744d8 Binary files /dev/null and b/doc/images/icon_spec.png differ diff --git a/doc/images/splash_spec.png b/doc/images/splash_spec.png new file mode 100644 index 0000000..e5e5cb7 Binary files /dev/null and b/doc/images/splash_spec.png differ diff --git a/doc/品牌资源规范.md b/doc/品牌资源规范.md new file mode 100644 index 0000000..920ab3f --- /dev/null +++ b/doc/品牌资源规范.md @@ -0,0 +1,57 @@ +# 品牌 UI 资源交付规范 + +本文档面向 UI 设计师，说明了在使用 `web_android_shell` 框架生成各品牌 Android 壳应用时，需要提供的图片素材规格。 + +**文件存放路径**：`flavors/<品牌名>/` + +--- + +## 1. 交付总览 + +| 资源名称 | 文件名 | 格式要求 | 尺寸 (px) | 核心要求 | +|---|---|---|---|---| +| **应用图标** | `icon.png` | PNG *(不透明)* | 1024 × 1024 | 正方形铺满（用于老版本系统图标）。 | +| **自适应前景** | `icon_foreground.png` | **PNG (背景透明)** | 1024 × 1024 | 主体图形居中。四周必须保留 **33% 的透明安全区**。 | +| **启动页图像** | `splash.png` | PNG *(含透明或实色)* | 1152 × 1152 | 核心 Logo 必须完全置于正中心的 **768×768 直径圆形**范围内。 | +| **单色前景** *(可选)* | `icon_monochrome.png` | **PNG (背景透明)** | 1024 × 1024 | 专为 Android 13+ 提供。必须是纯黑色或纯白色（无渐变），靠透明度展现轮廓。 | + +--- + +## 2. 详细规格说明与示意图 + +### 2.1 应用图标 (`icon.png`) + +这是最基础的图标，用于向后兼容较老版本的 Android 系统。 + +* **尺寸**：1024 × 1024 像素（也可提供最低 512 × 512 的设计底线）。 +* **要求**：不需要圆角或圆形裁切（系统会自动裁切），直接提交带有背景颜色的**纯正方向**图形。 + +![应用图标规范](images/icon_spec.png) + +--- + +### 2.2 自适应图标前景 (`icon_foreground.png`) + +自 Android 8.0 起，系统采用了由「背景层」+「前景层」自由组合实现动态效果的自适应图标（Adaptive Icon）。该图即为此时使用的「前景层」。 + +* **格式**：**必须是带透明背景的 PNG (PNG-24/32)**，不能使用 JPEG，否则其白色底会遮盖住背景颜色。 +* **安全区设计**： + * 画布总尺寸保持 1024 × 1024。 + * **主体内容必须集中在中央的 682 × 682 的圆形安全区内**。 + * 外围的透明留白（约占据画布边长的 33%）将被系统底层用于视差动画和异形遮罩裁切。超出中央安全圈的内容**将被无情裁掉**。 + +![自适应前景图规范](images/foreground_spec.png) + +--- + +### 2.3 启动页图片 (`splash.png`) + +自 Android 12 开始，系统强制接管开屏动画（SplashScreen API），对核心图像的位置和大小有极其严苛的要求，否则在 2K/4K 等高清分辨率平板上会造成拉伸模糊或主体被截断。 + +* **画布尺寸**：**绝对正中心对其的 1152 × 1152 像素**。 +* **排版留白**： + * 核心 Logo 及其相关文字，必须完全置于中心一个 **直径为 768 px 的虚拟圆圈** 内。 + * 中心圆之外的区域，将根据不同机型屏幕分辨率被裁掉。 +* **背景机制**：通常启动页背景色是实色（在 `flavors/xxx.yaml` 配置的 `splash_color`），因此该图建议为透明背景（Logo 独占）；如果该图自带实色背景也没有关系，只要确保主体内容满足 768 圆圈即可。 + +![启动页规范](images/splash_spec.png) diff --git a/flavors/quanxue/icon.png b/flavors/quanxue/icon.png index 774f0b6..f19711a 100644 Binary files a/flavors/quanxue/icon.png and b/flavors/quanxue/icon.png differ diff --git a/flavors/quanxue/icon_foreground.png b/flavors/quanxue/icon_foreground.png index 63025db..977ad82 100644 Binary files a/flavors/quanxue/icon_foreground.png and b/flavors/quanxue/icon_foreground.png differ diff --git a/flavors/quanxue/splash.png b/flavors/quanxue/splash.png index bfc6171..1a95930 100644 Binary files a/flavors/quanxue/splash.png and b/flavors/quanxue/splash.png differ