Help Center/ KooPhone/ User Guide/ App Deployment/ Managing the App Library
Updated on 2024-07-22 GMT+08:00

Managing the App Library

Overview

The App Library page displays all uploaded app packages and used storage space. You can upload and delete app packages, and install apps on specified cloud phone instances.

  • The Used Storage area displays the used space and total space. The total space of a single region is configured when you buy cloud phone instances in that region. The default total space is 1,000 MB. You can click View Details to check the usage details.

    Up to five regions are displayed in the Used Storage area. Regions are sorted in descending order of the total usage. If there are more than five regions, the Show More button is displayed. If there are five or fewer regions, the View Details button is displayed.

  • By default, the app list displays the app name, app package name, version number, file size, 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 1.
    Table 1 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.

    File Size (MB)

    No

    Size of the local app.

    Upload From

    No

    Region of the cloud phone instance. You can select a region for an app.

    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 Cloud Phone Instances page. For details, see Uninstalling an App.

Uploading an App

  1. Sign in to the KooPhone console.
  2. In the navigation pane, choose App Deployment > App Library.
  3. Click Upload App. Configure app parameters based on Table 2 and click OK.

    Table 2 App parameters

    Parameter

    Description

    App Name

    App name entered during app upload. The value contains up to 20 characters.

    Description

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

    Upload From

    Region of the purchased cloud phone 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.

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

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 a cloud phone instance where the app is to be installed and click OK.

    • The list displays all purchased cloud phone instances. You can click a cloud phone 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 cloud phones.

  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. Sign in to the KooPhone console.
  2. In the navigation pane, choose Cloud Phone Instances.
  3. Uninstall an app from one or more cloud phones.

    • In the instance list, select one or more cloud phone instances and choose More > Uninstall App in the upper left corner above the list.
    • In the instance list, locate a cloud phone instance and choose More > Uninstall App in the Operation column on the right.

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

    When uninstalling an app from multiple cloud phones, a dialog box is displayed, showing the list of all cloud phone instances with this app installed.

    An app can be uninstalled only from running cloud phones.

  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.