安卓/ios图标到底怎么配，我配置后在进行云打包后对apk进行安装后生成的手机桌面图标是纯白色的图标

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

针对你遇到的“云打包后安装 apk 桌面图标显示纯白色”问题，核心原因通常是图标配置不完整或图片格式不符合要求。请按以下步骤逐一排查：

1. 检查图标配置是否完整

在 hbuilderx 中，打开项目的 manifest.json 文件，选择“app 图标配置”选项卡。

• 安卓平台：不能只配置一张大图。必须为所有列出的分辨率尺寸（如 48x48、72x72、96x96、144x144、192x192 等）都选择对应的 png 图片。如果只配置了部分尺寸，打包机可能会用默认的白色图标填充未配置的尺寸，导致显示异常。
• ios 平台：同样需要为所有列出的尺寸（特别是 1024x1024 的 appstore 图标）配置图片。若未配置，云端打包机会默认使用纯白色图标。

2. 严格检查图片格式

• 必须使用真正的 png 格式：不能将 .jpg、.jpeg 或其他格式的图片文件，直接通过重命名后缀的方式改为 .png。这会导致文件无法被正确识别。请使用专业的图片处理工具（如 photoshop、在线转换工具）将图片转换并导出为 png 格式。
• 图标不要包含圆角或透明信息：ios 平台要求图标必须是直角，且不要包含 alpha 通道（透明信息），否则审核可能不通过。安卓平台虽然对圆角宽容度更高，但为保证兼容性，也建议使用直角方形图标。

3. 验证配置是否生效

修改图标配置后，必须重新提交云端打包才能生效。仅修改 manifest.json 而不重新打包，安装的仍然是旧包。

4. 验证 apk 包内图标是否正确

这是一个关键的排查步骤，可以确认是打包问题还是手机缓存问题。

1. 将打好的 .apk 安装包文件的后缀名改为 .zip。
2. 用解压软件打开这个 zip 文件。
3. 依次进入 res -> drawable-xhdpi-v4（或 drawable-xxhdpi-v4 等目录）。
4. 找到 icon.png 文件，查看它是否是你设置的正确图标。
   • 如果图标正确：说明打包没有问题，是手机系统缓存了旧图标。请尝试重启手机或清除桌面启动器（launcher）的缓存后再安装。
   • 如果图标是白色或错误：说明打包环节出了问题，请返回检查步骤 1 和步骤 2，确认配置无误后重新打包。

5. 安卓自适应图标（android 8.0+）的兼容性说明

对于 android 8.0 及以上系统，原生支持“自适应图标”（adaptive icons），它需要前景图和背景图分层。根据社区反馈，uni-app 的云端打包在某些情况下可能对此支持不完善，导致图标显示为白色底或形状异常。如果你在部分较新的安卓手机上遇到此问题，且以上步骤无法解决，可能是该版本系统对自适应图标的要求更严格。

请按照以上步骤，特别是第 1、2、4 步进行排查，通常能解决大部分图标显示白色的问题。