BetaBuilder 技术文档

1. 安装指南

系统要求

• 操作系统：macOS（推荐使用10.6及以上版本）
• Xcode：4.0及以上版本（不支持Xcode 3）
• Ruby：系统自带的Ruby即可

安装步骤

1. 打开终端（Terminal.app）。
2. 输入以下命令安装BetaBuilder gem：

   $ gem install betabuilder
   

3. 安装完成后，BetaBuilder即可使用。

2. 项目的使用说明

初始化配置

1. 在项目的根目录下创建一个Rakefile文件（如果还没有的话）。
2. 在Rakefile的顶部添加以下代码，引入rubygems和betabuilder：

   require 'rubygems'
   require 'betabuilder'
   

3. 配置BetaBuilder，示例如下：

   BetaBuilder::Tasks.new do |config|
     # 你的Xcode目标名称
     config.target = "MyGreatApp"
   
     # Xcode配置文件
     config.configuration = "Adhoc"
   end
   

常用任务

• rake beta:build：构建beta版本的App。
• rake beta:package：将beta版本打包为IPA文件。
• rake beta:deploy：部署beta版本到测试平台（如TestFlight）。

自定义命名空间

如果需要为不同的配置设置不同的命名空间，可以使用以下方式：

BetaBuilder::Tasks.new(:my_custom_namespace) do |config|
end

3. 项目API使用文档

配置选项

• config.target：指定Xcode目标名称。
• config.configuration：指定Xcode配置文件（如Adhoc）。
• config.build_dir：指定自定义的构建目录路径。
• config.xcode4_archive_mode：启用Xcode 4的归档模式。
• config.workspace_path：指定Xcode工作区的路径。
• config.scheme：指定Xcode工作区的scheme。
• config.app_name：指定应用名称。

部署策略

TestFlight部署

config.deploy_using(:testflight) do |tf|
  tf.api_token  = "YOUR_API_TOKEN"
  tf.team_token = "YOUR_TEAM_TOKEN"
  tf.generate_release_notes do
    # 返回发布说明
  end
  tf.distribution_lists = %w{Testers Internal}
end

自定义服务器部署

config.deploy_using(:web) do |web|
  web.deploy_to = "http://beta.myserver.co.uk/myapp"
  web.remote_host = "myserver.com"
  web.remote_directory = "/remote/path/to/deployment/directory"
end

4. 项目安装方式

BetaBuilder通过Ruby gem的方式进行安装，具体步骤如下：

1. 打开终端。
2. 输入以下命令安装BetaBuilder：

   $ gem install betabuilder
   

3. 安装完成后，在项目的Rakefile中引入并配置BetaBuilder。

通过以上步骤，您可以顺利安装并使用BetaBuilder来管理和发布iOS应用的Ad-hoc构建版本。