在树莓派 3 上构建 Swift 3.0

做者：iAchieved.it，原文连接，原文日期：2016-06-2
译者：pucca601；校对：靛青K；定稿：CMB

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

在开始以前你须要准备好如下东西：

• 一个树莓派 3

• 一个容量至少 16GB 的 UHS-I/class 10 microSD 卡（我喜欢性价比高的 Patriot EP Series）

• Ubuntu Xenial 16.04

• 耐心

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

安装 Xenial

咱们用 Ubuntu Xenial 代替 Raspbian 。用 curl 或 wget 获取 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

若是你对使用 diskutil 和 dd 命令感到困惑，建议阅读这篇文章。顺便说一句，若是你常常摆弄 Raspberry Pi 而且造成了习惯，wget 、 xzcat 和 dd 命令都是很重要的工具。要熟练操做它们。

更新 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。要正确的使用 swiftc 和 swift 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。