All Products
Search
Document Center

:Build the short video client for iOS

Last Updated:Jun 20, 2026

This topic describes how to build the short video client for iOS.

Prepare the environment

Environment

Description

System version

iOS 9.0 or later is supported.

iPhone

iPhone 5 or later is supported.

CPU architecture

The ARM64, ARMv7, and ARMv7s architectures are supported for physical devices. Simulator architectures are not supported.

Xcode

Xcode 9.0 or later is supported. Download Xcode.

Prerequisites

Procedure

  1. Download the short video demo and decompress the package. For more information, see SDK overview and download.

    Directory structure:

    - demo  
          - |- AlivcCommon      # The public component.
          - |- AlivcCore        # The public component of the short video service.
          - |- AlivcCrop        # The component that contains the code used to implement the cropping UI.
          - |- AlivcEdit        # The component that contains the code used to implement the editing UI.
          - |- AlivcRecord      # The component that contains the code used to implement the recording UI.
          - |- AlivcSmartVideo  # The component of the short video service.
          - |- AliyunVideoClient_Entrance    # The project entry file of the short video service.
    - doc  # The related documentations.
    - sdk  # The SDK that is used by the project. You can manually import an SDK as needed.
    - xxxReleaseNote.md  # The release note.
  2. Import and configure the project.

    1. Open Xcode, click Open a project or file, and then double-click the AliyunVideoClient_Entrance.xcworkspace file in the demo directory.

    2. Specify the server address.

      File path: demo/AlivcCommon/AlivcCommon/Classes/Macro/AlivcDefine.m.

      Modify the kAlivcQuUrlString variable in the file, setting it to the public IP address of the ECS instance where the Qu Video AppServer is fully integrated, and add the port number 8080.

      Example: http://<Public IP address of the ECS instance>:8080.

      NSString * const kAlivcQuUrlString = @"http://:8080";
  3. Modify the Bundle Identifier and Signing Certificate parameters.

    Important

    Change the Bundle Identifier to com.<Company Name>.<Project Name> to avoid run failures that occur when the Bundle Identifier is already in use.

    The value of the Bundle Identifier parameter must be defined in the package_name parameter in the profile of your short video AppServer. Assume that you do not set the Bundle Identifier parameter on the short video AppServer. When your application runs on the short video client for iOS, the bundle ID interceptor that is deployed on the short video AppServer intercepts the bundle ID of the application. As a result, a 403 error with the "Request failed:forbidden" error message is returned when the application sends a request to the short video AppServer. For more information about how to set the Bundle Identifier parameter on the short video AppServer, see Build the short video AppServer.

    In Xcode, select the project target, click the General tab, and then modify the Bundle Identifier in the Identity section.

    On the Signing & Capabilities tab, in the Signing section, ensure Automatically manage signing is selected. Verify that the Bundle Identifier value matches the one configured on your AppServer.

  4. On the Signing & Capabilities tab, verify that Automatically manage signing is selected, then choose your Team.

    1. Select your Team.

      This field is in the Signing section of the Signing & Capabilities tab. Click the dropdown menu next to Team to select your account.

    2. If you have not yet added an account, click Add an Account.

      This option is in the Team dropdown menu in the Signing section of the Signing & Capabilities tab.

    3. Create an account.

      In Xcode, go to Preferences > Accounts. Click the + button in the lower-left corner. In the Sign in with your Apple ID dialog box that appears, enter your Apple ID and click Next to sign in.

    4. Select the created account from the Team drop-down list. Make sure that no error message appears after you add the signature.

  5. Compile and run the project.

    1. Set the run target to AliyunVideoClient_Entrance. Connect a physical iOS device to your computer with a data cable. In Xcode, select the device as the run destination. On your physical device, enable Developer Mode in the Settings app.

    2. Click the build and run button.