Wax 项目技术文档

1. 安装指南

1.1 环境要求

• 操作系统：macOS
• 开发工具：Xcode
• 依赖管理工具：CocoaPods

1.2 安装步骤

1. 安装CocoaPods
   如果你还没有安装CocoaPods，可以通过以下命令安装：

   sudo gem install cocoapods
   

2. 创建Podfile
   在你的项目目录下创建一个名为Podfile的文件，并在其中添加以下内容：

   platform :ios, '9.0'
   use_frameworks!
   
   target 'YourTargetName' do
     pod 'Wax', :git => 'https://github.com/alibaba/wax.git'
   end
   

3. 安装Wax
   在终端中运行以下命令，安装Wax：

   pod install
   

4. 打开项目
   安装完成后，使用Xcode打开生成的.xcworkspace文件，开始使用Wax。

2. 项目使用说明

2.1 概述

Wax是一个框架，允许你使用Lua编写原生iPhone应用。它通过Objective-C运行时桥接了Objective-C和Lua，使得你可以在Lua中使用Objective-C的所有功能。

2.2 基本用法

2.2.1 创建一个UIView并设置背景颜色

view = UIView:initWithFrame(CGRect(0, 0, 320, 100))
view:setBackgroundColor(UIColor:redColor())

2.2.2 调用带有多个参数的方法

UIApplication:sharedApplication():setStatusBarHidden_animated(true, false)

2.2.3 发送HTTP请求

url = "http://search.twitter.com/trends/current.json"
wax.http.request{url, callback = function(body, response)
    puts(response:statusCode())
    puts(body)
end}

3. 项目API使用文档

3.1 类与方法

3.1.1 waxClass

用于定义一个新的Objective-C类，继承自指定的父类。

waxClass["MyController", UIViewController]

3.1.2 toblock

将Lua函数转换为Objective-C块。

UIView:animateWithDuration_animations_completion(1, toblock(function()
    label:setCenter(CGPoint(300, 300))
end), toblock(function(finished)
    print('lua animations completion ' .. tostring(finished))
end, ["void", "BOOL"]))

3.2 数据类型转换

3.2.1 toobjc

将Lua值转换为Objective-C对象。

local testString = "Hello lua"
local bigFont = UIFont:boldSystemFontOfSize(30)
local size = toobjc(testString):sizeWithFont(bigFont)

4. 项目安装方式

4.1 通过CocoaPods安装

如前所述，通过CocoaPods安装Wax是最简单的方式。只需在Podfile中添加Wax的依赖，然后运行pod install即可。

4.2 手动安装

如果你不想使用CocoaPods，也可以手动将Wax的源代码添加到你的项目中：

1. 克隆Wax仓库：

   git clone https://github.com/alibaba/wax.git
   

2. 将Wax的源代码文件夹拖入你的Xcode项目中。
3. 确保在项目设置中正确配置了Wax的依赖项。

通过以上步骤，你就可以在你的项目中使用Wax框架，享受Lua带来的灵活性和便捷性。