All Products
Search

This Product

    Cloud Phone:CreateApp

    Document Center

    Cloud Phone:CreateApp

    Last Updated:Dec 05, 2025

    Creates an Android application. Before you can install an application, you must use this API operation to create it. The application is not downloaded when it is created. It is downloaded only during installation. Ensure that the cloud phone can access the download URL.

    Operation description

    When you create an application, you can pass the application information in one of the following two ways:

    • Method 1: Pass an application from the WUYING Workspace app center.

      • Supported methods:

        • Method 1: Pass FileName and FilePath. Both parameters are required.

        • Method 2: Pass OssAppUrl.

      • Rule: If you pass an application from the WUYING Workspace app center, you must use at least one of the two methods. If you use both, Method 1 takes precedence.

      • Prerequisite: Log on to the Elastic Desktop Service Enterprise console. Follow the on-screen instructions to upload your application file to the WUYING Workspace app center. You can then obtain the required request parameters for this operation: FileName and FilePath, or OssAppUrl.

    • Method 2: Pass a custom application.

      • Supported method: Pass CustomAppInfo.

      • Rule: If you pass CustomAppInfo, all six fields in this object parameter are required.

    Note

    If you use both Method 1 and Method 2, the information passed in Method 2 takes precedence.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example

    AppName

    string

    No

    The application name.

    应用名称1

    FileName

    string

    No

    The name of the application file stored in Object Storage Service (OSS). This parameter and FilePath together determine the unique OSS address.

    Note

    • If you pass an application from the WUYING Workspace app center, you must pass FileName and FilePath, or OssAppUrl. The former takes precedence.

    • Log on to the WUYING Workspace console. Follow the on-screen instructions to upload your application file to the WUYING Workspace app center to obtain this parameter.

    testApp.apk

    FilePath

    string

    No

    The storage address of the application file in an OSS bucket. This parameter and FileName together determine the unique OSS address.

    Note

    • If you pass an application from the WUYING Workspace app center, you must pass FileName and FilePath, or OssAppUrl. The former takes precedence.

    • Log on to the WUYING Workspace console. Follow the on-screen instructions to upload your application file to the WUYING Workspace app center to obtain this parameter.

    tenant/1642150****/

    IconUrl

    string

    No

    The URL of the application icon.

    https://www.example.com/icon.png

    OssAppUrl

    string

    No

    The OSS address of the application.

    Note

    • If you pass an application from the WUYING Workspace app center, you must pass FileName and FilePath, or OssAppUrl. The former takes precedence.

    • Log on to the WUYING Workspace console. Follow the on-screen instructions to upload your application file to the WUYING Workspace app center to obtain this parameter.

    http://testApp.apk

    BizRegionId

    string

    No

    The region ID.

    cn-hangzhou

    InstallParam

    string

    No

    The installation parameters. The -r installation parameter is included by default when you install the application.

    -d

    Description

    string

    No

    The application description.

    应用描述

    CustomAppInfo

    object

    No

    The custom application information.

    Note

    • If you pass a custom application, pass the CustomAppInfo parameter. All six fields in this object parameter are required.

    • Custom applications have a higher priority than applications from the WUYING Workspace app center. If you pass the CustomAppInfo parameter, FileName and FilePath, or OssAppUrl will be invalid.

    DownloadUrl

    string

    No

    The download URL of the application.

    http://testApp.apk

    Version

    string

    No

    The application version.

    1.0.0

    VersionCode

    string

    No

    The application version code.

    10000

    PackageName

    string

    No

    The application package name.

    com.example.demo

    ApkSize

    string

    No

    The size of the .apk file. Unit: MB.

    10

    Md5

    string

    No

    The MD5 value of the .apk package.

    df3f46ce5844ddb278f14c5a9cd2****

    SignApk

    string

    No

    Specifies whether to perform a system signature.

    Valid values:

    • false :

      A signature is not required.

    • true :

      A signature is required.

    false

    Response elements

    Element

    Type

    Description

    Example

    object

    The returned parameters.

    AppId

    integer

    The application ID.

    1234

    RequestId

    string

    The request ID.

    E5138F7E-46B5-526A-8C99-82DEAE6B****

    Examples

    Success response

    JSON format

    {
  "AppId": 1234,
  "RequestId": "E5138F7E-46B5-526A-8C99-82DEAE6B****"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.