vnote/zh_cn/docs/开发者/构建VNote.md
2021-07-13 19:28:45 +08:00

3.1 KiB
Raw Blame History

构建 VNote

您需要 Qt 5.12 或以上版本才能从源代码创建 VNote。

获取 VNote 的源代码

VNote 的源代码可在 GitHub 上获取。您可以下载代码的ZIP存档。请注意VNote 依赖于某些子模块,因此您还应该下载这些模块的源代码。

推荐的方法是像以下方式使用 git

git clone https://github.com/vnotex/vnote.git vnote.git
cd vnote.git
git submodule update --init --recursive

获取 Qt 5.12

您可以从 Qt Downloads 获取完整的 Qt SDK。对于中国大陆用户您可以通过 TUNA 镜像 加快下载速度。

Windows

在 Windows 上,您需要 Visual Studio 2015 或更高版本来编译 VNote (Mingw 受支持)。

打开 Qt Creator 并打开 vnote.git\vnote.pro 作为项目。现在您已准备好调整和编译 VNote

Linux

在Ubuntu中你可以像这样从PPA获得 Qt 5.12

sudo add-apt-repository ppa:beineri/opt-qt5.12.10-bionic -y
sudo apt-get update -qq
sudo apt-get -y install qt512base qt512webengine
sudo apt-get -y install qt512webchannel qt512svg qt512location qt512tools qt512translations
source /opt/qt*/bin/qt*-env.sh

然后像这样编译和安装 VNote

cd vnote.git
mkdir build
cd build
qmake ../vnote.pro
make
sudo make install

Fcitx

如果您使用 Fcitx 作为输入方式,则需要将缺少的库 libfcitxplatforminputcontextplugin.so 复制到 Qt 的插件目录。

要找到 libfcitxplatforminputcontextplugin.so 的位置,您可以执行:

fcitx-diagnose | grep libfcitxplatforminputcontextplugin.so

如果没有这样的库,您可能需要在继续之前为 Qt5 正确安装和配置 Fcitx。

然后您需要将库文件复制到 Qt 的插件目录:

<path_to_Qt_installation_directory>/5.12.10/gcc_64/plugins/platforminputcontexts/

OpenSSL

VNote 需要 openSSL 1.0 以实现联网。

安装 openSSL 后,您可以找到两个库文件:

/usr/lib/libcrypto.so.1.0.0
/usr/lib/libssl.so.1.0.0

将这两个文件复制到 Qt 的库目录中:

<path_to_Qt_installation_directory>/5.12.10/gcc_64/lib/

在Qt的库目录中为这两个文件创建符号链接

ln -s libcrypto.so.1.0.0 libcrypto.so
ln -s libssl.so.1.0.0 libssl.so

MacOS

如果您更喜欢 macOS 上的命令行操作方式,则可以按照以下步骤操作。

  1. 安装 Xcode 和 Homebrew;

  2. 通过 Homebrew 安装 Qt

    brew install qt@5.12.10
    
  3. 在项目目录中,像下面那样创建 build_macos.sh

    QTDIR="/usr/local/opt/qt@5.12.10"
    PATH="$QTDIR/bin:$PATH"
    LDFLAGS=-L$QTDIR/lib
    CPPFLAGS=-I$QTDIR/include
    
    mkdir -p build
    cd build
    qmake -v
    qmake CONFIG-=debug CONFIG+=release ../vnote.pro
    make -j2
    
  4. 使 build_macos.sh 可执行并运行它:

    chmod +x build_macos.sh
    ./build_macos.sh
    
  5. 现在你得到了bundle路径 path/to/project/build/src/vnote.app