1. 为什么你需要离线编译？从“龟速”到“起飞”的体验

如果你正在用Petalinux做嵌入式开发，尤其是基于Xilinx Zynq或者Versal平台，我猜你一定对那个漫长的编译过程又爱又恨。爱的是它强大的集成能力，恨的是每次执行 petalinux-build 后，看着屏幕上一行行滚动的下载信息，心里那个急啊。网络稍微有点波动，或者某个源站抽风，整个编译就可能卡住，甚至报错失败，一晚上的时间就这么白费了。这种感觉，我太懂了。

这就是典型的在线编译模式。Petalinux基于Yocto项目构建，每次构建时，系统都会从互联网上的各种源（比如SourceForge、GitHub、Kernel.org等）实时下载成千上万个软件包的源代码。这个过程不仅极度依赖网络稳定性，而且速度慢得让人抓狂。更头疼的是，一旦某个上游仓库的链接失效，或者版本更新导致不兼容，你的构建就会直接中断，排查起来非常麻烦。

离线编译，就是为了彻底解决这个问题而生的。它的核心思想很简单：“兵马未动，粮草先行”。我们提前把所有构建过程中需要的“粮草”——也就是源代码包和构建中间状态缓存——一次性下载到本地。之后的所有编译操作，都只从本地读取这些资源，完全摆脱了对互联网的依赖。我实测下来，第一次搭建好离线环境后，后续的工程编译速度能提升好几倍，而且稳定性极高，再也不用看网络的“脸色”了。

所以，这篇文章就是带你一步步搞定Petalinux 2022.2的离线编译环境搭建。这不是一个简单的命令罗列，而是我踩过无数坑之后，总结出的最稳、最全的实战指南。无论你是刚接触Petalinux的新手，还是被在线编译折磨已久的老手，跟着做一遍，你就能拥有一个属于自己的、高效的离线开发堡垒。

2. 战前准备：搭建坚实的Ubuntu基础环境

工欲善其事，必先利其器。离线编译的第一步，不是急着去配置Petalinux，而是要把我们的“作战平台”——Ubuntu系统——给收拾利索了。很多编译错误，根源都出在系统依赖库的缺失或版本不对上。这里我会给出比官方文档更详细的清单和避坑点。

我强烈建议使用 Ubuntu 20.04 LTS 作为宿主系统，这是经过Xilinx官方测试和推荐的版本，兼容性最好。别用太新的发行版，免得遇到一些奇怪的库冲突问题。

2.1 安装完整的系统依赖包

下面这一大串apt-get install命令，请你务必逐条执行。别嫌麻烦，这是为后续一切操作扫清障碍。你可以新建一个脚本文件，一次性粘贴执行。

sudo apt-get update

# 第一组：基础编译工具和Python环境
sudo apt-get install -y iproute2 gawk python3 python3-pip python3-pexpect \
     python3-git python3-jinja2 pylint3

# 第二组：核心开发工具链
sudo apt-get install -y build-essential gcc g++ make git git-core \
     autoconf automake libtool flex bison

# 第三组：系统库和网络工具
sudo apt-get install -y libncurses5-dev libncursesw5-dev zlib1g-dev \
     zlib1g:i386 libssl-dev libselinux1 gnupg net-tools tftpd-hpa \
     chrpath socat xterm texinfo debianutils iputils-ping

# 第四组：图形和多媒体库（用于支持一些工具的GUI和显示）
sudo apt-get install -y libsdl1.2-dev libsdl2-dev xvfb x11-utils \
     libgl1-mesa-dev libglu1-mesa-dev libegl1-mesa-dev

# 第五组：归档和文件处理工具
sudo apt-get install -y gzip bzip2 tar unzip cpio xz-utils lz4 zstd \
     diffstat screen pax

# 第六组：多架构支持（交叉编译必需）
sudo apt-get install -y gcc-multilib g++-multilib

# 最后，清理并确认
sudo apt-get autoremove -y
sudo apt-get clean

注意：执行过程中如果遇到某个包找不到，可能是源的问题。可以尝试换一下Ubuntu的软件源（如阿里云、清华源），然后再次执行 sudo apt-get update。

安装完这些，你的系统基础环境就差不多了。这里有个小技巧，你可以用 dpkg -l | grep -E ‘python3|gcc|make|libssl’ 这样的命令抽查几个关键包，确认是否安装成功。

2.2 安装和配置TFTP服务器

Petalinux在引导内核和设备树时，经常会用到TFTP。虽然离线编译不直接影响它，但一个完整的开发环境离不开它。安装很简单：

sudo apt-get install -y tftpd-hpa

安装后需要配置一下。编辑TFTP配置文件：

sudo vim /etc/default/tftpd-hpa

将其内容修改为类似下面这样，关键是 TFTP_DIRECTORY 要指向一个你有读写权限的目录，我通常放在 /var/lib/tftpboot：

# /etc/default/tftpd-hpa

TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/var/lib/tftpboot"
TFTP_ADDRESS=":69"
TFTP_OPTIONS="--secure --create"

然后创建目录并设置权限，重启服务：

sudo mkdir -p /var/lib/tftpboot
sudo chown -R tftp:tftp /var/lib/tftpboot
sudo chmod -R 777 /var/lib/tftpboot # 为方便起见，开发环境可以给足权限
sudo systemctl restart tftpd-hpa
sudo systemctl status tftpd-hpa # 检查服务是否正常运行

看到 active (running) 就说明TFTP服务器准备好了。以后你要启动开发板并通过网络加载镜像时，就把 image.ub、zynqmp_fsbl.elf 等文件拷贝到这个目录下。

3. 安装Petalinux 2022.2：避开那些恼人的警告

从Xilinx官网下载 petalinux-v2022.2-10141622-installer.run 这个安装文件后，别急着双击。在Linux下，我们需要通过命令行来安装，并且要特别注意安装路径的权限问题。

3.1 运行安装程序

假设你把安装文件放在了 ~/Downloads 目录下。我强烈建议不要把它安装在你的家目录（/home/你的用户名）下，更不要安装在需要sudo权限的系统目录里。最佳实践是创建一个独立的、路径中不带空格的目录，比如 /opt/pkg/petalinux/2022.2。

# 1. 进入安装文件所在目录
cd ~/Downloads

# 2. 给安装文件添加执行权限
chmod +x petalinux-v2022.2-10141622-installer.run

# 3. 执行安装，使用 --dir 指定目标目录
./petalinux-v2022.2-10141622-installer.run --dir /opt/pkg/petalinux/2022.2

这里 --dir 参数至关重要。如果不指定，它会尝试安装到当前目录，可能会引发权限问题，而且官方也不推荐这样做。

3.2 处理安装过程中的交互

运行安装命令后，你会进入一个文本交互界面。过程很简单：

  1. 首先会显示一份很长的许可协议。直接按 q 键退出阅读。
  2. 接着会问 Do you accept Xilinx End User License Agreement?，输入 y 并按回车。
  3. 然后问 Do you agree to the Web Talk terms and conditions?，同样输入 y 并回车。
  4. 最后问 Do you want to send information about your system, feature usage and diagnostic reports to Xilinx?，这个看个人，我一般选 y 或 n 都可以，不影响安装。

安装程序会检查环境。如果之前依赖包没装全，这里会报错。如果TFTP没装，它会警告，但可以继续，我们之前已经装好了，所以这个警告应该不会出现。

安装完成后，最重要的一步是导入Petalinux的环境变量。每次打开新的终端进行开发前，都需要执行：

source /opt/pkg/petalinux/2022.2/settings.sh

为了让这个步骤自动化，你可以把这行命令添加到你的 ~/.bashrc 文件末尾。这样每次登录终端，环境就自动设置好了。

echo “source /opt/pkg/petalinux/2022.2/settings.sh” >> ~/.bashrc
source ~/.bashrc # 立即生效

现在，在终端里输入 petalinux- 然后按Tab键，如果能自动补全一系列命令（如 petalinux-config, petalinux-build），说明安装成功了。

4. 离线编译的核心：构建本地资源仓库

好了，重头戏来了。在线编译慢，是因为要去网上拉取两个最重要的东西：源代码包（Downloads） 和 共享状态缓存（Sstate Cache）。我们的离线策略就是提前把这两样东西备齐。

4.1 获取离线资源包

你需要从Xilinx官网下载两个对应的离线安装包。对于Petalinux 2022.2，通常是这两个：

  • sstate_aarch64_2022.2.tar.gz：这是针对ARM架构（比如Zynq-7000和Zynq UltraScale+ MPSoC）的构建缓存。它包含了大量预编译的中间文件，能极大加速编译。
  • downloads_2022.2.tar.gz：这是源代码包合集，包含了构建Linux系统所需的几乎所有开源软件的源代码压缩包。

把它们下载到你的Ubuntu系统中，比如放到 /opt/xilinx/offline_2022.2/ 目录下。

sudo mkdir -p /opt/xilinx/offline_2022.2
# 假设你把两个压缩包放到了当前目录
sudo mv sstate_aarch64_2022.2.tar.gz /opt/xilinx/offline_2022.2/
sudo mv downloads_2022.2.tar.gz /opt/xilinx/offline_2022.2/

然后解压它们。注意顺序：先创建目标目录，再解压。

cd /opt/xilinx/offline_2022.2

# 解压源代码包，这会创建一个名为 `downloads` 的目录
sudo tar -xzf downloads_2022.2.tar.gz

# 解压状态缓存包，这会创建一个名为 `aarch64` 的目录（根据包名可能略有不同）
sudo tar -xzf sstate_aarch64_2022.2.tar.gz

解压完成后，/opt/xilinx/offline_2022.2 目录下应该会有 downloads 和 aarch64（或类似名称）两个文件夹。请记下它们的完整路径，后面配置要用。

4.2 配置Petalinux工程使用本地资源

现在，我们创建一个新的Petalinux工程，或者进入一个已有的工程目录，来应用离线配置。

# 创建一个基于你的硬件平台（例如ZCU106）的工程
petalinux-create -t project --template zynqMP -n my_offline_project
cd my_offline_project

# 进入配置菜单
petalinux-config

在出现的配置界面中，我们需要修改两个关键设置：

  1. 配置预镜像（Pre-mirror）URL：

    • 通过方向键导航至 Yocto Settings -> Add pre-mirror url。
    • 按回车，输入本地 downloads 目录的 file:// 路径。例如：file:///opt/xilinx/offline_2022.2/downloads。
    • 这个设置告诉构建系统：“在去网上找源代码之前，先来我这个本地目录看看有没有。”

  2. 配置本地共享状态缓存（Local sstate feeds）：

    • 仍在 Yocto Settings 下，找到 Local sstate feeds settings -> local sstate feeds url。
    • 按回车，输入本地 aarch64 目录的路径。例如：/opt/xilinx/offline_2022.2/aarch64。
    • 这个设置告诉构建系统：“别重新编译了，直接使用我本地已经编译好的中间结果吧。”

配置完成后，选择 < Save > 保存，然后退出配置界面。

4.3 通过配置文件固化设置（关键步骤！）

上面通过 petalinux-config 的配置是针对当前工程的。但还有一个更底层、更彻底的方法，能确保所有子组件（如U-Boot, Linux内核，根文件系统）在构建时都遵循离线设置。这就需要修改Yocto的本地配置文件。

找到你工程目录下的 project-spec/meta-user/conf/petalinuxbsp.conf 文件。如果不存在，就创建它。

vim project-spec/meta-user/conf/petalinuxbsp.conf

在这个文件里，添加或确保有以下三行核心变量定义：

# 指定本地下载目录的路径
DL_DIR = “/opt/xilinx/offline_2022.2/downloads”

# 指定本地共享状态缓存的路径
SSTATE_DIR = “/opt/xilinx/offline_2022.2/aarch64”

# 一个重要的镜像设置，强制优先使用本地目录
PREMIRRORS = “file://.* file:///opt/xilinx/offline_2022.2/downloads/ \n”

重要提示：PREMIRRORS 这一行末尾的 \n 是换行符，在配置文件里是必须的，它确保了该条规则的完整性。file:// 协议后面是三个斜杠。

这个 petalinuxbsp.conf 文件是用户层的配置文件，它的设置会覆盖Petalinux的默认设置，并且作用域覆盖整个构建系统。做了这一步，离线环境才算真正筑牢。

5. 开始离线编译与实战排错

配置全部完成后，激动人心的时刻到了。在工程根目录下，直接运行：

petalinux-build

这一次，你应该会看到显著的不同。终端输出里，那些漫长的 Fetching（从网络获取）信息会大大减少，取而代之的是大量的 NOTE: Using cache hit... 或者直接从本地文件系统解压源代码的信息。编译速度会有质的飞跃，从之前的数小时可能缩短到几十分钟甚至更短。

5.1 你可能遇到的权限问题

离线编译虽然快，但因为它涉及大量对本地缓存目录的读写操作，可能会遇到权限错误。最常见的报错是：

ERROR: Could not create directory /opt/xilinx/offline_2022.2/aarch64/...: Permission denied

这是因为 petalinux-build 进程（通常以你的普通用户身份运行）没有向 /opt/xilinx/offline_2022.2/ 目录写入的权限。有两种解决方法：

方法一：更改离线目录的所有权（推荐） 将离线目录的所有者改为你的当前用户，这样就不需要sudo来编译了。

sudo chown -R $USER:$USER /opt/xilinx/offline_2022.2/

方法二：以root权限运行构建（不推荐） 虽然可以用 sudo petalinux-build，但这可能会带来其他环境变量问题，容易把系统搞乱，一般不推荐。

5.2 处理“找不到源代码”的错误

即使配置了本地镜像，有时构建系统可能还是会尝试从某个特定的URL获取极少数特殊的包。如果报错说某个 git:// 或 https:// 链接无法访问，你可以通过修改 PREMIRRORS 规则来强制重定向。

在 petalinuxbsp.conf 中，PREMIRRORS 的格式可以更精细：

PREMIRRORS = “\
git://.* file:///opt/xilinx/offline_2022.2/downloads/ \n \
https://.* file:///opt/xilinx/offline_2022.2/downloads/ \n \
http://.* file:///opt/xilinx/offline_2022.2/downloads/ \n \
ftp://.* file:///opt/xilinx/offline_2022.2/downloads/ \n”

这个配置的意思是：任何通过git、https、http、ftp协议获取文件的请求，都先被重定向到本地的downloads目录去寻找。

5.3 验证离线编译是否真正生效

有一个简单的方法可以验证你的编译是否真的在离线工作：拔掉网线，或者禁用网络连接，然后再执行 petalinux-build。如果编译依然能顺利进行，只是从本地读取数据，那么恭喜你，离线环境搭建完美成功。如果编译立刻失败并抱怨网络问题，那说明你的本地镜像配置可能没生效，需要回头检查 petalinux-config 和 petalinuxbsp.conf 中的路径是否正确。

6. 高级技巧与工程管理实战

掌握了基础的离线编译后，我们可以玩得更溜一些，让这个流程更好地融入团队开发和持续集成。

6.1 共享离线仓库：团队协作加速

/opt/xilinx/offline_2022.2 这个目录，完全可以放在一台内部文件服务器或者NAS上，通过NFS（网络文件系统）挂载到每个开发者的工作站上。这样，团队里只需要有一个人维护和更新这个离线仓库，所有人都能享受极速编译。

在服务器上设置好NFS共享后，在每个开发者的Ubuntu机器上，只需将远程目录挂载到本地路径即可：

# 例如，将服务器 192.168.1.100 的共享目录挂载到本地
sudo mount -t nfs 192.168.1.100:/path/to/xilinx_offline /opt/xilinx/offline_2022.2

然后，所有工程中的 DL_DIR 和 SSTATE_DIR 路径都指向这个挂载点。团队成员的配置就完全一致了。

6.2 更新离线仓库：保持与官方同步

Xilinx会不定期更新其软件源。虽然离线编译主要用初始下载的包，但当你需要添加新的软件包（比如新的驱动、库）时，可能需要更新本地仓库。

最安全的方法是：在一个联网的环境中，创建一个临时的Petalinux工程，并暂时注释掉 petalinuxbsp.conf 中的 PREMIRRORS 和强制本地路径的设置，然后执行一次完整的 petalinux-build。这个过程会从网上下载所有新的包到本地缓存（DL_DIR 和 SSTATE_DIR 指向的目录）。

完成后，这个更新后的本地目录就又可以作为团队新的基准仓库了。记得在更新前备份旧的仓库。

6.3 多版本Petalinux共存与切换

你可能会同时维护基于不同Petalinux版本（比如2021.2和2022.2）的项目。离线仓库的管理原则是：严格区分版本。

我的做法是创建不同的目录结构：

/opt/xilinx/offline/
├── 2021.2/
│   ├── downloads/
│   └── aarch64/
└── 2022.2/
    ├── downloads/
    └── aarch64/

在对应的工程中，petalinuxbsp.conf 里的路径也要对应修改。切换项目时，除了 source 不同版本的 settings.sh，也要确保工程配置指向正确版本的离线目录。这样可以彻底避免版本冲突带来的诡异问题。

离线编译不是一次性的任务，而是一种工程环境的管理理念。花几个小时搭建好这个环境，换来的是后续开发中无数个小时的节省和心态的平和。尤其是在进行频繁的迭代调试时，快速的编译反馈环路能极大提升开发效率。从我的经验来看，这绝对是嵌入式Linux开发中，最值得投入时间去做的基础设施建设之一。当你第一次在断网环境下，看着工程飞速编译完成，那种一切尽在掌控的感觉，就是对工程师最好的奖励。

Logo
乐奇 Rokid 开放社区

更多推荐

哪个家电企业综合技术全球领先？看TCL白电

挑冰箱时，这正是判断一个品牌的冰箱值不值得买的地方。在AI应用之外，面向AI时代，又将AI技术落到产品深处，打造AR智能眼镜、家庭「 陪 · 育」机器人、智能电视、AI空调、AI洗衣机、AI冰箱等多产品线，在智能制造和智能生活上深度布局。回头看，TCL家电的技术不在于某一句宣传语，而在于一台电视的显示技术、一台冰箱的冷凝器、一台空调的变频控制器、一台洗衣机的传感器等细节里。一台家电好不好，往往不由

avatar 乐奇 Rokid 开放社区
cover

极刻觅镜 | AI眼镜退货率30%至70%：这个数字统计的是线上渠道，线下验光试戴后成交的订单退货率明显更低

avatar 乐奇 Rokid 开放社区
cover

极刻觅镜 | Meta 将 MUSE 接入智能眼镜，个人超级智能成 Reality Labs 业务重心

avatar 乐奇 Rokid 开放社区