Building the macOS Demo

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

View PDF

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

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
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
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
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.
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.