dartufbt #

Native Dart port of uFBT — deploys the Flipper Zero SDK and builds .fap applications. No Python, no SCons, no shell.

Built for qUnleashed, a Flipper Zero companion app. Made by ApertureFox Technology at DarkFlippers.

Features #

• SDK deployment — release / release-candidate / dev channels, a firmware branch, a direct URL or a local archive.
• Toolchain — downloads and unpacks the ARM GCC toolchain uFBT expects.
• FAP builder — compiles and links .fap / .fal, resolves API symbols against the SDK, embeds icons and file assets, writes FastFAP relocation tables and .fapmeta.
• Structured logging — events reach sinks as objects, so a GUI can render progress instead of scraping stdout.

Platforms #

Desktop only — Linux, macOS, Windows. Android and iOS are not supported: the ARM GCC toolchain has no host build for them, and iOS forbids running downloaded executables at all.

Install #

dependencies:
  dartufbt: ^0.1.0

Usage #

import 'dart:io';
import 'package:dartufbt/dartufbt.dart';

final logger = UfbtLogger(sink: UfbtConsoleSink().call);
final ufbt = UfbtInstaller(logger: logger);

// SDK + toolchain into ~/.ufbt
await ufbt.install(SdkDeployTask.channel(channel: UfbtUpdateChannel.release));

// Every app of application.fam into <appDir>/dist
final result = await FapBuilder(
  logger: logger,
  paths: ufbt.paths,
).build(appDir: Directory('my_app'));

print(result.success ? result.fap!.path : result.error);

SDK sources #

SdkDeployTask.channel(channel: UfbtUpdateChannel.dev);   // update channel
SdkDeployTask.branch(branch: 'my-feature');              // firmware branch
SdkDeployTask.url(url: '...', hwTarget: 'f7');           // direct archive
SdkDeployTask.local(filePath: '...', hwTarget: 'f7');    // local archive

ufbt.status() reports the deployed target, mode and version; ufbt.checkForUpdate() compares it against the channel head.

State #

Everything lives under ~/.ufbt — SDK in current/, toolchain in toolchain/, archives in download/. Override with UFBT_HOME and FBT_TOOLCHAIN_PATH, from the environment or from a .env file next to the project.

See also #

• flipperlib — talk to a Flipper Zero: connection over BLE / USB and the RPC protocol on top of it. Build the .fap here, ship it with flipperlib.

License #

GPL-3.0. See LICENSE.