Help Center/ KooPhone/ User Guide/ Deploying and Managing UNI Cloud Terminal Apps/ Managing a UNI Cloud Terminal App Library
Updated on 2025-11-27 GMT+08:00

Managing a UNI Cloud Terminal App Library

Uploading an App

  1. Log in to the KooPhone console. The KooPhone overview page is displayed.
  2. In the navigation pane on, choose UNI Cloud Terminal > App Deployment > App Library.
  3. On the app library management page, click Upload App.
  4. In the displayed dialog box, set parameters by referring to Table 1 and click OK.

    Figure 1 Dialog box for uploading an app
    Table 1 App parameters

    Parameter

    Description

    App Name

    App name entered when you upload an app.

    The name can contain 1 to 20 characters, including only letters, digits, hyphens (-), underscores (_), and periods (.).

    Description

    App description entered when you upload an app.

    The name can contain 1 to 100 characters, including only letters, digits, hyphens (-), underscores (_), commas (,), and periods (.).

    Upload From

    Region of the purchased instance. You can select a region from the drop-down list.

    Upload App

    Local app file to be uploaded, which must be an APK file.

    • Click Add File and select a local file. Only one file can be uploaded at a time.
    • Click to delete the temporarily uploaded app package and upload a new one.

  5. When the message "App uploaded" is displayed, click OK.

Viewing the App Library Management Page

You can upload and delete app packages, and install apps on specified instances.

By default, the app list displays the app name, app package name, version number, upload area, and upload time. Click in the upper right corner above the list to customize columns. For details about mandatory and optional parameters, see Table 2.
Table 2 Parameters

Parameter

Mandatory

Description

App Name

Yes

App name entered during app upload. A name contains up to 20 characters. This parameter is a criterion in the search box.

App Package Name

Yes

Name of a local app. This parameter is a criterion in the search box.

App Version Number

Yes

Version number of the local app, which can be used for version comparison.

Upload From

No

Region of the instance. You can click to filter regions.

Uploaded

No

Time when the app was uploaded.

Operation

Yes

Displays the Install button.

Description

No

App description entered during app upload. The value contains up to 100 characters.

NOTE:

By default, the app description is not displayed in the app list. You can choose to display it when customizing columns.

  • Click the app name to check the app package name. Enter a keyword in the search box or click next to Upload From to filter data.
  • Click on the right to search for apps that meet the criteria.
  • Click in the upper right corner to refresh all apps.
  • Click Uninstall above the app list to go to the Instance Management page. For details, see Uninstalling an App.

Deleting an App

  1. In the app list on the App Library page, select one or more apps to be deleted.
  2. Click Delete App in the upper left corner above the list.
  3. Check the app name and other information. In the Confirm dialog box, enter information as prompted and click OK.

    Batch deletion will clear app upload records in all upload regions.

  4. When the message "App Deleted" is displayed, click OK.

Installing an App

  1. In the app list on the App Library page, locate the app to be installed.
  2. Click Install in the Operation column on the right.
  3. Select an instance where the app is to be installed and click OK.

    • The list displays all purchased instances. You can click an instance name to check the flavor and username, or enter a keyword in the search box or click the filter button next to Running Status to filter data.
    • Apps can only be installed on running UNI Cloud Terminal.

  4. When the message "Install App Requested" is displayed, click OK.

    It takes some time to install the app. You can click App Query to check the installation progress.

Uninstalling an App

  1. Log in to the KooPhone console. The KooPhone overview page is displayed.
  2. In the navigation pane, choose UNI Cloud Terminal > Instance Management.
  3. Uninstall an app from one or more instances.

    • In the instance list, select one or more instances and choose More > App uninstallation in the upper left corner above the list.
    • In the instance list, locate an instance and choose More > App uninstallation in the Operation column.

  4. In the displayed dialog box, enter the app package name and click OK.

    • When an app is uninstalled from multiple instances, a dialog box is displayed, showing the list of all instances with this app installed.
    • Apps can only be uninstalled from running UNI Cloud Terminal.

  5. When the message "Uninstall App Requested" is displayed, click OK.

    It takes some time to uninstall the app. You can click App Query to check the uninstallation progress.