XCoder 技术文档

1. 安装指南

安装 XCoder

要使用 XCoder，首先需要安装 Ruby 包。可以通过以下命令安装：

gem install xcoder

确保你的系统中安装了 XCode 4.6 以及 Mountain Lion 上的 Ruby 1.9。虽然 XCoder 可能与其他版本有所兼容，但并未对这些版本做特别支持。

依赖项

XCoder 依赖于以下环境：

• XCode 4.6
• Ruby 1.9
• Mountain Lion

2. 项目使用说明

XCoder 是一个 Ruby 的封装，围绕各种 Xcode 工具提供项目和工作区的解析和部分写入支持。XCoder 还支持对钥匙串的操作、打包以及将构建产物上传到 Testflight 和配置文件管理。

示例用法

首先，确保已安装 XCoder gem，然后在你的项目、Rakefile 等文件中引用它：

require 'xcoder'

加载项目

project = Xcode.project('MyProject')  # 可以是项目名称、文件（如 MyProject.xcodeproj）或路径

查找当前目录下的所有项目

Xcode.find_projects.each {|p| puts p.name }

查找项目中的配置

config = Xcode.project(:MyProject).target(:Target).config(:Debug)  # 返回一个 Xcode::Configuration 对象

构建配置

config = Xcode.project(:MyProject).target(:Target).config(:Debug)
builder = config.builder
builder.profile = 'Profiles/MyAdHoc.mobileprovision'
builder.identity = 'iPhone Developer: Ray Hilton'  # 用来签署 IPA 的身份名称（可选）
builder.clean
builder.build

打包构建的 .app

builder.package

这将生成类似 MyProject-Debug-1.0.ipa 和 MyProject-Debug-1.0.dSYM.zip 的文件。

更新构建编号

config.info_plist do |info|
  info.version = info.version.to_i + 1
  info.save
end

使用 Versionomy 管理版本号

建议使用 Versionomy 来更高效地管理构建编号。

3. 项目 API 使用文档

以下是 XCoder 的一些关键 API 的使用说明：

• Xcode.project(name_or_path)：根据名称或路径加载项目。
• Xcode.find_projects：从当前目录向下查找所有项目。
• Xcode.workspace(name_or_path)：加载工作区。
• project.target(name)：获取项目中的目标。
• target.config(name)：获取目标中的配置。
• config.builder：获取用于构建的构建器对象。

更多 API 使用细节，请参考 XCoder 的官方文档。

4. 项目安装方式

XCoder 的安装方式如下：

1. 安装 Ruby 环境。
2. 使用 gem install xcoder 命令安装 XCoder gem。
3. 在你的 Ruby 项目中引用 xcoder。

确保你的开发环境满足 XCoder 的依赖要求。