Updated on 2024-12-27 GMT+08:00

Building the macOS Demo

This section describes how to quickly compile and run the macOS Native demo of the client SDK.

Hardware Requirements

Ensure that the following hardware requirements are met during the compilation and running of the macOS Native demo.

SDK Type

Hardware Requirements

Description

For Intel chips (x86_64)

Mac devices

The Intel-based SDKs can be used on all Mac devices.

For M-series chips (ARM64)

Apple-developed devices with M-series chips

SDKs of this type outperform the Intel-based SDKs on Apple devices with M-series chips, reducing both memory and CPU usage significantly.

Environment Requirements

Ensure that the following environment requirements are met during the compilation and running of the macOS Native demo.

Table 1 Environment requirements

Environment and Tool

Version

Description

OS

macOS High Sierra 10.14.4 or later

Requirement of Xcode on the macOS. The recommended version is 10.15 or later.

Xcode

Xcode 11 or later

Xcode 12.0.1 is used as an example in the demo and documentation.

Requesting test resources and app IDs

-

For details, see Preparations.

Procedure

  1. Download the SDK and demo source code.

    1. Download the ZIP package of the SDK by following the instructions provided in Table 1.
    2. Decompress the ZIP package to obtain the following files and directories:
      Figure 1 Directory structure of the SDK package

  2. Select an SDK library based on hardware requirements (x86_64 SDK by default).

    1. Delete the original SDK libraries.
      Figure 2 Deleting the original SDK libraries
    2. Delete the original SDK library dependencies.
      Figure 3 Deleting the original SDK library dependencies
    3. Delete the original framework search paths.
      Figure 4 Deleting the original framework search paths
    4. Add the SDK libraries in the HWMUISDK directory to Frameworks, Libraries, and Embedded Content of the project based on the hardware requirements, and modify the value of Embed.
      Figure 5 Adding SDK libraries
    5. Ensure that Embed Frameworks are executed before Run Script.
      Figure 6 Placing Embed Frameworks before Run Script

  3. Request an app ID and change the app ID in the demo to the requested one.

    For details about how to request an app ID, see Introduction to App ID Authentication.

    Replace the app ID in HWMAppKeyManager with the obtained app ID.

    Figure 7 Changing the default app ID of the demo

  4. Edit and run the demo project.

    1. Modify the bundle identifier and install the corresponding certificate. Replace it with the certificate of your company.
    2. Set Build Location to Custom under Preferences of Xcode.
      Figure 8 Changing Xcode Build location
    3. Compile and run the project.

  5. Use the demo.

    The following describes how to create an instant meeting:

    1. Click Initialization to initialize the SDK.

    2. Log in to the system.

      Login using an account and password: Click the login button. On the login screen, enter the account and password and click Log in.

    3. Click Create meeting.