qTox项目安装与编译完全指南

qTox项目安装与编译完全指南

qTox qTox is a chat, voice, video, and file transfer IM client using the encrypted peer-to-peer Tox protocol. 项目地址: https://gitcode.com/gh_mirrors/qt/qTox

项目简介

qTox是一款基于Tox协议的跨平台即时通讯软件，提供端到端加密功能。作为一款开源软件，qTox支持Windows、Linux和macOS等多个操作系统平台。本文将详细介绍qTox在不同平台上的安装与编译方法。

系统依赖要求

在开始安装或编译qTox之前，需要确保系统满足以下基本依赖要求：

核心依赖

• Qt框架：版本≥5.7.1，需要包含concurrent、core、gui等模块
• GCC/MinGW编译器：版本≥4.8，需支持C++11标准
• toxcore库：版本≥0.2.10（Tox协议核心实现）
• FFmpeg多媒体框架：版本≥2.6.0
• CMake构建工具：版本≥3.7.2
• OpenAL Soft音频库：版本≥1.16.0
• qrencode二维码生成库：版本≥3.0.3
• sqlcipher加密数据库：版本≥3.2.0
• pkg-config工具：版本≥0.28

可选依赖

• 拼写检查支持：sonnet库（≥5.45）
• 桌面通知支持：snorenotify（≥0.7.0）
• 自动离开功能：libXScrnSaver和libX11库

Linux系统安装指南

通过包管理器直接安装

大多数主流Linux发行版都提供了qTox的预编译包：

• Arch Linux:

  pacman -S qtox
  

• Debian/Ubuntu:

  sudo apt install qtox
  

• Fedora:

  dnf install qtox
  

• Gentoo:

  emerge qtox
  

• openSUSE:

  zypper in qtox
  

从源码编译安装

1. 获取源代码

首先需要安装Git版本控制工具：

sudo apt install git  # Debian/Ubuntu
sudo dnf install git  # Fedora
sudo pacman -S git    # Arch

然后克隆qTox仓库：

git clone https://github.com/qTox/qTox.git
cd qTox

2. 安装编译依赖

不同发行版的依赖安装命令略有不同：

• Debian/Ubuntu:

  sudo apt install build-essential cmake libtool \
  libavcodec-dev libavdevice-dev libavfilter-dev \
  libavformat-dev libavutil-dev libswscale-dev \
  libopenal-dev libqrencode-dev libsqlcipher-dev \
  libsodium-dev libglib2.0-dev libgdk-pixbuf2.0-dev \
  libgtk2.0-dev libx11-dev libxss-dev qt5-default \
  qttools5-dev qttools5-dev-tools
  

• Arch Linux:

  sudo pacman -S base-devel cmake ffmpeg \
  openal qrencode sqlcipher libsodium \
  gtk2 qt5-base qt5-tools
  

3. 编译toxcore

qTox依赖于toxcore库，需要先编译安装：

git clone https://github.com/toktok/c-toxcore.git
cd c-toxcore
cmake . -DBOOTSTRAP_DAEMON=OFF
make -j$(nproc)
sudo make install

4. 编译qTox

完成依赖安装后，可以开始编译qTox：

mkdir build && cd build
cmake ..
make -j$(nproc)
sudo make install

编译完成后，可通过./qtox命令启动程序。

macOS系统安装指南

系统要求

• macOS版本≥10.15
• 需要安装Xcode命令行工具和Homebrew包管理器

安装步骤

1. 安装Homebrew：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 克隆qTox仓库：

   git clone https://github.com/qTox/qTox.git
   cd qTox
   

3. 安装依赖：

   brew bundle --file osx/Brewfile
   

4. 编译安装：

   mkdir -p _build && cd _build
   cmake .. -DCMAKE_PREFIX_PATH=$(brew --prefix qt@5)
   make -j$(sysctl -n hw.ncpu)
   make install
   

编译完成后会生成qTox.dmg安装包，可直接运行或安装到应用程序目录。

Windows系统安装

Windows平台推荐使用预编译的安装包。如需从源码编译，建议在Linux环境下进行交叉编译。

安全加固建议（Linux）

对于Linux用户，建议启用AppArmor安全模块来限制qTox的权限：

1. 安装AppArmor工具：

   sudo apt install apparmor apparmor-utils  # Debian/Ubuntu
   

2. 加载qTox配置文件：

   sudo aa-enforce /etc/apparmor.d/qtox
   

常见问题解决

1. 依赖缺失问题：

   • 使用apt-file search或类似命令查找缺失的头文件
   • 确保所有开发包(-dev或-devel后缀)已安装

2. 编译错误：

   • 检查CMake输出确认所有依赖已找到
   • 确保toxcore和toxext库已正确安装

3. 运行时错误：

   • 检查动态库路径是否包含/usr/local/lib
   • 运行ldconfig更新库缓存

通过本文介绍的方法，您应该能够在各主流操作系统上成功安装或编译qTox。如需更详细的平台特定指导，建议参考对应发行版的文档。

qTox qTox is a chat, voice, video, and file transfer IM client using the encrypted peer-to-peer Tox protocol. 项目地址: https://gitcode.com/gh_mirrors/qt/qTox