Haskell 包指南

本文档旨在涵盖在 Arch 上制作优秀 Haskell 软件包的标准和指南。

在本文档完成之前，请联系 User:Felixonmars。

软件包命名

对于 Haskell 库，请使用 haskell-libraryname，通常与 hackage 上的名称相同。

注意：软件包名称应完全小写。

架构

请参阅 PKGBUILD#arch。

每个 Haskell 库或程序都依赖于架构。

源代码

Haskell 程序或库的首选来源是 hackage。PKGBUILD#source source=() 数组应使用以下 URL 模板

https://hackage.haskell.org/packages/archive/$_hkgname/$pkgver/$_hkgname-$pkgver.tar.gz

请注意，由于 Haskell 软件包通常以 haskell- 为前缀，因此使用自定义的 _hkgname 变量而不是 pkgname。此变量可以通用地定义如下

_hkgname=stm-delay

重建顺序

当 Haskell 库更改其构建标志或更新时，所有依赖的软件包都需要重建。可以使用 genrebuild 工具来找出需要重建的内容以及如何重建。用法示例

$ ./genrebuild -H haskell-basement

使用 arch-hs

提供 arch-hs 以自动化 PKGBUILD 的生成和维护。

为 Hackage 软件包（及其未打包的依赖项）生成一系列 PKGBUILD

$ arch-hs -o /path/to/workdir library_name

比较依赖项和其他打包元数据以更新现有软件包

$ arch-hs-diff library_name old_version new_version

比较 Arch [extra] 软件包版本及其对应的 Hackage 软件包版本

$ arch-hs-sync check

请注意，arch-hs 使用 cabal-install 来维护 Hackage 数据库，因此请定期更新您的cabal-install数据库以保持其新鲜

$ cabal update

PKGBUILD 库示例

打包 Haskell 库与打包 Haskell 程序不同，Arch Linux 中打包的库旨在供打包的 Haskell 程序使用。

PKGBUILD

# Maintainer: Your Name <youremail@domain.com>
_hkgname=stm-delay
pkgname=haskell-stm-delay
pkgver=
pkgrel=1
license=()
arch=('x86_64')
url="https://hackage.haskell.org/package/$_hkgname"
depends=(ghc-libs)
makedepends=(ghc)
source=("https://hackage.haskell.org/packages/archive/$_hkgname/$pkgver/$_hkgname-$pkgver.tar.gz")
sha256sums=()

build() {
  cd "$_hkgname-$pkgver"

  runhaskell Setup configure -O --enable-shared --enable-debug-info --enable-executable-dynamic --disable-library-vanilla \
    --prefix=/usr --docdir="/usr/share/doc/$pkgname" --datasubdir=$pkgname --enable-tests \
    --dynlibdir=/usr/lib --libsubdir=\$compiler/site-local/\$pkgid \
    --ghc-option=-optl-Wl\,-z\,relro\,-z\,now \
    --ghc-option='-pie'

  runhaskell Setup build $MAKEFLAGS
  runhaskell Setup register --gen-script
  runhaskell Setup unregister --gen-script
  sed -i -r -e "s|ghc-pkg.*update[^ ]* |&'--force' |" register.sh
  sed -i -r -e "s|ghc-pkg.*unregister[^ ]* |&'--force' |" unregister.sh
}

check() {
  cd "$_hkgname-$pkgver"
  runhaskell Setup test
}

package() {
  cd "$_hkgname-$pkgver"

  install -D -m744 register.sh "$pkgdir/usr/share/haskell/register/$pkgname.sh"
  install -D -m744 unregister.sh "$pkgdir/usr/share/haskell/unregister/$pkgname.sh"
  runhaskell Setup copy --destdir="$pkgdir"
  install -D -m644 "LICENSE" "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
  rm -f "${pkgdir}/usr/share/doc/${pkgname}/LICENSE"
}