Skip to content

Latest commit

 

History

History
66 lines (50 loc) · 4.03 KB

how_to_build_win.md

File metadata and controls

66 lines (50 loc) · 4.03 KB
Raw

Building on Windows

This software can be built using Visual Studio 2022 and Qt 5.15

Required Software

Visual Studio Community 2022

CMake

Qt

Customized Qt v5.15.2 with WinTab support

  • The customized Qt5.15.2 are made with cherry-picking the WinTab feature to be officially introduced from 6.0.
  • You can build OT with WinTab support by using the prebuilt package of the customized version of Qt for MSVC2019-x64 provided here.

Acquiring the Source Code

  • Note: You can also perform these next commands with Github for Desktop client.
  • Clone the base repository.
  • Throughout the explanation $xdts_viewer will represent the root for the base repository.
  • Visual Studio cannot recognize UTF-8 without BOM source code properly. Furthermore, since the endline character is represented with only the LF character, one line comments in Japanese will often cause the following line to be treated as a comment by MSVS as well.
  • In order to prevent this, please change the following setting in git so that it will preserve the proper endline characters:
  • git config core.safecrlf true

Using CMake to Create a Visual Studio Project

  • Launch CMake
  • In Where is the source code, navigate to $xdts_viewer/sources
  • In Where to build the binaries, navigate to $xdts_viewer/build
    • Or to wherever you usually build to.
    • If the build directory is in the git repository, be sure to add the directory to .gitignore
    • If the build directory is different from the one above, be sure to change to the specified directory where appropriate below.
  • Click on Configure and select the version of Visual Studio you are using.
    • If Qt was installed to a directory other than the default, and the error Specify QTDIR properly appears, navigate to the QTDIR install folder and specify the path to msvc2019_64. Rerun Configure.
    • If red lines appear in the bottom box, you can safely ignore them.
  • Click Generate
  • Should the CMakeLists.txt file change, such as during automatic build cleanup, there is no need to rerun CMake.

Building

  • Open $xdts_viewer/build/xdts_viewer.sln and change to Debug or Release in the top bar.
  • Compile the build.
  • The output will be in the corresponding folder in $xdts_viewer/build/

Running the Program

Setting Up the Program's Path

  1. Copy the entire contents of $xdts_viewer/build/Release to an appropriate folder.

  2. Open a Command Prompt and navigate to QTDIR/msvc2015_64/bin. Run the Qt program windeployqt.exe with the path for xdts_viewer.exe as an argument. (Another way to do this is navigate to the exe that was created in your Release folder and drag and drop the IwaWarper.exe on top of the windeployqt.exe This will automatically generate the QT files and folders you will need.)

    • The necessary Qt library files should be in the same folder as xdts_viewer.exe

Copying the resource folder

  • Copy the entire folder $xdts_viewer/xdts_viewer_resources to the same folder as xdts_viewer.exe. This folder contains various settings, translation files, exposure sheet templates, etc. which are necessary for the software to work.

Running

xdts_viewer.exe can now be run. Congratulations!

Creating Translation Files

Qt translation files are generated first from the source code to .ts files, then from .ts files to a .qm file. These files can be created in Visual Studio if the translation_ project and Build translation_??? only (translation_???のみをビルド) is used. These files are not created in the default Build Project Solution.