TSPSG Installation Guide

Author:
Copyright © 2007-2010 Lёppa <contacts[at]oleksii[dot]name>
Id
install.dox 111 2010-04-27 23:40:22Z laleppa
URL
https://tspsg.svn.sourceforge.net/svnroot/tspsg/trunk/docs/dox/install.dox

Thank you for trying TSPSG. This document will guide you through the steps necessary to compile and run TSPSG.


Table of Contents

  1. REQUIREMENTS
  2. ASSUMPTIONS
  3. SUPPORTED PLATFORMS
  4. BUILDING AND INSTALLATION
    1. GENERAL INSTALLATION PROCEDURE
    2. LINUX/UNIX
    3. WINDOWS
      1. USING MINGW
      2. USING VISUAL STUDIO
    4. WINDOWS CE/MOBILE
    5. SYMBIAN
    6. OTHER PLATFORMS, SUPPORTED BY QT
  5. UNINSTALLATION
  6. TROUBLESHOOTING
    1. WINDRES.EXE CRASH
  7. NOTES
  8. REFERNECES

REQUIREMENTS

To be able compile TSPSG you need to have Qt libraries[1]. The minimum supported version of Qt is 4.4.0. The recommended version is 4.5.x or higher.

Note:
Please, note that there will be some regressions in functionality if your version of Qt is lower than the recommended.


ASSUMPTIONS

This guide assumes that you already have Qt libraries and all necessary prerequisites installed.

Also, the following assumptions are made:



SUPPORTED PLATFORMS

TSPSG is oficially supported and tested on the following platforms:



BUILDING AND INSTALLATION

GENERAL INSTALLATION PROCEDURE

On most platforms the general building and installation procedure is:

  1. Run lrelease to generate binary translation files (.qm) from the source (.ts).
  2. Run qmake with CONFIG+=release parameter to generate makefiles.
  3. Run make utility (e.g., make, nmake, mingw32-make) to build TSPSG.
  4. Run make utility with install parameter.
Note:
It is important to run lrelease before qmake, or qmake will not "pick up" the translations when generating installation rules.

LINUX/UNIX

Open a shell, navigate to the directory where you have TSPSG source downloaded and type

tar xvjf \b TSPSG-<VERSION>-src.tar.bz2
cd \b TSPSG-<VERSION>-src

where <VERSION> is the version of TSPSG you downloaded. Now run

lrelease tspsg.pro
qmake tspsg.pro
make

In some cases you may need to type

qmake tspsg.pro CONFIG+=release

If make step finished without errors you can install TSPSG by running

sudo make install

or

su
make install

depending on your distribution.

By default, executable will go to /usr/bin, COPYING.txt and README.txt will go to /usr/share/TSPSG, translations will go /usr/share/TSPSG/l10n, all docs will go to /usr/share/doc/TSPSG-<VERSION>.


WINDOWS

Note:
Please, read the section NOTES after reading this section.

USING MINGW

Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Qt Command Prompt from the Start Menu, navigate to the directory where you unpacked the source and run

lrelease tspsg.pro
qmake tspsg.pro CONFIG+=release
mingw32-make
Note:
Make process may fail with a crash of windres.exe. If you've run into this issue, please, read the section WINDRES.EXE CRASH.

If make step finished without errors you can install TSPSG by running

mingw32-make install

TSPSG will be installed to %PROGRAMFILES%\TSPSG folder (usually, it is C:\Program Files\TSPSG).

USING VISUAL STUDIO

Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Visual Studio Command Prompt from the Start Menu, navigate to the directory where you unpacked the source and run

C:\Qt\bin\lrelease tspsg.pro
C:\Qt\bin\qmake tspsg.pro CONFIG+=release
nmake

If make step finished without errors you can install TSPSG by running

nmake install

TSPSG will be installed to %PROGRAMFILES%\TSPSG folder (usually, it is C:\Program Files\TSPSG).


WINDOWS CE/MOBILE

Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Visual Studio Command Prompt from the Start Menu and run

set PATH=C:\Qt\bin;\%PATH\%
setcepaths wincewm50pocket-msvc2008

Now navigate to the directory where you unpacked the source and run

lrelease tspsg.pro
qmake tspsg.pro CONFIG+=release
nmake

There is no automated installation process for Windows Mobile build. To install TSPSG on your PDA you need to create a folder on your device and copy the following files to it:


SYMBIAN

Unpack the downloaded source code of TSPSG with your favourite compression software. Now launch the Qt for Symbian Command Prompt from the Start Menu, navigate to the directory where you unpacked the source and run

lrelease tspsg.pro
qmake tspsg.pro CONFIG+=release
make release-gcce
Warning:
You need to unpack the source to the same drive as Symbian SDK and the path must not contain any spaces or TSPSG won't build.

If make step finished without errors you can generate sis installation file by running

make sis

You'll get TSPSG.sis file in the source directory. Copy it to your phone and run or install it using Nokia PC Suite.

Note:
You need to install Qt libraries on your device before installing TSPSG. Usually, it should be enough to install qt_installer.sis from the Qt installation directory.

Alternatively, if you have installed Nokia Smart Installer[2] you can run

make installer_sis

You'll get an TSPSG_installer.sis that will automatically download and install the required Qt libraries on TSPSG installation.

Note:
Please, be aware that you have to sign the sis file to be able to install it on your device. You can use Open Signed Online[3] to quickly sign the sis file for your device. Alternatively, you can try to enable the installation of self-signed files in the phone settings. Please, reffer to your phone manual on the instructions how to do this.

OTHER PLATFORMS, SUPPORTED BY QT

While TSPSG is oficially supported only on Linux, Windows and Windows Mobile it should be possible to compile it on any platform, supported by Qt. To do so, please, refer to the section GENERAL INSTALLATION PROCEDURE for the general build and installation procedure.



UNINSTALLATION

Usually, it is enough to replace install parameter with uninstall in the installation command from the section BUILDING AND INSTALLATION. Alternatively, you can manually delete all installed TSPSG files and directories.



TROUBLESHOOTING

WINDRES.EXE CRASH

When building under Windows using minGW toolchain make process may fail with windres.exe crash (access violation). This is a known bug in windres.exe regarding processing resource files with UTF-8 (cp65001) encoding[4]. To be able to successfully build TSPSG you will need to download and replace windres.exe with a fixed version. To do this:

  1. Open https://sourceforge.net/projects/mingw/files/ in your favourite browser.
  2. Find and download the latest version of GNU Binutils. At the time of writing this guide it was binutils-2.20.1-2-mingw32-bin.tar.gz.
  3. Unpack the file bin\windres.exe from the downloaded archive to <Your Qt installation path>\mingw\bin\ replacing the existing one.
  4. Now run
    mingw32-make distclean
    
    in the TSPSG directory and repeat the installation process.


NOTES

qmake doesn't always enclose installation paths in quotes. This may cause some files not to be installed or removed when their path contains spaces. In this case it is safe to delete these files and TSPSG installation directory manually.



REFERNECES

  1. ^ http://qt.nokia.com/
  2. ^ http://qt.nokia.com/developer/nokia-smart-installer-for-symbian
  3. ^ https://www.symbiansigned.com/app/page/public/openSignedOnline.do
  4. ^ http://sourceware.org/bugzilla/show_bug.cgi?id=10165
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Defines

Generated on Wed Apr 28 02:47:14 2010 for TSPSG: TSP Solver and Generator by  doxygen 1.6.1