Skip to content

Latest commit

 

History

History
98 lines (71 loc) · 5.12 KB

INSTALL.md

File metadata and controls

98 lines (71 loc) · 5.12 KB
Raw

##Installation


- [Unix-like](#unix-like-linux-unix-os-x) - [Troubleshooting](#troubleshooting) - [Windows](#windows)
- [Building using Qt Creator](#building-using-qt-creator)

###Dependencies

Name Version
Qt >= 5.2.0
C++ compiler supporting C++11 (i.e. gcc 4.6+)
toxcore most recent

###Unix-like (Linux, Unix, OS X):

Grab and install Qt 5.2.0+ from qt-project website (alternatively you could get it from your distro's package repository).

Then install toxcore following this instructions.

Clone this repo and build it with Qt's qmake:

git clone https://github.com/nurupo/ProjectTox-Qt-GUI.git
cd ProjectTox-Qt-GUI
mkdir build && cd build
qmake -Wall ../projectfiles/QtCreator/TOX-Qt-GUI.pro
make

On success, this will produce a TOX-Qt-GUI executable.

See building using Qt Creator if you want to build the project by using Qt Creator IDE, rather than shell commands.

####Troubleshooting

  • On OS X you may get a warning while running qmake: "WARNING: Could not resolve Info.plist: 'Info.plist.app'. Check if QMAKE_INFO_PLIST points to a valid file", just disregard it and run make.

  • If Qt complains about missing GL library, install libgl-dev package. The exact package name might differ from distribution to distribution, but you get the idea of what you should look for.

  • Note that qmake might not be found by bash or it might be found, but from Qt4 installation. In the case of qmake not working, make sure you use the right qmake. If you have installed Qt5 from the qt-project website, you should specify the full path to Qt's qmake, since it's not added to /user/bin/. For example, in my case I used /home/nurupo/Qt5.2.0/5.2.0/gcc_64/bin/qmake.

###Windows

Grab and install MinGW version of Qt 5.2.0+ from qt-project website. The MinGW version includes MinGW compiler, so you don't have to bother with installing one manually.

Download and extract a ZIP archive of this repo's master branch, or, if you have git, clone it:

git clone https://github.com/nurupo/ProjectTox-Qt-GUI.git

Get toxcore appropriate for the platform your toolchain targets: toxcore-32bit or toxcore-64bit. If you use MinGW compiler that came with Qt MinGW, then you want toxcore-32bit.

Create libs directory in repo's root and extract contents of the toxcore archive in there.

Run cmd.exe, navigate to the repo' directory and run:

set PATH=%PATH%;C:\wherever\is\your\Qt\installed\Tools\mingw48_32\bin\
cd projectfiles && mkdir build && cd build
C:\wherever\is\your\Qt\installed\5.2.0\mingw48_32\bin\qmake.exe -Wall ../QtCreator/TOX-Qt-GUI.pro
C:\wherever\is\your\Qt\installed\Tools\mingw48_32\bin\mingw32-make.exe

On success, this will produce a TOX-Qt-GUI.exe binary. If you used Qt from qt-project webite, your binary would be dynamically linked to Qt's libraries, i.e. the executable would require Qt's dlls from C:\wherever\is\your\Qt\installed\5.2.0\mingw48_32\bin\ in order to run.

See building using Qt Creator if you want to build the project by using Qt Creator IDE, rather than shell commands.

##Building using Qt Creator

Qt Creator is cross-platform, so the next instructions should be valid for all platforms.

If you downloaded Qt from the qt-project website, then it's likely that you already have it installed in the Qt's directory. Some generic Qt packages on Linux also install it.

To build the project with Qt Creator:

  1. Open the Qt Creator.
  2. Select File -> Open File or Project....
  3. Select the project file located at ProjectTox-Qt-GUI\projectfiles\QtCreator\TOX-Qt-GUI.pro.
  4. You will be prompted to configure the project, select one set of Qt5.2.0+ libraries (Release and Debug) and click on Configure Project.
  5. You will see two Debugs on the left, click on the lowest one and switch it to Release.
  6. Optional: if you want to speed up the building process a little:
  7. Click on Projects on the left.
  8. Under Build Steps find Make.
  9. Click on its Details.
  10. Add -jN to the Make arguments, where N is a number of cores your processor has + 1. For example, if your machine is dual core, add -j3.
  11. Close the Details.
  12. Click the big green arrow on bottom left (or press Ctlr+R), that should build and run the project in Release mode.
  13. Wait for it to be built.
  14. You should have a binary in whenever Project (on the left) -> Build directory points to.

Here is a screen capture of the process: Building-using-Qt-Creator.webm.