> 来源：https://mac-cms.com/install/adb
> 简介：通过 ADB 给安卓电视、盒子、投影仪安装空壳影视的通用教程：电脑装 adb、电视开启调试、adb connect、adb install、常见报错与排查。各品牌开启 ADB 的方法见品牌页。
> 更新：2026-11-02

# 通过 ADB 安装

ADB（Android Debug Bridge）是电脑控制安卓设备的命令行工具。用它装 APK，不需要 U 盘，也不经过电视自带的安装器，所以**对一些限制第三方安装的电视特别有用**。代价是需要一台电脑，并且电视要先开启 ADB。

::: tip 先看你的品牌
每个品牌开启 ADB 的方式不同，这页讲的是通用流程。开启方法见：
[小米](/install/xiaomi) · [TCL / 雷鸟](/install/tcl) · [创维 / 酷开](/install/skyworth) · [海信](/install/hisense) · [华为](/install/huawei) · [运营商盒子](/install/operator-box) · [投影仪](/install/projector) · [其他](/install/other)
:::

## 一、准备

- 电脑和电视连**同一个路由器**（同一 WiFi 或一个接网线一个接 WiFi 都行，但要在同一网段）。
- 下载安装包：`https://files.mac-cms.com/app-release.apk`，文件名保持默认的 `app-release.apk` 即可。重复下载时浏览器可能改成 `app-release (1).apk`，命令里的文件名要对应修改，带空格和括号时要加引号。
- 查到电视的 IP 地址，记为 `<TV_IP>`，查法见下一节。

### 查电视 IP

IP 地址是电视在家里网络中的"门牌号"，样子像 `192.168.1.23`，四段数字，用点隔开。下面几种办法任选一种。

**办法一：在电视上看（最直接）**

1. 先确认电视已经连上网（WiFi 或网线）。
2. 用遥控器打开"设置"，找"**网络**"（有的叫"网络设置 / 网络与互联网"）。
3. 点进当前连着的 WiFi 或"有线网络"，在详情或"网络信息 / 高级"里找"**IP 地址**"。
4. 有的电视没放在网络里，而是在"设置 → 关于 → **本机信息**"里，也能看到 IP 地址。

找不到、看不懂，用办法二。

**办法二：在路由器的"已连接设备"里找**

1. 手机连上家里 WiFi，在浏览器打开路由器的管理地址。地址一般印在路由器背面的标签上，常见是 `192.168.1.1` 或 `192.168.0.1`。也可以用路由器自带的手机 App。
2. 输入路由器管理密码（也印在背面，或是你自己设的）。
3. 找到"**设备列表 / 已连接设备 / 客户端**"，里面按设备名称列出了 IP。电视通常显示品牌名或型号，比如 `Xiaomi-TV`、`TCL`、`Android-xxx`。
4. 不确定哪个是电视时，关掉电视再刷新一次，消失的那一项就是。

**办法三：用手机扫描**

手机装一个局域网扫描 App（如 **Fing**），手机连同一个 WiFi，扫描后列表里能看到各设备和 IP，找电视那一项。

**办法四：电脑上命令查（给 AI 或会用命令行的人）**

```bash
arp -a
```

会列出同一网络里的设备 IP。找到最近出现、可能是电视的地址，用 `adb connect <IP>:5555` 逐个试，能连上并在电视屏幕弹出授权框的就是电视。

::: warning 注意这几点
- **电脑和电视必须连同一个路由器**，两者 IP 的前三段要一样。比如电视是 `192.168.1.23`，电脑也应该是 `192.168.1.xx`。电脑的 IP 在 Windows 里用 `ipconfig` 看，macOS / Linux 用 `ifconfig` 或"系统设置 → 网络"看。
- 电视如果连的是路由器的**访客 WiFi**，电脑通常连不上，改连主 WiFi。
- 电视断电或重启后，IP 可能变，需要重新查。想固定下来，可以在路由器里给电视绑定固定 IP（可选）。
:::

## 二、电脑上装 adb

下面的命令都要在"终端"里执行。**不会打开终端的话**：

- **Windows**：把 platform-tools 解压后，打开解压出来的 `platform-tools` 文件夹，点击上方的**地址栏**，输入 `cmd` 再按回车，就会弹出一个已定位到该文件夹的黑色窗口。之后用 `adb` 开头的命令直接粘贴执行（解压版如果提示找不到命令，写成 `.\adb`）。
- **macOS**：打开"启动台"里的"终端"，输入 `cd ` 加一个空格，把解压出来的 `platform-tools` 文件夹拖进窗口，按回车。之后命令写成 `./adb ...`。

下载 Google 官方的 Platform Tools，解压即用，不需要安装程序。

- Windows：https://dl.google.com/android/repository/platform-tools-latest-windows.zip
- macOS：https://dl.google.com/android/repository/platform-tools-latest-darwin.zip
- Linux：https://dl.google.com/android/repository/platform-tools-latest-linux.zip

也可以用包管理器：

```bash
# Windows (winget)
winget install --id Google.PlatformTools -e

# macOS (Homebrew)
brew install --cask android-platform-tools

# Debian / Ubuntu
sudo apt install -y adb
```

装好后在终端里执行 `adb version`，能看到版本号就行。解压版要进到 `platform-tools` 目录里，或者用完整路径调用。

## 三、电视上开启 ADB

通用路径是：**设置 → 关于（或"关于本机"）→ 连续点击"版本号"7 次左右 → 返回找到"开发者选项" → 打开"USB 调试"**。

不熟悉遥控器怎么连点、找不到入口，先看 [开启开发者模式](/install/developer-mode)，里面有小白版步骤和常见问题。

但很多国产电视把入口藏起来了，要用遥控器按特定按键序列，或者进工厂菜单。具体做法按品牌看：

- [小米 / 红米电视](/install/xiaomi#开启-adb)
- [TCL / 雷鸟电视](/install/tcl#开启-adb)
- [创维 / 酷开电视](/install/skyworth#开启-adb)
- [海信电视](/install/hisense#开启-adb)
- [华为智慧屏](/install/huawei#开启-adb)
- [运营商盒子](/install/operator-box#开启-adb)
- [投影仪](/install/projector#开启-adb)
- [其他电视 / 盒子](/install/other#开启-adb)

## 四、连接

```bash
adb connect <TV_IP>:5555
adb devices
```

- 电视屏幕上会弹出"是否允许 USB 调试"，用遥控器选**允许**（可勾选"始终允许"）。
- `adb devices` 里看到 `<TV_IP>:5555   device` 才算连接成功。
- 如果状态是 `unauthorized`，说明你还没在电视上点允许；`offline` 就执行 `adb disconnect` 后重连。

::: tip Android 11 及以上的"无线调试"
部分新电视用的是"无线调试"，端口不是 5555，而且要先配对：

```bash
adb pair <TV_IP>:<配对端口>      # 输入电视上显示的配对码
adb connect <TV_IP>:<连接端口>
```

配对端口、连接端口和配对码，都在电视的"无线调试"页面里。
:::

## 五、安装

```bash
adb install -r app-release.apk
```

输出 `Success` 就装好了。`-r` 表示已安装时覆盖升级并保留数据。

同时连着多台设备时，必须指定目标：

```bash
adb -s <TV_IP>:5555 install -r app-release.apk
```

## 六、启动

```bash
adb shell monkey -p com.mac_cms.app -c android.intent.category.LAUNCHER 1
```

电视只注册了 TV 启动器时，把 `LAUNCHER` 换成 `LEANBACK_LAUNCHER`。也可以直接在电视"我的应用"里找"空壳影视"。

## 七、常见报错

| 报错 | 原因与办法 |
|------|------------|
| `cannot connect to <IP>:5555` / `Connection refused` | 电视没开 ADB，或端口不对；电脑和电视不在同一网段；电视休眠后关闭了 ADB，唤醒后重新开启 |
| `unauthorized` | 电视上还没点允许，重新 `adb connect` 并看电视屏幕 |
| `more than one device/emulator` | 连了多台设备，加 `-s <序列号>` |
| `INSTALL_FAILED_OLDER_SDK` | 系统低于 Android 5.0，不支持 |
| `INSTALL_FAILED_UPDATE_INCOMPATIBLE` | 设备上有签名不同的同包名应用，需先卸载旧版（会丢数据，要先确认） |
| `INSTALL_FAILED_INSUFFICIENT_STORAGE` | 存储空间不足 |
| `INSTALL_FAILED_VERIFICATION_FAILURE` / `INSTALL_FAILED_USER_RESTRICTED` | 电视拦截了 ADB 安装。有些电视会在屏幕上弹确认框，让用户点允许；仍然不行就改走品牌页里的手动安装 |
| `INSTALL_PARSE_FAILED_*` | APK 下载不完整，重新下载 |
| `INSTALL_FAILED_NO_MATCHING_ABIS` | 设备架构不匹配，一般是下错了安装包 |

## 八、装完建议

- 用完可以把电视的 USB 调试关掉，避免家里其他设备误连。
- 以后给这台电视装别的 App，可以用空壳影视的[免 U 盘安装](/app/app-tv-install)。

## 如果 ADB 走不通

不用硬试。回到你的品牌页，用 U 盘或手机推送的方式手动安装，入口见[安装总览](/install/index)。