Skip to main content
本文档对应 SDK 2.0.0。授权见 授权认证。美妆 / 美型枚举见 参数枚举

环境要求

  • macOS 版本macOS 10.15 及以上
  • 开发语言Objective-C(AppKit / NSImage
  • 架构支持x86_64arm64(Apple Silicon)

获取示例源码

克隆 GitHub 仓库 到本地,进入 demo/macos 目录。
Xcode 15+ 编译错误使用 Xcode 15 或更高版本时,编译可能出现 Sandbox: rsync.samba deny(1)。这是 Xcode 默认开启 User Script Sandboxing 导致的。解决方法:
  1. 在 Xcode 中选择 Project
  2. 打开 Build Settings
  3. 搜索 ENABLE_USER_SCRIPT_SANDBOXING
  4. 将值从 Yes 改为 No

配置应用信息与密钥

绑定应用 Bundle ID

按照 绑定应用信息 在控制台绑定 macOS 应用 Bundle ID,例如:com.example.app

获取凭证

按照 获取 AppID 和 AppKey 取得 appIdappKey。打开 demo/macos/FBExampleObjc/BeautyCameraViewController.m,在 FBEngineConfig 上填写凭证。
licenseToken 非空,SDK 会在本地校验该 token,不会再用 appId / appKey 请求 /facebetter/v2/auth。详见 授权认证

运行工程

打开 demo/macos/FBExampleObjc.xcworkspace
  1. 确保 Xcode 工程签名正确。
Xcode 签名
  1. 若使用在线 appId / appKey 授权,请在 App Sandbox 中允许出站网络。
macOS 网络权限
  1. 编译运行。
选择本机 Mac(或模拟器),点击编译运行。