2019-04-03 20:51:14 +02:00
# Build instructions for Visual Studio 2019
2016-07-03 15:17:22 +02:00
2017-02-16 11:57:53 +01:00
- [Prepare folder ](#prepare-folder )
2017-09-06 11:12:27 +02:00
- [Install third party software ](#install-third-party-software )
- [Clone source code and prepare libraries ](#clone-source-code-and-prepare-libraries )
- [Build the project ](#build-the-project )
- [Qt Visual Studio Tools ](#qt-visual-studio-tools )
2016-07-03 15:17:22 +02:00
## Prepare folder
2014-06-25 22:15:34 +02:00
2017-09-28 11:40:26 +02:00
Choose an empty folder for the future build, for example **D:\\TBuild** . It will be named ** *BuildPath*** in the rest of this document. Create two folders there, ** *BuildPath*\\ThirdParty** and ** *BuildPath*\\Libraries**.
2016-10-11 11:56:51 +02:00
2019-04-03 20:51:14 +02:00
All commands (if not stated otherwise) will be launched from **x86 Native Tools Command Prompt for VS 2019.bat** (should be in **Start Menu > Visual Studio 2019** menu folder). Pay attention not to use any other Command Prompt.
2014-06-25 22:15:34 +02:00
2018-11-04 11:29:30 +01:00
### Obtain your API credentials
You will require **api_id** and **api_hash** to access the Telegram API servers. To learn how to obtain them [click here][api_credentials].
2017-09-06 11:12:27 +02:00
## Install third party software
2017-04-14 11:58:10 +02:00
2020-01-03 09:41:38 +01:00
* Download **Strawberry Perl** installer from [http://strawberryperl.com/ ](http://strawberryperl.com/ ) and install to ** *BuildPath*\\ThirdParty\\Strawberry**
2017-09-06 11:12:27 +02:00
* Download **NASM** installer from [http://www.nasm.us ](http://www.nasm.us ) and install to ** *BuildPath*\\ThirdParty\\NASM**
* Download **Yasm** executable from [http://yasm.tortall.net/Download.html ](http://yasm.tortall.net/Download.html ), rename to *yasm.exe* and put to ** *BuildPath*\\ThirdParty\\yasm**
* Download **MSYS2** installer from [http://www.msys2.org/ ](http://www.msys2.org/ ) and install to ** *BuildPath*\\ThirdParty\\msys64**
* Download **jom** archive from [http://download.qt.io/official_releases/jom/jom.zip ](http://download.qt.io/official_releases/jom/jom.zip ) and unpack to ** *BuildPath*\\ThirdParty\\jom**
2017-10-11 23:33:49 +02:00
* Download **Python 2.7** installer from [https://www.python.org/downloads/ ](https://www.python.org/downloads/ ) and install to ** *BuildPath*\\ThirdParty\\Python27**
2017-09-06 11:12:27 +02:00
* Download **CMake** installer from [https://cmake.org/download/ ](https://cmake.org/download/ ) and install to ** *BuildPath*\\ThirdParty\\cmake**
* Download **Ninja** executable from [https://github.com/ninja-build/ninja/releases/download/v1.7.2/ninja-win.zip ](https://github.com/ninja-build/ninja/releases/download/v1.7.2/ninja-win.zip ) and unpack to ** *BuildPath*\\ThirdParty\\Ninja**
2020-07-04 01:40:48 +02:00
* Download **Git** installer from [https://git-scm.com/download/win ](https://git-scm.com/download/win ) and install it.
2017-04-14 11:58:10 +02:00
2019-04-03 20:51:14 +02:00
Open **x86 Native Tools Command Prompt for VS 2019.bat** , go to ** *BuildPath*** and run
2014-06-25 22:15:34 +02:00
2017-09-06 11:12:27 +02:00
cd ThirdParty
2019-10-02 13:43:54 +02:00
git clone https://github.com/desktop-app/patches.git
2019-11-05 09:33:13 +01:00
cd patches
2020-08-10 14:13:11 +02:00
git checkout b2ee1fb
2019-11-05 09:33:13 +01:00
cd ../
2019-10-02 13:43:54 +02:00
git clone https://chromium.googlesource.com/external/gyp
2017-09-06 11:12:27 +02:00
cd gyp
2019-10-02 13:43:54 +02:00
git checkout 9f2a7bb1
git apply ../patches/gyp.diff
2017-09-06 11:12:27 +02:00
cd ..\..
2014-06-25 22:15:34 +02:00
2017-09-06 11:12:27 +02:00
Add **GYP** and **Ninja** to your PATH:
2014-06-25 22:15:34 +02:00
2017-09-06 11:12:27 +02:00
* Open **Control Panel** -> **System** -> **Advanced system settings**
* Press **Environment Variables...**
* Select **Path**
* Press **Edit**
* Add ** *BuildPath*\\ThirdParty\\gyp** value
* Add ** *BuildPath*\\ThirdParty\\Ninja** value
2016-10-11 11:56:51 +02:00
2017-09-06 11:12:27 +02:00
## Clone source code and prepare libraries
2014-06-25 22:15:34 +02:00
2019-04-03 20:51:14 +02:00
Open **x86 Native Tools Command Prompt for VS 2019.bat** , go to ** *BuildPath*** and run
2014-06-25 22:15:34 +02:00
2020-01-03 09:41:38 +01:00
SET PATH=%cd%\ThirdParty\Strawberry\perl\bin;%cd%\ThirdParty\Python27;%cd%\ThirdParty\NASM;%cd%\ThirdParty\jom;%cd%\ThirdParty\cmake\bin;%cd%\ThirdParty\yasm;%PATH%
2015-10-19 23:24:39 +02:00
2017-09-06 11:12:27 +02:00
git clone --recursive https://github.com/telegramdesktop/tdesktop.git
mkdir Libraries
cd Libraries
2019-10-11 08:32:26 +02:00
SET LibrariesPath=%cd%
2019-10-02 13:43:54 +02:00
git clone https://github.com/desktop-app/patches.git
2019-11-05 09:33:13 +01:00
cd patches
2020-07-16 10:52:05 +02:00
git checkout 7df6fdd
2019-11-05 13:27:42 +01:00
cd ..
2017-11-19 15:37:07 +01:00
2019-11-05 13:27:42 +01:00
git clone https://github.com/desktop-app/lzma.git
2017-09-06 11:12:27 +02:00
cd lzma\C\Util\LzmaLib
msbuild LzmaLib.sln /property:Configuration=Debug
msbuild LzmaLib.sln /property:Configuration=Release
cd ..\..\..\..
2015-10-19 23:24:39 +02:00
2019-10-11 08:32:26 +02:00
git clone https://github.com/openssl/openssl.git openssl_1_1_1
cd openssl_1_1_1
git checkout OpenSSL_1_1_1-stable
2020-07-12 21:35:19 +02:00
perl Configure no-shared no-tests debug-VC-WIN32
2019-10-11 08:32:26 +02:00
nmake
mkdir out32.dbg
move libcrypto.lib out32.dbg
move libssl.lib out32.dbg
2019-10-17 17:07:54 +02:00
move ossl_static.pdb out32.dbg\ossl_static
nmake clean
move out32.dbg\ossl_static out32.dbg\ossl_static.pdb
perl Configure no-shared VC-WIN32
nmake
mkdir out32
move libcrypto.lib out32
move libssl.lib out32
move ossl_static.pdb out32
2017-09-06 11:12:27 +02:00
cd ..
2014-06-25 22:15:34 +02:00
2019-11-05 13:27:42 +01:00
git clone https://github.com/desktop-app/zlib.git
2017-09-06 11:12:27 +02:00
cd zlib
cd contrib\vstudio\vc14
msbuild zlibstat.vcxproj /property:Configuration=Debug
msbuild zlibstat.vcxproj /property:Configuration=ReleaseWithoutAsm
cd ..\..\..\..
2014-09-04 09:33:44 +02:00
2019-04-03 20:51:14 +02:00
git clone https://github.com/telegramdesktop/openal-soft.git
2016-04-26 17:26:18 +02:00
cd openal-soft
2019-05-23 09:03:40 +02:00
git checkout fix_capture
2017-09-06 11:12:27 +02:00
cd build
2019-04-04 19:51:06 +02:00
cmake -G "Visual Studio 16 2019" -A Win32 -D LIBTYPE:STRING=STATIC -D FORCE_STATIC_VCRT:STRING=ON ..
2018-11-08 12:26:44 +01:00
msbuild OpenAL.vcxproj /property:Configuration=Debug
msbuild OpenAL.vcxproj /property:Configuration=Release
2017-09-06 11:12:27 +02:00
cd ..\..
git clone https://github.com/google/breakpad
cd breakpad
git checkout a1dbcdcb43
git apply ../../tdesktop/Telegram/Patches/breakpad.diff
cd src
git clone https://github.com/google/googletest testing
cd client\windows
gyp --no-circular-check breakpad_client.gyp --format=ninja
cd ..\..
ninja -C out/Debug common crash_generation_client exception_handler
ninja -C out/Release common crash_generation_client exception_handler
2018-08-27 17:08:16 +02:00
cd tools\windows\dump_syms
gyp dump_syms.gyp
msbuild dump_syms.vcxproj /property:Configuration=Release
cd ..\..\..\..\..
2014-09-04 09:33:44 +02:00
2015-06-01 14:44:10 +02:00
git clone https://github.com/telegramdesktop/opus.git
2017-08-05 19:13:19 +02:00
cd opus
2017-09-06 11:12:27 +02:00
git checkout tdesktop
cd win32\VS2015
msbuild opus.sln /property:Configuration=Debug /property:Platform="Win32"
msbuild opus.sln /property:Configuration=Release /property:Platform="Win32"
2014-09-04 09:33:44 +02:00
2017-09-11 13:04:25 +02:00
cd ..\..\..\..
2017-09-06 11:12:27 +02:00
SET PATH_BACKUP_=%PATH%
SET PATH=%cd%\ThirdParty\msys64\usr\bin;%PATH%
cd Libraries
2014-09-04 09:33:44 +02:00
2015-10-19 23:24:39 +02:00
git clone https://github.com/FFmpeg/FFmpeg.git ffmpeg
cd ffmpeg
2017-11-23 16:00:11 +01:00
git checkout release/3.4
2014-09-04 09:33:44 +02:00
2017-09-06 11:12:27 +02:00
set CHERE_INVOKING=enabled_from_arguments
set MSYS2_PATH_TYPE=inherit
bash --login ../../tdesktop/Telegram/Patches/build_ffmpeg_win.sh
2015-06-01 14:49:53 +02:00
2017-09-06 11:12:27 +02:00
SET PATH=%PATH_BACKUP_%
2017-09-11 13:04:25 +02:00
cd ..
2016-10-17 22:20:30 +02:00
2020-03-01 12:38:25 +01:00
git clone git://code.qt.io/qt/qt5.git qt_5_12_8
cd qt_5_12_8
2015-10-19 23:24:39 +02:00
perl init-repository --module-subset=qtbase,qtimageformats
2020-03-01 12:38:25 +01:00
git checkout v5.12.8
2020-05-12 17:43:39 +02:00
git submodule update qtbase qtimageformats
2019-10-17 17:07:54 +02:00
cd qtbase
2020-06-02 12:14:51 +02:00
for /r %i in (..\..\patches\qtbase_5_12_8\*) do git apply %i
2020-06-12 07:07:02 +02:00
cd ..
2017-02-16 11:57:53 +01:00
2020-03-01 12:38:25 +01:00
configure -prefix "%LibrariesPath%\Qt-5.12.8" -debug-and-release -force-debug-info -opensource -confirm-license -static -static-runtime -I "%LibrariesPath%\openssl_1_1_1\include" -no-opengl -openssl-linked OPENSSL_LIBS_DEBUG="%LibrariesPath%\openssl_1_1_1\out32.dbg\libssl.lib %LibrariesPath%\openssl_1_1_1\out32.dbg\libcrypto.lib Ws2_32.lib Gdi32.lib Advapi32.lib Crypt32.lib User32.lib" OPENSSL_LIBS_RELEASE="%LibrariesPath%\openssl_1_1_1\out32\libssl.lib %LibrariesPath%\openssl_1_1_1\out32\libcrypto.lib Ws2_32.lib Gdi32.lib Advapi32.lib Crypt32.lib User32.lib" -mp -nomake examples -nomake tests -platform win32-msvc
2017-02-16 11:57:53 +01:00
2017-09-06 11:12:27 +02:00
jom -j4
jom -j4 install
2016-05-19 13:29:06 +02:00
cd ..
2014-06-25 22:15:34 +02:00
2017-09-06 11:12:27 +02:00
## Build the project
2017-02-18 20:23:50 +01:00
2019-12-31 13:08:56 +01:00
Go to ** *BuildPath*\\tdesktop\\Telegram** and run (using [your **api_id** and **api_hash** ](#obtain-your-api-credentials ))
2017-02-18 20:23:50 +01:00
2020-08-10 16:10:42 +02:00
configure.bat -D TDESKTOP_API_ID=YOUR_API_ID -D TDESKTOP_API_HASH=YOUR_API_HASH -D DESKTOP_APP_USE_PACKAGED=OFF -D DESKTOP_APP_DISABLE_CRASH_REPORTS=OFF
2016-08-14 20:41:31 +02:00
2019-12-31 13:08:56 +01:00
* Open ** *BuildPath*\\tdesktop\\out\\Telegram.sln** in Visual Studio 2019
2017-09-06 11:12:27 +02:00
* Select Telegram project and press Build > Build Telegram (Debug and Release configurations)
* The result Telegram.exe will be located in **D:\TBuild\tdesktop\out\Debug** (and **Release** )
2016-08-14 20:41:31 +02:00
2017-09-06 11:12:27 +02:00
### Qt Visual Studio Tools
2016-08-14 20:41:31 +02:00
2017-09-06 11:12:27 +02:00
For better debugging you may want to install Qt Visual Studio Tools:
2016-08-14 20:41:31 +02:00
2020-06-10 06:08:51 +02:00
* Open **Extensions** -> **Manage Extensions**
2017-09-06 11:12:27 +02:00
* Go to **Online** tab
* Search for **Qt**
* Install **Qt Visual Studio Tools** extension
2018-11-04 11:29:30 +01:00
[api_credentials]: api_credentials.md