Hacking:Building: Difference between revisions

From Seamly
Content added Content deleted
(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.