Xamarin.iOS AR开发调用ArcGIS DataManager.cs报文件未找到错误

以下是该问题的高频触发原因及对应修复方式，按排查优先级排序：

• 路径映射逻辑不匹配
  官方示例中的DataManager类是为官方示例仓库的专属目录结构、示例资源映射逻辑设计的，手动复制代码到自有项目时，如果没有同步修改路径拼接规则，会直接指向不存在的目录。Xamarin.iOS 存在严格的沙盒路径隔离：打包进安装包的资源位于只读的App Bundle目录，运行时下载、解压的文件必须存放在可写的缓存/文档目录，两类路径的获取方式完全不同，直接套用示例的路径返回逻辑必然出错。
• 解压后文件结构不符合加载要求
  ModelSceneSymbol构造函数要求传入的Uri必须直接指向3D模型的主文件（支持.dae/.gltf/.glb等格式），不能指向zip压缩包，也不能指向解压后的外层文件夹。常见错误是zip解压后自动生成了一层和压缩包同名的嵌套目录，代码传入的是外层目录的Uri而非内部模型文件的Uri，直接触发文件找不到异常。
  额外注意：iOS平台文件系统大小写敏感，代码中填写的模型文件名、后缀必须和实际文件的大小写完全一致，Windows、Mac模拟器上忽略大小写的逻辑在iOS真机上不生效。
• 项目构建配置错误
  如果模型文件是预置在项目中的静态资源，需要将对应文件的构建操作设置为BundleResource，如果设置为None或EmbeddedResource，文件不会被打包进App安装包，运行时无法读取。
  如果是运行时从ArcGIS服务下载zip包再解压，不要将解压目标路径设置为App Bundle的只读目录，会导致解压流程静默失败，后续加载找不到文件。可通过以下代码获取合法的可写缓存路径：

  // 获取Xamarin.iOS运行时合法可写缓存目录
  string modelCachePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "3DModelAssets");
  Directory.CreateDirectory(modelCachePath);
  

• 冗余依赖缺失
  官方DataManager类依赖SampleInfo资源映射表、多平台版本判断等多个配套类，手动复制时如果遗漏任意依赖，都会导致路径拼接结果错误。这类场景下建议直接裁剪掉官方示例的封装逻辑，自行实现zip下载、解压、返回模型文件绝对路径的逻辑，排查成本远低于修复复制来的冗余示例代码。

快速定位技巧：在调用ModelSceneSymbol构造函数前，先通过File.Exists(待传入的模型路径)做校验，同时打印出完整的绝对路径，直接到对应沙盒目录核对文件是否存在、文件名是否正确，绝大多数路径类问题可通过这一步直接定位。

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