代码拉取完成，页面将自动刷新
作者：康林 kl222@126.com
# 仅编译 AppImage
./Script/build_linux.sh --appimage
# 仅编译 deb 包
./Script/build_linux.sh --deb
# 仅编译 rpm 包
./Script/build_linux.sh --rpm
详见：脚本
Ubuntu
~$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 24.04.1 LTS
Release: 24.04
Codename: noble
Debian
~$ lsb_release -a
No LSB modules are available.
Distributor ID: Debian
Description: Debian GNU/Linux 12 (bookworm)
Release: 12
Codename: bookworm
Fedora
$ cat /etc/redhat-release
Fedora release 42 (Adams)
版本：v15.0.0。建议使用 v5.0.2 及以后版本，以前版本对 CMake 支持不够。
~$ sudo apt install build-essential
编译器
GCC/G++
~$ sudo apt install g++ gcc
automake、autoconf、make、fakeroot
~$ sudo apt install automake autoconf make fakeroot
~$ sudo apt install git
版本: 大于 3.27.0
~$ sudo apt install cmake
~$ sudo apt install debhelper
Qt 官方发行版本： https://download.qt.io/official_releases/qt/
QT_ROOT
Qt6：Qt6_ROOT 或者 Qt6_DIR 。 详见：https://doc.qt.io/qt-6/cmake-get-started.html
Qt5：Qt5_ROOT 或者 Qt5_DIR 。 详见：https://doc.qt.io/qt-5/cmake-get-started.html
环境变量
export QT_ROOT=Qt 安装位置
# 编译 AppImage 需要
export QMAKE=$QT_ROOT/bin/qmake
# 当使用 Qt6 时
export Qt6_ROOT=$QT_ROOT
# 当使用 Qt5 时
export Qt5_ROOT=$QT_ROOT
# 或者
# 当使用 Qt6 时
export Qt6_DIR=$QT_ROOT/lib/cmake/Qt6
# 当使用 Qt5 时
export Qt5_DIR=$QT_ROOT/lib/cmake/Qt5
CMAKE 参数
#当使用 Qt6 时
cmake -DQT_ROOT=[Qt 安装位置] -DQt6_DIR=[Qt 安装位置] ......
#当使用 Qt5 时
cmake -DQT_ROOT=[Qt 安装位置] -DQt5_DIR=[Qt 安装位置] ......
# 编译 AppImage 需要
export QMAKE=$QT_ROOT/bin/qmake
系统自带：
Qt5:
~$ sudo apt install qttools5-dev qttools5-dev-tools qtbase5-dev qtbase5-dev-tools qtmultimedia5-dev qtlocation5-dev libqt5svg5-dev libqtermwidget5-0-dev
Qt6: 详见： Script/build_depend.sh
~$ sudo apt install qmake6 qt6-tools-dev qt6-tools-dev-tools qt6-base-dev qt6-base-dev-tools qt6-qpa-plugins libqt6svg6-dev qt6-l10n-tools qt6-translations-l10n qt6-scxml-dev qt6-multimedia-dev libqt6serialport6-dev
系统安装多个分发版本 Qt 时。例如：同时安装 Qt5 和 Qt6 。 系统使用 qtchooser 工具来选择当前的 Qt 版本。
l@l:/home/RabbitRemoteControl$ qtchooser
Usage:
qtchooser { -l | -list-versions | -print-env }
qtchooser -install [-f] [-local] <name> <path-to-qmake>
qtchooser -run-tool=<tool name> [-qt=<Qt version>] [program arguments]
<executable name> [-qt=<Qt version>] [program arguments]
Environment variables accepted:
QTCHOOSER_RUNTOOL name of the tool to be run (same as the -run-tool argument)
QT_SELECT version of Qt to be run (same as the -qt argument)
查看当前系统安装的 Qt 版本
l@l:/home/RabbitRemoteControl$ qtchooser -l
4
5
default
qt4-x86_64-linux-gnu
qt4
qt5-x86_64-linux-gnu
qt5
qt6
# 查看当前环境的 Qt 版本
l@l:/home/RabbitRemoteControl$ qtchooser --print-env
QT_SELECT="default"
QTTOOLDIR="[Paths]"
QTLIBDIR="Prefix=/usr"
设置当前环境的 Qt 版本
export QT_SELECT=qt6 #设置当前环境 Qt 版本为 6
# 查看当前环境的 Qt 版本
l@l:/home/RabbitRemoteControl$ qtchooser --print-env
QT_SELECT="qt6"
QTTOOLDIR="/usr/lib/qt6/bin"
QTLIBDIR="/usr/lib/aarch64-linux-gnu"
~$ sudo apt install qtcreator
~$ sudo apt install libglu1-mesa-dev
~$ sudo apt install doxygen
此库默认放在与本项目同级目录下
~$ git clone https://github.com/KangLin/RabbitRemoteControl.git
~$ git clone https://github.com/KangLin/RabbitCommon.git
如果没有在同级目录下，则必须指定 CMake 参数或者环境变量:
~$ git clone https://github.com/KangLin/RabbitRemoteControl.git
# 设置环境变量
~$ export RabbitCommon_ROOT=[RabbitCommon 安装目录]
~$ cd RabbitRemoteControl
# 或者设置 CMake 参数
~/RabbitRemoteControl$ cmake -DRabbitCommon_ROOT=[RabbitCommon 安装目录] ......
使用系统预编译开发库
~$ sudo apt install freerdp3-dev
使用 vcpkg
源码位置: https://github.com/microsoft/vcpkg/
~$ git clone https://github.com/microsoft/vcpkg.git
~$ cd vcpkg
~/vcpkg$ ./bootstrap-vcpkg.sh
~/vcpkg$ vcpkg install freerdp
指定 CMake 参数：-DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
使用 vcpk ， FreeRDP 服务不是默认功能，所以需要你手动指定。
从源码编译
编译详见：https://github.com/FreeRDP/FreeRDP/wiki/Compilation
~$ git clone https://github.com/FreeRDP/FreeRDP.git
~$ cd FreeRDP
~/FreeRDP$ mkdir build
~/FreeRDP/build$ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install -DWITH_SERVER=ON
~/FreeRDP/build$ cmake --build . --config Release --target install
当 FreeRDP 从源码编译时，编译本项需要指定的 CMake 参数：
使用系统预编译开发库
~$ sudo apt install libvncserver-dev
从源码编译
当 LibVNCServer 从源码编译时，编译本项需要指定的 CMake 参数：
-DLibVNCServer_DIR=[LibVNCServer 安装目录]/lib/cmake/LibVNCServer
从源码编译
源码位置: https://github.com/KangLin/RabbitVNC
~$ sudo apt install libpixman-1-dev
~$ git clone https://github.com/KangLin/RabbitVNC.git
~$ cd RabbitVNC
~/RabbitVNC$ mkdir build
~/RabbitVNC$ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install
~/RabbitVNC$ cmake --build . --config Release --target install
当 RabbitVNC 从源码编译时，编译本项需要指定的 CMake 参数：
-DRabbitVNC_DIR=[RabbitVNC 安装目录]/lib/cmake/RabbitVNC
官方只是个应用程序，不支持库。详见：https://github.com/TigerVNC/tigervnc/issues/1123
所以本人在官方基础上做了修改。源码位置：https://github.com/KangLin/tigervnc
~$ sudo apt install libpixman-1-dev
~$ git clone https://github.com/KangLin/tigervnc.git
~$ cd tigervnc
~/tigervnc$ mkdir build
~/tigervnc$ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install
~/tigervnc$ cmake --build . --config Release --target install
当 TigerVNC 从源码编译时，编译本项需要指定的 CMake 参数：
-Dtigervnc_DIR=[TigerVNC 安装目录]/lib/cmake/tigervnc
使用 vcpkg
源码位置: https://github.com/microsoft/vcpkg/
~$ git clone https://github.com/microsoft/vcpkg.git
~$ cd vcpkg
~/vcpkg$ vcpkg install libdatachannel
指定 CMake 参数：-DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
从源码编译
编译详见： https://github.com/paullouisageneau/libdatachannel/blob/master/BUILDING.md
~$ git clone https://github.com/paullouisageneau/libdatachannel.git
~$ cd libdatachannel
~/libdatachannel$ git submodule update --init --recursive
~/libdatachannel$ mkdir build
~/libdatachannel$ cd build
~/libdatachannel/build$ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install
~/libdatachannel/build$ cmake --build . --config Release --target install
当 libdatachannel 从源码编译时，编译本项需要指定的 CMake 参数：
-DLibDataChannel_DIR=[libdatachannel 安装目录]/lib/cmake/LibDataChannel
使用系统预编译开发库
~$ sudo apt install libqxmpp-dev
从源码编译
源码位置： https://github.com/qxmpp-project/qxmpp
~$ git clone https://github.com/qxmpp-project/qxmpp.git
~$ cd qxmpp
~/qxmpp$ mkdir build
~/qxmpp$ cd build
~/qxmpp/build$ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install -DQt5_DIR=[Qt5 安装目录]/lib/cmake/Qt5
~/qxmpp/build$ cmake --build . --config Release --target install
当 QXmpp 从源码编译时，编译本项需要指定的 CMake 参数：
-DQXmpp_DIR=[QXmpp 安装目录]/lib/cmake/qxmpp
使用系统预编译开发库
~$ sudo apt install libqtermwidget5-0-dev
从源码编译
当 QTermWidget 从源码编译时，编译本项需要指定的 CMake 参数：
-Dqtermwidget5_DIR=[qtermwidget 安装目录]/lib/cmake/qtermwidget5
使用系统预编译开发库
~$ sudo apt install libssh-dev
使用 vcpkg
源码位置: https://github.com/microsoft/vcpkg/
~$ git clone https://github.com/microsoft/vcpkg.git
~$ cd vcpkg
~/vcpkg$ vcpkg install libssh
指定 CMake 参数：-DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
从源码编译
当 libssh 从源码编译时，编译本项需要指定的 CMake 参数：
-Dlibssh_DIR=[libssh 安装目录]/lib/cmake/libssh
从源码编译
源码位置：: https://github.com/KangLin/qt-solutions/
~$ git clone https://github.com/KangLin/qt-solutions.git
~$ cd qt-solutions
~/qt-solutions$ mkdir build
~/qt-solutions$ cd build
~/qt-solutions/build$ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install
~/qt-solutions/build$ cmake --build . --config Release --target install
当 QtService 从源码编译时，编译本项需要指定的 CMake 参数：
-DQtService_DIR=[QtService 安装目录]/lib/cmake/QtService
从源码编译
源码位置：https://github.com/seladb/PcapPlusPlus
~$ git clone https://github.com/seladb/PcapPlusPlus.git
使用 vcpkg
源码位置：https://github.com/microsoft/vcpkg/
~$ git clone https://github.com/microsoft/vcpkg.git
~$ cd vcpkg
~/vcpkg$ ./vcpkg install pcapplusplus
当 PcapPlusPlus 从源码编译时，编译本项需要指定的 CMake 参数：
-DPcapPlusPlus_DIR=[PcapPlusPlus 安装目录]/lib/cmake/pcapplusplus
PcapPlusPlus 依赖此库。
使用系统预编译开发库
~$ sudo apt install libpcap-dev
下载源码
~$ git clone https://github.com/KangLin/RabbitRemoteControl.git
命令行编译
不用 vcpkg
~$ cd RabbitRemoteControl
~/RabbitRemoteControl$ mkdir build
~/RabbitRemoteControl/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install
~/RabbitRemoteControl/build$ cmake --build . --config Release --target install
使用 vcpkg
~$ cd RabbitRemoteControl
~/RabbitRemoteControl$ mkdir build
~/RabbitRemoteControl/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install \
-DCMAKE_TOOLCHAIN_FILE=[vcpkg installation path]/scripts/buildsystems/vcpkg.cmake \
[可选依赖库]
~/RabbitRemoteControl/build$ cmake --build . --config Release --target install
IDE(Qt Creator) 编译
使用脚本 build_debpackage.sh
设置 CMake 参数或者环境变量为环境变量。例如：
export RabbitVNC_DIR=[RabbitVNC 安装目录]/lib/cmake/RabbitVNC
export tigervnc_DIR=[TigerVNC 安装目录]/lib/cmake/tigervnc
export QtService_DIR=[QtService 安装目录]/lib/cmake/QtService
使用脚本 build_debpackage.sh
./Script/build_debpackage.sh [$QT_ROOT] [$RabbitCommon_ROOT]
程序安装在 install/bin 下
~$ cd RabbitRemoteControl
~/RabbitRemoteControl$ cd build/install/bin
~/RabbitRemoteControl$ ./RabbitRemoteControl.sh
# 或者
~/RabbitRemoteControl$ ./RabbitRemoteControlApp
注意： 如果插件没有加载。则可能是插件的依赖库没有安装到系统。 你可以把依赖库的目录加入到环境变量 LD_LIBRARY_PATH 中。 你也可以把依赖库的目录加入到 /etc/ld.so.conf 文件中， 然后运行 ldconfig 把依赖库加入到系统中。
Qt 变量
QT_DEBUG_PLUGINS: 调试插件
export QT_DEBUG_PLUGINS=1
QT_QPA_PLATFORM: 加载指定的平台。例如使用 vnc
export QT_QPA_PLATFORM=vnc
```bash
# 安装开发工具软件包
~$ sudo apt install build-essential
# 安装工具
~$ sudo apt install git cmake debhelper doxygen
# [可选] 安装 Qt5
~$ sudo apt install qttools5-dev qttools5-dev-tools qtbase5-dev \
qtbase5-dev-tools qtmultimedia5-dev qtlocation5-dev libqt5svg5-dev \
libqtermwidget5-0-dev
# 安装 X 开发库
~$ sudo apt install libxkbcommon-dev libxkbcommon-x11-dev libx11-xcb-dev \
libx11-dev libxfixes-dev
~$ sudo apt install libutf8proc-dev libpam0g-dev #编译 qtermwidget 需要
# 安装依赖库
~$ sudo apt install freerdp2-dev libvncserver-dev libssh-dev libtelnet-dev
~$ sudo apt install debhelper fakeroot
# 安装 pixman ,RabbitVNC 和 TigerVNC 需要它
~$ sudo apt install libpixman-1-dev
# 编译 RabbitVNC
~$ git clone https://github.com/KangLin/RabbitVNC.git
~$ cd RabbitVNC
~$ mkdir build
~/RabbitVNC/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install
~/RabbitVNC/build$ cmake --build . --config Release --target install
~/RabbitVNC/build$ cd ~
# 编译 TigerVNC
~$ git clone https://github.com/KangLin/tigervnc.git
~$ cd tigervnc
~$ mkdir build
~/tigervnc/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install
~/tigervnc/build$ cmake --build . --config Release --target install
~/tigervnc/build$ cd ~
~$ sudo apt install libqxmpp-dev
# 编译 libdatachannel
~$ git clone https://github.com/paullouisageneau/libdatachannel.git
~$ cd libdatachannel
~/libdatachannel$ git submodule update --init --recursive
~/libdatachannel$ mkdir build
~/libdatachannel$ cd build
~/libdatachannel/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install
~/libdatachannel/build$ cmake --build . --config Release --target install
~/libdatachannel/build$ cd ~
# 编译 QtService
~$ git clone https://github.com/KangLin/qt-solutions.git
~$ cd qt-solutions/qtservice
~/qt-solutions/qtservice$ mkdir build
~/qt-solutions/qtservice$ cd build
~/qt-solutions/qtservice/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install
~/qt-solutions/qtservice/build$ cmake --build . --config Release --target install
~/qt-solutions/qtservice/build$ cd ~
~$ git clone https://github.com/KangLin/RabbitCommon.git
~$ git clone https://github.com/KangLin/RabbitRemoteControl.git
~$ cd RabbitRemoteControl
~/RabbitRemoteControl$ mkdir build
~/RabbitRemoteControl$ cd build
~/RabbitRemoteControl/build$ cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/install \
-DBUILD_FREERDP=ON \
-DRabbitVNC_DIR=~/RabbitVNC/build/install/lib/cmake/RabbitVNC \
-Dtigervnc_DIR=~/tigervnc/build/install/lib/cmake/tigervnc \
-DLibDataChannel_DIR=~/libdatachannel/build/install/lib/cmake/LibDataChannel \
-DQtService_DIR=~/qt-solutions/qtservice/build/lib/cmake/QtService
~/RabbitRemoteControl/build$ cmake --build . --config Release --target install
```
详见：脚本
构建
~/RabbitRemoteControl/build$ cmake .. \
-DCMAKE_INSTALL_PREFIX=/usr \
-DCMARK_SHARED=OFF \
-DCMARK_TESTS=OFF \
-DCMARK_STATIC=ON \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DBUILD_QUIWidget=OFF \
-DBUILD_APP=ON \
-DBUILD_FREERDP=ON
cmake --build . --parallel $(nproc)
cmake --install . --config Release --component DependLibraries --prefix AppDir/usr
cmake --install . --config Release --component Runtime --prefix AppDir/usr
cmake --install . --config Release --component Application --prefix AppDir/usr
cmake --install . --config Release --component Plugin --prefix AppDir/usr
建立 AppImage
# See: https://github.com/linuxdeploy/linuxdeploy-plugin-qt
#export QMAKE=${QT_ROOT}/bin/qmake
export EXTRA_PLATFORM_PLUGINS="libqxcb.so"
# Icons from theme are not displayed in QtWidgets Application: https://github.com/linuxdeploy/linuxdeploy-plugin-qt/issues/17
export EXTRA_QT_MODULES="svg"
./linuxdeploy-`uname -m`.AppImage --appdir=AppDir -v0 \
--deploy-deps-only=AppDir/usr/plugins/Client \
--deploy-deps-only=AppDir/usr/lib/`uname -m`-linux-gnu \
--plugin qt \
--output appimage
运行
sudo chmod u+x ./Rabbit_Remote_Control-`uname -m`.AppImage
./Rabbit_Remote_Control-`uname -m`.AppImage
其它
解压 AppImage
./Rabbit_Remote_Control-`uname -m`.AppImage --appimage-extract # 解压 AppImage 文件
FUSE 问题
第一次执行AppImage文件的时候可能会碰到 PUSE 相关的问题，报错如下：
dlopen(): error loading libfuse.so.2
AppImages require FUSE to run.
You might still be able to extract the contents of this AppImage
if you run it with the --appimage-extract option.
See https://github.com/AppImage/AppImageKit/wiki/FUSE
for more information
解决方案：安装 fuse2
sudo apt install fuse
在 docker 中运行时出现 FUSE 错误
在创建容器的时候加上参数: --privileged
docker run --privileged --interactive ubuntu
安装 snapcraft
sudo snap install snapcraft --classic
通过检查版本号来验证 Snapcraft 是否已安装。
snapcraft --version
把当前用户加入 lxd 组
sudo usermod -aG lxd $USER
如果系统已安装了 docker, 则用下列方法设置：
允许 ipv4 转发
sudo echo "net.ipv4.conf.all.forwarding=1" > /etc/sysctl.d/99-forwarding.conf
sudo systemctl restart systemd-sysctl
允许出口网络流量
sudo iptables -I DOCKER-USER -i <network_bridge> -j ACCEPT
sudo ip6tables -I DOCKER-USER -i <network_bridge> -j ACCEPT
sudo iptables -I DOCKER-USER -o <network_bridge> -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
sudo ip6tables -I DOCKER-USER -o <network_bridge> -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
# 如果 lxd 接口名为 lxdbr0
sudo iptables -I DOCKER-USER -i lxdbr0 -j ACCEPT
sudo ip6tables -I DOCKER-USER -i lxdbr0 -j ACCEPT
sudo iptables -I DOCKER-USER -o lxdbr0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
sudo ip6tables -I DOCKER-USER -o lxdbr0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
构建:
Parts 生命周期: https://snapcraft.io/docs/parts-lifecycle
https://snapcraft.io/docs/how-snapcraft-builds
~$ git clone https://github.com/KangLin/RabbitRemoteControl.git
~$ cd RabbitRemoteControl
~$ snapcraft -v
这些生命周期步骤中的每一个都可以从命令行运行， 并且该命令可以是特定于部件的命令，也可以是应用于项目中的所有部件的命令。
snapcraft pull [<part-name>]
snapcraft build [<part-name>]
snapcraft stage [<part-name>]
snapcraft prime [<part-name>]
snapcraft pack or snapcraft
迭代构建: https://snapcraft.io/docs/iterating-over-a-build 通过以下命令，您可以单步执行此封装环境：
--shell：将快照构建到指定之前的生命周期步骤，并在环境中打开一个 shell 例如，运行 snapcraft prime [] --shell 将运行到暂存步骤并打开一个 shell）。
--shell-after：构建对指定生命周期步骤的快照，并在环境中打开 shell。 （例如，运行 snapcraft prime [] --shell-after 将运行到 prime 步骤，然后进入 shell）。
--debug 在发生错误后在环境中打开一个 shell。
-v: 显示构建动作
$ # 例如 prime freerdp
$ snapcraft prime freerdp --shell-after -v --debug
清理
snapcraft clean
调试
开发模式安装 （--devmode）。未签名的。
snap install ./rabbitremotecontrol_0.0.27_amd64.snap --devmode
运行
rabbitremotecontrol
卸载
snap remove rabbitremotecontrol
参考：
准备
安装构建和运行 flatpak 所需的软件：flatpak 和 flatpak-builder
在 Fedora 上我们必须运行：
$ sudo dnf install flatpak flatpak-builder
# 其它工具
$ sudo dnf install autogen git cmake gcc autoconf
在 Debian/Ubuntu 或基于它的众多发行版之一上：
$ sudo apt-get update && sudo apt-get install flatpak flatpak-builder
在 Archlinux 上我们可以使用 pacman 来执行相同的操作：
$ sudo pacman -Sy flatpak flatpak-builder
添加 Flathub 仓库：
$ flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
中科大镜像：
$flatpak remote-modify flathub --url=https://mirrors.ustc.edu.cn/flathub
上海交大镜像：
$flatpak remote-modify flathub --url=https://mirror.sjtu.edu.cn/flathub
查看flatpak仓库的详细信息
$ flatpak remotes --show-details
参考
构建
$ cd RabbitRemoteControl
$ flatpak-builder build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml
** (flatpak-builder:37): WARNING **: 03:05:45.408: Unknown property branch for type BuilderSourceDir
error: org.kde.Sdk/x86_64/6.8 not installed
Failed to init: Unable to find sdk org.kde.Sdk version 6.8
提示 sdk 没有安装。指定的运行时和 sdk 不会自动安装，我们必须手动安装。 要仅为我们的用户从 flathub 存储库安装它们，我们使用以下命令：
$ flatpak install org.kde.Sdk//6.8 org.kde.Platform//6.8
安装完所有的 sdk 和运行库后，再构建：
$ flatpak-builder --force-clean build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml
# 或者 用户模式
$ flatpak-builder --user --force-clean build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml
请注意，我们在此处使用 --user 选项以安装应用程序在当前用户范围内。 如果您愿意，可以忽略此选项，则安装应用程序在系统范围内。
编译目录位于当前目录下：.flatpak-builder
进入构建沙盒环境
$ flatpak-builder --run build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml bash
安装
应用程序构建完成，我们就可以安装它。我们所要做的就是运行以下命令：
$ flatpak-builder --force-clean --install build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml
# 或者 用户模式
$ flatpak-builder --user --force-clean --install build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml
运行
$ flatpak run io.github.KangLin.RabbitRemoteControl
创建存储库
如果到目前为止一切都按预期工作，我们可以继续将我们的应用程序放入存储库中。 在这里，我们将创建自己的存储库，但如果您想将应用程序上线， 则需要按照要上传到的网站（例如 FlatHub）的提交说明进行操作。 我们将再次构建应用程序，但这次添加 --repo 选项。我们将我们的存储库称为“Rabbit”。
$ flatpak-builder --user --repo=Rabbit --force-clean build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml
接下来，我们可以将新存储库添加到 Flatpak，然后从存储库安装我们的应用程序。
$ flatpak --user remote-add --no-gpg-verify Rabbit Rabbit
$ flatpak --user install Rabbit io.github.KangLin.RabbitRemoteControl
请注意，我们在此处使用 --user 选项以避免安装应用程序以供系统范围使用。如果您愿意，可以忽略此选项。
另外，如果生成 .flatpak 文件。则可以直接安装 .flatpak 文件
$ flatpak --user install RabbitRemoteControl_v0.0.32_Linux_x86_64.flatpak
添加元信息
文件名：<app-id>.metainfo.xml
io.github.KangLin.RabbitRemoteControl.metainfo.xml
文件位置：
/app/share/metainfo
验证 XML 语法：
# 安装验证工具
sudo apt install appstream-util # Debian/Ubuntu
sudo dnf install appstream-util # Fedora
# 验证 XML 语法
appstream-util validate-relax io.github.KangLin.RabbitRemoteControl.metainfo.xml
验证元数据文件 构建后检查文件是否被正确安装：
# 进入构建沙盒环境
flatpak-builder --run build-dir Package/Flatpak/io.github.KangLin.RabbitRemoteControl.yml bash
# 在沙盒中检查路径
ls -l /app/share/metainfo/io.github.KangLin.RabbitRemoteControl.metainfo.xml
问题
在 docker 中运行时出现 FUSE 错误
Initializing build dir
Committing stage init to cache
Starting build of io.github.KangLin.RabbitRemoteControl
fuse: device not found, try 'modprobe fuse' first
Error: Failure spawning rofiles-fuse, exit_status: 1024
在创建容器的时候加上参数: --privileged
docker run --privileged --interactive fedora
在 docker 中，运行程序出现下面错误：
[root@de5245ca3cfc Download]# flatpak run io.github.KangLin.RabbitRemoteControl
App.Main: QT_QPA_PLATFORM: ""
Current Qt Platform is: "xcb" ; This can be modified with the environment variables QT_QPA_PLATFORM:
export QT_QPA_PLATFORM=xcb
Optional: xcb; vnc
qt.qpa.xcb: could not connect to display
qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
Available platform plugins are: offscreen, vnc, xcb, wayland, minimal, wayland-egl, eglfs, minimalegl, linuxfb, vkkhrdisplay.
原因是由于没有安装桌面系统。所以安装 xvfb
sudo dnf install xorg-x11-server-Xvfb
sudo Xvfb :99 -ac -screen 0 1200x900x24 &
export DISPLAY=:99.0
文档
安装 rpm-build 的相关 rpm 包
dnf -y install rpm-build rpmdevtools
生成打包目录结构
[root@111c5317c4e6 /]# rpmdev-setuptree
[root@111c5317c4e6 ~]# ls -a
. .bash_logout .bashrc .cshrc .rpmmacros .tcshrc rpmbuild
.. .bash_profile .cache .local .ssh .viminfo
[root@111c5317c4e6 /]# cd /root/rpmbuild/
[root@111c5317c4e6 rpmbuild]# ls
BUILD RPMS SOURCES SPECS SRPMS
可以通过如下的命令查看工作目录的路径：
[root@111c5317c4e6 ~]# rpmbuild --showrc | grep topdir
-13: _builddir %{_topdir}/BUILD
-13: _rpmdir %{_topdir}/RPMS
-13: _sourcedir %{_topdir}/SOURCES
-13: _specdir %{_topdir}/SPECS
-13: _srcrpmdir %{_topdir}/SRPMS
-13: _topdir %(echo $HOME)/rpmbuild
构建脚本
使用 build_linux.sh
# 仅构建 AppImage
./Script/build_linux.sh --appimage
# 仅构建 deb 包
./Script/build_linux.sh --deb
# 仅编译 rpm 包
./Script/build_linux.sh --rpm
# 如果同时构建 deb、rpm 包和 AppImage，请用 docker 。否则 qt 可能会产生污染。
./Script/build_linux.sh --docker --deb --appimage --rpm
分步构建
# 如果是从 [Qt官网](download.qt.io) 安装的 Qt
export QT_ROOT=
export Qt6_ROOT=$QT_ROOT
export QMAKE=$QT_ROOT/bin/qmake
# 如果是系统自带的 Qt
export QT_SELECT=qt6
# 注意：下面环境变量一定要使用绝对路径
export BUILD_DIR=`pwd`/build
export INSTALL_DIR=$BUILD_DIR/install
export SOURCE_DIR=$BUILD_DIR/source
export TOOLS_DIR=$BUILD_DIR/tools
# 安装依赖库
sudo ./Script/build_depend.sh --apt_update --base --default --rabbitcommon \
--tigervnc --pcapplusplus \
--install ${INSTALL_DIR} \
--source ${SOURCE_DIR} \
--tools ${TOOLS_DIR} \
--build ${BUILD_DIR}
# 设置环境变量
export RabbitCommon_ROOT=${SOURCE_DIR}/RabbitCommon
export tigervnc_DIR=${INSTALL_DIR}/lib/cmake/tigervnc
export PcapPlusPlus_DIR=${INSTALL_DIR}/lib/cmake/pcapplusplus
# 构建 deb 包
./Script/build_debpackage.sh
# 构建 AppImage
./Script/build_appimage.sh
deploy.sh: 分发版本。仅由管理员使用。
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手