このページの概要
adbでandroid端末の各種操作をするにあたり、android Nからは、新規に
$ adb shell cmd <service> <options>
というコマンド体系が追加された模様。
各種コマンドの役割、使い方を整理したい。
なお、現状、未実装なコマンドも多いようなので、随時更新する予定。
現状のservice一覧 (Nexus 5x, NPF10C, 2016/10/27現在)
各種serviceは存在しているが、実際のコマンドは未実装なものが多い
$ adb shell cmd -l
Currently running services:
AtCmdFwd
DockObserver
SurfaceFlinger
accessibility
account
activity
alarm
android.hardware.fingerprint.IFingerprintDaemon
android.security.keystore
appops
appwidget
assetatlas
audio
backup
battery
batteryproperties
batterystats
bluetooth_manager
carrier_config
clipboard
cneservice
commontime_management
connectivity
connectivity_metrics_logger
connmetrics
consumer_ir
content
contexthub_service
country_detector
cpuinfo
dbinfo
device_policy
deviceidle
devicestoragemonitor
diskstats
display
display.qservice
dns_listener
dreams
drm.drmManager
dropbox
ethernet
fingerprint
gfxinfo
gpu
graphicsstats
hardware_properties
imms
ims
input
input_method
iphonesubinfo
isms
isub
jobscheduler
launcherapps
location
lock_settings
media.audio_flinger
media.audio_policy
media.camera
media.camera.proxy
media.codec
media.drm
media.extractor
media.player
media.radio
media.resource_manager
media.sound_trigger_hw
media_projection
media_router
media_session
meminfo
midi
mount
netpolicy
netstats
network_management
network_score
network_time_update_service
nfc
notification
otadexopt
package
permission
persistent_data_block
phone
pinner
power
print
processinfo
procstats
recovery
restrictions
rttmanager
samplingprofiler
scheduling_policy
search
sensorservice
serial
servicediscovery
shortcut
simphonebook
sip
soundtrigger
statusbar
telecom
telephony.registry
textservices
trust
uimode
updatelock
usagestats
usb
user
vendor.qcom.PeripheralManager
vibrator
voiceinteraction
vrmanager
wallpaper
webviewupdate
wifi
wifip2p
wifiscanner
window
各コマンドについて（随時、補足説明する予定、、、）
adb shell cmd activity
Activity manager (activity) commands:
help
Print this help text.
force-stop [--user <USER_ID> | all | current] <PACKAGE>
Completely stop the given application package.
kill [--user <USER_ID> | all | current] <PACKAGE>
Kill all processes associated with the given application.
kill-all
Kill all processes that are safe to kill (cached, etc).
write
Write all pending state to storage.
track-associations
Enable association tracking.
untrack-associations
Disable and clear association tracking.
is-user-stopped <USER_ID>
Returns whether <USER_ID> has been stopped or not.
lenient-background-check [<true|false>]
Optionally controls lenient background check mode, returns current mode.
get-uid-state <UID>
Gets the process state of an app given its <UID>.
adb shell cmd appops
AppOps service (appops) commands:
help
Print this help text.
set [--user <USER_ID>] <PACKAGE> <OP> <MODE>
Set the mode for a particular application and operation.
get [--user <USER_ID>] <PACKAGE> [<OP>]
Return the mode for a particular application and optional operation.
query-op [--user <USER_ID>] <OP> [<MODE>]
Print all packages that currently have the given op in the given mode.
reset [--user <USER_ID>] [<PACKAGE>]
Reset the given application or all applications to default modes.
write-settings
Immediately write pending changes to storage.
read-settings
Read the last written settings, replacing current state in RAM.
options:
<PACKAGE> an Android package name.
<OP> an AppOps operation.
<MODE> one of allow, ignore, deny, or default
<USER_ID> the user id under which the package is installed. If --user is not
specified, the current user is assumed.
adb shell cmd battery
バッテリー状態のエミュレートとか？
Battery service (battery) commands:
help
Print this help text.
set [ac|usb|wireless|status|level|invalid] <value>
Force a battery property value, freezing battery state.
unplug
Force battery unplugged, freezing battery state.
reset
Unfreeze battery state, returning to current hardware values.
adb shell cmd deviceidle
Doze状態の確認、Emulate、除外アプリの設定
Device idle controller (deviceidle) commands:
help
Print this help text.
step [light|deep]
Immediately step to next state, without waiting for alarm.
force-idle [light|deep]
Force directly into idle mode, regardless of other device state.
force-inactive
Force to be inactive, ready to freely step idle states.
unforce
Resume normal functioning after force-idle or force-inactive.
get [light|deep|force|screen|charging|network]
Retrieve the current given state.
disable [light|deep|all]
Completely disable device idle mode.
enable [light|deep|all]
Re-enable device idle mode after it had previously been disabled.
enabled [light|deep|all]
Print 1 if device idle mode is currently enabled, else 0.
whitelist
Print currently whitelisted apps.
whitelist [package ...]
Add (prefix with +) or remove (prefix with -) packages.
tempwhitelist
Print packages that are temporarily whitelisted.
tempwhitelist [-u] [package ..]
Temporarily place packages in whitelist for 10 seconds.
adb shell cmd input
Input manager commands:
help
Print this help text.
setlayout IME_ID IME_SUPTYPE_HASH_CODE DEVICE_DESCRIPTOR VENDOR_ID PRODUCT_ID KEYBOARD_DESCRIPTOR
Sets a keyboard layout for a given IME subtype and input device pair
adb shell cmd jobscheduler
Job操作
Job scheduler (jobscheduler) commands:
help
Print this help text.
run [-f | --force] [-u | --user USER_ID] PACKAGE JOB_ID
Trigger immediate execution of a specific scheduled job.
Options:
-f or --force: run the job even if technical constraints such as
connectivity are not currently met
-u or --user: specify which user's job is to be run; the default is
the primary or system user
adb shell cmd netpolicy
通信制御（UID単位で）
Network policy manager (netpolicy) commands:
help
Print this help text.
add restrict-background-whitelist UID
Adds a UID to the whitelist for restrict background usage.
add restrict-background-blacklist UID
Adds a UID to the blacklist for restrict background usage.
get restrict-background
Gets the global restrict background usage status.
list wifi-networks [BOOLEAN]
Lists all saved wifi networks and whether they are metered or not.
If a boolean argument is passed, filters just the metered (or unmetered)
networks.
list restrict-background-whitelist
Lists UIDs that are whitelisted for restrict background usage.
list restrict-background-blacklist
Lists UIDs that are blacklisted for restrict background usage.
remove restrict-background-whitelist UID
Removes a UID from the whitelist for restrict background usage.
remove restrict-background-blacklist UID
Removes a UID from the blacklist for restrict background usage.
set metered-network ID BOOLEAN
Toggles whether the given wi-fi network is metered.
set restrict-background BOOLEAN
Sets the global restrict background usage status.
adb shell cmd otadexopt
OTA Dexopt (ota) commands:
help
Print this help text.
prepare
Prepare an OTA dexopt pass, collecting all packages.
done
Replies whether the OTA is complete or not.
step
OTA dexopt the next package.
next
Get parameters for OTA dexopt of the next package.
cleanup
Clean up internal states. Ends an OTA session.
adb shell cmd package
Package manager (package) commands:
help
Print this help text.
compile [-m MODE | -r REASON] [-f] [-c]
[--reset] [--check-prof (true | false)] (-a | TARGET-PACKAGE)
Trigger compilation of TARGET-PACKAGE or all packages if "-a".
Options:
-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:
verify-none
verify-at-runtime
verify-profile
interpret-only
space-profile
space
speed-profile
speed
everything
-r: select compilation reason
REASON is one of:
first-boot
boot
install
bg-dexopt
ab-ota
nsys-library
shared-apk
forced-dexopt
core-app
--reset: restore package to its post-install state
--check-prof (true | false): look at profiles when doing dexopt?
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] [-u] [--user USER_ID] [FILTER]
Prints all packages; optionally only those whose name contains
the text in FILTER.
Options:
-f: see their associated file
-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
-u: also include uninstalled packages
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:
-g: organize by group
-f: print all information
-s: short summary
-d: only list dangerous permissions
-u: list only the permissions users will see
dump-profiles TARGET-PACKAGE
Dumps method/class profile files to
/data/misc/profman/TARGET-PACKAGE.txt
resolve-activity [--brief] [--components] [--user USER_ID] INTENT
Prints the activity that resolves to the given Intent.
query-activities [--brief] [--components] [--user USER_ID] INTENT
Prints all activities that can handle the given Intent.
query-services [--brief] [--components] [--user USER_ID] INTENT
Prints all services that can handle the given Intent.
query-receivers [--brief] [--components] [--user USER_ID] INTENT
Prints all broadcast receivers that can handle the given Intent.
suspend [--user USER_ID] TARGET-PACKAGE
Suspends the specified package (as user).
unsuspend [--user USER_ID] TARGET-PACKAGE
Unsuspends the specified package (as user).
set-home-activity [--user USER_ID] TARGET-COMPONENT
set the default home activity (aka launcher).
<INTENT> specifications include these flags and arguments:
[-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]
[-c <CATEGORY> [-c <CATEGORY>] ...]
[-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]
[--esn <EXTRA_KEY> ...]
[--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]
[--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]
[--el <EXTRA_KEY> <EXTRA_LONG_VALUE> ...]
[--ef <EXTRA_KEY> <EXTRA_FLOAT_VALUE> ...]
[--eu <EXTRA_KEY> <EXTRA_URI_VALUE> ...]
[--ecn <EXTRA_KEY> <EXTRA_COMPONENT_NAME_VALUE>]
[--eia <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...]]
(mutiple extras passed as Integer[])
[--eial <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...]]
(mutiple extras passed as List<Integer>)
[--ela <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...]]
(mutiple extras passed as Long[])
[--elal <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...]]
(mutiple extras passed as List<Long>)
[--efa <EXTRA_KEY> <EXTRA_FLOAT_VALUE>[,<EXTRA_FLOAT_VALUE...]]
(mutiple extras passed as Float[])
[--efal <EXTRA_KEY> <EXTRA_FLOAT_VALUE>[,<EXTRA_FLOAT_VALUE...]]
(mutiple extras passed as List<Float>)
[--esa <EXTRA_KEY> <EXTRA_STRING_VALUE>[,<EXTRA_STRING_VALUE...]]
(mutiple extras passed as String[]; to embed a comma into a string,
escape it using "\,")
[--esal <EXTRA_KEY> <EXTRA_STRING_VALUE>[,<EXTRA_STRING_VALUE...]]
(mutiple extras passed as List<String>; to embed a comma into a string,
escape it using "\,")
[--f <FLAG>]
[--grant-read-uri-permission] [--grant-write-uri-permission]
[--grant-persistable-uri-permission] [--grant-prefix-uri-permission]
[--debug-log-resolution] [--exclude-stopped-packages]
[--include-stopped-packages]
[--activity-brought-to-front] [--activity-clear-top]
[--activity-clear-when-task-reset] [--activity-exclude-from-recents]
[--activity-launched-from-history] [--activity-multiple-task]
[--activity-no-animation] [--activity-no-history]
[--activity-no-user-action] [--activity-previous-is-top]
[--activity-reorder-to-front] [--activity-reset-task-if-needed]
[--activity-single-top] [--activity-clear-task]
[--activity-task-on-home]
[--receiver-registered-only] [--receiver-replace-pending]
[--receiver-foreground]
[--selector]
[<URI> | <PACKAGE> | <COMPONENT>]
デフォルトactivityの確認
たとえば、複数のbrowserがインストールされた状態で、
"$ adb shell am start -a android.intent.action.VIEW http://xxx" というintentを投げたときにdefaultで起動するActivity
標準アプリが設定されていたときの結果
$ adb shell cmd package resolve-activity -a android.intent.action.VIEW http://xxx
priority=0 preferredOrder=0 match=0x208000 specificIndex=-1 isDefault=true
ActivityInfo:
name=com.google.android.apps.chrome.Main
packageName=com.android.chrome
----------------------(snip)---------------------------------
標準アプリが設定されていなかったときの結果
$ adb shell cmd package resolve-activity -a android.intent.action.VIEW http://xxx
priority=0 preferredOrder=0 match=0x0 specificIndex=-1 isDefault=false
ActivityInfo:
name=com.android.internal.app.ResolverActivity <------「起動アプリを選択するためのダイアログ」
packageName=android
----------------------(snip)---------------------------------
Intent-filterを登録しているactivityの確認
たとえば、複数のbrowserがインストールされた状態で、
"$ adb shell am start -a android.intent.action.VIEW http://xxx" というintentを投げたときに、起動候補になりうるActivity
$ adb shell cmd package query-activities -a android.intent.action.VIEW http://xxx
3 activities found:
Activity #0:
priority=0 preferredOrder=0 match=0x208000 specificIndex=-1 isDefault=true
ActivityInfo:
name=com.google.android.apps.chrome.Main
packageName=com.android.chrome
----------------------(snip)---------------------------------
Activity #1:
priority=0 preferredOrder=0 match=0x208000 specificIndex=-1 isDefault=true
ActivityInfo:
name=com.opera.mini.android.Browser
packageName=com.opera.mini.native
----------------------(snip)---------------------------------
Activity #2:
priority=0 preferredOrder=0 match=0x208000 specificIndex=-1 isDefault=true
ActivityInfo:
name=org.mozilla.gecko.tabqueue.TabQueueDispatcher
packageName=org.mozilla.firefox
----------------------(snip)---------------------------------
adb shell cmd shortcut
Usage: cmd shortcut COMMAND [options ...]
cmd shortcut reset-throttling [--user USER_ID]
Reset throttling for all packages and users
cmd shortcut reset-all-throttling
Reset the throttling state for all users
cmd shortcut override-config CONFIG
Override the configuration for testing (will last until reboot)
cmd shortcut reset-config
Reset the configuration set with "update-config"
cmd shortcut clear-default-launcher [--user USER_ID]
Clear the cached default launcher
cmd shortcut get-default-launcher [--user USER_ID]
Show the default launcher
cmd shortcut unload-user [--user USER_ID]
Unload a user from the memory
(This should not affect any observable behavior)
cmd shortcut clear-shortcuts [--user USER_ID] PACKAGE
Remove all shortcuts from a package, including pinned shortcuts
adb shell cmd statusbar
Status bar commands:
help
Print this help text.
expand-notifications
Open the notifications panel.
expand-settings
Open the notifications panel and expand quick settings if present.
collapse
Collapse the notifications and settings panel.
add-tile COMPONENT
Add a TileService of the specified component
remove-tile COMPONENT
Remove a TileService of the specified component
click-tile COMPONENT
Click on a TileService of the specified component
adb shell cmd user
User manager (user) commands:
help
Print this help text.
list
Prints all users on the system.
adb shell cmd webviewupdate
WebView updater commands:
help
Print this help text.
enable-redundant-packages
Allow a fallback package to be installed and enabled even when a
more-preferred package is available. This command is useful when testing
fallback packages.
disable-redundant-packages
Disallow installing and enabling fallback packages when a more-preferred
package is available.
set-webview-implementation PACKAGE
Set the WebView implementation to the specified package.
まだ未実装なもの（2016/10/27現在）
実行しても、
adb shell cmd <service>
No shell command implementation.
となるもの
adb shell cmd AtCmdFwd
adb shell cmd DockObserver
ドッキングステーション関連？
adb shell cmd accessibility
ユーザ補助関連
adb shell cmd account
googleアカウントなど、各種アカウント管理？
adb shell cmd alarm
AlarmManager関連？
adb shell cmd appwidget
adb shell cmd assetatlas
adb shell cmd audio
adb shell cmd backup
バックアップマネージャー関連？
adb shell cmd batterystats
adb shell cmd bluetooth_manager
adb shell cmd carrier_config
adb shell cmd clipboard
adb shell cmd cneservice
adb shell cmd commontime_management
adb shell cmd connectivity
adb shell cmd connectivity_metrics_logger
adb shell cmd connmetrics
adb shell cmd consumer_ir
adb shell cmd content
adb shell cmd contexthub_service
adb shell cmd country_detector
adb shell cmd cpuinfo
adb shell cmd dbinfo
adb shell cmd device_policy
adb shell cmd devicestoragemonitor
adb shell cmd diskstats
adb shell cmd display
adb shell cmd display.qservice
adb shell cmd dns_listener
adb shell cmd dreams
adb shell cmd dropbox
adb shell cmd ethernet
adb shell cmd fingerprint
adb shell cmd graphicsstats
adb shell cmd gfxinfo
adb shell cmd hardware_properties
adb shell cmd imms
adb shell cmd ims
adb shell cmd input_method
adb shell cmd iphonesubinfo
adb shell cmd isms
adb shell cmd isub
adb shell cmd launcherapps
adb shell cmd location
adb shell cmd lock_settings
adb shell cmd media.camera.proxy
adb shell cmd media_projection
adb shell cmd media_router
adb shell cmd media_session
adb shell cmd meminfo
adb shell cmd midi
adb shell cmd mount
adb shell cmd netstats
adb shell cmd network_management
adb shell cmd network_score
adb shell cmd network_time_update_service
adb shell cmd nfc
adb shell cmd notification
adb shell cmd permission
adb shell cmd persistent_data_block
adb shell cmd phone
adb shell cmd pinner
adb shell cmd power
adb shell cmd print
adb shell cmd processinfo
adb shell cmd procstats
adb shell cmd recovery
adb shell cmd restrictions
adb shell cmd rttmanager
adb shell cmd samplingprofiler
adb shell cmd scheduling_policy
adb shell cmd search
adb shell cmd serial
adb shell cmd servicediscovery
adb shell cmd simphonebook
adb shell cmd sip
adb shell cmd soundtrigger
adb shell cmd telecom
adb shell cmd telephony.registry
adb shell cmd textservices
adb shell cmd trust
adb shell cmd uimode
adb shell cmd updatelock
adb shell cmd usagestats
adb shell cmd usb
adb shell cmd vibrator
adb shell cmd voiceinteraction
adb shell cmd vrmanager
adb shell cmd wallpaper
adb shell cmd wifi
adb shell cmd wifip2p
adb shell cmd wifiscanner
adb shell cmd window
実装状況が（私に）わからないもの （2016/10/27現在）
実行しても、何の反応も無いもの
adb shell cmd SurfaceFlinger
adb shell cmd android.hardware.fingerprint.IFingerprintDaemon
adb shell cmd android.security.keystore
adb shell cmd batteryproperties
adb shell cmd drm.drmManager
adb shell cmd media.audio_flinger
adb shell cmd media.audio_policy
adb shell cmd media.camera
adb shell cmd media.codec
adb shell cmd media.drm
adb shell cmd media.extractor
adb shell cmd media.player
adb shell cmd media.radio
adb shell cmd media.resource_manager
adb shell cmd media.sound_trigger_hw
adb shell cmd sensorservice
adb shell cmd vendor.qcom.PeripheralManager
バグってる（？）もの（2016/10/27現在）
adb shell cmd gpu
実行すると端末が再起動してしまう
端末側のコマンド実装について
ShellCommandをextendsしたクラスで実現する模様
例：ActivityManagerShellCommand
class ActivityManagerShellCommand extends ShellCommand {
-----(snip)-----------
@Override
public int onCommand(String cmd) {
if (cmd == null) {
return handleDefaultCommands(cmd);
}
PrintWriter pw = getOutPrintWriter();
try {
switch (cmd) {
case "force-stop":
return runForceStop(pw);
case "kill":
return runKill(pw);
case "kill-all":
return runKillAll(pw);
case "write":
return runWrite(pw);
case "track-associations":
return runTrackAssociations(pw);
case "untrack-associations":
return runUntrackAssociations(pw);
case "is-user-stopped":
return runIsUserStopped(pw);
case "lenient-background-check":
return runLenientBackgroundCheck(pw);
case "get-uid-state":
return getUidState(pw);
default:
return handleDefaultCommands(cmd);
}
} catch (RemoteException e) {
pw.println("Remote exception: " + e);
}
return -1;
}
int runIsUserStopped(PrintWriter pw) {
-----(snip)-----------
}
int runForceStop(PrintWriter pw) throws RemoteException {
-----(snip)-----------
}
int runKill(PrintWriter pw) throws RemoteException {
-----(snip)-----------
}
int runKillAll(PrintWriter pw) throws RemoteException {
-----(snip)-----------
}
int runWrite(PrintWriter pw) {
-----(snip)-----------
}
int runTrackAssociations(PrintWriter pw) {
-----(snip)-----------
}
int runUntrackAssociations(PrintWriter pw) {
-----(snip)-----------
}
int runLenientBackgroundCheck(PrintWriter pw) throws RemoteException {
-----(snip)-----------
}
int getUidState(PrintWriter pw) throws RemoteException {
-----(snip)-----------
}
@Override
public void onHelp() {
PrintWriter pw = getOutPrintWriter();
dumpHelp(pw, mDumping);
}
-----(snip)-----------
}