作者:iAchieved.it,原文链接,原文日期:2016-06-2
译者:pucca601;校对:靛青K;定稿:CMB

有许多小伙伴对在他们的树莓派 3 上构建 Swift 3.0 感兴趣,这篇教程献给那些勇敢的灵魂!

在开始之前你需要准备好以下东西:

显然这是可以做到的;而且我们已经做到了,并且还有其他小伙伴也对基于 ARM 的设备上构建 Swift 程序作出了贡献。所以别放弃。不过就算你放弃了我们也不会说什么,直接下载我们的 prebuilt Swift 3.0 package for the Raspberry Pi 2 and 3 吧。

安装 Xenial

我们用 Ubuntu Xenial 代替 Raspbian 。用 curlwget 获取 Xenial,然后用 dd 将文件系统写入 microSD 卡。

注意:请确保阅读此警告。你必须替换下文提到的 YOUR_DEVICE 为正确的设备名。如果不替换成正确的名字,你的数据可能会毁坏(它们调用 dd 清除你的文件)。

使用 Linux

# wget http://www.finnie.org/software/raspberrypi/ubuntu-rpi3/ubuntu-16.04-preinstalled-server-armhf+raspi3.img.xz
# xzcat ubuntu-16.04-preinstalled-server-armhf+raspi3.img.xz | sudo dd of=/dev/YOUR_DEVICE bs=8M

想知道你的 YOUR_DEVICE,你需要将 microSD 卡插入一台装载 Linux 的机器,运行 dmesg|tai 查看类似下面的内容

[1255451.544316] usb-storage 4-2:1.0: USB Mass Storage device detected
[1255451.544466] scsi host25: usb-storage 4-2:1.0
[1255452.545332] scsi 25:0:0:0: Direct-Access Generic STORAGE DEVICE 0817 PQ: 0 ANSI: 6
[1255452.545670] sd 25:0:0:0: Attached scsi generic sg8 type 0
[1255452.828405] sd 25:0:0:0: [sdh] 15523840 512-byte logical blocks: (7.94 GB/7.40 GiB)
[1255452.829402] sd 25:0:0:0: [sdh] Write Protect is off
[1255452.829409] sd 25:0:0:0: [sdh] Mode Sense: 23 00 00 00
[1255452.830400] sd 25:0:0:0: [sdh] Write cache: disabled, read cache: enabled, doesn't support DPO or FUA
[1255452.835967] sdh: sdh1
[1255452.840401] sd 25:0:0:0: [sdh] Attached SCSI removable disk

在这个例子中,你的设备是 /dev/sdh

使用 OS X (macOS)

我个人喜欢用一个单独的 Linux 服务器进行这些操作,但你也可以在一台 Mac 上使用 homebrew 完成这些操作:

# brew install wget xz
# wget http://www.finnie.org/software/raspberrypi/ubuntu-rpi3/ubuntu-16.04-preinstalled-server-armhf+raspi3.img.xz
# xzcat ubuntu-16.04-preinstalled-server-armhf+raspi3.img.xz|sudo dd of=/dev/rdisk3 bs=8m

注意到当在 Mac 上操作 dd,使用 /dev/rYOUR_DEVICE 会更明智。使用 /dev/YOUR_DEVICE 的速度很慢,详细解释见这里

要在 Mac 上找到 YOUR_DEVICE,插入 microSD 卡并且在终端运行 diskutil list 。寻找匹配你 SD 卡大小的磁盘(如果你有其他相同大小可匹配的磁盘,记得查看其他属性保证你找到的磁盘是对的)。

# diskutil list
...
/dev/disk5 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: FDisk_partition_scheme *16.0 GB disk5
1: Windows_FAT_32 system-boot 134.2 MB disk5s1
2: Linux 15.9 GB disk5s2

如果你对使用 diskutildd 命令感到困惑,建议阅读这篇文章。顺便说一句,如果你经常摆弄 Raspberry Pi 并且形成了习惯,wgetxzcatdd 命令都是很重要的工具。要熟练操作它们。

更新 Xenial

好啦,既然你有一个装着 Xenial 的 microSD 卡,就可以直接塞进树莓派 3 启动它!没错就是这样,然后我们假设你有一个以太网接口或者 miniUSB 接口连接网络。你可以先尝试用 ssh ubuntu@ubuntu.local 远程登录你的树莓派,如果失败了,你可以打开路由器的 LAN 页面确认一下 IP 地址。默认密码是 ubuntu

# ssh ubuntu@192.168.1.115
The authenticity of host '192.168.1.115 (192.168.1.115)' can't be established.
ECDSA key fingerprint is 62:e9:f9:09:d0:30:3c:c9:0e:47:a3:42:f5:2c:e2:ae.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.1.115' (ECDSA) to the list of known hosts.
ubuntu@192.168.1.115's password:
You are required to change your password immediately (root enforced)
Welcome to Ubuntu 16.04 LTS (GNU/Linux 4.4.0-1009-raspi2 armv7l)
...
WARNING: Your password has expired.
You must change your password now and login again!
Changing password for ubuntu.
(current) UNIX password:

一旦你修改了密码,你需要用 ubuntu 用户重新登录并且更新系统:

# sudo apt-get update && sudo apt-get upgrade -y
# reboot

安装构建所需的依赖

编译 Swift 需要很多依赖。可以用如下命令一次性搞定:

# sudo apt-get install -y git cmake ninja-build clang uuid-dev libicu-dev icu-devtools libbsd-dev libedit-dev libxml2-dev libsqlite3-dev swig libpython-dev libncurses5-dev pkg-config

幸运地是我们不用自己一个个去寻找依赖(你知道的,那些一次又一次下载一个目录尝试构建它后才发现缺少的依赖),因为这些依赖全都列在了 Open Source Swift README 里。

我也喜欢包含 htop 这样我就可以看看树莓派编译出的进程信息:

添加一些 Swap 分区

尽管派 3 自带 1GB 的高容量 RAM,依然不够完整的构建 Swift(通常在链接步骤发生问题)。让我们手动添加 1G Swap 分区。

# fallocate -l 1G 1G.swap
# sudo mkswap 1G.swap
Setting up swapspace version 1, size = 1024 MiB (1073737728 bytes)
no label, UUID=184d002a-2f15-4b23-8360-8e792badc6a2
# sudo swapon 1G.swap

以下是你在构建过程中出现 Swap 分区不可用的问题。

cd /root/workspace/Swift-3.0-Pi3-ARM-Incremental/build/buildbot_linux/swift-linux-armv7/bin && /usr/bin/cmake -E create_symlink swift swiftc && cd /root/workspace/Swift-3.0-Pi3-ARM-Incremental/build/buildbot_linux/swift-linux-armv7/bin && /usr/bin/cmake -E create_symlink swift swift-autolink-extract
clang: error: unable to execute command: Killed
clang: error: linker command failed due to signal (use -v to see invocation)
ninja: build stopped: subcommand failed.
./swift/utils/build-script: fatal error: command terminated with a non-zero exit status 1, aborting

在一个 microSD 卡上利用 Swap 分区双倍扩容 RAM 并不是通用的办法。一旦我们进入到构建阶段需要我们染指 Swap 分区时,构建过程会变慢。但是不使用分区程序,其代价是以内存不足为错误提示崩溃。

使用 package-swift

package-swift 是我们的 Github 目录,内含一些辅助脚本使得构建 Swift 更便捷。

# git clone https://github.com/iachievedit/package-swift
# cd package-swift

默认情况下 package-swift 会迁出一个 swift-3.0 的分支。脚本都非常简单:

  • get.sh – 下载所有构建 Swift 需要的目录
  • update.sh – 从 Github 上更新所有的本地目录
  • patch.sh – 应用 Swift on ARM 团队推出的最新补丁;我们必须时不时的更新保证可运行。一旦补丁不再需要我们就移除它,所以在实际的构建之前需要先 git pull 保证所有补丁包最新。
  • package.sh – 运行 Swift 的构建脚本,预设脚本名为 buildbot_linux_armv7

我建议你看看每个 shell 脚本,在执行前弄清它们的逻辑。脚本看上去很简单,但是花时间去弄懂它们还是相当值得的。请注意在 get.sh 和 update.sh 中会检到我们的构建是在 ARMv7 处理器上,所以我们需要 William Dillon 的 swift-llvm fork

开始构建

请确保你有:

  • 安装所有依赖包
  • 激活 1 GB Swap 分区
  • 已经从 Github 克隆的 package-swift

现在,克隆所有需要的目录:

# cd package-swift
# ./get.sh

这个步骤我在我的 SD 卡上用了 15 分钟下载和写入所有东西。

紧接着,打补丁。获取 Swift on ARM 团队开发测试过的最新的补丁是非常重要的一步。这些补丁时不时就会改变,所以请保证实时更新它们。

# ./patch.sh

现在开始编译。Swift on ARM 团队使用 Jenkins 运行这个脚本,在这之上的构建工作是没有日志的。但是如果你使用 nohup 来确保你的编译正在进行,即使你的终端断线了也能知道。

# nohup ./package.sh > swiftbuild.log&

现在,只需要等待!整个构建过程至少 6 个小时。然而等待的成果是值得的,最后奖励是 swift.tar.gz bundle,可以在跑着 Ubuntu Xenial 的树莓派 2 或 3 上安装(不要尝试在装了 Raspbian 的机器上安装,不然你会失望的)。我选择像这样在 /opt/swift/ 安装 Swift:

# cd /opt
# mkdir -p swift/swift-3.0
# cd swift/swift-3.0
# tar -xzvf /path/to/swift.tar.gz

然后你可以用 export PATH=/opt/swift/swift-3.0/usr/bin:$PATH 设置 PATH。要正确的使用 swiftcswift build 还需要运行以下命令:

sudo apt-get install -y libicu-dev
sudo apt-get install -y clang-3.6
sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-3.6 100
sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-3.6 100

需要帮助

你的第一次构建往往会失败的。事实上,在 ARM 设备上例如树莓派 2 和 3 上构建可能会持续很长时间一团糟一直到有人能够修理它们。如果你有什么编译问题,请大胆的发邮件到 admin@iachieved.it,我们会邀请你到 Swift for ARM Slack 社区来讨论你的问题。

致谢

我应该单独为此写一页;许多小伙伴在推动在 ARM 设备上运行 Swift 作出了很多贡献。像 PJ 开创了 树莓派 1 上构建 Swift 的先河,以及任何一篇文章都离不开的 William Dillon’s 贡献,感谢小伙伴们所做的这一切。

本文由 SwiftGG 翻译组翻译,已经获得作者翻译授权,最新文章请访问 http://swift.gg

文章目录
  1. 1. 安装 Xenial
  2. 2. 使用 Linux
  3. 3. 使用 OS X (macOS)
  4. 4. 更新 Xenial
  5. 5. 安装构建所需的依赖
  6. 6. 添加一些 Swap 分区
  7. 7. 使用 package-swift
  8. 8. 开始构建
  9. 9. 需要帮助
  10. 10. 致谢