Ruby 包指南

本文档涵盖了编写使用 ruby 的软件的 PKGBUILD 的标准和指南。

包命名

对于库，使用 ruby-$_name (其中 $_name 是上游项目名称)。对于应用程序，使用项目名称 (不带 ruby- 前缀)，并可以选择将 ruby-$_name 添加到 provides。

构建和测试

Ruby 包应从上游源代码构建，这为构建提供了透明的信任链。为确保与现有 Ruby 包集的集成，期望使用 ruby-rake 或 ruby-rspec 来运行测试。

注意要检测项目中版本之间依赖关系的变化，在更新时请仔细查看 .gemspec 或 Gemfile。

模板

PKGBUILD

prepare() {
  cd "${_name}-${pkgver}"

  # update gemspec/Gemfile to allow newer version of the dependencies
  sed --in-place --regexp-extended 's|~>|>=|g' "${_name}.gemspec"
}

build() {
  cd "${_name}-${pkgver}"

  local _gemdir="$(gem env gemdir)"

  gem build "${_name}.gemspec"

  gem install \
    --local \
    --verbose \
    --ignore-dependencies \
    --build-root "tmp_install" \
    "${_name}-${pkgver}.gem"

  # remove unrepreducible files
  rm --force --recursive --verbose \
    "tmp_install/${_gemdir}/cache/" \
    "tmp_install/${_gemdir}/gems/${_name}-${pkgver}/vendor/" \
    "tmp_install/${_gemdir}/doc/${_name}-${pkgver}/ri/ext/"

  find "tmp_install/${_gemdir}/gems/" \
    -type f \
    \( \
      -iname "*.o" -o \
      -iname "*.c" -o \
      -iname "*.so" -o \
      -iname "*.time" -o \
      -iname "gem.build_complete" -o \
      -iname "Makefile" \
    \) \
    -delete

  find "tmp_install/${_gemdir}/extensions/" \
    -type f \
    \( \
      -iname "mkmf.log" -o \
      -iname "gem_make.out" \
    \) \
    -delete
}

check() {
  cd "${_name}-${pkgver}"

  local _gemdir="$(gem env gemdir)"

  GEM_HOME="tmp_install/${_gemdir}" rake test
}

package() {
  cd "${_name}-${pkgver}"

  cp --archive --verbose tmp_install/* "${pkgdir}"

  install --verbose -D --mode=0644 LICENSE --target-directory "${pkgdir}/usr/share/licenses/${pkgname}"
  install --verbose -D --mode=0644 *.md --target-directory "${pkgdir}/usr/share/doc/${pkgname}"
}

技巧与提示

gem 使用 "git ls-files" 来派生要添加的文件

在这种情况下，您可以将以下 sed 命令添加到 prepare() 函数中

# we don't build from a git checkout
sed --in-place --regexp-extended 's|git ls-files|find . -type f -not -path "*/\.git/*"|' "${_name}.gemspec"

上游项目使用 "rspec" 来运行测试

在这种情况下，您可以将 check() 函数中的代码行替换为以下内容

GEM_HOME="tmp_install/${_gemdir}" rspec

参见