如何用 FBT 编译 Flipper Zero 固件从环境检查到刷入 SD 卡的完整流程【免费下载链接】awesome-flipperzero A collection of awesome resources for the Flipper Zero device.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-flipperzeroFlipper Zero 固件编译不必是高门槛操作。这篇教程面向刚入手设备、第一次尝试自定义固件的用户先做三项动手前检查再说明 FBTFlipper Build Tool构建工具的定位然后走一遍从克隆仓库、安装依赖到生成固件包的完整命令流程最后覆盖固件升级的安装方法和常见 FBT 编译报错的处理思路。动手前的三项检查确认系统、Git 与备份FBT 需要 Linux 环境推荐 Ubuntu 20.04 及以上版本。运行以下命令确认 Git 已安装git --version⚠️ 开始编译和刷机前请先把当前 SD 卡内容完整拷贝一份到电脑。实验性固件与官方固件行为不完全一致建议先在非主力设备上测试。万一设备无法开机可在断电状态下同时按住 OK 与 BACK 键约 30 秒无任何提示属正常现象再连接电脑用 qFlipper 恢复固件详见 FAQ.md 中 My device is frozen 一节的恢复方法。先选固件再谈编译不要先装工具链再决定目标。各固件的能力差异比较大官方版本有 Sub-GHz 频段限制且不支持滚动码保存发送社区版本各有取向。对照 Firmwares.md 里的完整差异说明先确定一个目标固件后面的编译路径才有意义。FBT 能帮你做什么用三句话理解 FBT它接收固件源码调用 ARM 交叉编译工具链把代码编译并打包成可刷入设备的固件压缩包。你不需要手工配置交叉编译器路径和构建参数./fbt一条命令即可驱动整个流程。社区插件与应用.fap 文件同样基于这套构建体系产出之后直接放进 SD 卡apps目录即可安装见 FAQ.md。简单说FBT 与源码仓库绑定你改的是源码或配置它负责产出结果。最小路径从克隆到生成固件获取资源仓库并安装依赖先克隆本资源仓库它汇总了固件对比、FAQ 与社区资料是编译前查资料的最佳入口固件源码本身以所选固件仓库为准克隆地址见对应仓库文档git clone https://gitcode.com/GitHub_Trending/aw/awesome-flipperzero cd awesome-flipperzeroFBT 依赖 ARM 交叉编译工具链。在 Ubuntu 上运行以下命令手动安装常用依赖sudo apt update sudo apt install -y git build-essential cmake gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc-arm-none-eabi-newlib其中gcc-arm-none-eabi是核心项缺失它时编译阶段会直接报arm-none-eabi-gcc: command not found。部分固件仓库的 FBT 版本支持自动拉取工具链具体以该仓库的 README 为准。运行 FBT 生成固件拿到目标固件源码后进入其仓库根目录找到 FBT 入口脚本通常名为fbt或fbt.py以仓库实际文件为准执行构建./fbtfbt后可选参数用于指定构建目标与版本不同固件仓库的目标命名与参数并不统一请以对应仓库文档中的构建说明为准。首次构建需要拉取依赖并完整编译耗时较长属正常现象。完成后在终端输出中确认生成的固件压缩包路径并检查build目录下的实际产物不要假设固定的文件名。不同固件怎么选固件取向适合人群Official 官方Sub-GHz 有区域限制不支持滚动码保存发送求稳、不想承担额外风险Unleashed默认移除 Sub-GHz 区域限制支持滚动码捕获与发送社区活跃想体验社区功能的主力选择RogueMaster基于 Unleashed自定义动画与实验性功能较多个别场景稳定性略弱喜欢尝鲜且有备用设备SquashWare基于官方分支自定义动画、内置改名功能保留官方行为想要外观与功能增强但不想偏离官方完整条目还包含 Xtreme、Xvirus、Wetox 等版本详见 Firmwares.md 的 Summary 小节。⚠️ 移除 Sub-GHz 发射限制在多数地区存在法律风险文档明确提示需自行评估并承担后果。配置入口与产物安装修改配置前先读懂文档想要调整默认行为区域设置、扩展频率、额外应用等修改位置在各固件仓库自己的配置目录中路径与可选宏定义各版本不同请勿凭猜测改动。正确做法是对照目标固件仓库的 README 与 Firmwares.md 中列出的特性差异确认某项改动属于该固件支持的范围后再编辑改完重新运行 FBT。把编译产物装进 SD 卡编译成功后将生成的固件压缩包解压把解压出的update文件夹内含update.fuf文件拷入 SD 卡根目录SD卡/ └── update/ └── update.fuf然后在设备上回到桌面/待机界面按 Down 进入文件浏览器按 Left 显示所有文件夹打开update目录进入你拷入的文件夹对update文件选择 Run in app 即可完成升级。该流程与 FAQ.md 中 How do I install custom firmwares? 一节的描述一致。如果只拿到单独的.dfu文件则改用 qFlipper 的 Install from file 功能安装。遇到报错先按现象排查FBT 编译报错工具链缺失arm-none-eabi-gcc: command not found交叉编译工具链未安装或不在 PATH 中。重新执行上文依赖安装命令之后运行以下命令验证arm-none-eabi-gcc --version若版本正常输出却仍报错检查终端PATH是否包含工具链可执行目录。刷入后卡在开机 logo常见原因是改动过的配置与硬件或该固件版本不兼容。先用上文备份恢复官方固件让设备回到可用状态再逐项回退配置改动每次只改一处并重新编译缩小问题范围。排查思路参考 FAQ.md 与所选固件仓库的问题反馈区。固件体积过大在构建时向 FBT 追加体积优化选项如OPTFLAGS-Os这类编译旗标重新生成固件后再对比体积./fbt OPTFLAGS-Os不同固件仓库对额外参数的接收方式不同若该写法未被识别请查看对应仓库文档中关于自定义构建参数的说明。继续深入固件版本逐项对比Firmwares.md设备恢复、SD 卡选型、DFU 模式等常见问题FAQ.md插件安装.fap 放入 SD 卡apps目录FAQ.md 的 How do I install applications and plugins? 一节先按默认配置完成一次完整编译与升级再逐项开启需要的功能是控制风险最稳妥的路径。【免费下载链接】awesome-flipperzero A collection of awesome resources for the Flipper Zero device.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-flipperzero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考