华为ML Kit端侧翻译下载模型提示不存在异常如何解决

依赖配置校验 #

• 确认同时引入翻译基础SDK和端侧算法包，且两者版本号完全一致，仅引入基础SDK仅支持远程翻译，无法加载端侧模型，正确配置示例：

  dependencies {
      // 翻译基础服务SDK
      implementation 'com.huawei.hms:ml-computer-translate:3.7.0.302'
      // 端侧翻译算法包，端侧功能必须引入
      implementation 'com.huawei.hms:ml-computer-translate-model:3.7.0.302'
  }
  

  注意：版本号建议使用最新稳定版，跨版本混用会导致模型检索逻辑异常

AGC服务开关校验 #

• 端侧翻译服务不会默认开启，需登录AGC控制台进入对应项目，在ML Kit -> 服务设置页面手动开启「端侧翻译」开关，开启后需等待10~15分钟配置生效，再重新测试模型下载

语言参数校验 #

• 端侧翻译的语言编码规则和远程翻译存在差异，仅支持两位ISO 639-1标准语言代码，常见错误传参包括zh-CN、en-US等带区域后缀的编码，需替换为zh、en格式，同时确认传入的源/目标语言属于端侧翻译支持范围
• 可以提前调用MLTranslateLanguage.getAllLocalLanguages()获取当前SDK支持的端侧翻译语言列表，确认参数合法性

签名校验 #

• 端侧模型下载会校验应用签名指纹，需确认当前安装包使用的签名SHA256指纹，已经正确录入AGC控制台对应项目的「应用信息」配置中，debug和release签名需分别录入对应指纹

本地缓存清除 #

• 之前下载过损坏的模型文件会导致后续请求异常，可先调用模型删除接口清空本地缓存后再重试下载，示例代码：

  // 以中英翻译模型为例
  MLTranslateLanguage modelLang = new MLTranslateLanguage.Factory()
          .setSourceLanguage(MLTranslateLanguage.ZH)
          .setTargetLanguage(MLTranslateLanguage.EN)
          .create();
  MLLocalTranslatorModelManager.getInstance().deleteModel(modelLang, null);
  

日志排查 #

如果以上步骤校验完成仍报错，可开启SDK调试日志获取具体错误码进一步定位：

MLLog.setLogLevel(MLLog.LOG_DEBUG);

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