H5GG iOS模组引擎完整使用指南

H5GG是一款专为iOS设备设计的模组引擎，通过JavaScript API和HTML5界面提供了强大的修改能力。该引擎允许开发者在非越狱与越狱设备上，利用JavaScript编写脚本来影响游戏或其他应用的行为，无需深入原生代码。

项目介绍

H5GG支持加载本地或网络上的JS与HTML文件，动态加载dylib插件以扩展API功能，并具备自动搜索内存指针和偏移值的能力。其独特之处在于可以自定义UI界面，即便是没有电脑的情况下也能通过HTML+CSS来实现，并且提供了一键制作自定义插件的功能。

环境要求

• 操作系统: macOS或Linux（推荐使用macOS进行iOS开发）
• Xcode: 需要最新版本或指定兼容版本
• Git: 用于克隆项目代码
• iOS开发者账号（可选，仅当需要签名应用或测试非越狱设备时）

安装步骤

1. 克隆项目

首先需要将项目克隆到本地：

git clone https://gitcode.com/gh_mirrors/h5/H5GG.git

这将在当前目录下创建名为H5GG的文件夹，包含项目的所有源代码。

2. 项目结构说明

H5GG项目包含多个重要目录：

• examples-JavaScript/ - JavaScript示例脚本
• examples-HTML5/ - HTML5界面示例
• examples-h5frida/ - Frida集成示例
• pluginDemo/ - 插件开发示例
• pictures/ - 项目截图和说明图片

3. 编译和安装

H5GG支持4种运行模式：

模式1：注入H5GG.dylib到ipa（非越狱设备） 适用于非越狱设备，需要将H5GG.dylib注入到目标应用的ipa文件中。

模式2：Tweak自动加载（越狱设备） 通过deb包形式安装，H5GG会自动加载到所有应用中。

模式3：独立应用（越狱设备） 作为独立应用运行，兼容iPad的SlideOver和SplitView功能。

模式4：悬浮窗口（越狱设备） 以悬浮窗口形式运行，不支持iPad的分屏功能，支持iOS 11-14。

核心功能特性

JavaScript引擎API

H5GG提供了丰富的JavaScript API，类似于Android GG的Lua接口：

// 基本内存操作
h5gg.searchNumber('数值', '类型', '搜索下限', '搜索上限');
h5gg.getValue('地址', '类型');
h5gg.setValue('地址', '数值', '类型');
h5gg.editAll('数值', '类型');

// 插件加载
h5gg.loadPlugin('OC类名', 'dylib路径');

// 界面控制
setButtonImage(图标);
setWindowRect(x, y, 宽度, 高度);
setWindowVisible(显示状态);

数据类型支持

• 浮点类型：F32、F64
• 有符号数：I8、I16、I32、I64
• 无符号数：U8、U16、U32、U64

h5frida官方插件

H5GG集成了h5frida插件，提供强大功能：

• 调用任意C/C++/Objective-C函数（无需越狱）
• Hook任意模块的Objective-C方法（无需越狱）
• Hook任意模块的C/C++导出函数（无需越狱）
• 代码动态补丁（无需越狱）

自定义UI开发

H5GG允许完全自定义用户界面，使用HTML+CSS即可创建个性化的操作界面：

<!-- 示例：简单的控制按钮 -->
<div class="control-panel">
    <button onclick="searchValue()">搜索数值</button>
    <button onclick="modifyValue()">修改数值</button>
</div>

在EasyHtml中设计界面

可以使用EasyHtml应用（AppStore可下载）在iPhone/iPad上直接设计H5GG的HTML菜单界面：

调试技巧

可以通过macOS Safari远程调试运行在iOS设备上的H5GG JavaScript/HTML代码：

1. 确保宿主应用具有get-task-allow权限（越狱设备或开发者证书签名）
2. 在Safari中开启开发菜单
3. 连接到iOS设备进行实时调试

依赖项说明

H5GG的全局视图模块需要以下依赖项，可能需要根据iOS版本进行更新：

• BackgrounderAction：适用于iOS 11-12
• BackgrounderAction2：适用于iOS 13+
• libAPAppView：适用于iOS 13+

JavaScript引擎文档

完整的JavaScript API文档包含在h5gg-js-doc.js文件中，提供了详细的接口说明和使用示例。建议开发前仔细阅读该文档。

注意事项

1. 地址参数支持十进制或0x开头的十六进制格式自动识别
2. 搜索结果较多时不要一次性获取全部数据，应分段获取避免内存溢出
3. JavaScript中数组索引从0开始，与Lua的从1开始不同
4. 数字运算前需用Number()进行类型转换
5. 悬浮窗默认尺寸为370x370，可通过API调整

H5GG是一个完全免费开源的项目，为iOS设备提供了强大的内存修改和界面定制能力，无论是游戏修改还是应用调试都能发挥重要作用。