Flipper Zero Unleashed 固件安装第三方插件（FAP）教程
【免费下载链接】unleashed-firmwareFlipper Zero Unleashed Firmware项目地址: https://gitcode.com/GitHub_Trending/un/unleashed-firmware
给设备扩充红外码库、SubGHz 遥控或专用工具，而官方固件里又没有对应入口，这是 Flipper Zero Unleashed 固件用户最常遇到的情况。Unleashed 固件把扩展功能做成了第三方插件：一个 FAP 文件（内含代码、资源与元数据的 ELF 可执行包），放入 SD 卡指定目录就能被加载器识别并运行，不需要重刷固件。本文只讲一条最短可行的安装路径，并给出每一步的验证信号。
安装前需要确认的两件事
- API 版本对齐。进入 设置 > 关于，查看固件的 API 版本号。插件的加载器只比对 FAP 元数据中的 API主版本号与固件是否一致，次版本号不同也能运行；主版本号不同则会直接启动失败。拿到 FAP 文件后，先向提供方确认它针对的 API 主版本号。
- SD 卡目录与扩展名。固件只扫描 SD 卡根目录下的
apps文件夹（见 applications/services/loader/loader_applications.c），且只识别.fap扩展名。文件名可以随意，子文件夹也可以保留。
安装操作的三个步骤
第一步：建立目录。把 SD 卡插到电脑，在根目录新建apps文件夹；目录已存在就跳过。验证信号：资源管理器中能看到根目录下的apps。
第二步：放入文件。把.fap文件复制到apps目录（可按功能自建子目录），安全弹出。验证信号：复制完成提示正常，文件扩展名仍是.fap。
第三步：设备端确认。SD 卡插回设备。打开主菜单的Apps分类，文件浏览器会从apps目录扫描，你放入的 FAP 以应用名称和图标列出。验证信号：列表中出现新条目。
结果验证
用方向键选中该条目，按确认键。看到加载动画后进入应用界面，即安装成功；返回后按Back退出应用，不影响设备其他功能。再次进入 Apps 分类时列表不变，说明文件已被稳定识别。
两种方式的取舍
| 方式 | 适用场景 | 说明 | | 手动复制 SD 卡 | 安装现成的单个 FAP | 本文主流程，无需开发环境 | |./fbt launch APPSRC=applications_user/你的应用| 自研应用开发调试 | 在固件工程目录执行，一步完成编译并经 USB 推送到设备，应用直接启动，无需重启 |
快速排障
| 现象 | 原因 | 处理动作 | | 应用列表里没有新 FAP | 文件不在apps目录，或扩展名不是.fap| 核对 SD 卡路径与文件扩展名 | | 点开后提示 API Mismatch | FAP 的 API 主版本号与固件不一致 | 向提供方索取与当前固件匹配的 FAP 版本 | | 打开后很快闪退 | FAP 需先整体拷入 RAM 再运行，可用堆内存少于内置应用，内存不足 | 换成更小的 FAP，或移除部分占用内存的文件后重试 | | 条目显示默认 JS 图标且无法启动 | 扩展名为.js或文件损坏 | 确认是.fap；必要时重新拷贝 |
进阶入口
如果要自己编写 FAP 或在开发机上调试，从 documentation/AppsOnSDCard.md 开始，其中包含清单配置（application.fam）、fap_{APPID}构建目标与 gdb 调试说明；构建命令见 documentation/fbt.md，自研应用源码放在applications_user目录，加载器实现位于 applications/services/loader/。
下一步：把手头已确认 API 版本的 FAP 按上面三步放入apps目录，然后在 Apps 分类里把它跑起来。
【免费下载链接】unleashed-firmwareFlipper Zero Unleashed Firmware项目地址: https://gitcode.com/GitHub_Trending/un/unleashed-firmware
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考