SwiftPango 是 pango-1.x 的 Swift 封装，主要通过 gobject-introspection 自动生成。如需最新的（自动生成）参考文档，请访问 https://rhx.github.io/SwiftPango/
gir2swift 的 15 版本提供了一个 Package Manager 插件。这需要 Swift 5.6 或更高版本。（旧版本可以通过 swift52 分支使用）。
要构建，请从 https://swiftlang.cn/download/ 下载 Swift -- 如果您使用的是 macOS，请确保您也安装了命令行工具）。使用 swift --version 测试您的编译器是否工作正常，它应该给出类似如下的输出：
$ swift --version
swift-driver version: 1.75.2 Apple Swift version 5.8 (swiftlang-5.8.0.124.2 clang-1403.0.22.11.100)
Target: arm64-apple-macosx13.0
在 macOS 上，或者在 Linux 上，您应该得到类似如下的输出：
$ swift --version
Swift version 5.8.1 (swift-5.8.1-RELEASE)
Target: x86_64-unknown-linux-gnu
这些 Swift 封装已经过 pango-1.40、1.42、1.44、1.46、1.48 和 1.50 以及 harfbuzz-4.2 和 glib-2.56、2.58、2.60、2.62、2.64、2.66、2.68、2.70、2.72、2.74 和 2.76 的测试。它们应该适用于更高版本，但 YMMV（个人体验可能不同）。 另外请确保您已安装 gobject-introspection 及其 .gir 文件。
在 Ubuntu 18.04 和 20.04 上，您可以使用发行版自带的 gtk。只需使用 apt 包管理器安装即可。
sudo apt update
sudo apt install libpango1.0-dev gir1.2-pango-1.0 libharfbuzz-dev gir1.2-harfbuzz-0.0 gobject-introspection libgirepository1.0-dev libxml2-dev jq
在 Fedora 29 上，您可以使用发行版自带的 gtk。只需使用 dnf 包管理器安装即可。
sudo dnf install pango-devel harfbuzz-devel glib2-devel gobject-introspection-devel libxml2-devel
在 macOS 上，您可以使用 HomeBrew 安装 glib 和 Pango（有关安装说明，请参阅 https://brew.sh.cn）。一旦您安装并运行了 HomeBrew，您就可以使用它来安装 cairo 的原生版本。
brew update
brew install pango harfbuzz glib glib-networking gobject-introspection pkg-config
通常，您不需要直接构建此软件包（但为了测试，您可以 - 请参阅下面的“构建”）。相反，您需要使用 Swift Package Manager 将 SwiftPango 嵌入到您自己的项目中。在安装前提条件（请参阅下面的“前提条件”）之后，将 SwiftPango 作为依赖项添加到您的 Package.swift 文件中，例如：
// swift-tools-version:5.6
import PackageDescription
let package = Package(name: "MyPackage",
dependencies: [
.package(url: "https://github.com/rhx/gir2swift.git", branch: "main"),
.package(url: "https://github.com/rhx/SwiftPango.git", branch: "main"),
],
targets: [
.target(name: "MyPackage",
dependencies: [
.product(name: "Pango", package: "SwiftPango")
]
)
]
)
通常，您不需要直接构建此软件包，而是将其嵌入到您自己的项目中（请参阅上面的“用法”）。但是，您可以单独构建和测试此模块，以确保一切正常。请确保您已安装所有前提条件（见上文）。之后，您只需克隆此仓库并构建命令行可执行文件（请耐心等待，这将下载所有必需的依赖项并需要一段时间编译），使用：
git clone https://github.com/rhx/SwiftPango.git
cd SwiftPango
swift build
swift test
在 macOS 上，您可以改用 Xcode 构建项目。为此，您需要在 Xcode IDE 中打开软件包。
cd SwiftPango
open Package.swift
之后，使用（通常的）“构建”和“测试”按钮来构建/测试此软件包。
您可以使用 DocC plugin 生成文档。要预览与本地安装匹配的文档，只需运行：
swift package --disable-sandbox preview-documentation
然后导航到本地预览服务器显示的 URL。请确保您的浏览器中已启用 JavaScript。
或者，您可以使用 jazzy 创建静态文档。请确保您已安装 sourcekitten 和 jazzy，例如在 macOS (x86_64) 上：
brew install ruby sourcekitten
/usr/local/opt/ruby/bin/gem install jazzy
./generate-jazzy.sh
这里列出了一些您可能会遇到的常见错误以及如何修复它们。
如果您收到类似如下的错误：
Girs located at
Cannot open '/GLib-2.0.gir': No such file or directory
请确保您已安装相关的 gobject-introspection 软件包（如“前提条件”部分所述），包括它们的 .gir 和 .pc 文件。
如果在您运行 swift build 时，您收到 Segmentation fault (core dumped) 或循环依赖错误，例如：
warning: circular dependency detected while parsing pangocairo: harfbuzz -> freetype2 -> harfbuzz
这可能意味着您的 Swift 工具链太旧，尤其是在 Linux 上。请确保最新的工具链是您运行 Swift 编译器时找到的那个（见上文）。
如果您得到一个旧版本，请确保在您的 PATH 中首先找到正确版本的 swift 编译器。在 macOS 上，使用 xcode-select 来选择和安装最新版本，例如：
sudo xcode-select -s /Applications/Xcode.app
xcode-select --install