Ruby 软件包指南

Arch 软件包指南

32 位 – CLR – CMake – 交叉编译 – DKMS – Eclipse – Electron – 字体 – Free Pascal – GNOME – Go – Haskell – Java – KDE – 内核模块 – Lisp – Meson – MinGW – Node.js – 非自由 – OCaml – Perl – PHP – Python – R – Ruby – Rust - 安全 – Shell – VCS – Web – Wine

本文档涵盖关于为使用 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

参见