2. 程式人生 > 其它 >Java8 Optional類的使用

Java8 Optional類的使用

阿新 • • 發佈：2022-05-10

Android 除錯橋 (adb) 是一種功能多樣的命令列工具，可讓您與裝置進行通訊。adb 命令可用於執行各種裝置操作（例如安裝和除錯應用），並提供對 Unix shell（可用來在裝置上執行各種命令）的訪問許可權。它是一種客戶端-伺服器程式，包括以下三個元件：

  • 客戶端：用於傳送命令。客戶端在開發機器上執行。您可以通過發出 adb 命令從命令列終端呼叫客戶端。
  • 守護程式 (adbd)：用於在裝置上執行命令。守護程式在每個裝置上作為後臺程序執行。
  • 伺服器：用於管理客戶端與守護程式之間的通訊。伺服器在開發機器上作為後臺程序執行。

基本用法

命令語法

adb 命令的基本語法如下：

adb [-d|-e|-s <serialNumber>] <command>

如果只有一個裝置/模擬器連線時，可以省略掉 [-d|-e|-s <serialNumber>] 這一部分，直接使用 adb <command>。

為命令指定目標裝置

如果有多個裝置/模擬器連線，則需要為命令指定目標裝置。

引數 含義
-d 指定當前唯一通過 USB 連線的 Android 裝置為命令目標
-e 指定當前唯一執行的模擬器為命令目標
-s <serialNumber> 指定相應 serialNumber 號的裝置/模擬器為命令目標

在多個裝置/模擬器連線的情況下較常用的是 -s <serialNumber> 引數，serialNumber 可以通過 adb devices 命令獲取。如：

$ adb devices

List of devices attached
cf264b8f	device
emulator-5554	device
10.129.164.6:5555	device

輸出裡的 cf264b8f、emulator-5554 和 10.129.164.6:5555 即為 serialNumber。

比如這時想指定 cf264b8f 這個裝置來執行 adb 命令獲取螢幕解析度：

adb -s cf264b8f shell wm size

又如想給 10.129.164.6:5555 這個裝置安裝應用（這種形式的 serialNumber 格式為 <IP>:<Port>，一般為無線連線的裝置或 Genymotion 等第三方 Android 模擬器）：

adb -s 10.129.164.6:5555 install test.apk

遇到多裝置/模擬器的情況均使用這幾個引數為命令指定目標裝置，下文中為簡化描述，不再重複。

啟動/停止

啟動 adb server 命令：

adb start-server

（一般無需手動執行此命令，在執行 adb 命令時若發現 adb server 沒有啟動會自動調起。）

停止 adb server 命令：

adb kill-server

檢視 adb 版本

命令：

adb version

示例輸出：

Android Debug Bridge version 1.0.36
Revision 8f855a3d9b35-android

以 root 許可權執行 adbd

adb 的執行原理是 PC 端的 adb server 與手機端的守護程序 adbd 建立連線，然後 PC 端的 adb client 通過 adb server 轉發命令，adbd 接收命令後解析執行。

所以如果 adbd 以普通許可權執行，有些需要 root 許可權才能執行的命令無法直接用 adb xxx 執行。這時可以 adb shell 然後 su 後執行命令，也可以讓 adbd 以 root 許可權執行，這個就能隨意執行高許可權命令了。

命令：

adb root

正常輸出：

restarting adbd as root

現在再執行 adb shell，看看命令列提示符是不是變成 # 了？

有些手機 root 後也無法通過 adb root 命令讓 adbd 以 root 許可權執行，比如三星的部分機型，會提示 adbd cannot run as root in production builds，此時可以先安裝 adbd Insecure，然後 adb root 試試。

相應地，如果要恢復 adbd 為非 root 許可權的話，可以使用 adb unroot 命令。

指定 adb server 的網路埠

命令：

adb -P <port> start-server

預設埠為 5037。

裝置連線管理

查詢已連線裝置/模擬器

命令：

adb devices

輸出示例：

List of devices attached
cf264b8f	device
emulator-5554	device
10.129.164.6:5555	device

輸出格式為 [serialNumber] [state]，serialNumber 即我們常說的 SN，state 有如下幾種：

  • offline —— 表示裝置未連線成功或無響應。

  • device —— 裝置已連線。注意這個狀態並不能標識 Android 系統已經完全啟動和可操作，在裝置啟動過程中裝置例項就可連線到 adb，但啟動完畢後系統才處於可操作狀態。

  • no device —— 沒有裝置/模擬器連線。

以上輸出顯示當前已經連線了三臺裝置/模擬器，cf264b8f、emulator-5554 和 10.129.164.6:5555 分別是它們的 SN。從 emulator-5554 這個名字可以看出它是一個 Android 模擬器，而 10.129.164.6:5555 這種形為 <IP>:<Port> 的 serialNumber 一般是無線連線的裝置或 Genymotion 等第三方 Android 模擬器。

常見異常輸出：

  1. 沒有裝置/模擬器連線成功。

    List of devices attached

  2. 裝置/模擬器未連線到 adb 或無響應。

    List of devices attached
cf264b8f	offline

USB 連線

通過 USB 連線來正常使用 adb 需要保證幾點：

  1. 硬體狀態正常。

    包括 Android 裝置處於正常開機狀態，USB 連線線和各種介面完好。

  2. Android 裝置的開發者選項和 USB 除錯模式已開啟。

    可以到「設定」-「開發者選項」-「Android 除錯」檢視。

    如果在設定裡找不到開發者選項，那需要通過一個彩蛋來讓它顯示出來：在「設定」-「關於手機」連續點選「版本號」7 次。

  3. 裝置驅動狀態正常。

    這一點貌似在 Linux 和 Mac OS X 下不用操心，在 Windows 下有可能遇到需要安裝驅動的情況，確認這一點可以右鍵「計算機」-「屬性」，到「裝置管理器」裡檢視相關裝置上是否有黃色感嘆號或問號，如果沒有就說明驅動狀態已經好了。否則可以下載一個手機助手類程式來安裝驅動先。

  4. 通過 USB 線連線好電腦和裝置後確認狀態。

    adb devices

    如果能看到

    xxxxxx device

    說明連線成功。

無線連線（Android11 及以上）

Android 11 及更高版本支援使用 Android 除錯橋 (adb) 從工作站以無線方式部署和除錯應用。例如，您可以將可除錯應用部署到多臺遠端裝置，而無需通過 USB 實際連線裝置。這樣就可以避免常見的 USB 連線問題，例如驅動程式安裝方面的問題。

官方文件

操作步驟：

  1. 更新到最新版本的 SDK 平臺工具(至少30.0.0)。

  2. 將 Android 裝置與要執行 adb 的電腦連線到同一個區域網，比如連到同一個 WiFi。

  3. 在開發者選項中啟用無線除錯。

  4. 在詢問要允許在此網路上進行無線除錯嗎？的對話方塊中，點選允許。

  5. 選擇使用配對碼配對裝置，使用彈窗中的 IP 地址和埠號。

adb pair ipaddr:port

  1. 提示Enter pairing code: 時輸入彈窗中的配對碼，成功後會顯示Successfully paired to ...。

  2. 使用無線除錯下的 IP 地址和埠。

adb connect ipaddr:port

  1. 確認連線狀態。

    adb devices

    如果能看到

    ipaddr:port device

說明連線成功。

無線連線（需要藉助 USB 線）

除了可以通過 USB 連線裝置與電腦來使用 adb，也可以通過無線連線——雖然連線過程中也有需要使用 USB 的步驟，但是連線成功之後你的裝置就可以在一定範圍內擺脫 USB 連線線的限制啦！

操作步驟：

  1. 將 Android 裝置與要執行 adb 的電腦連線到同一個區域網，比如連到同一個 WiFi。

  2. 將裝置與電腦通過 USB 線連線。

    應確保連線成功（可執行 adb devices 看是否能列出該裝置）。

  3. 讓裝置在 5555 埠監聽 TCP/IP 連線：

    adb tcpip 5555

  4. 斷開 USB 連線。

  5. 找到裝置的 IP 地址。

    一般能在「設定」-「關於手機」-「狀態資訊」-「IP地址」找到，也可以使用下文裡 [檢視裝置資訊 - IP 地址][1] 一節裡的方法用 adb 命令來檢視。

  6. 通過 IP 地址連線裝置。

    adb connect <device-ip-address>

    這裡的 <device-ip-address> 就是上一步中找到的裝置 IP 地址。

  7. 確認連線狀態。

    adb devices

    如果能看到

    <device-ip-address>:5555 device

    說明連線成功。

如果連線不了，請確認 Android 裝置與電腦是連線到了同一個 WiFi，然後再次執行 adb connect <device-ip-address> 那一步；

如果還是不行的話，通過 adb kill-server 重新啟動 adb 然後從頭再來一次試試。

斷開無線連線

命令：

adb disconnect <device-ip-address>

無線連線（無需藉助 USB 線）

注：需要 root 許可權。

上一節「無線連線（需要藉助 USB 線）」是官方文件裡介紹的方法，需要藉助於 USB 資料線來實現無線連線。

既然我們想要實現無線連線，那能不能所有步驟下來都是無線的呢？答案是能的。

  1. 在 Android 裝置上安裝一個終端模擬器。

    已經安裝過的裝置可以跳過此步。我使用的終端模擬器下載地址是：Terminal Emulator for Android Downloads

  2. 將 Android 裝置與要執行 adb 的電腦連線到同一個區域網，比如連到同一個 WiFi。

  3. 開啟 Android 裝置上的終端模擬器，在裡面依次執行命令：

    su
setprop service.adb.tcp.port 5555

  4. 找到 Android 裝置的 IP 地址。

    一般能在「設定」-「關於手機」-「狀態資訊」-「IP地址」找到，也可以使用下文裡 [檢視裝置資訊 - IP 地址][1] 一節裡的方法用 adb 命令來檢視。

  5. 在電腦上通過 adb 和 IP 地址連線 Android 裝置。

    adb connect <device-ip-address>

    這裡的 <device-ip-address> 就是上一步中找到的裝置 IP 地址。

    如果能看到 connected to <device-ip-address>:5555 這樣的輸出則表示連線成功。

節注一：

有的裝置，比如小米 5S + MIUI 8.0 + Android 6.0.1 MXB48T，可能在第 5 步之前需要重啟 adbd 服務，在裝置的終端模擬器上執行：

restart adbd

如果 restart 無效，嘗試以下命令：

stop adbd
start adbd

應用管理

檢視應用列表

檢視應用列表的基本命令格式是

adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]

即在 adb shell pm list packages 的基礎上可以加一些引數進行過濾檢視不同的列表，支援的過濾引數如下：

引數 顯示列表
無 所有應用
-f 顯示應用關聯的 apk 檔案
-d 只顯示 disabled 的應用
-e 只顯示 enabled 的應用
-s 只顯示系統應用
-3 只顯示第三方應用
-i 顯示應用的 installer
-u 包含已解除安裝應用
<FILTER> 包名包含 <FILTER> 字串

所有應用

命令：

adb shell pm list packages

輸出示例：

package:com.android.smoketest
package:com.example.android.livecubes
package:com.android.providers.telephony
package:com.google.android.googlequicksearchbox
package:com.android.providers.calendar
package:com.android.providers.media
package:com.android.protips
package:com.android.documentsui
package:com.android.gallery
package:com.android.externalstorage
...
// other packages here
...

系統應用

命令：

adb shell pm list packages -s

第三方應用

命令：

adb shell pm list packages -3

包名包含某字串的應用

比如要檢視包名包含字串 mazhuang 的應用列表，命令：

adb shell pm list packages mazhuang

當然也可以使用 grep 來過濾：

adb shell pm list packages | grep mazhuang

安裝 APK

命令格式：

adb install [-lrtsdg] <path_to_apk>

引數：

adb install 後面可以跟一些可選引數來控制安裝 APK 的行為，可用引數及含義如下：

引數 含義
-l 將應用安裝到保護目錄 /mnt/asec
-r 允許覆蓋安裝
-t 允許安裝 AndroidManifest.xml 裡 application 指定 android:testOnly="true" 的應用
-s 將應用安裝到 sdcard
-d 允許降級覆蓋安裝
-g 授予所有執行時許可權
--abi abi-identifier 為特定 ABI 強制安裝 apk，abi-identifier 可以是 armeabi-v7a、arm64-v8a、v86、x86_64 等

執行命令後如果見到類似如下輸出（狀態為 Success）代表安裝成功：

[100%] /data/local/tmp/1.apk
	pkg: /data/local/tmp/1.apk
Success

上面是當前最新版 v1.0.36 的 adb 的輸出，會顯示 push apk 檔案到手機的進度百分比。

使用舊版本 adb 的輸出則是這樣的：

12040 KB/s (22205609 bytes in 1.801s)
        pkg: /data/local/tmp/SogouInput_android_v8.3_sweb.apk
Success

而如果狀態為 Failure 則表示安裝失敗，比如：

[100%] /data/local/tmp/map-20160831.apk
        pkg: /data/local/tmp/map-20160831.apk
Failure [INSTALL_FAILED_ALREADY_EXISTS]

常見安裝失敗輸出程式碼、含義及可能的解決辦法如下：

輸出 含義 解決辦法
INSTALL_FAILED_ALREADY_EXISTS 應用已經存在，或解除安裝了但沒解除安裝乾淨 adb install 時使用 -r 引數，或者先 adb uninstall <packagename> 再安裝
INSTALL_FAILED_INVALID_APK 無效的 APK 檔案
INSTALL_FAILED_INVALID_URI 無效的 APK 檔名 確保 APK 檔名裡無中文
INSTALL_FAILED_INSUFFICIENT_STORAGE 空間不足 清理空間
INSTALL_FAILED_DUPLICATE_PACKAGE 已經存在同名程式
INSTALL_FAILED_NO_SHARED_USER 請求的共享使用者不存在
INSTALL_FAILED_UPDATE_INCOMPATIBLE 以前安裝過同名應用，但解除安裝時資料沒有移除；或者已安裝該應用，但簽名不一致 先 adb uninstall <packagename> 再安裝
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE 請求的共享使用者存在但簽名不一致
INSTALL_FAILED_MISSING_SHARED_LIBRARY 安裝包使用了裝置上不可用的共享庫
INSTALL_FAILED_REPLACE_COULDNT_DELETE 替換時無法刪除
INSTALL_FAILED_DEXOPT dex 優化驗證失敗或空間不足
INSTALL_FAILED_OLDER_SDK 裝置系統版本低於應用要求
INSTALL_FAILED_CONFLICTING_PROVIDER 裝置裡已經存在與應用裡同名的 content provider
INSTALL_FAILED_NEWER_SDK 裝置系統版本高於應用要求
INSTALL_FAILED_TEST_ONLY 應用是 test-only 的，但安裝時沒有指定 -t 引數
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE 包含不相容裝置 CPU 應用程式二進位制介面的 native code
INSTALL_FAILED_MISSING_FEATURE 應用使用了裝置不可用的功能
INSTALL_FAILED_CONTAINER_ERROR 1. sdcard 訪問失敗;
2. 應用簽名與 ROM 簽名一致，被當作內建應用。		 1. 確認 sdcard 可用，或者安裝到內建儲存;
2. 打包時不與 ROM 使用相同簽名。
INSTALL_FAILED_INVALID_INSTALL_LOCATION 1. 不能安裝到指定位置;
2. 應用簽名與 ROM 簽名一致，被當作內建應用。		 1. 切換安裝位置，新增或刪除 -s 引數;
2. 打包時不與 ROM 使用相同簽名。
INSTALL_FAILED_MEDIA_UNAVAILABLE 安裝位置不可用 一般為 sdcard，確認 sdcard 可用或安裝到內建儲存
INSTALL_FAILED_VERIFICATION_TIMEOUT 驗證安裝包超時
INSTALL_FAILED_VERIFICATION_FAILURE 驗證安裝包失敗
INSTALL_FAILED_PACKAGE_CHANGED 應用與呼叫程式期望的不一致
INSTALL_FAILED_UID_CHANGED 以前安裝過該應用，與本次分配的 UID 不一致 清除以前安裝過的殘留檔案
INSTALL_FAILED_VERSION_DOWNGRADE 已經安裝了該應用更高版本 使用 -d 引數
INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE 已安裝 target SDK 支援執行時許可權的同名應用，要安裝的版本不支援執行時許可權
INSTALL_PARSE_FAILED_NOT_APK 指定路徑不是檔案，或不是以 .apk 結尾
INSTALL_PARSE_FAILED_BAD_MANIFEST 無法解析的 AndroidManifest.xml 檔案
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION 解析器遇到異常
INSTALL_PARSE_FAILED_NO_CERTIFICATES 安裝包沒有簽名
INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES 已安裝該應用，且簽名與 APK 檔案不一致 先解除安裝裝置上的該應用，再安裝
INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING 解析 APK 檔案時遇到 CertificateEncodingException
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME manifest 檔案裡沒有或者使用了無效的包名
INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID manifest 檔案裡指定了無效的共享使用者 ID
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED 解析 manifest 檔案時遇到結構性錯誤
INSTALL_PARSE_FAILED_MANIFEST_EMPTY 在 manifest 檔案裡找不到找可操作標籤（instrumentation 或 application）
INSTALL_FAILED_INTERNAL_ERROR 因系統問題安裝失敗
INSTALL_FAILED_USER_RESTRICTED 使用者被限制安裝應用 在開發者選項裡將「USB安裝」開啟，如果已經打開了，那先關閉再開啟。
INSTALL_FAILED_DUPLICATE_PERMISSION 應用嘗試定義一個已經存在的許可權名稱
INSTALL_FAILED_NO_MATCHING_ABIS 應用包含裝置的應用程式二進位制介面不支援的 native code
INSTALL_CANCELED_BY_USER 應用安裝需要在裝置上確認，但未操作裝置或點了取消 在裝置上同意安裝
INSTALL_FAILED_ACWF_INCOMPATIBLE 應用程式與裝置不相容
INSTALL_FAILED_TEST_ONLY APK 檔案是使用 Android Studio 直接 RUN 編譯出來的檔案 通過 Gradle 的 assembleDebug 或 assembleRelease 重新編譯，或者 Generate Signed APK
does not contain AndroidManifest.xml 無效的 APK 檔案
is not a valid zip file 無效的 APK 檔案
Offline 裝置未連線成功 先將裝置與 adb 連線成功
unauthorized 裝置未授權允許除錯
error: device not found 沒有連線成功的裝置 先將裝置與 adb 連線成功
protocol failure 裝置已斷開連線 先將裝置與 adb 連線成功
Unknown option: -s Android 2.2 以下不支援安裝到 sdcard 不使用 -s 引數
No space left on device 空間不足 清理空間
Permission denied ... sdcard ... sdcard 不可用
signatures do not match the previously installed version; ignoring! 已安裝該應用且簽名不一致 先解除安裝裝置上的該應用，再安裝

參考：PackageManager.java

adb install 內部原理簡介

adb install 實際是分三步完成：

  1. push apk 檔案到 /data/local/tmp。

  2. 呼叫 pm install 安裝。

  3. 刪除 /data/local/tmp 下的對應 apk 檔案。

所以，必要的時候也可以根據這個步驟，手動分步執行安裝過程。

解除安裝應用

命令：

adb uninstall [-k] <packagename>

<packagename> 表示應用的包名，-k 引數可選，表示解除安裝應用但保留資料和快取目錄。

命令示例：

adb uninstall com.qihoo360.mobilesafe

表示解除安裝 360 手機衛士。

清除應用資料與快取

命令：

adb shell pm clear <packagename>

<packagename> 表示應用名包，這條命令的效果相當於在設定裡的應用資訊介面點選了「清除快取」和「清除資料」。

命令示例：

adb shell pm clear com.qihoo360.mobilesafe

表示清除 360 手機衛士的資料和快取。

檢視前臺 Activity

命令：

adb shell dumpsys activity activities | grep mResumedActivity

輸出示例：

mResumedActivity: ActivityRecord{8079d7e u0 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher t42}

其中的 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher 就是當前處於前臺的 Activity。

在 Windows 下以上命令可能不可用，可以嘗試 adb shell dumpsys activity activities | findstr mResumedActivity 或 adb shell "dumpsys activity activities | grep mResumedActivity"。

檢視正在執行的 Services

命令：

adb shell dumpsys activity services [<packagename>]

<packagename> 引數不是必須的，指定 <packagename> 表示檢視與某個包名相關的 Services，不指定表示檢視所有 Services。

<packagename> 不一定要給出完整的包名，比如執行 adb shell dumpsys activity services org.mazhuang，那麼包名 org.mazhuang.demo1、org.mazhuang.demo2 和 org.mazhuang123 等相關的 Services 都會列出來。

檢視應用詳細資訊

命令：

adb shell dumpsys package <packagename>

輸出中包含很多資訊，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安裝後的檔案資原始碼等路徑、版本資訊、許可權資訊和授予狀態、簽名版本資訊等。

<packagename> 表示應用包名。

輸出示例：

Activity Resolver Table:
  Non-Data Actions:
      android.intent.action.MAIN:
        5b4cba8 org.mazhuang.guanggoo/.SplashActivity filter 5ec9dcc
          Action: "android.intent.action.MAIN"
          Category: "android.intent.category.LAUNCHER"
          AutoVerify=false

Registered ContentProviders:
  org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider:
    Provider{7a3c394 org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider}

ContentProvider Authorities:
  [org.mazhuang.guanggoo.fileProvider]:
    Provider{7a3c394 org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider}
      applicationInfo=ApplicationInfo{7754242 org.mazhuang.guanggoo}

Key Set Manager:
  [org.mazhuang.guanggoo]
      Signing KeySets: 501

Packages:
  Package [org.mazhuang.guanggoo] (c1d7f):
    userId=10394
    pkg=Package{55f714c org.mazhuang.guanggoo}
    codePath=/data/app/org.mazhuang.guanggoo-2
    resourcePath=/data/app/org.mazhuang.guanggoo-2
    legacyNativeLibraryDir=/data/app/org.mazhuang.guanggoo-2/lib
    primaryCpuAbi=null
    secondaryCpuAbi=null
    versionCode=74 minSdk=15 targetSdk=25
    versionName=1.1.74
    splits=[base]
    apkSigningVersion=2
    applicationInfo=ApplicationInfo{7754242 org.mazhuang.guanggoo}
    flags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ALLOW_BACKUP ]
    privateFlags=[ RESIZEABLE_ACTIVITIES ]
    dataDir=/data/user/0/org.mazhuang.guanggoo
    supportsScreens=[small, medium, large, xlarge, resizeable, anyDensity]
    timeStamp=2017-10-22 23:50:53
    firstInstallTime=2017-10-22 23:50:25
    lastUpdateTime=2017-10-22 23:50:55
    installerPackageName=com.miui.packageinstaller
    signatures=PackageSignatures{af09595 [53c7caa2]}
    installPermissionsFixed=true installStatus=1
    pkgFlags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ALLOW_BACKUP ]
    requested permissions:
      android.permission.READ_PHONE_STATE
      android.permission.INTERNET
      android.permission.ACCESS_NETWORK_STATE
      android.permission.ACCESS_WIFI_STATE
      android.permission.READ_LOGS
      android.permission.WRITE_EXTERNAL_STORAGE
      android.permission.READ_EXTERNAL_STORAGE
    install permissions:
      android.permission.INTERNET: granted=true
      android.permission.ACCESS_NETWORK_STATE: granted=true
      android.permission.ACCESS_WIFI_STATE: granted=true
    User 0: ceDataInode=1155675 installed=true hidden=false suspended=false stopped=true notLaunched=false enabled=0
      gids=[3003]
      runtime permissions:
        android.permission.READ_EXTERNAL_STORAGE: granted=true
        android.permission.READ_PHONE_STATE: granted=true
        android.permission.WRITE_EXTERNAL_STORAGE: granted=true
    User 999: ceDataInode=0 installed=false hidden=false suspended=false stopped=true notLaunched=true enabled=0
      gids=[3003]
      runtime permissions:


Dexopt state:
  [org.mazhuang.guanggoo]
    Instruction Set: arm64
      path: /data/app/org.mazhuang.guanggoo-2/base.apk
      status: /data/app/org.mazhuang.guanggoo-2/oat/arm64/base.odex [compilation_filter=speed-profile, status=kOatUpToDa
      te]

檢視應用安裝路徑

命令:

adb shell pm path <PACKAGE>

輸出應用安裝路徑

輸出示例:

adb shell pm path ecarx.weather

package:/data/app/ecarx.weather-1.apk

與應用互動

主要是使用 am <command> 命令，常用的 <command> 如下：

command 用途
start [options] <INTENT> 啟動 <INTENT> 指定的 Activity
startservice [options] <INTENT> 啟動 <INTENT> 指定的 Service
broadcast [options] <INTENT> 傳送 <INTENT> 指定的廣播
force-stop <packagename> 停止 <packagename> 相關的程序

<INTENT> 引數很靈活，和寫 Android 程式時程式碼裡的 Intent 相對應。

用於決定 intent 物件的選項如下：

引數 含義
-a <ACTION> 指定 action，比如 android.intent.action.VIEW
-c <CATEGORY> 指定 category，比如 android.intent.category.APP_CONTACTS
-n <COMPONENT> 指定完整 component 名，用於明確指定啟動哪個 Activity，如 com.example.app/.ExampleActivity

<INTENT> 裡還能帶資料，就像寫程式碼時的 Bundle 一樣：

引數 含義
--esn <EXTRA_KEY> null 值（只有 key 名）
`-e --es <EXTRA_KEY> <EXTRA_STRING_VALUE>`
--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> boolean 值
--ei <EXTRA_KEY> <EXTRA_INT_VALUE> integer 值
--el <EXTRA_KEY> <EXTRA_LONG_VALUE> long 值
--ef <EXTRA_KEY> <EXTRA_FLOAT_VALUE> float 值
--eu <EXTRA_KEY> <EXTRA_URI_VALUE> URI
--ecn <EXTRA_KEY> <EXTRA_COMPONENT_NAME_VALUE> component name
--eia <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...] integer 陣列
--ela <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...] long 陣列

啟動應用/ 調起 Activity

指定Activity名稱啟動

命令格式：

adb shell am start [options] <INTENT>

例如：

adb shell am start -n com.tencent.mm/.ui.LauncherUI

表示調起微信主介面。

adb shell am start -n org.mazhuang.boottimemeasure/.MainActivity --es "toast" "hello, world"

表示調起 org.mazhuang.boottimemeasure/.MainActivity 並傳給它 string 資料鍵值對 toast - hello, world。

不指定Activity名稱啟動（啟動主Activity）

命令格式：

adb shell monkey -p <packagename> -c android.intent.category.LAUNCHER 1

例如：

adb shell monkey -p com.tencent.mm -c android.intent.category.LAUNCHER 1

表示調起微信主介面。

調起 Service

命令格式：

adb shell am startservice [options] <INTENT>

例如：

adb shell am startservice -n com.tencent.mm/.plugin.accountsync.model.AccountAuthenticatorService

表示調起微信的某 Service。

另外一個典型的用例是如果裝置上原本應該顯示虛擬按鍵但是沒有顯示，可以試試這個：

adb shell am startservice -n com.android.systemui/.SystemUIService

停止 Service

命令格式：

adb shell am stopservice [options] <INTENT>

傳送廣播

命令格式：

adb shell am broadcast [options] <INTENT>

可以向所有元件廣播，也可以只向指定元件廣播。

例如，向所有元件廣播 BOOT_COMPLETED：

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED

又例如，只向 org.mazhuang.boottimemeasure/.BootCompletedReceiver 廣播 BOOT_COMPLETED：

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED -n org.mazhuang.boottimemeasure/.BootCompletedReceiver

這類用法在測試的時候很實用，比如某個廣播的場景很難製造，可以考慮通過這種方式來發送廣播。

既能傳送系統預定義的廣播，也能傳送自定義廣播。如下是部分系統預定義廣播及正常觸發時機：

action 觸發時機
android.net.conn.CONNECTIVITY_CHANGE 網路連線發生變化
android.intent.action.SCREEN_ON 螢幕點亮
android.intent.action.SCREEN_OFF 螢幕熄滅
android.intent.action.BATTERY_LOW 電量低，會彈出電量低提示框
android.intent.action.BATTERY_OKAY 電量恢復了
android.intent.action.BOOT_COMPLETED 裝置啟動完畢
android.intent.action.DEVICE_STORAGE_LOW 儲存空間過低
android.intent.action.DEVICE_STORAGE_OK 儲存空間恢復
android.intent.action.PACKAGE_ADDED 安裝了新的應用
android.net.wifi.STATE_CHANGE WiFi 連線狀態發生變化
android.net.wifi.WIFI_STATE_CHANGED WiFi 狀態變為啟用/關閉/正在啟動/正在關閉/未知
android.intent.action.BATTERY_CHANGED 電池電量發生變化
android.intent.action.INPUT_METHOD_CHANGED 系統輸入法發生變化
android.intent.action.ACTION_POWER_CONNECTED 外部電源連線
android.intent.action.ACTION_POWER_DISCONNECTED 外部電源斷開連線
android.intent.action.DREAMING_STARTED 系統開始休眠
android.intent.action.DREAMING_STOPPED 系統停止休眠
android.intent.action.WALLPAPER_CHANGED 桌布發生變化
android.intent.action.HEADSET_PLUG 插入耳機
android.intent.action.MEDIA_UNMOUNTED 解除安裝外部介質
android.intent.action.MEDIA_MOUNTED 掛載外部介質
android.os.action.POWER_SAVE_MODE_CHANGED 省電模式開啟

（以上廣播均可使用 adb 觸發）

強制停止應用

命令：

adb shell am force-stop <packagename>

命令示例：

adb shell am force-stop com.qihoo360.mobilesafe

表示停止 360 安全衛士的一切程序與服務。

收緊記憶體

命令：

adb shell am send-trim-memory  <pid> <level>

pid: 程序 ID
level:
HIDDEN、RUNNING_MODERATE、BACKGROUND、
RUNNING_LOW、MODERATE、RUNNING_CRITICAL、COMPLETE

命令示例：

adb shell am send-trim-memory 12345 RUNNING_LOW

表示向 pid=12345 的程序，發出 level=RUNNING_LOW 的收緊記憶體命令。

檔案管理

複製裝置裡的檔案到電腦

命令：

adb pull <裝置裡的檔案路徑> [電腦上的目錄]

其中 電腦上的目錄 引數可以省略，預設複製到當前目錄。

例：

adb pull /sdcard/sr.mp4 ~/tmp/

小技巧：裝置上的檔案路徑可能需要 root 許可權才能訪問，如果你的裝置已經 root 過，可以先使用 adb shell 和 su 命令在 adb shell 裡獲取 root 許可權後，先 cp /path/on/device /sdcard/filename 將檔案複製到 sdcard，然後 adb pull /sdcard/filename /path/on/pc。

複製電腦裡的檔案到裝置

命令：

adb push <電腦上的檔案路徑> <裝置裡的目錄>

例：

adb push ~/sr.mp4 /sdcard/

小技巧：裝置上的檔案路徑普通許可權可能無法直接寫入，如果你的裝置已經 root 過，可以先 adb push /path/on/pc /sdcard/filename，然後 adb shell 和 su 在 adb shell 裡獲取 root 許可權後，cp /sdcard/filename /path/on/device。

模擬按鍵/輸入

在 adb shell 裡有個很實用的命令叫 input，通過它可以做一些有趣的事情。

input 命令的完整 help 資訊如下：

Usage: input [<source>] <command> [<arg>...]

The sources are:
      mouse
      keyboard
      joystick
      touchnavigation
      touchpad
      trackball
      stylus
      dpad
      gesture
      touchscreen
      gamepad

The commands and default sources are:
      text <string> (Default: touchscreen)
      keyevent [--longpress] <key code number or name> ... (Default: keyboard)
      tap <x> <y> (Default: touchscreen)
      swipe <x1> <y1> <x2> <y2> [duration(ms)] (Default: touchscreen)
      press (Default: trackball)
      roll <dx> <dy> (Default: trackball)

比如使用 adb shell input keyevent <keycode> 命令，不同的 keycode 能實現不同的功能，完整的 keycode 列表詳見 KeyEvent，摘引部分我覺得有意思的如下：

keycode 含義
3 HOME 鍵
4 返回鍵
5 開啟撥號應用
6 結束通話電話
24 增加音量
25 降低音量
26 電源鍵
27 拍照（需要在相機應用裡）
64 開啟瀏覽器
82 選單鍵
85 播放/暫停
86 停止播放
87 播放下一首
88 播放上一首
122 移動游標到行首或列表頂部
123 移動游標到行末或列表底部
126 恢復播放
127 暫停播放
164 靜音
176 開啟系統設定
187 切換應用
207 開啟聯絡人
208 開啟日曆
209 開啟音樂
210 開啟計算器
220 降低螢幕亮度
221 提高螢幕亮度
223 系統休眠
224 點亮螢幕
231 開啟語音助手
276 如果沒有 wakelock 則讓系統休眠

下面是 input 命令的一些用法舉例。

電源鍵

命令：

adb shell input keyevent 26

執行效果相當於按電源鍵。

選單鍵

命令：

adb shell input keyevent 82

HOME 鍵

命令：

adb shell input keyevent 3

返回鍵

命令：

adb shell input keyevent 4

音量控制

增加音量：

adb shell input keyevent 24

降低音量：

adb shell input keyevent 25

靜音：

adb shell input keyevent 164

媒體控制

播放/暫停：

adb shell input keyevent 85

停止播放：

adb shell input keyevent 86

播放下一首：

adb shell input keyevent 87

播放上一首：

adb shell input keyevent 88

恢復播放：

adb shell input keyevent 126

暫停播放：

adb shell input keyevent 127

點亮/熄滅螢幕

可以通過上文講述過的模擬電源鍵來切換點亮和熄滅螢幕，但如果明確地想要點亮或者熄滅螢幕，那可以使用如下方法。

點亮螢幕：

adb shell input keyevent 224

熄滅螢幕：

adb shell input keyevent 223

滑動解鎖

如果鎖屏沒有密碼，是通過滑動手勢解鎖，那麼可以通過 input swipe 來解鎖。

命令（引數以機型 Nexus 5，向上滑動手勢解鎖舉例）：

adb shell input swipe 300 1000 300 500

引數 300 1000 300 500 分別表示起始點x座標 起始點y座標 結束點x座標 結束點y座標。

輸入文字

在焦點處於某文字框時，可以通過 input 命令來輸入文字。

命令：

adb shell input text hello

現在 hello 出現在文字框了。

檢視日誌

Android 系統的日誌分為兩部分，底層的 Linux 核心日誌輸出到 /proc/kmsg，Android 的日誌輸出到 /dev/log。

Android 日誌

命令格式：

[adb] logcat [<option>] ... [<filter-spec>] ...

常用用法列舉如下：

按級別過濾日誌

Android 的日誌分為如下幾個優先順序（priority）：

  • V —— Verbose（最低，輸出得最多）
  • D —— Debug
  • I —— Info
  • W —— Warning
  • E —— Error
  • F —— Fatal
  • S —— Silent（最高，啥也不輸出）

按某級別過濾日誌則會將該級別及以上的日誌輸出。

比如，命令：

adb logcat *:W

會將 Warning、Error、Fatal 和 Silent 日誌輸出。

（注： 在 macOS 下需要給 *:W 這樣以 * 作為 tag 的引數加雙引號，如 adb logcat "*:W"，不然會報錯 no matches found: *:W。）

按 tag 和級別過濾日誌

<filter-spec> 可以由多個 <tag>[:priority] 組成。

比如，命令：

adb logcat ActivityManager:I MyApp:D *:S

表示輸出 tag ActivityManager 的 Info 以上級別日誌，輸出 tag MyApp 的 Debug 以上級別日誌，及其它 tag 的 Silent 級別日誌（即遮蔽其它 tag 日誌）。

日誌格式

可以用 adb logcat -v <format> 選項指定日誌輸出格式。

日誌支援按以下幾種 <format>：

  • brief

    預設格式。格式為：

    <priority>/<tag>(<pid>): <message>

    示例：

    D/HeadsetStateMachine( 1785): Disconnected process message: 10, size: 0

  • process

    格式為：

    <priority>(<pid>) <message>

    示例：

    D( 1785) Disconnected process message: 10, size: 0  (HeadsetStateMachine)

  • tag

    格式為：

    <priority>/<tag>: <message>

    示例：

    D/HeadsetStateMachine: Disconnected process message: 10, size: 0

  • raw

    格式為：

    <message>

    示例：

    Disconnected process message: 10, size: 0

  • time

    格式為：

    <datetime> <priority>/<tag>(<pid>): <message>

    示例：

    08-28 22:39:39.974 D/HeadsetStateMachine( 1785): Disconnected process message: 10, size: 0

  • threadtime

    格式為：

    <datetime> <pid> <tid> <priority> <tag>: <message>

    示例：

    08-28 22:39:39.974  1785  1832 D HeadsetStateMachine: Disconnected process message: 10, size: 0

  • long

    格式為：

    [ <datetime> <pid>:<tid> <priority>/<tag> ]
<message>

    示例：

    [ 08-28 22:39:39.974  1785: 1832 D/HeadsetStateMachine ]
Disconnected process message: 10, size: 0

指定格式可與上面的過濾同時使用。比如：

adb logcat -v long ActivityManager:I *:S

清空日誌

adb logcat -c

核心日誌

命令：

adb shell dmesg

輸出示例：

<6>[14201.684016] PM: noirq resume of devices complete after 0.982 msecs
<6>[14201.685525] PM: early resume of devices complete after 0.838 msecs
<6>[14201.753642] PM: resume of devices complete after 68.106 msecs
<4>[14201.755954] Restarting tasks ... done.
<6>[14201.771229] PM: suspend exit 2016-08-28 13:31:32.679217193 UTC
<6>[14201.872373] PM: suspend entry 2016-08-28 13:31:32.780363596 UTC
<6>[14201.872498] PM: Syncing filesystems ... done.

中括號裡的 [14201.684016] 代表核心開始啟動後的時間，單位為秒。

通過核心日誌我們可以做一些事情，比如衡量核心啟動時間，在系統啟動完畢後的核心日誌裡找到 Freeing init memory 那一行前面的時間就是。

檢視裝置資訊

型號

命令：

adb shell getprop ro.product.model

輸出示例：

Nexus 5

電池狀況

命令：

adb shell dumpsys battery

輸入示例：

Current Battery Service state:
  AC powered: false
  USB powered: true
  Wireless powered: false
  status: 2
  health: 2
  present: true
  level: 44
  scale: 100
  voltage: 3872
  temperature: 280
  technology: Li-poly

其中 scale 代表最大電量，level 代表當前電量。上面的輸出表示還剩下 44% 的電量。

螢幕解析度

命令：

adb shell wm size

輸出示例：

Physical size: 1080x1920

該裝置螢幕解析度為 1080px * 1920px。

如果使用命令修改過，那輸出可能是：

Physical size: 1080x1920
Override size: 480x1024

表明裝置的螢幕解析度原本是 1080px * 1920px，當前被修改為 480px * 1024px。

螢幕密度

命令：

adb shell wm density

輸出示例：

Physical density: 420

該裝置螢幕密度為 420dpi。

如果使用命令修改過，那輸出可能是：

Physical density: 480
Override density: 160

表明裝置的螢幕密度原來是 480dpi，當前被修改為 160dpi。

顯示屏引數

命令：

adb shell dumpsys window displays

輸出示例：

WINDOW MANAGER DISPLAY CONTENTS (dumpsys window displays)
  Display: mDisplayId=0
    init=1080x1920 420dpi cur=1080x1920 app=1080x1794 rng=1080x1017-1810x1731
    deferred=false layoutNeeded=false

其中 mDisplayId 為 顯示屏編號，init 是初始解析度和螢幕密度，app 的高度比 init 裡的要小，表示螢幕底部有虛擬按鍵，高度為 1920 - 1794 = 126px 合 42dp。

android_id

命令：

adb shell settings get secure android_id

輸出示例：

51b6be48bac8c569

IMEI

在 Android 4.4 及以下版本可通過如下命令獲取 IMEI：

adb shell dumpsys iphonesubinfo

輸出示例：

Phone Subscriber Info:
  Phone Type = GSM
  Device ID = 860955027785041

其中的 Device ID 就是 IMEI。

而在 Android 5.0 及以上版本里這個命令輸出為空，得通過其它方式獲取了（需要 root 許可權）：

adb shell
su
service call iphonesubinfo 1

輸出示例：

Result: Parcel(
  0x00000000: 00000000 0000000f 00360038 00390030 '........8.6.0.9.'
  0x00000010: 00350035 00320030 00370037 00350038 '5.5.0.2.7.7.8.5.'
  0x00000020: 00340030 00000031                   '0.4.1...        ')

把裡面的有效內容提取出來就是 IMEI 了，比如這裡的是 860955027785041。

參考：adb shell dumpsys iphonesubinfo not working since Android 5.0 Lollipop

Android 系統版本

命令：

adb shell getprop ro.build.version.release

輸出示例：

5.0.2

IP 地址

每次想知道裝置的 IP 地址的時候都得「設定」-「關於手機」-「狀態資訊」-「IP地址」很煩對不對？通過 adb 可以方便地檢視。

命令：

adb shell ifconfig | grep Mask

輸出示例：

inet addr:10.130.245.230  Mask:255.255.255.252
inet addr:127.0.0.1  Mask:255.0.0.0

那麼 10.130.245.230 就是裝置 IP 地址。

在有的裝置上這個命令沒有輸出，如果裝置連著 WiFi，可以使用如下命令來檢視區域網 IP：

adb shell ifconfig wlan0

輸出示例：

wlan0: ip 10.129.160.99 mask 255.255.240.0 flags [up broadcast running multicast]

或

wlan0     Link encap:UNSPEC
          inet addr:10.129.168.57  Bcast:10.129.175.255  Mask:255.255.240.0
          inet6 addr: fe80::66cc:2eff:fe68:b6b6/64 Scope: Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:496520 errors:0 dropped:0 overruns:0 frame:0
          TX packets:68215 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:3000
          RX bytes:116266821 TX bytes:8311736

如果以上命令仍然不能得到期望的資訊，那可以試試以下命令（部分系統版本里可用）：

adb shell netcfg

輸出示例：

wlan0    UP                               10.129.160.99/20  0x00001043 f8:a9:d0:17:42:4d
lo       UP                                   127.0.0.1/8   0x00000049 00:00:00:00:00:00
p2p0     UP                                     0.0.0.0/0   0x00001003 fa:a9:d0:17:42:4d
sit0     DOWN                                   0.0.0.0/0   0x00000080 00:00:00:00:00:00
rmnet0   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet1   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet3   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet2   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet4   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet6   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet5   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet7   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rev_rmnet3 DOWN                                   0.0.0.0/0   0x00001002 4e:b7:e4:2e:17:58
rev_rmnet2 DOWN                                   0.0.0.0/0   0x00001002 4e:f0:c8:bf:7a:cf
rev_rmnet4 DOWN                                   0.0.0.0/0   0x00001002 a6:c0:3b:6b:c4:1f
rev_rmnet6 DOWN                                   0.0.0.0/0   0x00001002 66:bb:5d:64:2e:e9
rev_rmnet5 DOWN                                   0.0.0.0/0   0x00001002 0e:1b:eb:b9:23:a0
rev_rmnet7 DOWN                                   0.0.0.0/0   0x00001002 7a:d9:f6:81:40:5a
rev_rmnet8 DOWN                                   0.0.0.0/0   0x00001002 4e:e2:a9:bb:d0:1b
rev_rmnet0 DOWN                                   0.0.0.0/0   0x00001002 fe:65:d0:ca:82:a9
rev_rmnet1 DOWN                                   0.0.0.0/0   0x00001002 da:d8:e8:4f:2e:fe

可以看到網路連線名稱、啟用狀態、IP 地址和 Mac 地址等資訊。

Mac 地址

命令：

adb shell cat /sys/class/net/wlan0/address

輸出示例：

f8:a9:d0:17:42:4d

這檢視的是區域網 Mac 地址，行動網路或其它連線的資訊可以通過前面的小節「IP 地址」裡提到的 adb shell netcfg 命令來檢視。

CPU 資訊

命令：

adb shell cat /proc/cpuinfo

輸出示例：

Processor       : ARMv7 Processor rev 0 (v7l)
processor       : 0
BogoMIPS        : 38.40

processor       : 1
BogoMIPS        : 38.40

processor       : 2
BogoMIPS        : 38.40

processor       : 3
BogoMIPS        : 38.40

Features        : swp half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt
CPU implementer : 0x51
CPU architecture: 7
CPU variant     : 0x2
CPU part        : 0x06f
CPU revision    : 0

Hardware        : Qualcomm MSM 8974 HAMMERHEAD (Flattened Device Tree)
Revision        : 000b
Serial          : 0000000000000000

這是 Nexus 5 的 CPU 資訊，我們從輸出裡可以看到使用的硬體是 Qualcomm MSM 8974，processor 的編號是 0 到 3，所以它是四核的，採用的架構是 ARMv7 Processor rev 0 (v71)。

記憶體資訊

命令：

adb shell cat /proc/meminfo

輸出示例：

MemTotal:        1027424 kB
MemFree:          486564 kB
Buffers:           15224 kB
Cached:            72464 kB
SwapCached:        24152 kB
Active:           110572 kB
Inactive:         259060 kB
Active(anon):      79176 kB
Inactive(anon):   207736 kB
Active(file):      31396 kB
Inactive(file):    51324 kB
Unevictable:        3948 kB
Mlocked:               0 kB
HighTotal:        409600 kB
HighFree:         132612 kB
LowTotal:         617824 kB
LowFree:          353952 kB
SwapTotal:        262140 kB
SwapFree:         207572 kB
Dirty:                 0 kB
Writeback:             0 kB
AnonPages:        265324 kB
Mapped:            47072 kB
Shmem:              1020 kB
Slab:              57372 kB
SReclaimable:       7692 kB
SUnreclaim:        49680 kB
KernelStack:        4512 kB
PageTables:         5912 kB
NFS_Unstable:          0 kB
Bounce:                0 kB
WritebackTmp:          0 kB
CommitLimit:      775852 kB
Committed_AS:   13520632 kB
VmallocTotal:     385024 kB
VmallocUsed:       61004 kB
VmallocChunk:     209668 kB

其中，MemTotal 就是裝置的總記憶體，MemFree 是當前空閒記憶體。

更多硬體與系統屬性

裝置的更多硬體與系統屬性可以通過如下命令檢視：

adb shell cat /system/build.prop

這會輸出很多資訊，包括前面幾個小節提到的「型號」和「Android 系統版本」等。

輸出裡還包括一些其它有用的資訊，它們也可通過 adb shell getprop <屬性名> 命令單獨檢視，列舉一部分屬性如下：

屬性名 含義
ro.build.version.sdk SDK 版本
ro.build.version.release Android 系統版本
ro.build.version.security_patch Android 安全補丁程式級別
ro.product.model 型號
ro.product.brand 品牌
ro.product.name 裝置名
ro.product.board 處理器型號
ro.product.cpu.abilist CPU 支援的 abi 列表[節注一]
persist.sys.isUsbOtgEnabled 是否支援 OTG
dalvik.vm.heapsize 每個應用程式的記憶體上限
ro.sf.lcd_density 螢幕密度

節注一：

一些小廠定製的 ROM 可能修改過 CPU 支援的 abi 列表的屬性名，如果用 ro.product.cpu.abilist 屬性名查詢不到，可以這樣試試：

adb shell cat /system/build.prop | grep ro.product.cpu.abi

示例輸出：

ro.product.cpu.abi=armeabi-v7a
ro.product.cpu.abi2=armeabi

修改設定

注： 修改設定之後，執行恢復命令有可能顯示仍然不太正常，可以執行 adb reboot 重啟裝置，或手動重啟。

修改設定的原理主要是通過 settings 命令修改 /data/data/com.android.providers.settings/databases/settings.db 裡存放的設定值。

解析度

命令：

adb shell wm size 480x1024

表示將解析度修改為 480px * 1024px。

恢復原解析度命令：

adb shell wm size reset

螢幕密度

命令：

adb shell wm density 160

表示將螢幕密度修改為 160dpi。

恢復原螢幕密度命令：

adb shell wm density reset

顯示區域

命令：

adb shell wm overscan 0,0,0,200

四個數字分別表示距離左、上、右、下邊緣的留白畫素，以上命令表示將螢幕底部 200px 留白。

恢復原顯示區域命令：

adb shell wm overscan reset

關閉 USB 除錯模式

命令：

adb shell settings put global adb_enabled 0

恢復：

用命令恢復不了了，畢竟關閉了 USB 除錯 adb 就連線不上 Android 裝置了。

去裝置上手動恢復吧：「設定」-「開發者選項」-「Android 除錯」。

允許/禁止訪問非 SDK API

允許訪問非 SDK API：

adb shell settings put global hidden_api_policy_pre_p_apps 1
adb shell settings put global hidden_api_policy_p_apps 1

禁止訪問非 SDK API：

adb shell settings delete global hidden_api_policy_pre_p_apps
adb shell settings delete global hidden_api_policy_p_apps

不需要裝置獲得 Root 許可權。

命令最後的數字的含義：

值 含義
0 禁止檢測非 SDK 介面的呼叫。該情況下，日誌記錄功能被禁用，並且令 strict mode API，即 detectNonSdkApiUsage() 無效。不推薦。
1 僅警告——允許訪問所有非 SDK 介面，但保留日誌中的警告資訊，可繼續使用 strick mode API。
2 禁止呼叫深灰名單和黑名單中的介面。
3 禁止呼叫黑名單中的介面，但允許呼叫深灰名單中的介面。

狀態列和導航欄的顯示隱藏

本節所說的相關設定對應 Cyanogenmod 裡的「擴充套件桌面」。

命令：

adb shell settings put global policy_control <key-values>

<key-values> 可由如下幾種鍵及其對應的值組成，格式為 <key1>=<value1>:<key2>=<value2>。

key 含義
immersive.full 同時隱藏
immersive.status 隱藏狀態列
immersive.navigation 隱藏導航欄
immersive.preconfirms ?

這些鍵對應的值可則如下值用逗號組合：

value 含義
apps 所有應用
* 所有介面
packagename 指定應用
-packagename 排除指定應用

例如：

adb shell settings put global policy_control immersive.full=*

表示設定在所有介面下都同時隱藏狀態列和導航欄。

adb shell settings put global policy_control immersive.status=com.package1,com.package2:immersive.navigation=apps,-com.package3

表示設定在包名為 com.package1 和 com.package2 的應用裡隱藏狀態列，在除了包名為 com.package3 的所有應用裡隱藏導航欄。

實用功能

螢幕截圖

截圖儲存到電腦：

adb exec-out screencap -p > sc.png

如果 adb 版本較老，無法使用 exec-out 命令，這時候建議更新 adb 版本。無法更新的話可以使用以下麻煩點的辦法：

先截圖儲存到裝置裡：

adb shell screencap -p /sdcard/sc.png

然後將 png 檔案匯出到電腦：

adb pull /sdcard/sc.png

可以使用 adb shell screencap -h 檢視 screencap 命令的幫助資訊，下面是兩個有意義的引數及含義：

引數 含義
-p 指定儲存檔案為 png 格式
-d display-id 指定截圖的顯示屏編號（有多顯示屏的情況下）

實測如果指定檔名以 .png 結尾時可以省略 -p 引數；否則需要使用 -p 引數。如果不指定檔名，截圖檔案的內容將直接輸出到 stdout。

另外一種一行命令截圖並儲存到電腦的方法：

Linux 和 Windows

adb shell screencap -p | sed "s/\r$//" > sc.png

Mac OS X

adb shell screencap -p | gsed "s/\r$//" > sc.png

這個方法需要用到 gnu sed 命令，在 Linux 下直接就有，在 Windows 下 Git 安裝目錄的 bin 資料夾下也有。如果確實找不到該命令，可以下載 sed for Windows 並將 sed.exe 所在資料夾新增到 PATH 環境變數裡。

而在 Mac 下使用系統自帶的 sed 命令會報錯：

sed: RE error: illegal byte sequence

需要安裝 gnu-sed，然後使用 gsed 命令：

brew install gnu-sed

錄製螢幕

錄製螢幕以 mp4 格式儲存到 /sdcard：

adb shell screenrecord /sdcard/filename.mp4

需要停止時按 Ctrl-C，預設錄製時間和最長錄製時間都是 180 秒。

如果需要匯出到電腦：

adb pull /sdcard/filename.mp4

可以使用 adb shell screenrecord --help 檢視 screenrecord 命令的幫助資訊，下面是常見引數及含義：

引數 含義
--size WIDTHxHEIGHT 視訊的尺寸，比如 1280x720，預設是螢幕解析度。
--bit-rate RATE 視訊的位元率，預設是 4Mbps。
--time-limit TIME 錄製時長，單位秒。
--verbose 輸出更多資訊。

重新掛載 system 分割槽為可寫

注：需要 root 許可權。

/system 分割槽預設掛載為只讀，但有些操作比如給 Android 系統新增命令、刪除自帶應用等需要對 /system 進行寫操作，所以需要重新掛載它為可讀寫。

步驟：

  1. 進入 shell 並切換到 root 使用者許可權。

    命令：

    adb shell
su

  2. 檢視當前分割槽掛載情況。

    命令：

    mount

    輸出示例：

    rootfs / rootfs ro,relatime 0 0
tmpfs /dev tmpfs rw,seclabel,nosuid,relatime,mode=755 0 0
devpts /dev/pts devpts rw,seclabel,relatime,mode=600 0 0
proc /proc proc rw,relatime 0 0
sysfs /sys sysfs rw,seclabel,relatime 0 0
selinuxfs /sys/fs/selinux selinuxfs rw,relatime 0 0
debugfs /sys/kernel/debug debugfs rw,relatime 0 0
none /var tmpfs rw,seclabel,relatime,mode=770,gid=1000 0 0
none /acct cgroup rw,relatime,cpuacct 0 0
none /sys/fs/cgroup tmpfs rw,seclabel,relatime,mode=750,gid=1000 0 0
none /sys/fs/cgroup/memory cgroup rw,relatime,memory 0 0
tmpfs /mnt/asec tmpfs rw,seclabel,relatime,mode=755,gid=1000 0 0
tmpfs /mnt/obb tmpfs rw,seclabel,relatime,mode=755,gid=1000 0 0
none /dev/memcg cgroup rw,relatime,memory 0 0
none /dev/cpuctl cgroup rw,relatime,cpu 0 0
none /sys/fs/cgroup tmpfs rw,seclabel,relatime,mode=750,gid=1000 0 0
none /sys/fs/cgroup/memory cgroup rw,relatime,memory 0 0
none /sys/fs/cgroup/freezer cgroup rw,relatime,freezer 0 0
/dev/block/platform/msm_sdcc.1/by-name/system /system ext4 ro,seclabel,relatime,data=ordered 0 0
/dev/block/platform/msm_sdcc.1/by-name/userdata /data ext4 rw,seclabel,nosuid,nodev,relatime,noauto_da_alloc,data=ordered 0 0
/dev/block/platform/msm_sdcc.1/by-name/cache /cache ext4 rw,seclabel,nosuid,nodev,relatime,data=ordered 0 0
/dev/block/platform/msm_sdcc.1/by-name/persist /persist ext4 rw,seclabel,nosuid,nodev,relatime,data=ordered 0 0
/dev/block/platform/msm_sdcc.1/by-name/modem /firmware vfat ro,context=u:object_r:firmware_file:s0,relatime,uid=1000,gid=1000,fmask=0337,dmask=0227,codepage=cp437,iocharset=iso8859-1,shortname=lower,errors=remount-ro 0 0
/dev/fuse /mnt/shell/emulated fuse rw,nosuid,nodev,relatime,user_id=1023,group_id=1023,default_permissions,allow_other 0 0
/dev/fuse /mnt/shell/emulated/0 fuse rw,nosuid,nodev,relatime,user_id=1023,group_id=1023,default_permissions,allow_other 0 0

    找到其中我們關注的帶 /system 的那一行：

    /dev/block/platform/msm_sdcc.1/by-name/system /system ext4 ro,seclabel,relatime,data=ordered 0 0

  3. 重新掛載。

    命令：

    mount -o remount,rw -t yaffs2 /dev/block/platform/msm_sdcc.1/by-name/system /system

    這裡的 /dev/block/platform/msm_sdcc.1/by-name/system 就是我們從上一步的輸出裡得到的檔案路徑。

如果輸出沒有提示錯誤的話，操作就成功了，可以對 /system 下的檔案為所欲為了。

檢視連線過的 WiFi 密碼

注：需要 root 許可權。

命令：

adb shell
su
cat /data/misc/wifi/*.conf

輸出示例：

network={
	ssid="TP-LINK_9DFC"
	scan_ssid=1
	psk="123456789"
	key_mgmt=WPA-PSK
	group=CCMP TKIP
	auth_alg=OPEN
	sim_num=1
	priority=13893
}

network={
	ssid="TP-LINK_F11E"
	psk="987654321"
	key_mgmt=WPA-PSK
	sim_num=1
	priority=17293
}

ssid 即為我們在 WLAN 設定裡看到的名稱，psk 為密碼，key_mgmt 為安全加密方式。

如果 Android O 或以後，WiFi 密碼儲存的地址有變化，是在 WifiConfigStore.xml 裡面

adb shell
su
cat /data/misc/wifi/WifiConfigStore.xml

輸出格式：

資料項較多，只需關注 ConfigKey（WiFi 名字）和 PreSharedKey（WiFi 密碼）即可

<string name="ConfigKey">&quot;Wi-Fi&quot;WPA_PSK</string>
<string name="PreSharedKey">&quot;931907334&quot;</string>

設定系統日期和時間

注：需要 root 許可權。

命令：

adb shell
su
date -s 20160823.131500

表示將系統日期和時間更改為 2016 年 08 月 23 日 13 點 15 分 00 秒。

重啟手機

命令：

adb reboot

檢測裝置是否已 root

命令：

adb shell
su

此時命令列提示符是 $ 則表示沒有 root 許可權，是 # 則表示已 root。

使用 Monkey 進行壓力測試

Monkey 可以生成偽隨機使用者事件來模擬單擊、觸控、手勢等操作，可以對正在開發中的程式進行隨機壓力測試。

簡單用法：

adb shell monkey -p <packagename> -v 500

表示向 <packagename> 指定的應用程式傳送 500 個偽隨機事件。

Monkey 的詳細用法參考 官方文件。

開啟/關閉 WiFi

注：需要 root 許可權。

有時需要控制裝置的 WiFi 狀態，可以用以下指令完成。

開啟 WiFi：

adb root
adb shell svc wifi enable

關閉 WiFi：

adb root
adb shell svc wifi disable

若執行成功，輸出為空；若未取得 root 許可權執行此命令，將執行失敗，輸出 Killed。

刷機相關命令

重啟到 Recovery 模式

命令：

adb reboot recovery

從 Recovery 重啟到 Android

命令：

adb reboot

重啟到 Fastboot 模式

命令：

adb reboot bootloader

通過 sideload 更新系統

如果我們下載了 Android 裝置對應的系統更新包到電腦上，那麼也可以通過 adb 來完成更新。

以 Recovery 模式下更新為例：

  1. 重啟到 Recovery 模式。

    命令：

    adb reboot recovery

  2. 在裝置的 Recovery 介面上操作進入 Apply update-Apply from ADB。

    注：不同的 Recovery 選單可能與此有差異，有的是一級選單就有 Apply update from ADB。

  3. 通過 adb 上傳和更新系統。

    命令：

    adb sideload <path-to-update.zip>

安全相關命令

啟用/禁用 SELinux

啟用 SELinux

adb root
adb shell setenforce 1

禁用 SELinux

adb root
adb shell setenforce 0

啟用/禁用 dm_verity

啟用 dm_verity

adb root
adb enable-verity

禁用 dm_verity

adb root
adb disable-verity

更多 adb shell 命令

Android 系統是基於 Linux 核心的，所以 Linux 裡的很多命令在 Android 裡也有相同或類似的實現，在 adb shell 裡可以呼叫。本文件前面的部分內容已經用到了 adb shell 命令。

檢視程序

命令：

adb shell ps

輸出示例：

USER     PID   PPID  VSIZE  RSS     WCHAN    PC        NAME
root      1     0     8904   788   ffffffff 00000000 S /init
root      2     0     0      0     ffffffff 00000000 S kthreadd
...
u0_a71    7779  5926  1538748 48896 ffffffff 00000000 S com.sohu.inputmethod.sogou:classic
u0_a58    7963  5926  1561916 59568 ffffffff 00000000 S org.mazhuang.boottimemeasure
...
shell     8750  217   10640  740   00000000 b6f28340 R ps

各列含義：

列名 含義
USER 所屬使用者
PID 程序 ID
PPID 父程序 ID
NAME 程序名

檢視實時資源佔用情況

命令：

adb shell top

輸出示例：

User 0%, System 6%, IOW 0%, IRQ 0%
User 3 + Nice 0 + Sys 21 + Idle 280 + IOW 0 + IRQ 0 + SIRQ 3 = 307

  PID PR CPU% S  #THR     VSS     RSS PCY UID      Name
 8763  0   3% R     1  10640K   1064K  fg shell    top
  131  0   3% S     1      0K      0K  fg root     dhd_dpc
 6144  0   0% S   115 1682004K 115916K  fg system   system_server
  132  0   0% S     1      0K      0K  fg root     dhd_rxf
 1731  0   0% S     6  20288K    788K  fg root     /system/bin/mpdecision
  217  0   0% S     6  18008K    356K  fg shell    /sbin/adbd
 ...
 7779  2   0% S    19 1538748K  48896K  bg u0_a71   com.sohu.inputmethod.sogou:classic
 7963  0   0% S    18 1561916K  59568K  fg u0_a58   org.mazhuang.boottimemeasure
 ...

各列含義：

列名 含義
PID 程序 ID
PR 優先順序
CPU% 當前瞬間佔用 CPU 百分比
S 程序狀態（R=執行，S=睡眠，T=跟蹤/停止，Z=殭屍程序）
#THR 執行緒數
VSS Virtual Set Size 虛擬耗用記憶體（包含共享庫佔用的記憶體）
RSS Resident Set Size 實際使用實體記憶體（包含共享庫佔用的記憶體）
PCY 排程策略優先順序，SP_BACKGROUND/SPFOREGROUND
UID 程序所有者的使用者 ID
NAME 程序名

top 命令還支援一些命令列引數，詳細用法如下：

Usage: top [ -m max_procs ] [ -n iterations ] [ -d delay ] [ -s sort_column ] [ -t ] [ -h ]
    -m num  最多顯示多少個程序
    -n num  重新整理多少次後退出
    -d num  重新整理時間間隔（單位秒，預設值 5）
    -s col  按某列排序（可用 col 值：cpu, vss, rss, thr）
    -t      顯示執行緒資訊
    -h      顯示幫助文件

檢視程序 UID

有兩種方案：

  1. adb shell dumpsys package <packagename> | grep userId=

    如：

    $ adb shell dumpsys package org.mazhuang.guanggoo | grep userId=
   userId=10394

  2. 通過 ps 命令找到對應程序的 pid 之後 adb shell cat /proc/<pid>/status | grep Uid

    如：

    $ adb shell
gemini:/ $ ps | grep org.mazhuang.guanggoo
u0_a394   28635 770   1795812 78736 SyS_epoll_ 0000000000 S org.mazhuang.guanggoo
gemini:/ $ cat /proc/28635/status | grep Uid
Uid:    10394   10394   10394   10394
gemini:/ $

其它

如下是其它常用命令的簡單描述，前文已經專門講過的命令不再額外說明：

命令 功能
cat 顯示檔案內容
cd 切換目錄
chmod 改變檔案的存取模式/訪問許可權
df 檢視磁碟空間使用情況
grep 過濾輸出
kill 殺死指定 PID 的程序
ls 列舉目錄內容
mount 掛載目錄的檢視和管理
mv 移動或重新命名檔案
ps 檢視正在執行的程序
rm 刪除檔案
top 檢視程序的資源佔用情況

常見問題

啟動 adb server 失敗

出錯提示

error: protocol fault (couldn't read status): No error

可能原因

adb server 程序想使用的 5037 埠被佔用。

解決方案

找到佔用 5037 埠的程序，然後終止它。以 Windows 下為例：

netstat -ano | findstr LISTENING

...
TCP    0.0.0.0:5037           0.0.0.0:0              LISTENING       1548
...

這裡 1548 即為程序 ID，用命令結束該程序：

taskkill /PID 1548

然後再啟動 adb 就沒問題了。

com.android.ddmlib.AdbCommandRejectedException

在 Android Studio 裡新建一個模擬器，但是用 adb 一直連線不上，提示：

com.android.ddmlib.AdbCommandRejectedException: device unauthorized.
This adb server's $ADB_VENDOR_KEYS is not set
Try 'adb kill-server' if that seems wrong.
Otherwise check for a confirmation dialog on your device.

在手機上安裝一個終端然後執行 su 提示沒有該命令，這不正常。

於是刪除該模擬器後重新下載安裝一次，這次就正常了。

adb 的非官方實現

  • fb-adb - A better shell for Android devices (for Mac).

相關命令

相關推薦

java8 Optional 類

package jdk180reduce; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map;

利用Java8 Optional類優雅如何地解決空指標問題

前言 Java8 由Oracle在2014年釋出，是繼Java5之後最具革命性的版本。 Java8吸收其他語言的精髓帶來了函數語言程式設計，lambda表示式，Stream流等一系列新特性，學會了這些新特性，可以讓你實現高效編碼優雅編碼。

JAVA8 Optional類記錄

Optional 屬於java.util 包，是一個工具類。 具體是判斷是否為null，優化空指標的寫法，更為優雅的寫法。

Java8 Optional類的使用

一、簡介 　　Optional 是一個物件容器，具有以下兩個特點： 　　　　1. 提示使用者要注意該物件有可能為null　　　　2. 簡化if else程式碼

Java8 中的 Optional 類的基本使用

Java8 引入了一個十分有趣的 Optional 類它主要是為瞭解決臭名昭著的空指標異常（NullPointerException）。當我們對物件的屬性進行檢查，判斷它的值是否為期望的格式，最終卻發現我們檢視的並不是一個物件，而是一個

Java8新特性之空指標異常的剋星Optional類的實現

Java8新特性系列我們已經介紹了Stream、Lambda表示式、DateTime日期時間處理，最後以“NullPointerException” 的剋星Optional類的講解來收尾。

Java8的方法引用和Optional類

方法引用 方法引用分為三種，方法引用通過一對雙冒號:: 來表示，方法引用是一種函式式介面的另一種書寫方式

Java8-Optional 容器類

1、Optional類是什麼？Optional<T>類（java.util.Optional）是一個容器類，代表一個值存在或者不存在，原來用null

Java8 Lambda表示式、Optional類淺析

1.概念 Lambda是一個匿名函式，可以將其理解為一段可以傳遞的程式碼（將程式碼像資料一樣進行傳遞）可以寫出更簡潔、更靈活的程式碼。作為一種更緊湊的程式碼風格，使得java語言的表達能利得到了提升。

Java重溫學習筆記，Java8新特性：Optional 類

Optional 類是一個可以為null的容器物件。如果值存在則isPresent()方法會返回true，呼叫get()方法會返回該物件。Optional 是個容器：它可以儲存型別T的值，或者僅僅儲存null。Optional提供很多有用的方法，這樣我們就

Java8新特性 Optional 類的使用

Optional 類 定義與宣告 定義 Optional 類是一個可以為null的容器物件。它可以儲存型別T的值，或者僅僅儲存null。

【Java8新特性】Optional 類

概述 Optional 類是一個可以為null的容器物件。如果值存在則isPresent()方法會返回true，呼叫get()方法會返回該物件。

Java8 Optional用法

　　根據Oracle文件，Optional是一個容器物件，可以包含也可以不包含非null值。Optional在Java 8中引入，目的是解決 NullPointerExceptions的問題。本質上，Optional是一個包裝器類，其中包含對其他物件的引用。在這

Java8 Optional原理及用法解析

平時開發的工作中,自己組內的很多大佬經常使用Optional的用法,自己問他們,這個到底有什麼好處呢,他們說可以很好的規避好空指標的問題,我們在平時寫java程式碼的時候,如果是一個新手,肯定很多情況下都會出現空指標的報

Optional類學習總結

簡單瞭解Optional類 眾所周知,在日常開發中Null Pointer Exception 空指標異常是非常令人頭疼的一件事情,為了避免這個問題我們不得不在程式碼中穿插大量的判空程式碼使得程式碼看起來非常的不優雅.而Java1.8的新特

Optional類

1、Java1.8新特性之Optional package java.util; import java.util.function.Consumer; import java.util.function.Function;

Java 8 新特性之 Optional 類

技術標籤：JavaOptional 類 Java 8 提供的 Optional 類是一個可以為 null 的容器物件。如果值存在則 isPresent() 方法會返回 true，呼叫 get() 方法會返回該物件。同時，Optional 又是個容器，它可以儲存型別 T的

jdk8新特性：Optional類

技術標籤：java 引言 Optional 類主要解決的問題是臭名昭著的空指標異常（NullPointerException）。本質上，這是一個包含有可選值的包裝類，這意味著 Optional 類既可以含有物件也可以為空。 Optional 類是一個

java8-Optional解決判斷Null的問題

　　做專案時，經常會遇到判斷null的問題，在之前有Objects.requireNonNull()來解決，java8提供了Optional來解決這個問題，在網上看到一篇講解Option的部落格，閱讀後拿來加強自己的記憶。　　

空指標異常處理 Optional類

技術標籤：JAVAjavaspring經驗分享 Optional各方法的作用 public static Optional of(T value)