下载独立 DevKit
PXA 0.10.0 提供 Linux x86_64 DevKit,要求 glibc 2.39 或更新(例如 Ubuntu 24.04)。它包含 C++26 SDK、WASI SDK、专用 AOT 编译器、CMake/Ninja、Python、PXADB 和预编译模拟器;应用开发无需先克隆固件工作区或编译 LLVM。
Windows x64 可以下载预编译 ZIP,解压后将 bin 加入 PATH;先安装微软 VC++ 2015–2022 x64 运行库。macOS、ARM 与其他 Linux 发行版看跨平台教程,容器构建、本机 PXADB 调试 USB 串口。
前往 下载页 获取固定版本。先在终端检查 uname -m(应为 x86_64)和 getconf GNU_LIBC_VERSION(应为 2.39+)。解压到任意目录,包括带空格的目录:
tar -xzf pxa-devkit-0.10.0-linux-x86_64.tar.gz
export PATH="$PWD/pxa-devkit-0.10.0-linux-x86_64/bin:$PATH"
pxa --version
预期看到 pxa 0.10.0。此页只安装工具;下一步到第一个应用创建一次 hello。export PATH 只影响当前终端,新终端需要再次设置,或将包含绝对路径的设置加入 shell 配置。
工具链、SDK 和运行时按同一发行版本提供。项目第一次构建生成可提交的 pxa.lock;已有项目不会随最新版本静默升级。开发私钥自动保存在用户数据目录,SDK 内不携带私钥。
离线与按版本安装
完整 DevKit 解压后可离线构建。已有 pxa 时,可以安装指定版本:
pxa sdk install 0.10.0
# 离线组件与在线发行使用同一份签名清单
pxa sdk install 0.10.0 --offline --manifest /media/releases/0.10.0/distribution.json
离线介质须同时包含清单、distribution.json.sig 及其中列出的五个组件包。工具验证内置公钥签名、归档 SHA-256 和大小,原子安装到用户数据目录(Linux 默认 ~/.local/share/pxa/releases/0.10.0,可由 XDG_DATA_HOME 改变)。安装不会修改 shell 的 PATH;现有 pxa 启动器按项目锁选择版本,不需要把安装目录重复加入 PATH。项目锁定其他已安装版本时自动选择对应 SDK;版本缺失会明确报错。
项目与固件分离
只开发 App 不需要 ESP-IDF。适配系统或构建固件才需要 ESP 环境 和 工作区源码。源码用户仍可使用 CMake;发布 DevKit 与固件集成方式互不替代。
预编译 DevKit 覆盖 Linux x86_64 和 Windows x64;Windows 已通过 Wine 构建运行测试,原生窗口、音频与 COM 仍需目标电脑确认。macOS/ARM 使用 Linux amd64 容器与宿主机调试工具。参见 跨平台路线与源码构建边界。