在树莓派 3 上构建 Swift 3.0_app

概述作者：iAchieved.it，原文链接，原文日期：2016-06-2 译者：pucca601；校对：靛青K；定稿：CMB 有许多小伙伴对在他们的树莓派 3 上构建 Swift 3.0 感兴趣，这篇教程献给那些勇敢的灵魂！在开始之前你需要准备好以下东西：一个树莓派 3 一个容量至少 16GB 的 UHS-I/class 10 microSD 卡（我喜欢性价比高的 Patriot EP Seri

作者：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.115The 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)? yesWarning: 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.swapSetting 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-extractclang: error: unable to execute command: Killedclang: 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-devsudo apt-get install -y clang-3.6sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-3.6 100sudo 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 贡献，感谢小伙伴们所做的这一切。