Hacking:Building: Difference between revisions
(Created page with "Main repository: https://bitbucket.org/dismine/valentina<br /> Mirror on GitHub: https://github.com/dismine/Valentina") |
No edit summary |
||
Line 1: | Line 1: | ||
__TOC__ |
|||
== Getting the sources == |
|||
Main repository: https://bitbucket.org/dismine/valentina<br /> |
Main repository: https://bitbucket.org/dismine/valentina<br /> |
||
Mirror on GitHub: https://github.com/dismine/Valentina |
Mirror on GitHub: https://github.com/dismine/Valentina |
||
=== From the download section === |
|||
Just download the Valentina sources from the [https://bitbucket.org/dismine/valentina/downloads/ downloads section] and extract it. |
|||
The source tarball is called <code>valentina-v.X.Y.Z.tar.gz</code> where <code>X.Y.Z</code> is the version number. |
|||
=== With mercurial === |
|||
To get a copy of Valentina's repository, run: |
|||
<source lang=bash> |
|||
hg clone https://bitbucket.org/dismine/valentina |
|||
cd $SOURCE_DIRECTORY |
|||
</source> |
|||
To update that repository, run: |
|||
<source lang=bash> |
|||
hg pull |
|||
hg up |
|||
</source> |
|||
== Dependencies == |
|||
Prerequisites: |
|||
* Qt 5.2.1 or later (On Unix development packages needed) |
|||
For Windows visit webpage: [https://www.qt.io/download/ Download Qt]. |
|||
* mercurial (TortoiseHG is recommended.) |
|||
* ccache (on Linux) |
|||
* g++ (at least GCC 4.6 is needed and GCC 4.8 is recommended) |
|||
* MinGW or Visual Studio |
|||
== Configuring and building == |
|||
The installed toolchains have to match the one Qt was compiled with. |
|||
You can build Valentina |
|||
<source lang=bash> |
|||
cd $SOURCE_DIRECTORY |
|||
qmake -r |
|||
make (or mingw32-make or nmake or jom, depending on your platform) |
|||
</source> |
|||
Note:In order to build and use Valentina, the PATH environment variable needs to be extended: |
|||
PATH - to locate qmake, moc and other Qt tools This is done by adding c:\Qt\%VERSION%\bin to the PATH variable. |
|||
For newer versions of Windows, PATH can be extended through the Control Panel|System|Advanced|Environment variables menu. |
|||
You may also need to ensure that the locations of your compiler and other build tools are listed in the PATH variable. This will depend on your choice of software development environment. |
|||
== Issues with build == |
|||
If you have issues with build Valentina check if you satisfy all dependencies. If this not help, [[Hacking:How To Report Valentina Bugs|create new issue in the issues tracker]] or new topic in the [https://groups.google.com/forum/#!forum/valentina-project-list mailing list]. Add information about your system and full log of compilation. We also need information about what branch did you fail try to build. |
|||
Current known issue, and solution, on building with QtCreator 3.4.0 based on Qt 5.4.1 on Windows 8 64-bit with Avira AntiVirus Pro version 15.0.10.434 (as of June 11 2015): Build fails with 'file previously exists' errors when writing build files to destination directory. Problem is based on Avira scanning each file causing delay, Qt retries writing the file and generates the error. Other versions of Qt Creator and Avira may exhibit similar behavior. Set Avira Real-Time Protection to 'off' before building. |
Revision as of 14:36, 26 May 2016
Getting the sources
Main repository: https://bitbucket.org/dismine/valentina
Mirror on GitHub: https://github.com/dismine/Valentina
From the download section
Just download the Valentina sources from the downloads section and extract it.
The source tarball is called valentina-v.X.Y.Z.tar.gz
where X.Y.Z
is the version number.
With mercurial
To get a copy of Valentina's repository, run:
hg clone https://bitbucket.org/dismine/valentina
cd $SOURCE_DIRECTORY
To update that repository, run:
hg pull
hg up
Dependencies
Prerequisites:
- Qt 5.2.1 or later (On Unix development packages needed)
For Windows visit webpage: Download Qt.
- mercurial (TortoiseHG is recommended.)
- ccache (on Linux)
- g++ (at least GCC 4.6 is needed and GCC 4.8 is recommended)
- MinGW or Visual Studio
Configuring and building
The installed toolchains have to match the one Qt was compiled with.
You can build Valentina
cd $SOURCE_DIRECTORY
qmake -r
make (or mingw32-make or nmake or jom, depending on your platform)
Note:In order to build and use Valentina, the PATH environment variable needs to be extended:
PATH - to locate qmake, moc and other Qt tools This is done by adding c:\Qt\%VERSION%\bin to the PATH variable.
For newer versions of Windows, PATH can be extended through the Control Panel|System|Advanced|Environment variables menu.
You may also need to ensure that the locations of your compiler and other build tools are listed in the PATH variable. This will depend on your choice of software development environment.
Issues with build
If you have issues with build Valentina check if you satisfy all dependencies. If this not help, create new issue in the issues tracker or new topic in the mailing list. Add information about your system and full log of compilation. We also need information about what branch did you fail try to build.
Current known issue, and solution, on building with QtCreator 3.4.0 based on Qt 5.4.1 on Windows 8 64-bit with Avira AntiVirus Pro version 15.0.10.434 (as of June 11 2015): Build fails with 'file previously exists' errors when writing build files to destination directory. Problem is based on Avira scanning each file causing delay, Qt retries writing the file and generates the error. Other versions of Qt Creator and Avira may exhibit similar behavior. Set Avira Real-Time Protection to 'off' before building.