使用 Zig 开发 Flipper Zero 应用程序：一种现代方法

Flipper Zero 一直是硬件黑客和安全研究人员的最爱，这主要是因为它具有多功能性以及 Flipper Devices 提供的强大的基于 C 的 SDK。然而，对于寻求现代语言特性（例如编译时安全性）和更直观构建系统的开发者来说，C 语言有时会让人感到受限。Flipper Zero Zig Template 应运而生，这是一个生产就绪的框架，它弥合了 Zig 编程语言与 Flipper Zero 固件开发工具包之间的鸿沟。

通过将 Zig 的 ARM Cortex-M4 交叉编译能力与 Unofficial Flipper Build Tool (ufbt) 集成，该模板允许开发者编写既具有内存安全性又具有高性能的应用程序，而无需牺牲对 Flipper SDK 全套 API 的访问。

使用 Zig 驱动的 Flipper 应用的架构

为 Flipper Zero 进行开发需要特定的工具链来针对 STM32WB55 (ARM Cortex-M4F) 处理器。Zig 模板通过实现两阶段构建过程来简化这一过程：

1. Zig 构建阶段

Zig 处理将源代码编译为 ARM Cortex-M4 对象文件 (app.o) 的初始编译过程。配置针对硬件进行了精确调整：

  • 架构: thumb 配合 cortex-m4 CPU 模型。
  • ABI: eabihf (Embedded Application Binary Interface, Hard Float)。
  • 优化: 默认为 ReleaseSmall 以确保生成的二进制文件符合设备受限的内存。

2. UFBT 软件包阶段

一旦创建了对象文件，模板就会调用 ufbt (Unofficial Flipper Build Tool)。此阶段将 Zig 生成的对象文件与 Flipper SDK 链接，并将其打包成在设备上部署所需的 .fap (Flipper Application Package) 格式。

开始使用该模板

要开始开发，您需要 Zig (版本 0.15.1 或更高版本)、Python 3 和 ufbt。设置过程通过交互式初始化脚本进行了简化：

  1. 安装 UFBT: python3 -m pip install --upgrade ufbt，随后运行 ufbt update 以获取 SDK。
  2. 初始化: 运行 zig build init 会提示开发者输入应用元数据，包括 App ID、显示名称和作者信息。
  3. 构建与部署:
    • zig build: 编译源代码到对象文件。
    • zig build fap: 运行完整的流水线以创建可部署的 .fap 文件。
    • zig build launch: 构建、打包并自动通过 USB 将应用传输到连接的 Flipper Zero。

技术深挖：与 C SDK 的交互

Zig 最强大的优势之一是其无缝的 C 互操作性。在 Flipper Zero 的语境下，这允许开发者使用 @cImport 来引入核心 SDK 头文件，如 furi.h (Flipper Universal Runtime Interface) 和 GUI 库。

调用约定

由于 Flipper SDK 期望特定的 ARM 过程调用，开发者必须在 Zig 中明确指定调用约定以避免崩溃：

  • AAPCS: 用于主要的 start() 入口点。
  • AAPCS-VFP: 用于需要浮点或向量支持的回调函数。

示例入口点签名：

export fn start(_: ?*anyopaque) callconv(.{ .arm_aapcs = .{} }) i32

处理复杂的 C 头文件

并非所有 C 头文件都能与 Zig 的翻译器完美兼容。某些 SDK 头文件包含带有不透明类型的 union，这可能会使编译器产生困惑。在这种情况下，模板建议手动使用 extern 关键字声明外部函数以保持稳定性。

社区观点与注意事项

虽然该模板提供了一个强大的飞跃，但社区也注意到了一些值得关注的点。一些开发者观察到，即使在语言本身尚未达到最终稳定版本之前，Zig 在嵌入式项目中的采用率也在加速，这表明嵌入式领域对该语言的安全性特性有着强烈的需求。

此外，还有一些技术上的注意事项。由于 Zig 语言演进迅速，某些语法可能会发生变化；例如，一些用户指出，某些 C 导入方法可能需要更新以适应最新的编译器版本。此外，开发者应留意在 application.fam 清单文件中定义的 stack_size，因为错误的调用约定或过度的栈使用可能会导致应用在启动时立即崩溃。

项目关键文件摘要

File Purpose
src/root.zig 主应用程序逻辑和入口点
application.fam Flipper-specific 格式清单 (元数据, 栈大小)
build.zig 构建系统配置和目标定义
build.zig.zon Zig 软件包清单
icon.png 应用程序图标 (10x10px)

通过将 Zig 的安全性与 Flipper Zero SDK 的灵活性相结合，该模板将开发体验从繁琐的手动 C 语言开发转变为现代、流线化的工作流程。

Sources