如何在不使用CocoaPods/SPM的iOS（Objective-C）项目中集成Google ML Kit

• 下载对应ML Kit模块框架
  前往Google ML Kit官方页面下载你需要的功能模块框架包（比如文本识别、人脸检测等，ML Kit为模块化设计，按需选择），解压后得到.framework格式的文件。

• 添加框架到项目
  打开Xcode项目，将解压后的.framework文件直接拖入项目导航栏，在弹出的对话框中勾选「Copy items if needed」，并选择要集成的目标Target。

• 添加系统依赖框架
  进入项目的Build Phases -> Link Binary With Libraries，添加ML Kit所需的系统框架，常见依赖包括：

  • CoreMedia
  • AVFoundation
  • Accelerate
  • CoreImage（部分模块如人脸检测需要）
    具体依赖可参考对应模块的官方说明。

• 配置Build Settings

  1. 在Build Settings中找到Framework Search Paths，添加ML Kit框架所在的路径，确保Xcode能正确定位框架文件。
  2. 找到Other Linker Flags，添加-ObjC参数，避免运行时出现符号缺失的错误。

• 导入并使用ML Kit
  在你的Objective-C代码文件中导入头文件：

  #import <GoogleMLKit/GoogleMLKit.h>
  

  之后即可按照ML Kit的API文档调用对应功能，例如初始化文本检测器并处理图像：

  MLKTextRecognizer *textRecognizer = [MLKTextRecognizer textRecognizer];
  UIImage *image = [UIImage imageNamed:@"sample_image"];
  MLKVisionImage *visionImage = [[MLKVisionImage alloc] initWithImage:image];
  [textRecognizer processImage:visionImage completion:^(MLKText * _Nullable result, NSError * _Nullable error) {
      if (error) {
          // 处理错误
          return;
      }
      // 处理识别结果
      NSString *recognizedText = result.text;
  }];
  

• 注意事项

  • 确保下载的ML Kit框架版本与你的Xcode、iOS系统版本兼容；
  • 如果使用摄像头、相册等功能，需在Info.plist中添加对应的权限描述（如NSCameraUsageDescription、NSPhotoLibraryUsageDescription）；
  • 若框架区分真机和模拟器版本，需根据编译目标切换对应框架，或下载通用版本。

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