应用管理

启动应用

pb launch <package>

通过包名启动应用。

参数	类型	必填	说明
package_name	string	是	Android 包名

示例：

pb launch com.android.chrome

启动 Activity

pb start <package>

启动 Android Activity。支持类似 adb am start 的参数。

参数	类型	必填	说明
package_name	string	否	包名（位置参数）
-n	string	否	组件名（包名/Activity 类名），/ 分隔包名和类名
-a	string	否	Intent action
-d	string	否	Intent data URI
-t	string	否	MIME type

示例：

# 通过包名启动
pb start com.android.chrome

# 启动指定 Activity
pb start -n com.android.chrome/com.google.android.apps.chrome.Main

# 通过 action 和 data 启动
pb start -a android.intent.action.VIEW -d "https://example.com"

强制停止

pb force-stop <package>

强制停止应用。

参数	类型	必填	说明
package_name	string	是	要停止的包名

示例：

pb force-stop com.android.chrome

已安装应用

pb packages

列出设备上所有已安装的应用包。

示例：

pb packages

Text

com.android.chrome
com.android.settings
mark.via

JSON

{
  "code": 200,
  "data": {
    "packages": [
      "com.android.chrome",
      "com.android.settings",
      "mark.via"
    ]
  },
  "msg": "OK"
}

前台 Activity

pb top-activity

获取当前前台 Activity 信息。

示例：

pb top-activity

Text

com.android.chrome/org.chromium.chrome.browser.ChromeTabbedActivity

JSON

{
  "code": 200,
  "data": {
    "package_name": "com.android.chrome",
    "class_name": "org.chromium.chrome.browser.ChromeTabbedActivity"
  },
  "msg": "OK"
}

安装应用

pb install <file_or_url>

在设备上安装 APK 或 XAPK 文件。支持本地文件、URL 和设备路径。

参数	类型	必填	说明
file_or_url	string	是	本地文件路径、URL 或设备路径

路由策略

pb install 根据输入自动选择最佳安装方式：

输入类型	行为
http:// / https:// URL	设备直接下载并安装
file:// / content:// URI	传给设备直接安装
本地文件路径（你的机器上存在的文件）	分块上传到设备后安装，安装完自动清理临时文件
其他路径（如 /sdcard/Download/app.apk）	当作设备路径直接透传

TIP

本地文件上传使用 base64 分块传输（通过 shell），交互模式下显示进度条。大文件（~100 MB+）可能需要几分钟。

示例：

# 安装本地文件
pb install ./my-app.apk

# 通过 URL 安装（设备直接下载）
pb install https://example.com/app.apk

# 从设备路径安装
pb install /sdcard/Download/app.apk

卸载应用

pb uninstall <package>

从设备上卸载应用。

参数	类型	必填	说明
package_name	string	是	要卸载的包名

示例：

pb uninstall com.example.app