You are on page 1of 6

apk of the given PACKAGE.

dump PACKAGE
Print various system state associated with the given PACKAGE.

has-feature FEATURE_NAME [version]


Prints true and returns exit status 0 when system has a FEATURE_NAME,
otherwise prints false and returns exit status 1

list features
Prints all features of the system.

list instrumentation [-f] [TARGET-PACKAGE]


Prints all test packages; optionally only those targeting TARGET-PACKAGE
Options:
-f: dump the name of the .apk file containing the test package

list libraries
Prints all system libraries.

list packages [-f] [-d] [-e] [-s] [-3] [-i] [-l] [-u] [-U]
[--show-versioncode] [--apex-only] [--uid UID] [--user USER_ID] [FILTER]
Prints all packages; optionally only those whose name contains
the text in FILTER. Options are:
-f: see their associated file
-a: all known packages (but excluding APEXes)
-d: filter to only show disabled packages
-e: filter to only show enabled packages
-s: filter to only show system packages
-3: filter to only show third party packages
-i: see the installer for the packages
-l: ignored (used for compatibility with older releases)
-U: also show the package UID
-u: also include uninstalled packages
--show-versioncode: also show the version code
--apex-only: only show APEX packages
--uid UID: filter to only show packages with the given UID
--user USER_ID: only list packages belonging to the given user

list permission-groups
Prints all known permission groups.

list permissions [-g] [-f] [-d] [-u] [GROUP]


Prints all known permissions; optionally only those in GROUP. Options are:
-g: organize by group
-f: print all information
-s: short summary
-d: only list dangerous permissions
-u: list only the permissions users will see

list staged-sessions [--only-ready] [--only-sessionid] [--only-parent]


Prints all staged sessions.
--only-ready: show only staged sessions that are ready
--only-sessionid: show only sessionId of each session
--only-parent: hide all children sessions

list users
Prints all users.
resolve-activity [--brief] [--components] [--query-flags FLAGS]
[--user USER_ID] INTENT
Prints the activity that resolves to the given INTENT.

query-activities [--brief] [--components] [--query-flags FLAGS]


[--user USER_ID] INTENT
Prints all activities that can handle the given INTENT.

query-services [--brief] [--components] [--query-flags FLAGS]


[--user USER_ID] INTENT
Prints all services that can handle the given INTENT.

query-receivers [--brief] [--components] [--query-flags FLAGS]


[--user USER_ID] INTENT
Prints all broadcast receivers that can handle the given INTENT.

install [-rtfdgw] [-i PACKAGE] [--user USER_ID|all|current]


[-p INHERIT_PACKAGE] [--install-location 0/1/2]
[--install-reason 0/1/2/3/4] [--originating-uri URI]
[--referrer URI] [--abi ABI_NAME] [--force-sdk]
[--preload] [--instant] [--full] [--dont-kill]
[--enable-rollback]
[--force-uuid internal|UUID] [--pkg PACKAGE] [-S BYTES]
[--apex] [--wait TIMEOUT]
[PATH [SPLIT...]|-]
Install an application. Must provide the apk data to install, either as
file path(s) or '-' to read from stdin. Options are:
-R: disallow replacement of existing application
-t: allow test packages
-i: specify package name of installer owning the app
-f: install application on internal flash
-d: allow version code downgrade (debuggable packages only)
-p: partial application install (new split on top of existing pkg)
-g: grant all runtime permissions
-S: size in bytes of package, required for stdin
--user: install under the given user.
--dont-kill: installing a new feature split, don't kill running app
--restrict-permissions: don't whitelist restricted permissions at install
--originating-uri: set URI where app was downloaded from
--referrer: set URI that instigated the install of the app
--pkg: specify expected package name of app being installed
--abi: override the default ABI of the platform
--instant: cause the app to be installed as an ephemeral install app
--full: cause the app to be installed as a non-ephemeral full app
--install-location: force the install location:
0=auto, 1=internal only, 2=prefer external
--install-reason: indicates why the app is being installed:
0=unknown, 1=admin policy, 2=device restore,
3=device setup, 4=user request
--force-uuid: force install on to disk volume with given UUID
--apex: install an .apex file, not an .apk
--wait: when performing staged install, wait TIMEOUT milliseconds
for pre-reboot verification to complete. If TIMEOUT is not
specified it will wait for 60000 milliseconds.

install-existing [--user USER_ID|all|current]


[--instant] [--full] [--wait] [--restrict-permissions] PACKAGE
Installs an existing application for a new user. Options are:
--user: install for the given user.
--instant: install as an instant app
--full: install as a full app
--wait: wait until the package is installed
--restrict-permissions: don't whitelist restricted permissions

install-create [-lrtsfdg] [-i PACKAGE] [--user USER_ID|all|current]


[-p INHERIT_PACKAGE] [--install-location 0/1/2]
[--install-reason 0/1/2/3/4] [--originating-uri URI]
[--referrer URI] [--abi ABI_NAME] [--force-sdk]
[--preload] [--instant] [--full] [--dont-kill]
[--force-uuid internal|UUID] [--pkg PACKAGE] [--apex] [-S BYTES]
[--multi-package] [--staged]
Like "install", but starts an install session. Use "install-write"
to push data into the session, and "install-commit" to finish.

install-write [-S BYTES] SESSION_ID SPLIT_NAME [PATH|-]


Write an apk into the given install session. If the path is '-', data
will be read from stdin. Options are:
-S: size in bytes of package, required for stdin

install-remove SESSION_ID SPLIT...


Mark SPLIT(s) as removed in the given install session.

install-add-session MULTI_PACKAGE_SESSION_ID CHILD_SESSION_IDs


Add one or more session IDs to a multi-package session.

install-commit SESSION_ID
Commit the given active install session, installing the app.

install-abandon SESSION_ID
Delete the given active install session.

set-install-location LOCATION
Changes the default install location. NOTE this is only intended for
debugging;
using this can cause applications to break and other undersireable behavior.
LOCATION is one of:
0 [auto]: Let system decide the best location
1 [internal]: Install on internal device storage
2 [external]: Install on external media

get-install-location
Returns the current install location: 0, 1 or 2 as per set-install-location.

move-package PACKAGE [internal|UUID]

move-primary-storage [internal|UUID]

uninstall [-k] [--user USER_ID] [--versionCode VERSION_CODE]


PACKAGE [SPLIT...]
Remove the given package name from the system. May remove an entire app
if no SPLIT names specified, otherwise will remove only the splits of the
given app. Options are:
-k: keep the data and cache directories around after package removal.
--user: remove the app from the given user.
--versionCode: only uninstall if the app has the given version code.

clear [--user USER_ID] PACKAGE


Deletes all data associated with a package.
enable [--user USER_ID] PACKAGE_OR_COMPONENT
disable [--user USER_ID] PACKAGE_OR_COMPONENT
disable-user [--user USER_ID] PACKAGE_OR_COMPONENT
disable-until-used [--user USER_ID] PACKAGE_OR_COMPONENT
default-state [--user USER_ID] PACKAGE_OR_COMPONENT
These commands change the enabled state of a given package or
component (written as "package/class").

hide [--user USER_ID] PACKAGE_OR_COMPONENT


unhide [--user USER_ID] PACKAGE_OR_COMPONENT

suspend [--user USER_ID] TARGET-PACKAGE


Suspends the specified package (as user).

unsuspend [--user USER_ID] TARGET-PACKAGE


Unsuspends the specified package (as user).

grant [--user USER_ID] PACKAGE PERMISSION


revoke [--user USER_ID] PACKAGE PERMISSION
These commands either grant or revoke permissions to apps. The permissions
must be declared as used in the app's manifest, be runtime permissions
(protection level dangerous), and the app targeting SDK greater than Lollipop
MR1.

reset-permissions
Revert all runtime permissions to their default state.

set-permission-enforced PERMISSION [true|false]

get-privapp-permissions TARGET-PACKAGE
Prints all privileged permissions for a package.

get-privapp-deny-permissions TARGET-PACKAGE
Prints all privileged permissions that are denied for a package.

get-oem-permissions TARGET-PACKAGE
Prints all OEM permissions for a package.

set-app-link [--user USER_ID] PACKAGE {always|ask|never|undefined}


get-app-link [--user USER_ID] PACKAGE

trim-caches DESIRED_FREE_SPACE [internal|UUID]


Trim cache files to reach the given free space.

list users
Lists the current users.

create-user [--profileOf USER_ID] [--managed] [--restricted] [--ephemeral]


[--guest] [--pre-create-only] [--user-type USER_TYPE] USER_NAME
Create a new user with the given USER_NAME, printing the new user identifier
of the user.
USER_TYPE is the name of a user type, e.g. android.os.usertype.profile.MANAGED.
If not specified, the default user type is
android.os.usertype.full.SECONDARY.
--managed is shorthand for '--user-type android.os.usertype.profile.MANAGED'.
--restricted is shorthand for '--user-type
android.os.usertype.full.RESTRICTED'.
--guest is shorthand for '--user-type android.os.usertype.full.GUEST'.
remove-user USER_ID
Remove the user with the given USER_IDENTIFIER, deleting all data
associated with that user

set-user-restriction [--user USER_ID] RESTRICTION VALUE

get-max-users

get-max-running-users

compile [-m MODE | -r REASON] [-f] [-c] [--split SPLIT_NAME]


[--reset] [--check-prof (true | false)] (-a | TARGET-PACKAGE)
Trigger compilation of TARGET-PACKAGE or all packages if "-a". Options are:
-a: compile all packages
-c: clear profile data before compiling
-f: force compilation even if not needed
-m: select compilation mode
MODE is one of the dex2oat compiler filters:
assume-verified
extract
verify
quicken
space-profile
space
speed-profile
speed
everything
-r: select compilation reason
REASON is one of:
first-boot
boot
install
bg-dexopt
ab-ota
inactive
shared
labs
adcp
--reset: restore package to its post-install state
--check-prof (true | false): look at profiles when doing dexopt?
--secondary-dex: compile app secondary dex files
--split SPLIT: compile only the given split name
--compile-layouts: compile layout resources for faster inflation

force-dex-opt PACKAGE
Force immediate execution of dex opt for the given PACKAGE.

bg-dexopt-job
Execute the background optimizations immediately.
Note that the command only runs the background optimizer logic. It may
overlap with the actual job but the job scheduler will not be able to
cancel it. It will also run even if the device is not in the idle
maintenance mode.

reconcile-secondary-dex-files TARGET-PACKAGE
Reconciles the package secondary dex files with the generated oat files.

dump-profiles TARGET-PACKAGE
Dumps method/class profile files to
/data/misc/profman/TARGET-PACKAGE.txt

snapshot-profile TARGET-PACKAGE [--code-path path]


Take a snapshot of the package profiles to
/data/misc/profman/TARGET-PACKAGE[-code-path].prof
If TARGET-PACKAGE=android it will take a snapshot of the boot image

set-home-activity [--user USER_ID] TARGET-COMPONENT


Set the default home activity (aka launcher).
TARGET-COMPONENT can be a package name (com.package.my) or a full
component (com.package.my/component.name). However, only the package name
matters: the actual component used will be determined automatically from
the package.

set-installer PACKAGE INSTALLER


Set installer package name

get-instantapp-resolver
Return the name of the component that is the current instant app installer.

set-harmful-app-warning [--user <USER_ID>] <PACKAGE> [<WARNING>]


Mark the app as harmful with the given warning message.

get-harmful-app-warning [--user <USER_ID>] <PACKAGE>


Return the harmful app warning message for the given app, if present

uninstall-system-updates [<PACKAGE>]
Removes updates to the given system application and falls back to its
/system version. Does nothing if the given package is not a system app.
If no package is specified, removes updates to all system applications.

get-moduleinfo [--all | --installed] [module-name]


Displays module info. If module-name is specified only that info is shown
By default, without any argument only installed modules are shown.
--all: show all module info
--installed: show only installed modules

log-visibility [--enable|--disable] <PACKAGE>


Turns on debug logging when visibility is blocked for the given package.
--enable: turn on debug logging (default)
--disable: turn off debug logging

You might also like