# android-kiosk-skill

**Repository Path**: yangtf/android-kiosk-skill

## Basic Information

- **Project Name**: android-kiosk-skill
- **Description**: 把任意 Android APP 设成默认桌面（kiosk 模式），无需 root。附 macOS/Linux/Windows 脚本与可直接复制给 AI 的 SKILL.md
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-25
- **Last Updated**: 2026-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android Kiosk

把任意 Android APP 设成默认桌面（kiosk / 单应用模式），**不需要 root**。

适合门店展示机、工控平板、检定仪、点餐机——只要一个 APP、不要系统桌面的场景。

## 用 Skill 的方式

> **把 [`SKILL.md`](SKILL.md) 全文复制粘贴到豆包对话框，它就变成你的 Android 桌面设置助手——直接跟它说"帮我把某个 APP 设成桌面"，它会一步步给你命令。**

## 直接跑脚本

macOS / Linux：

```bash
git clone <本仓库地址>
cd android-kiosk-skill
chmod +x kiosk.sh

./kiosk.sh list            # 列出能当桌面的应用
./kiosk.sh on com.xxx.app  # 切换
./kiosk.sh status          # 看当前状态
./kiosk.sh off             # 恢复系统桌面
```

Windows（需装 adb 并加入 PATH）：

```bat
kiosk.bat list
kiosk.bat on com.xxx.app
kiosk.bat off
```

多台设备时用 `SERIAL` 指定：

```bash
SERIAL=1234567890 ./kiosk.sh on com.xxx.app
```

## 原理

APP 在 manifest 里声明 `CATEGORY_HOME` 就是合法桌面候选，再把系统桌面禁用掉，系统只剩一个选择：

```bash
pm disable-user --user 0 com.android.launcher                                  # 禁用系统桌面
am start -a android.intent.action.MAIN -c android.intent.category.HOME          # 切过去
```

回滚：

```bash
pm enable com.android.launcher
```

## 前提：APP 要声明 HOME

APP 的启动 Activity 里要有：

```xml
<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
    <category android:name="android.intent.category.HOME" />
    <category android:name="android.intent.category.DEFAULT" />
</intent-filter>
```

没声明的话，`kiosk.sh list` 里不会出现它。

## 支持的设备

| 品牌 | 支持 |
|---|---|
| 原生 Android / AOSP | ✅ |
| OPPO ColorOS / realme | ✅ |
| 小米 MIUI / HyperOS | ✅ |
| vivo OriginOS | ✅（视版本） |
| 华为 HarmonyOS | ❌ ROM 拒绝禁用系统桌面 |
| 荣耀 MagicOS | ❌ 同上，ROLE 也被锁 |

## ⚠️ 救急

设成 kiosk 后手机没有系统桌面了。**卸载那个 APP 或恢复出厂之前，一定先恢复**：

```bash
adb shell pm enable com.android.launcher
```

万一忘了，插上 USB 跑这条命令就能救回来。

## License

MIT