Help Center/ Cloud Phone Host/ Best Practices/ Best Practices of Cloud Phone Application Sharing/ Usage Guide to Application Sharing/ Using the appctrl Command to Manage Shared Applications
Updated on 2023-03-16 GMT+08:00
View PDF

Using the appctrl Command to Manage Shared Applications

You can run appctrl commands on a cloud phone to manage shared applications on the cloud phone.

You can

Running the appctrl start Command to Start an Application

Scenario: The appctrl start command is used to install an application on a cloud phone and start the application.

Prerequisites: The TAR package of the application has been pushed to the cloud phone server.

Usage guide: appctrl start {package name} {launch_activity}

Example: Start Subway Surfers.

appctrl start com.kiloo.subwaysurf com.idsky.android.impl.ui.IdskySplashActivity

You'd better transfer the startup activity name of the application. If the name cannot be obtained, you can transfer only the startup package name and let appctrl to obtain the startup item. That is, run the appctrl start package_name command to start the application.

Running the appctrl uninstall Command to Uninstall an Application

Scenario: When an application is no longer used on a cloud phone, you can run appctrl uninstall to uninstall it from the cloud phone. You are advised to uninstall an application each time you finish using it. This is to ensure data security and use the latest application version in the future.

Prerequisites: The application has been installed on the cloud phone by running appctrl install or appctrl start.

Usage guide: Run the appctrl uninstall {package name} command on the cloud phone.

For example, uninstall Subway Surfers.

appctrl uninstall com.kiloo.subwaysurf

Running the appctrl clear Command to Clear Application Data

Scenario: When cloud phones are allocated to different users, run the appctrl clear command to clear all non-preinstalled applications on the cloud phones each time the cloud phones are restarted or before the cloud phones are allocated to new users.

Prerequisites: The cloud phone has been restarted or reset and is ready to be allocated to a new user.

Usage guide: Run appctrl clear on the cloud phone.

Updating the Version of an Application

Prerequisites: The TAR package of the application of the new version has been prepared. The application of the earlier version has been uninstalled from the cloud phone.

Operation guide

  1. Push the TAR package of the latest version to the shared storage.
  2. Run the appctrl start or appctrl install command, and the new version will be automatically installed.