rabix
/
RedPanda-CPP
mirror of https://github.com/Reduced-panda/RedPanda-CPP
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
RedPanda-CPP/BUILD_cn.md

5.9 KiB
Raw Blame History

依赖

小熊猫C++需要Qt 5(>=5.12)

Windows

我使用msys2打包的最新版的GCC和MinGW-w64工具链来编译小熊猫C++。VC和其他版本的gcc不一定能够正常编译。

编译步骤：

  • 安装msys2 (https://www.msys2.org)
  • 使用msys2的pacman程序安装mingw-w64-x86_64-qt5和mingw-w64-x86_64-gcc
  • 安装qtcreator
  • 使用qtcreator打开Red_Panda_CPP.pro文件

Linux

步骤:

  • 安装 gcc 和 qt5开发相关包
  • 如果使用静态版本的 Qt 编译，还要安装 fcitx5-qt
  • 使用qtcreator打开Red_Panda_CPP.pro文件

qmake 变量:

  • PREFIX：默认值是 /usr/local。打包时应该定义为 /usr 或 /opt/redpanda-cpp。
  • LIBEXECDIR：辅助程序的路径，默认值是 $PREFIX/libexec。Arch Linux 使用 /usr/lib。
  • XDG_ADAPTIVE_ICON=ON：遵循 freedesktop.org 图标主题规范安装图标，以适应不同的主题和尺寸。AppImage 需要启用此项；Linux 打包 PREFIX=/usr 时推荐启用此项。
  • LINUX_STATIC_IME_PLUGIN=ON（make 阶段）：静态链接输入法插件。推荐在使用静态版本的 Qt 编译时启用；不要在使用动态版本的 Qt 编译时启用。

Debian 及其衍生版本

适用于当前系统的 deb 包

  1. 安装依赖包： 
    sudo apt install \
  build-essential debhelper \
  libqt5svg5-dev qtbase5-dev qtbase5-dev-tools qttools5-dev-tools
  2. 构建 deb 包： 
    ./packages/debian/builddeb.sh
  3. 安装 deb 包： 
    sudo apt install /tmp/redpanda-cpp_*.deb
  4. 运行小熊猫 C++： 
    RedPandaIDE

在容器中构建适用于多架构/版本的包

Windows 宿主的额外要求：

  • Docker 使用基于 WSL 2 的引擎，或者对此项目文件夹启用文件共享（Settings > Resources > File sharing）；
  • PowerShell (Core) 或 Windows PowerShell。
  • Linux 宿主： 
    DOCKER=docker # 或 podman
SOURCE_DIR=/build/RedPanda-CPP # *容器内*的源代码路径

MIRROR=mirrors.ustc.edu.cn # 留空以使用默认的镜像站
PLATFORM=linux/amd64 # 或 linux/386、linux/arm64/v8、linux/arm/v7、linux/riscv64
IMAGE=debian:12 # 或 Ubuntu（如 ubuntu:22.04）

$DOCKER run --rm -e MIRROR=$MIRROR -e SOURCE_DIR=$SOURCE_DIR -v $PWD:$SOURCE_DIR --platform $PLATFORM $IMAGE $SOURCE_DIR/packages/debian/01-in-docker.sh
  • Windows 宿主： 
    $DOCKER = "docker" # 或 "podman"
$SOURCE_DIR = "/build/RedPanda-CPP" # *容器内*的源代码路径

$MIRROR = "mirrors.ustc.edu.cn" # 留空以使用默认的镜像站
$PLATFORM = "linux/amd64" # 或 "linux/386"、"linux/arm64/v8"、"linux/arm/v7"、"linux/riscv64"
$IMAGE = "debian:12" # 或 Ubuntu（如 "ubuntu:22.04"）

& $DOCKER run --rm -e MIRROR=$MIRROR -e SOURCE_DIR=$SOURCE_DIR -v "$(Get-Location):$SOURCE_DIR" --platform $PLATFORM $IMAGE $SOURCE_DIR/packages/debian/01-in-docker.sh

手动安装

  1. 安装编译器 
    apt install gcc g++ make gdb gdbserver
  2. 安装 Qt 5 和依赖包 
    apt install qtbase5-dev qttools5-dev-tools libqt5svg5-dev git qterminal
  3. 下载源码 
    git clone https://gitee.com/royqh1979/RedPanda-CPP.git
  4. 编译 
    cd RedPanda-CPP/
qmake Red_Panda_CPP.pro
make -j$(nproc)
sudo make install
  5. 运行 
    RedPandaIDE

Arch Linux 及衍生版本

packages/archlinux 目录下提供了一个参考 PKGBUILD，使用 makepkg 构建小熊猫 C++ 并安装。

小熊猫 C++ 可以通过 RedPandaIDE 命令启动。

注意：makepkg 签出此存储库的 HEAD，因此构建之前务必提交所有变更。

AppImage

  1. 安装依赖包：Docker 或 Podman。

    Windows 宿主的额外要求：

    • Docker 使用基于 WSL 2 的引擎，或者对此项目文件夹启用文件共享（Settings > Resources > File sharing）；
    • PowerShell (Core) 或 Windows PowerShell。

  2. 准备构建环境。Linux 宿主：

    ARCH=x86_64 # 或 aarch64、riscv64
DOCKER=docker # 或 podman
$DOCKER build -t redpanda-builder-$ARCH packages/appimage/dockerfile-$ARCH

    Windows 宿主：

    $ARCH = "x86_64" # 或 "aarch64"、"riscv64"
$DOCKER = "docker" # 或 "podman"
& $DOCKER build -t redpanda-builder-$ARCH packages/appimage/dockerfile-$ARCH

  3. 构建 AppImage。Linux 宿主：

    ARCH=x86_64
DOCKER=docker
$DOCKER run --rm -v $PWD:/build/RedPanda-CPP -e CARCH=$ARCH redpanda-builder-$ARCH /build/RedPanda-CPP/packages/appimage/01-in-docker.sh

    Windows 宿主：

    $ARCH = "x86_64"
$DOCKER = "docker"
& $DOCKER run --rm -v "$(Get-Location):/build/RedPanda-CPP" -e CARCH=$ARCH redpanda-builder-$ARCH /build/RedPanda-CPP/packages/appimage/01-in-docker.sh

  4. 运行小熊猫 C++.

    ./dist/RedPandaIDE-x86_64.AppImage # 或 *-aarch64.AppImage、*-riscv64.AppImage

异架构的模拟本机构建（emulated native build）

可以借助 QEMU 用户空间模拟，运行目标架构的本机工具链，来构建小熊猫 C++。

注意：始终在容器中运行模拟本机构建，因为混用不同架构的程序和库可能会损坏系统。

对于 Linux 宿主，需要安装静态链接的 QEMU 用户空间模拟器（包名通常为 qemu-user-static）并确认已经启用 binfmt 支持。

对于 Windows 宿主，Docker 和 Podman 应该已经启用了 QEMU 用户空间模拟。如果没有启用，

  • Docker： 
    docker run --rm --privileged multiarch/qemu-user-static:register
  • Podman（其虚拟机基于 Fedora WSL）只需要启用 binfmt 支持： 
    wsl -d podman-machine-default sudo cp /usr/lib/binfmt.d/qemu-aarch64-static.conf /proc/sys/fs/binfmt_misc/register
wsl -d podman-machine-default sudo cp /usr/lib/binfmt.d/qemu-riscv64-static.conf /proc/sys/fs/binfmt_misc/register