Haskell包指南

本文章或章节需要扩充。

原因： 请通过为 Haskell 软件包创建合理的软件包创建指南来帮助改进本文档。（在 Talk:Haskell package guidelines 中讨论）

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

在此文档编写完成之前，请联系 User:Felixonmars。

包命名

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

注意包名应全为小写。

Architecture

请参阅 PKGBUILD#arch。

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

Source（生效配置）

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

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

请注意，这里使用了自定义的 _hkgname 变量而不是 pkgname，因为 Haskell 包通常以 haskell- 开头。此变量通常可以定义如下：

_hkgname=stm-delay

创建软件包

arch-hs 用于自动化 PKGBUILD 的生成和维护。

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

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

更新软件包

警告 Haskell 包的升级需要特别考虑，并且与其他语言生态系统有显著差异。如果您是 Haskell 打包新手，在尝试更新任何包之前，请仔细阅读本节。

当 Haskell 库更改其构建标志或更新时，所有依赖于它的包及其传递依赖项，包括 makedepends 和 checkdepends，都需要重新构建。有关确定正确的重建顺序，请参阅下面的子章节。

此外，在 Haskell 生态系统中，最新的库版本经常无法协同工作。因此，建议逐步、小批量地升级包，并阅读上游的更改日志以识别潜在的上游问题。对于具有不可忽略的逆向依赖链的包尤其如此。有时，不兼容性可能仅在重建过程中才会被发现，并且可能难以修复；在这种情况下，最好回滚更改，并在相关的 bumpbuddy ticket 中记录不兼容性。

识别所需更改

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

$ 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

软件包重建

可以使用 genrebuild 工具来查找需要重建的内容以及如何进行。

示例用法

$ ./genrebuild -H haskell-basement

PKGBUILD 库示例

注意强烈建议在添加新包时使用 arch-hs。请参阅上面关于 #Creating packages 的部分。

打包 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"
}