Releasy 技术文档

2024-12-26 09:48:46作者：昌雅子Ethen

1. 安装指南

1.1 安装 Releasy

Releasy 是一个用于自动化发布 Ruby 应用程序的工具，适用于非 Ruby 用户。你可以通过以下命令安装 Releasy：

$ gem install releasy

1.2 外部依赖

Releasy 依赖于一些外部工具，以下是安装这些工具的指南：

1.2.1 7-Zip

Releasy 需要使用 7z 命令来进行压缩和解压缩操作。你可以通过以下方式安装 7-Zip：

OS X (Homebrew):
```
$ brew install p7zip
```
Ubuntu/Debian:
```
$ sudo apt-get install p7zip-full
```
Windows:
- 32 位系统：Releasy 自带了 32 位的 7z 可执行文件。
- 64 位系统：你可以安装 64 位的 7-Zip 以获得更好的性能。

1.2.2 InnoSetup (仅限 Windows)

如果你需要在 Windows 上构建安装包，你需要安装 InnoSetup。

1.2.3 RubyInstaller (仅限 OS X/Linux)

如果你在非 Windows 系统上构建 Windows 可执行文件，你需要下载 RubyInstaller 7-ZIP 压缩包。

2. 项目的使用说明

2.1 配置 Rakefile

在你的 Ruby 项目中，你需要配置 Rakefile 来使用 Releasy。以下是一个示例配置：

require 'rubygems'
require 'bundler/setup' # Releasy 要求使用 Bundler
require 'releasy'

Releasy::Project.new do
  name "My Application"
  version "1.3.2"
  verbose # 如果你不想看到所有构建消息，可以移除这行

  executable "bin/my_application.rb"
  files "lib/**/*.rb", "config/**/*.yml", "media/**/*.*"
  exposed_files "README.html", "LICENSE.txt"
  add_link "http://my_application.github.com", "My Application website"
  exclude_encoding # 如果你的应用不使用高级编码（如日文字符），可以使用这个选项来减少构建大小

  # 创建适用于所有平台的发布版本
  add_build :osx_app do
    url "com.github.my_application"
    wrapper "wrappers/gosu-mac-wrapper-0.7.41.tar.gz" # 假设这是你下载的文件路径
    icon "media/icon.icns"
    add_package :tar_gz
  end

  add_build :source do
    add_package :"7z"
  end

  add_build :windows_folder do
    icon "media/icon.ico"
    executable_type :windows # 假设你不想在运行时显示控制台窗口
    add_package :exe # Windows 自解压压缩包
  end

  add_build :windows_installer do
    icon "media/icon.ico"
    start_menu_group "Spooner Games"
    readme "README.html" # 安装后询问用户是否查看 readme
    license "LICENSE.txt" # 安装前要求用户阅读并确认许可协议
    executable_type :windows # 假设你不想在运行时显示控制台窗口
    add_package :zip
  end

  add_build :windows_wrapped do
    wrapper "wrappers/ruby-1.9.3-p0-i386-mingw32.7z" # 假设这是你下载的文件路径
    executable_type :windows # 假设你不想在运行时显示控制台窗口
    exclude_tcl_tk # 假设你的应用不使用 Tcl/Tk，可以使用这个选项来减少构建大小
    add_package :zip
  end

  add_deploy :local # 仅本地部署
end

2.2 生成的 Rake 任务

配置完成后，Releasy 会生成一系列 Rake 任务。你可以通过 rake -T 查看所有可用的任务。以下是一些常见的任务示例：

rake build                                # 构建 My Application 1.3.2
rake build:osx                            # 构建所有 OS X 版本
rake build:osx:app                        # 构建 OS X 应用
rake build:source                         # 构建源代码版本
rake build:windows                        # 构建所有 Windows 版本
rake build:windows:folder                 # 构建 Windows 文件夹版本
rake build:windows:installer              # 构建 Windows 安装包
rake deploy                               # 部署 My Application 1.3.2
rake deploy:osx:app:tar_gz:local          # 本地部署 OS X 应用的 .tar.gz 包
rake deploy:source:7z:local               # 本地部署源代码的 .7z 包
rake deploy:windows:folder:exe:local      # 本地部署 Windows 文件夹的 .exe 包
rake deploy:windows:installer:zip:local   # 本地部署 Windows 安装包的 .zip 包
rake package                              # 打包 My Application 1.3.2
rake package:osx:app:tar_gz               # 打包 OS X 应用的 .tar.gz 包
rake package:source:7z                    # 打包源代码的 .7z 包
rake package:windows:folder:exe           # 打包 Windows 文件夹的 .exe 包
rake package:windows:installer:zip        # 打包 Windows 安装包的 .zip 包