0penPublic/onHit
GitHub: 0penPublic/onHit
onHit是一个Xposed模块，通过系统级注入模拟NFC标签事件，无需物理标签即可触发Android的NDEF数据处理流程。
Stars: 59 | Forks: 6
# 当命中时
[](https://github.com/0penPublic/onHit/releases/latest)
[](https://github.com/0penPublic/onHit/stargazers)
[](https://github.com/Xposed-Modules-Repo/mba.vm.onhit/stargazers)
[](https://github.com/0penPublic/onHit/network/members)
[](GitHub 仓库语言](https://img.shields.io/github/languages/top/0penPublic/onHit?style=flat-square)](https://github.com/0penPublic/onHit/search?l=kotlin)
[](https://t.me/on_hit)
## 什么是 onHit?
这是一个 **Xposed 模块**，用于在 **系统内部模拟 NFC 标签触碰事件**，从而触发系统对 **NDEF 数据** 的解析与分发流程，使目标应用能够像接收到真实 NFC 标签一样处理 NDEF 内容。
模块内置了一个 **简易的文件管理器**，用于：
- 从实体 NFC 标签中读取并保存 **NDEF 数据（原始字节流）**
- 将已保存的 **NDEF 文件**写入实体 NFC 标签
NDEF 的读写过程完全基于 Android 官方公开 API 实现，理论上在不使用 Xposed 的情况下也可独立运行；
Xposed 仅用于实现 **“无实体标签的 NDEF 重放”**，即在系统层直接注入 NFC 触碰事件，这是普通应用无法完成的部分。
## 使用需求
- `Rooted Android device`：已有 Root 权限的 Android 设备
- `Dreamland` 或 `LSPosed` 等环境：`Dreamland` 或 `LSPosed` 之类的环境
- 具有 AOSP 类似 NFC 框架的 Android 系统（部分手机厂商私有的实现可能无法使用）
## 如何使用
1. **安装 onHit 应用程序**：安装 onHit 应用。
2. **启用模块**：在 *Xposed 环境*中激活 `onHit` 并勾选 **NFC 服务** (`com.android.nfc`)。
3. **设置存储**：打开 `onHit` 并选择一个用于存放 NDEF 文件的文件夹。
4. **导入**：从实体 NFC 标签或本地文件*导入 NDEF 数据*。
5. **（需要 Xposed）重放/模拟**：在文件列表中点击 NDEF 文件。模块将触发 Android 系统的 NFC 分发流程。
## 限制
- 强烈依赖于 Android 版本和厂商 NFC 实现
- 部分 OEM 框架可能修改或限制 NFC 内部机制
- 不适用于生产环境
- 不保证跨设备或 ROM 的兼容性
## 法律与伦理声明
本项目仅用于**研究、学习和测试目的**。
请勿使用本项目：
- 未经授权绕过安全机制
- 攻击或冒充现实世界的 NFC 系统
- 违反法律、服务条款或隐私政策
您对本软件的使用负全部责任。
## 许可证
本项目基于 **GNU General Public License v2.0 (GPLv2)** 授权。
您可以在 GPLv2 条款下使用、修改和重新分发本软件。
任何衍生作品也必须在同一许可证下分发。
完整的许可证文本请参见 `LICENSE` 文件。
## 星标历史
[](https://github.com/0penPublic/onHit/releases/latest)
[](https://github.com/0penPublic/onHit/stargazers)
[](https://github.com/Xposed-Modules-Repo/mba.vm.onhit/stargazers)
[](https://github.com/0penPublic/onHit/network/members)
[](GitHub 仓库语言](https://img.shields.io/github/languages/top/0penPublic/onHit?style=flat-square)](https://github.com/0penPublic/onHit/search?l=kotlin)
[](https://t.me/on_hit)
标签：Android, Android开发, DSL, Kotlin, NDEF数据, NFC技术, NFC模拟, SOC Prime, Xposed框架, Xposed模块, 事件触发, 开发工具, 文件管理器, 无物理标签, 标签写入, 标签读取, 模拟输入, 测试工具, 目录枚举, 移动安全, 系统模拟, 网络调试, 自动化