HarmonyOS鸿蒙Next中在AGC提交的应用名称和图标与安装到桌面之后的应用名称和图标不一致

HarmonyOS鸿蒙Next中在AGC提交的应用名称和图标与安装到桌面之后的应用名称和图标不一致

问题描述

开发者在AGC提交的应用名称和图标，与安装到桌面之后的应用名称和图标不一致。

  • 不通过示例1：“简体中文（默认）下AGC的名称“国泰海通道合”与包体en_US目录下的“label”不一致”。
  • 不通过示例2：“phone设备下AGC的图标与包体base目录下的不一致，相似度为xx%”。
3 回复

排查方案

（1）排查工程资源目录中base目录下，配置的名称和图标，是否与AGC默认语言下的名称和图标一致。

（2）如果工程资源目录中配置了多语言名称和图标，排查在AGC上是否配置了对应的多语言的名称和图标。

整改建议

（1）工程资源目录中的base目录配置的名称和图标，改为和AGC默认语言下的名称和图标一致。

（2）如果工程资源目录中配置了多语言名称和图标，在AGC上也需要配置对应的多语言的名称和图标。

参考资料

（1）名称和图标配置优先级和生成策略

  • HAP中包含UIAbility

    • 如果在module.json5配置文件的abilities标签中配置了icon和label，且该对应的ability中skills标签下面的entities中包含"entity.system.home"、actions中包含"ohos.want.action.home"，则系统将优先返回module.json5中的icon与label。如果存在多个满足条件的ability，优先返回module.json5中mainElement对应的ability配置的icon和label。
    • 如果在module.json5配置文件的abilities标签中未设置icon和label，系统将返回app.json5中的icon和label。

  • HAP中不包含UIAbility，系统将返回app.json5中的icon和label。

    说明

    在编译构建时，AppScope目录下的资源文件会合入到模块下相同路径的资源目录中，如果两个目录下存在重名文件，编译打包后AppScope目录下的资源文件会覆盖模块下的资源。

    例如，app.json5和module.json5中配置的分层图标的资源文件名称一致、图标不一致，AppScope目录下的资源文件会覆盖模块中的文件，最后的效果是app.json5中的配置图标生效。

    如果应用配置中未设置入口UIAbility，点击桌面图标将直接进入应用详情页（设置->应用和元服务下，点击任意应用即可进入该应用的应用详情页）。其他情况下，点击桌面图标将直接进入应用页面。应用未配置入口UIAbility包含2种场景：

    应用没有配置任何UIAbility。

    所有UIAbility中skills标签下的entities未配置或配置内容不包括 “entity.system.home”，并且actions未配置或配置内容不包括 “ohos.want.action.home”。

（2）资源匹配

应用使用某资源时，系统会根据当前设备状态优先从相匹配的限定词目录中寻找该资源。只有当resources目录中没有与设备状态匹配的限定词目录，或者在限定词目录中找不到该资源时，才会去base目录中查找。rawfile和resfile是原始文件目录，不会根据设备状态去匹配资源。

说明：

在编译构建时，AppScope目录下的资源文件会合入到模块下面的资源文件中，如果两个目录下的相同资源目录和资源组目录下存在重名资源，编译打包后只会保留AppScope目录下的资源。

更多关于HarmonyOS鸿蒙Next中在AGC提交的应用名称和图标与安装到桌面之后的应用名称和图标不一致的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，应用名称和图标在AGC提交与桌面显示不一致，通常由以下原因导致：

  1. 配置差异：应用在AppScope/resources目录下的app.json5或module.json5中配置的名称和图标，与AGC控制台提交时填写的元数据不一致。
  2. 多语言/多分辨率：应用安装后，系统可能根据设备语言或屏幕分辨率，加载了不同的资源文件（如zh_CN或xxhdpi目录下的图标），与AGC中预览的默认资源不同。
  3. 缓存问题：设备可能存在缓存，导致新图标未及时更新。可尝试清除应用数据或重启设备。
  4. 签名影响：不同签名证书打包的应用，可能被视为不同应用，导致图标显示异常。

请检查资源配置与AGC提交信息是否匹配。

这个问题通常是由于应用包内的资源配置与AGC（AppGallery Connect）上设置的信息不匹配导致的。HarmonyOS Next的应用在安装时，系统会优先使用HAP包内声明的资源（如应用名称和图标），而不是AGC后台配置的信息。

请按以下步骤排查：

  1. 检查应用配置文件（module.json5）：

    • 确认module.json5文件中abilities或extensionAbilities标签下的icon和label字段配置的路径是否正确。
    • 对于多语言场景，请检查resource目录下各语言子目录（如zh_CN、en_US等）中的string.json文件，确保label对应的值（即应用显示名称）与AGC中为对应语言设置的应用名称完全一致。

  2. 核对图标资源：

    • 确认module.json5中icon字段指向的图片资源（通常位于resources/base/media/或相应密度目录下）与在AGC中上传的应用图标在视觉上完全一致。系统会进行像素级比对，相似度低会导致审核不通过。
    • 确保图标文件格式、尺寸符合规范，且未被其他样式或主题覆盖。

  3. 清理构建缓存并重新打包：

    • 在DevEco Studio中执行Build > Clean Project，然后Build > Build HAP(s)，生成全新的发布HAP。
    • 务必使用这个新构建的HAP包在AGC提交审核。

  4. 在AGC中核对多语言信息：

    • 在AGC控制台的应用信息页面，检查“默认语言”及各“支持语言”项下填写的“应用名称”是否与包内对应语言的label值严格一致。常见问题是AGC中修改了名称，但本地资源文件未同步更新。

总结：确保最终提交的HAP包内module.json5和资源文件所定义的应用名称、图标，与你在AGC对应语言配置项中填写的内容完全一致。系统在审核时会提取包内资源与AGC信息进行比对，不一致则会被驳回。

回到顶部