qFlipper开源项目下载及安装教程

1. 项目介绍

qFlipper 是一款基于 Qt 框架的桌面应用程序，用于通过 PC 更新 Flipper Zero 设备的固件。它是一个完全开源的项目，支持 Windows、macOS 和 Linux 操作系统。qFlipper 提供了固件更新、修复损坏的固件安装、远程控制和显示 Flipper 屏幕等功能。

2. 项目下载位置

项目托管在 GitHub 上，下载位置为：qFlipper GitHub 仓库。

3. 项目安装环境配置

以下是不同操作系统的环境配置步骤：

Windows 环境配置

• 安装 Microsoft Visual Studio 2019 或更高版本。
• 安装 Qt 5.15.0 或更高版本（或 Qt 6）。
• 安装 NSIS（用于生成安装程序）。

Linux 环境配置

• 安装 Qt 5.15.0 或更高版本（或 Qt 6）。
• 安装 libusb 1.0.16 或更高版本。
• 安装 zlib 1.2.0 或更高版本。
• 安装 Qt 模块：base, tools, serialport, declarative, wayland。

macOS 环境配置

• 安装 Xcode 或命令行工具。
• 安装 Qt 6.3.1 静态通用版本。
• 安装 libusb 1.0.24 24 通用版本。
• 安装 dmgbuild 1.5.2 或更高版本。

4. 项目安装方式

克隆项目

首先，确保克隆项目及其子模块：

git clone https://github.com/flipperdevices/qFlipper.git --recursive

Windows 安装

编辑 build_windows.bat 文件以适应您的构建环境，然后运行：

build_windows.bat

Linux 安装

• 使用 Docker：

  docker compose up -d
  

  编译 qFlipper：

  docker compose exec dev /build_linux.sh
  

• 独立安装：

  mkdir build && cd build
  qmake /qFlipper.pro PREFIX=/path/to/install/dir -spec linux-g++ CONFIG+=qtquickcompiler && make qmake_all && make && make install
  

macOS 安装

/build_mac.sh

安装后，生成的映像文件可以在 build_mac/qFlipper.dmg 找到。

5. 项目处理脚本

以下是项目处理的一些基本脚本：

• Linux 独立构建：

  mkdir build && cd build
  qmake /qFlipper.pro PREFIX=/path/to/install/dir -spec linux-g++ CONFIG+=qtquickcompiler && make qmake_all && make && make install
  

• macOS 构建和签名：

  export SIGNING_KEY="Your Developer Key ID"
  /build_mac.sh
  

注意：上述图片路径 image_path 需要替换为实际的图片路径。