tdesktop/MSVC.md

##Build instructions for Visual Studio 2013

###Prepare folder

Choose a folder for the future build, for example **D:\TBuild**. There you will have two folders, Libraries for third-party libs and tdesktop (or tdesktop-master) for the app.

###Clone source code

By git – in Git Bash go to /d/tbuild and run

 git clone https://github.com/telegramdesktop/tdesktop.git

or download in ZIP and extract to **D:\TBuild**, rename tdesktop-master to tdesktop to have D:\TBuild\tdesktop\Telegram.sln solution

###Prepare libraries

####OpenSSL 1.0.1h

https://www.openssl.org/related/binaries.html > OpenSSL for Windows > Download Win32 OpenSSL v1.0.1h (16 Mb)

Install to D:\TBuild\Libraries\OpenSSL-Win32, while installing Copy OpenSSL DLLs to choose The OpenSSL binaries (/bin) directory

####LZMA SDK 9.20

http://www.7-zip.org/sdk.html > Download LZMA SDK (C, C++, C#, Java) 9.20

Extract to D:\TBuild\Libraries

#####Building library

• Open in VS2013 D:\TBuild\Libraries\lzma\C\Util\LzmaLib\LzmaLib.dsw > One-way upgrade – OK
• For Debug and Release configurations
  • LzmaLib Properties > General > Configuration Type = Static library (.lib) – OK
  • LzmaLib Properties > Librarian > General > Target Machine = MachineX86 (/MACHINE:X86) – OK
• Build Debug configuration
• Build Release configuration

####zlib 1.2.8

http://www.zlib.net/ > Download zlib source code, version 1.2.8, zipfile format

Extract to *D:\TBuild\Libraries*

#####Building library

• Open in VS2013 D:\TBuild\Libraries\zlib-1.2.8\contrib\vstudio\vc11\zlibvc.sln > One-way upgrade – OK
• We are interested only in zlibstat project, but it depends on some custom pre-build step, so build all
• For Debug configuration
  • zlibstat Properties > C/C++ > Code Generation > Runtime Library = Multi-threaded Debug (/MTd) – OK
• For Release configuration
  • zlibstat Properties > C/C++ > Code Generation > Runtime Library = Multi-threaded (/MT) – OK
• Build Solution for Debug configuration – only zlibstat project builds successfully
• Build Solution for Release configuration – only zlibstat project builds successfully

####libexif 0.6.20

Get sources from https://github.com/telegramdesktop/libexif-0.6.20, by git – in Git Bash go to /d/tbuild/libraries and run

git clone https://github.com/telegramdesktop/libexif-0.6.20.git

or download in ZIP and extract to **D:\TBuild\Libraries**, rename libexif-0.6.20-master to libexif-0.6.20 to have D:\TBuild\Libraries\libexif-0.6.20\win32\lib_exif.sln solution

#####Building library

• Open in VS2013 D:\TBuild\Libraries\libexif-0.6.20\win32\lib_exif.sln
• Build Debug configuration
• Build Release configuration

####OpenAL Soft

Get sources by git – in Git Bash go to /d/tbuild/libraries and run

git clone git://repo.or.cz/openal-soft.git

to have D:\TBuild\Libraries\openal-soft\CMakeLists.txt

#####Building library

• Install CMake
• Go in cmd to *D:\TBuild\Libraries\openal-soft\build*
• Run cmake -G "Visual Studio 12 2013" -D LIBTYPE:STRING=STATIC ..
• Open in VS2013 D:\TBuild\Libraries\openal-soft\build\OpenAL.sln
• For Debug configuration
  • OpenAL32 Properties > C/C++ > Code Generation > Runtime Library = Multi-threaded Debug (/MTd) – OK
  • common Properties > C/C++ > Code Generation > Runtime Library = Multi-threaded Debug (/MTd) – OK
• For Release configuration
  • OpenAL32 Properties > C/C++ > Code Generation > Runtime Library = Multi-threaded (/MT) – OK
  • common Properties > C/C++ > Code Generation > Runtime Library = Multi-threaded (/MT) – OK

####libogg 1.3.2

Get sources from http://xiph.org/downloads/ – in ZIP and extract to *D:\TBuild\Libraries*

#####Building library

• Open in VS2013 D:\TBuild\Libraries\libogg-1.3.2\win32\VS2010\libogg_static.sln > One-way upgrade – OK
• Build Debug configuration
• Build Release configuration

####Opus codec, opusfile

Get sources by git – in Git Bash go to /d/tbuild/libraries and run

git clone git://git.opus-codec.org/opus.git
git clone git://git.xiph.org/opusfile.git

to have D:\TBuild\Libraries\opus\win32

#####Building libraries

• Open in VS2013 D:\TBuild\Libraries\opus\win32\VS2010\opus.sln > One-way upgrade – OK
• Build Debug configuration
• Build Release configuration
• Open in VS2013 D:\TBuild\Libraries\opusfile\win32\VS2010\opusfile.sln > One-way upgrade – OK
• For Debug and Release configurations
  • opusfile > C/C++ > General > Additional include directories > Add ../../../libogg-1.3.2/include;
• Build Debug configuration
• Build Release configuration

####Qt 5.3.1, slightly patched

http://download.qt-project.org/official_releases/qt/5.3/5.3.1/single/qt-everywhere-opensource-src-5.3.1.zip

Extract to **D:\TBuild\Libraries**, rename qt-everywhere-opensource-src-5.3.1 to QtStatic to have *D:\TBuild\Libraries\QtStatic\qtbase* folder

Apply patch – copy (with overwrite!) everything from *D:\TBuild\tdesktop\_qt_5_3_1_patch* to *D:\TBuild\Libraries\QtStatic*

#####Building library

• Install Python 3.3.2 from https://www.python.org/download/releases/3.3.2 > Windows x86 MSI Installer (3.3.2)
• Open VS2013 x86 Native Tools Command Prompt.bat (should be in *\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\Tools\Shortcuts* folder)

There go to Qt directory

D:
cd TBuild\Libraries\QtStatic

and after that run configure

configure -debug-and-release -opensource -confirm-license -static -opengl desktop -mp -nomake examples -platform win32-msvc2013

to configure Qt build. After configuration is complete run

nmake
nmake install

building (nmake command) will take really long time.

####Qt Visual Studio Addin 1.2.3

http://download.qt-project.org/official_releases/vsaddin/qt-vs-addin-1.2.3-opensource.exe

Close all VS2013 instances and install to default location

###Building Telegram Desktop

• Launch VS2013 for configuring Qt Addin
• QT5 > Qt Options > Add
  • Version name: QtStatic.5.3.1
  • Path: D:\TBuild\Libraries\QtStatic\qtbase
• Default Qt/Win version: QtStatic.5.3.1 – OK
• File > Open > Project/Solution > D:\TBuild\tdesktop\Telegram.sln
• Build \ Build Solution (Debug and Release configurations)