Run macOS Sample Application

Environment Requirements

• macOS Version: macOS 10.14 and above
• Development Language: Objective-C
• Architecture Support: x86_64, arm64 (Apple Silicon)

Get Sample Source Code

Clone the GitHub repository locally, navigate to the macos/demo/FBExampleObjc directory, and open the Xcode project.

# clone 
git clone https://github.com/pixpark/facebetter-demo.git

Download the latest macOS version library from the SDK Download page and place it in the project directory macos/demo/FBExampleObjc/libs.

Configure Application Information and Keys

Bind Application Bundle ID

Follow the instructions on this page to bind your macOS application Bundle ID in the console, for example: com.example.app

Get AppID and AppKey

Follow the instructions on this page to get your appid and appkey. Open ViewController.m in the project and modify the appid and appkey.

  FBEngineConfig *engineConfig = [[FBEngineConfig alloc] init];
  engineConfig.appId = @"your appId"; 
  engineConfig.appKey = @"your appkey"; 
  // Optional: If licenseJson is provided, license data verification takes priority, appId and appKey are not required
  // engineConfig.licenseJson = @"your license json string";
 
  self.beautyEffectEngine = [FBBeautyEffectEngine createEngineWithConfig:engineConfig];

Run the Project

Open the macos/demo/FBExampleObjc/FBExampleObjc.xcodeproj project.

1. Ensure Xcode project signing is correct

2. Ensure network permissions are enabled for appkey validation

3. Ensure the Facebetter library is properly linked

4. Build and run

Select target device (Mac or Simulator) and click the build and run button.