# Technical Documentation: zfdang/Android-Touch-Helper

> ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/zfdang/Android-Touch-Helper)

### Overview (README.md)

# Android-Touch-Helper



[中文说明](README.zh-CN.md)

# Skip Splash Ads on Android

Android-Touch-Helper is an Android helper app that automatically skips splash ads. It is implemented with Android Accessibility Service, which means the app can inspect on-screen content to detect and click skip targets.

Because Accessibility-based tools can potentially access sensitive on-screen information, privacy is the biggest concern for this kind of app.

**This project is open source, does not require network permission or storage permission, and does not collect or upload personal data.**

The app can skip splash ads in three ways:

1. Keyword detection. It looks for buttons containing specific keywords and clicks them automatically.
2. Specific UI controls. It can find and click predefined controls for a given app.
3. Specific screen positions. It can click a configured screen area for a given app.

Ideas and pull requests are welcome.

[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
     alt="Get it on F-Droid"
     height="80">](https://f-droid.org/packages/com.zfdang.touchhelper/)
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png"
     alt="Get it on Google Play"
     height="80">](https://play.google.com/store/apps/details?id=com.zfdang.touchhelper)

# Project Website

[http://TouchHelper.zfdang.com](http://TouchHelper.zfdang.com)

## Star History

[](https://www.star-history.com/#zfdang/android-touch-helper)

## Maintenance Note

This is a mature, stable project — the core functionality is complete and the app is widely used. I continue to maintain it: reviewing and merging PRs, cutting releases, and fixing bugs (most recent commits September 2026). Large new features may take longer, but the project is alive and maintained.

# Acknowledgements

This project borrowed ideas and code from AccessibilityTool. Many thanks:

https://github.com/LGH1996/AccessibilityTool

---

### README (`docs/README.md`)

## 开屏跳过

安卓系统的开屏广告自动跳过助手

<p>
<img src="touch_helper.png" width="200">
</p>

自动跳过软件的实现，一般都是基于安卓的Accessibility“无障碍服务”实现。开启了无障碍服务的软件，可以获取屏幕上的任何内容，从而可以检测广告，帮助用户自动跳过。因此，使用广告跳过程序，最大的风险是个人信息被泄露！

**本程序是开源程序，不需要网络权限，不需要存储权限，不会收集或者上传任何信息！绝无隐私问题！**

## 功能介绍

"**开屏跳过**"可以帮助用户自动跳过一些应用的开屏广告，基于Android的无障碍服务实现。

程序可以使用三种方法跳过开屏广告：

1. 关键字。在应用中查找含有关键字的按钮，如果发现了对应的按钮，自动帮用户点击从而跳过广告。
2. 应用里指定的控件。当应用工作时，自动查找对应的控件，如果找到则自动点击；
3. 应用里指定的位置。当应用工作时，自动点击对应的区域。

上述三种方法可以在"设置"里做进一步配置。


## 下载程序

发布顺序由快到慢：

1. Github自动编译结果: [自动编译结果](https://github.com/zfdang/Android-Touch-Helper/releases)
2. 从本网站下载：[v2023.05.19](TouchHelper-release-v2023.05.19.apk)
3. Google Play Store: [开屏跳过](https://play.google.com/store/apps/details?id=com.zfdang.touchhelper)

## 程序演示和截图

[视频演示](touch_helper.mp4)

[Youtube](https://www.youtube.com/watch?v=_Ko-HM7sFps)

### 截图

<p>
<img src="images/status.jpeg" width="200">
<img src="images/settings.jpeg" width="200">
<img src="images/keyword.jpeg" width="200">
<img src="images/customization_2.jpeg" width="200">
<img src="images/about.jpeg" width="200">
</p>

## 常见问题

### 1. 程序无法正常工作？

因为程序需要始终在后台运行，所以需要适当的设置，才能让程序正常工作。

点击这里查看具体的解决方法：

[设置程序](/enable)

### 2. 在一些不含广告的应用里频繁提示跳过

那是因为程序在应用里发现了关键字。如果问题严重，请将应用添加到“白名单”里

<p>
<img src="whitelist.jpeg" width="250">
</p>

### 3. 跳过广告的高级设置

除了关键字外，程序支持对一些特殊的应用，指定控件或者位置，然后程序会自动点击对应的控件或者位置，帮助用户实现某些目标。

点击这里查看具体的设置方法：

[广告跳过高级设置](/settings)

## 赞助声明
本项目由 [ZMTO](https://zmto.com/) 的「开源项目免费 VPS计划」提供算力支持。 感谢 ZMTO 对开源社区的支持！

## 发现问题？

请在Github项目页创建Issue:

[Android Touch Helper](https://github.com/zfdang/Android-Touch-Helper)

---

### Enable (`docs/enable.md`)

开屏跳过是基于安卓的无障碍服务实现的，是一种在后台随时运行的程序。但是因为安卓系统的多样性，某些情况下程序可能会被中止运行，导致无法跳过广告。

如果出现这种问题，请检查下面的几个可能原因：


## 1. 在无障碍设置里开启本服务

安卓系统的Accessibility服务，可能会被翻译成”无障碍"服务，或者“辅助功能”等。

需要在系统设置里，启用“开屏跳过"服务。

### 步骤1

<p><img src="images/enable_accessibility-1.jpeg" width="250"></p>

### 步骤2
<p><img src="images/enable_accessibility-2.jpeg" width="250"></p>

### 步骤3
<p><img src="images/enable_accessibility-3.jpeg" width="250"></p>


## 2. 在电源优化里选择不优化本程序

安卓系统会对应用进行电源优化。请将本程序的电源优化设置成“不优化”。

<p><img src="images/power-optimization.jpeg" width="250"></p>

此项设置为标准安卓系统都有的设置，但各个ROM并非完全遵守此设定。

## 3. 在特定ROM的电池管理里将本程序加入白名单

各品牌的手机往往会有自己的电池管理方法，需要将本程序添加到ROM自己的电池管理白名单里。

#### 3.1 VIVO系统

设置路径为：设置 -> 电池  -> 后台耗电管理

**设置“开屏跳过”为“允许后台高耗电”**

<p><img src="images/vivo_battery.jpeg" width="250"></p>

### 3.2 OPPO系统

设置路径为：设置 -> 电池  -> 应用耗电管理 -> 开屏跳过，打开“允许完全后台行为”，打开“允许应用自启动”

<p><img src="images/oppo_battery.png" width="250"></p>


### 3.3 小米系统

貌似不需要单独设置这个，系统会遵循第二项的设置

设置路径为：设置 -> 应用设置 -> 应用管理 -> 开屏跳过 ->省电策略: 无限制; 自启动：允许

<p><img src="images/xiaomi_battery.png" width="250"></p>

### 3.4 华为系统

设置路径： 设置 -> 应用和服务 -> 应用启动管理 -> 开屏跳过 -> 关闭“自动管理”，手工管理里允许“自启动”，允许“后台活动”

<p><img src="images/huawei_battery_1.png" width="250"></p>

<p><img src="images/huawei_battery_2.png" width="250"></p>

### 3.5 三星系统
两种方式，效果貌似是相同的。

设置路径1： 设置 -> 应用程序 -> 开屏跳过 -> 电池 -> 允许后台活动
<p><img src="images/samsung_battery_1.png" width="250"></p>

设置路径2：设置 -> 常规管理 -> 电池 -> 后台活动限制  -> 自动运行应用程序, 打开“开屏跳过”
<p><img src="images/samsung_battery_2.png" width="250"></p>


## 4. 在任务管理或者后台清理程序里豁免本程序

请在任务管理，或者后台清理程序里，将本程序锁定，避免被误杀。

<p><img src="images/task-lock.jpeg" width="250"></p>



如果有其他问题，请在GitHub项目里提交issue:
[Github Issues](https://github.com/zfdang/Android-Touch-Helper/issues)

---

### Settings (`docs/settings.md`)

## 跳过广告的高级设置

“开屏跳过”可以使用三种方法跳过开屏广告：

1. 关键字。在应用中查找含有关键字的按钮，如果发现了对应的按钮，自动帮用户点击从而跳过广告。
2. 应用里指定的控件。当应用工作时，自动查找对应的控件，如果找到则自动点击；
3. 应用里指定的位置。当应用工作时，自动点击对应的区域。

如果你发现有些应用的广告无法跳过，你可以尝试使用下述的三种方法。

### 1. 定制关键字

缺省的关键字是：

1. 跳过

程序会查找所有含有这个关键字的控件，然后自动点击控件，帮用户跳过广告。如果目标应用使用的不是这些关键字，您可以在“设置”里增加新的关键字。

*如果控件的名字是"跳过 3"，或者“跳过广告 5"，程序也是可以找到控件并跳过广告的。*

<p>
<img src="images/keyword.jpeg" width="250">
</p>


### 2. 给目标应用增加指定的控件

我们可以在目标应用启动的时候，通过选择目标应用里的控件，然后添加到“开屏跳过”里，这样程序在下次启动应用的时候，就可以找到对应的控件，并点击跳过广告。

[演示视频](customize_activity.mp4)

步骤如下：

#### 2.1 在“设置”里，选择“添加程序的跳过方法”，将显示一个工具条，工具条可以上下拖动

<p>
<img src="images/customization_1.jpeg" width="250">
</p>

#### 2.2 将目标程序彻底关闭，然后重新启动

#### 2.3 程序启动的过程中，选择工具条里的“显示布局”

#### 2.4 选择目标应用的某个控件，目标控件会被标红。如下图右上角的“跳过”按钮：

<p>
<img src="images/customization_2.jpeg" width="250">
</p>

#### 2.5 点击工具条里的“添加控件”。如果“添加控件”不可用，那说明上一步没有选中控件。

#### 2.6 退出工具条，回到“设置”界面

#### 2.7 到“设置”里，点击“管理已添加按钮的程序”，确认程序已经被正确添加。

<p>
<img src="images/customization_3.jpeg" width="250">
</p>

操作完成！当目标程序再次启动的时候，应该可以根据控件来跳过广告了。

### 3.  给目标应用增加指定的位置

与给目标应用添加控件的方法类似，请参照以上步骤。区别在于使用“显示准心”，“添加坐标”

---

--- METRICS ---
- Files Extracted: 4
- Estimated Token Budget: ~1621 tokens
- Canonical Reference: https://codewiki.google/github.com/zfdang/Android-Touch-Helper