编译为知笔记客户端

8/12/2020

简介

为知笔记桌面客户端开源,采用C++(QT)编写,GPL协议。可以在Windows/macOS/Linux上面编译运行: macOS Windows Linux (Ubuntu)

源代码仓库

https://github.com/WizTeam/WizQTClient 可以直接clone或者fork

一、开发环境准备

macOS

Qt

下载Qt 5.9.0 for OS X https://download.qt.io/official_releases/qt/5.9/5.9.0/qt-opensource-mac-x64-5.9.0.dmg

xcode

从AppStore安装即可。

CMake

从CMake官网下载dmg版本,直接拖动到应用程序目录。运行CMake程序,点击菜单->Tools->How to Install For Command Line Use,按照提示,选择安装到/usr/local/bin文件夹。 运行 QtCreator,点击菜单 - 偏好设置 - 构建和运行 - CMake 中,点击「Add」,在「Name」中输入:cmake,在「Path」中输入:/Applications/CMake.app/Contents/bin/cmake(注意:Path 所填写的路径取决于 CMake 的安装路径)。填写完毕后,点击「OK」

Windows

Qt

下载Qt 5.9.0 https://download.qt.io/official_releases/qt/5.9/5.9.0/qt-opensource-windows-x86-5.9.0.exe

Visual Studio 2013

也可以安装Express版本。需要包含Visual C++。

CMake for Window

安装后需要把CMake安装路径添加到系统路径里面。

Git

安装git 客户端,可以直接安装github桌面客户端,或者其他git客户端。

Debugging Tools for Windows

如果要在Windows下面调试QT程序,需要额外安装Debugging Tools for Windows(没有被包含在Visual Studio里面)。下载地址: https://developer.microsoft.com/en-us/windows/hardware/windows-driver-kit

Linux (Ubuntu)

Qt

安装 5.9.0 for Linux https://download.qt.io/official_releases/qt/5.9/5.9.0/qt-opensource-linux-x64-5.9.0.run 下载下来的安装文件,更改权限为可执行,然后执行安装程序。不要用管理员权限安装,直接安装到home目录即可,例如~/Qt5.9.0

Git

  1. sudo apt-get install git

编译工具

  1. sudo apt-get install build-essential

CMake

  1. sudo apt-get install cmake

zlib

  1. sudo apt-get install zlib1g-dev

二、Clone为知笔记源代码

可以直接clone。然后切换到分支v2.5.8或者更新的分支。也可以直接使用master分支(通常代码不是最新的) 对于Mac/Linux,可以在终端中运行:

  1. cd ~
  2. mkdir WizTeam
  3. cd WizTeam
  4. git clone https://github.com/WizTeam/WizQTClient.git
  5. cd WizQTClient
  6. git checkout v2.5.8

对于Windows,可以试用客户端clone,也可以使用命令行。 注意

  1. 如果要在windows下面编译,必须选择v2.4.4或者更新的分支,之前的版本不支持Windows。
  2. 如果参与了新同步方式内测,需要选择 2.5.0-beta 或以上分支,推荐 2.5.8 分支

三、编译源代码

运行QtCreator,选择打开~/WizTeam/WizQTClient/CMakeLists.txt这个文件 注:通常QtCreator在安装路径下面的Tools/QtCreator/bin这个文件夹里面 如果出现运行CMake对话框,在参数中,输入下面的参数:(如果不设置参数,则会按照Release方式编译)。

  1. -DCMAKE_BUILD_TYPE=Debug

点击安装Run CMake,此时将会开始配置工程。等待1分钟左右后,如果没有错误,Done按钮将可以点击。点击Done(Finish)按钮。 如果没有出现 CMake 对话框,在QtCreator左侧导航栏,点击左下角Project构建按钮,选择 Build Debug->Run WizNote,然后点击左下角Build按钮,就可以开始编译WizNote源代码了。 几分钟后,就可以开始调试或者运行为知笔记客户端了。 若出现错误:No CMAKE_CXX_COMPILER could be found. mac qt 点击「项目」,打开「构建设置」,在 CMake 构建目录中添加以下两个参数,重新构建即可: -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++

四、打包

mac

在WizQTClient目录里面运行

  1. ./mac-package-qt-5.9.sh

需要自行调整这个文件里面的路径设置。成功运行后可以生成一个dmg文件。

linux

在WizQTClient目录里面运行

  1. ./linux-package.sh

  2. 需要自行调整这个文件里面的路径设置

  3. 需要给WizQTClient目录里面的linuxdeployqt增加可执行权限

  4. chmod a+x linuxdeployqt

成功运行后可以生成一个AppImage文件,双击即可运行