Wax Loader 技术文档

1. 安装指南

Wax Loader 是 Wax（https://github.com/probablycorey/wax/）的变种版本。为了使用 Wax Loader，您需要先从 GitHub 上下载 Wax Loader 的 zip 文件。解压后将得到 patch.lua 和其他 lua 脚本。

2. 项目使用说明

Wax Loader 支持从 Objective-C 代码中重写方法和直接调用方法，这使得您能够在运行的 iOS 应用程序中动态地更改行为。它已在超过 500 万台设备上证明稳定。

项目示例代码可以在 /patch 文件夹中找到。示例 iOS 项目会在启动前从网址加载补丁（您可能需要在 AppDelegate.m 中更改此网址）。

以下是一个使用前后的对比示例：

原始版本（Objective-C）：

@implementation MainViewController

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return 10;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    UITableViewCell *cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:@"Cell"];
    cell.textLabel.text = [NSString stringWithFormat:@"%d", indexPath.row + 1];
    return cell;
}

@end

补丁版本（Lua）：

waxClass{"MainViewController", UITableViewController}

function tableView_cellForRowAtIndexPath(self, tableView, indexPath)
    local cell = self:ORIGtableView_cellForRowAtIndexPath(tableView, indexPath) -- 原始方法以 'ORIG' 前缀保留
    cell:textLabel():setText("" .. (10 - indexPath:row()))
    cell:detailTextLabel():setText("http://github.com/mmin18")
    cell:textLabel():setTextColor(UIColor:redColor())
    return cell
end

3. 项目 API 使用文档

• waxClass{className, superClassName}: 定义一个新的 Wax 类，继承自给定的超类。
• function className:methodNames(): 定义一个方法，可以使用 Lua 代码重写 Objective-C 类的方法。
• self:ORIGmethodName(): 调用原始的 Objective-C 方法。

4. 项目安装方式

将下载的 Wax Loader zip 文件解压后，将 patch.lua 和其他 lua 脚本放入您的 iOS 项目中，并在适当的位置加载和执行它们。具体来说，在 AppDelegate.m 中的适当位置（例如，在 application:didFinishLaunchingWithOptions: 方法中）添加以下代码来加载补丁：

// 示例代码，您需要替换为实际的 URL
NSString *urlString = @"http://yoururl.com/patch.zip";
NSURL *url = [NSURL URLWithString:urlString];
NSData *data = [NSData dataWithContentsOfURL:url];
NSZipArchive *zip = [[NSZipArchive alloc] initWithData:data];
[zip unzipToDirectory:@"" overwrite:NO];

请根据您的实际项目需求修改以上代码，并确保 lua 脚本能够正确地被加载和执行。