Uno Platform安卓端Assets忽略目录结构 图片均加载为首组同命名资源

问题背景 #

• 正在开发对齐已上线生产环境Web端的iOS、Android双端跨平台昆虫识别应用，核心功能为支持用户通过通俗检索词识别昆虫，展示对应昆虫不同生长阶段的精选照片结果集。
• 所有昆虫照片按照分类学归属、生长阶段归入对应层级目录，按字母排序的典型路径示例如下：
  • /images/creatures/ephemeroptera/ameletidae/ameletus/celer/imago.jpg
  • /images/creatures/ephemeroptera/ameletidae/ameletus/celer/nymph.jpg
  • /images/creatures/ephemeroptera/ameletidae/ameletus/celer/sub-imago.jpg
  • /images/creatures/ephemeroptera/ephemerellidae/ephemerella/dorothea-dorothea/imago.jpg
  • /images/creatures/ephemeroptera/ephemerellidae/ephemerella/dorothea-dorothea/nymph.jpg
  • /images/creatures/ephemeroptera/ephemerellidae/ephemerella/dorothea-dorothea/sub-imago.jpg
• 图片加载核心实现代码：

ListView stagesList = new();
foreach (CreatureStage stage in creature.CreatureStages)
{
     stagesList.Items.Add(new Image { Source = $"ms-appx:///Assets/{stage.ThumbnailPath}", });
}

• 项目依赖版本：
  • Uno.Extensions.Logging.OSLog 1.4.0
  • Uno.UI 4.3.8
  • Uno.UI.Adapter.Microsoft.Extensions.Logging 4.3.8
  • Uno.UI.RemoteControl 4.3.8
  • Uno.UniversalImageLoader 1.9.36

异常表现 #

• iOS端运行完全正常，可正确加载每个昆虫条目对应的关联图片，已反复验证代码中配置的资源路径完全准确。
• Android端所有昆虫条目统一加载Ameletus celer的对应图片：按字母排序Ameletus celer是第一组同时包含imago.jpg、nymph.jpg、sub-imago.jpg三个同名文件的资源组，初步判断Android端处理Assets资源时未保留目录层级结构，资源解析逻辑与iOS存在平台差异。
• 当前应用共关联1000余张照片，全量条目在Android端均错误加载同组Ameletus celer图片，调试过程未捕获到有效异常线索，问题排查受阻。

问题根因 #

Android原生Assets资源打包默认采用扁平化处理规则：所有子目录下的资源在打包阶段会被平铺到Assets根目录，不会保留原有的嵌套文件夹层级，不同路径下的同名文件会直接发生覆盖，最终APK内仅会保留字母序最靠前的同名文件。
Uno平台Android端默认继承了这一打包逻辑：项目中所有嵌套在分类子目录下的昆虫图片，打包时全被平铺到Assets根目录，不同物种目录下同名的imago.jpg/nymph.jpg/sub-imago.jpg依次发生覆盖，最终仅剩下字母序最靠前的Ameletus celer组的三张图片，所有指向同名文件的资源路径最终都会命中这组留存的资源。iOS端资源打包默认保留完整目录层级，因此不会出现该异常。

修复方案 #

• 快速修复（无需改动业务代码与资源文件名）：修改Android项目的csproj配置，禁用Assets资源的扁平化打包逻辑，在Android项目的<PropertyGroup>节点下添加如下配置：

<AndroidAssetPackagingFlatten>false</AndroidAssetPackagingFlatten>

配置添加完成后，清理所有中间生成文件、删除bin和obj目录，再重新生成项目。该配置生效后，打包流程会完整保留预设的目录层级，路径解析逻辑与iOS端完全对齐。

• 通用兼容方案（适配所有版本，无配置依赖）：为所有资源文件设置全局唯一文件名，例如将各目录下的imago.jpg重命名为ameletus_celer_imago.jpg、ephemerella_dorothea_imago.jpg这类带完整分类标识的文件名，从根源上避免同名文件覆盖问题。该方案无需修改打包配置，兼容所有Uno版本与Android系统版本。

注意：无论采用哪种方案，修复后都必须执行完整的项目清理，删除旧的打包缓存后再重新生成，避免残留的扁平化资源导致问题复现。

内容的提问来源于stack exchange，提问作者Jim Speaker