Android Studio中MLKit文本识别模型预加载错误求助

以下是针对Waiting for the text optional module to be downloaded错误的具体解决步骤：

• 检查设备网络与Google服务可用性
  确保测试设备（模拟器或真机）能正常访问Google服务：

  • 模拟器优先选择带Google Play服务的AVD镜像，普通系统镜像缺少Google服务框架会导致模型下载失败；
  • 真机需确认Google Play服务已安装并能正常联网。

• 调整依赖配置，选择内置模型版本
  MLKit文本识别有两种依赖类型，若不想处理模型下载流程，可切换到模型内置的独立SDK版本：

  • 移除原依赖：com.google.android.gms:play-services-mlkit-text-recognition:18.0.0
  • 添加独立SDK依赖：implementation 'com.google.mlkit:text-recognition:17.0.0'
    该版本将OCR模型直接打包在APK中，无需额外下载即可使用。

• 监听模型下载状态（按需下载版本）
  若坚持使用按需下载的依赖版本，需在代码中监听下载状态，确保模型下载完成后再初始化TextRecognizer：

  val modelManager = ModelManager.getInstance()
  val textModel = TextRecognitionModelIdentifier.DEFAULT_MODEL
  
  modelManager.isModelDownloaded(textModel)
      .addOnSuccessListener { isDownloaded ->
          if (isDownloaded) {
              // 模型已就绪，初始化识别器
              val recognizer = TextRecognition.getClient(TextRecognizerOptions.DEFAULT_OPTIONS)
              // 执行OCR操作
          } else {
              // 触发模型下载
              modelManager.downloadModel(textModel)
                  .addOnSuccessListener {
                      // 下载完成后初始化识别器
                  }
                  .addOnFailureListener { exception ->
                      // 处理下载失败逻辑
                  }
          }
      }
      .addOnFailureListener { exception ->
          // 检查模型状态失败处理
      }
  

• 更新Google Play服务版本
  设备上的Google Play服务版本过低可能导致下载异常：

  • 模拟器打开Google Play应用，检查并更新到最新版本；
  • 真机同样通过Google Play商店更新Google Play服务。

• 清理缓存与重新构建

  • 清理Android Studio缓存：点击File → Invalidate Caches... → 选择Invalidate and Restart；
  • 执行项目清理命令：在终端运行./gradlew clean；
  • 卸载设备上的现有应用，重新编译安装。

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