2019-04-03 18:51:14 +00:00
# Build instructions for Visual Studio 2019
2016-07-03 13:17:22 +00:00
2017-02-16 10:57:53 +00:00
- [Prepare folder ](#prepare-folder )
2017-09-06 09:12:27 +00: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 13:17:22 +00:00
## Prepare folder
2014-06-25 20:15:34 +00:00
2017-09-28 09:40:26 +00: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 09:56:51 +00:00
2019-04-03 18:51:14 +00: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 20:15:34 +00:00
2018-11-04 10:29:30 +00: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 09:12:27 +00:00
## Install third party software
2017-04-14 09:58:10 +00:00
2020-01-03 08:41:38 +00:00
* Download **Strawberry Perl** installer from [http://strawberryperl.com/ ](http://strawberryperl.com/ ) and install to ** *BuildPath*\\ThirdParty\\Strawberry**
2017-09-06 09:12:27 +00: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 21:33:49 +00: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 09:12:27 +00: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-03 23:40:48 +00:00
* Download **Git** installer from [https://git-scm.com/download/win ](https://git-scm.com/download/win ) and install it.
2021-05-18 15:03:38 +00:00
* Download **NuGet** executable from [https://dist.nuget.org/win-x86-commandline/latest/nuget.exe ](https://dist.nuget.org/win-x86-commandline/latest/nuget.exe ) and put to ** *BuildPath*\\ThirdParty\\NuGet**
2017-04-14 09:58:10 +00:00
2019-04-03 18:51:14 +00:00
Open **x86 Native Tools Command Prompt for VS 2019.bat** , go to ** *BuildPath*** and run
2014-06-25 20:15:34 +00:00
2017-09-06 09:12:27 +00:00
cd ThirdParty
2019-10-02 11:43:54 +00:00
git clone https://github.com/desktop-app/patches.git
2019-11-05 08:33:13 +00:00
cd patches
2021-04-19 07:27:09 +00:00
git checkout ad34925
2019-11-05 08:33:13 +00:00
cd ../
2019-10-02 11:43:54 +00:00
git clone https://chromium.googlesource.com/external/gyp
2017-09-06 09:12:27 +00:00
cd gyp
2019-10-02 11:43:54 +00:00
git checkout 9f2a7bb1
git apply ../patches/gyp.diff
2017-09-06 09:12:27 +00:00
cd ..\..
2014-06-25 20:15:34 +00:00
2017-09-06 09:12:27 +00:00
Add **GYP** and **Ninja** to your PATH:
2014-06-25 20:15:34 +00:00
2017-09-06 09:12:27 +00: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
2021-03-02 11:47:08 +00:00
* Add ** *BuildPath*\\ThirdParty\\NuGet** value
2016-10-11 09:56:51 +00:00
2017-09-06 09:12:27 +00:00
## Clone source code and prepare libraries
2014-06-25 20:15:34 +00:00
2019-04-03 18:51:14 +00:00
Open **x86 Native Tools Command Prompt for VS 2019.bat** , go to ** *BuildPath*** and run
2014-06-25 20:15:34 +00:00
2020-08-20 19:19:53 +00: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 21:24:39 +00:00
2017-09-06 09:12:27 +00:00
git clone --recursive https://github.com/telegramdesktop/tdesktop.git
mkdir Libraries
cd Libraries
2019-10-02 11:43:54 +00:00
git clone https://github.com/desktop-app/patches.git
2019-11-05 08:33:13 +00:00
cd patches
2021-04-19 07:27:09 +00:00
git checkout ad34925
2019-11-05 12:27:42 +00:00
cd ..
2017-11-19 14:37:07 +00:00
2019-11-05 12:27:42 +00:00
git clone https://github.com/desktop-app/lzma.git
2017-09-06 09:12:27 +00:00
cd lzma\C\Util\LzmaLib
2020-11-06 17:22:02 +00:00
msbuild LzmaLib.sln /property:Configuration=Debug /property:Platform="x86"
msbuild LzmaLib.sln /property:Configuration=Release /property:Platform="x86"
2017-09-06 09:12:27 +00:00
cd ..\..\..\..
2015-10-19 21:24:39 +00:00
2019-10-11 06:32:26 +00: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 19:35:19 +00:00
perl Configure no-shared no-tests debug-VC-WIN32
2019-10-11 06:32:26 +00:00
nmake
mkdir out32.dbg
move libcrypto.lib out32.dbg
move libssl.lib out32.dbg
2019-10-17 15:07:54 +00:00
move ossl_static.pdb out32.dbg\ossl_static
nmake clean
move out32.dbg\ossl_static out32.dbg\ossl_static.pdb
2020-09-04 16:12:03 +00:00
perl Configure no-shared no-tests VC-WIN32
2019-10-17 15:07:54 +00:00
nmake
mkdir out32
move libcrypto.lib out32
move libssl.lib out32
move ossl_static.pdb out32
2017-09-06 09:12:27 +00:00
cd ..
2014-06-25 20:15:34 +00:00
2019-11-05 12:27:42 +00:00
git clone https://github.com/desktop-app/zlib.git
2020-11-06 17:22:02 +00:00
cd zlib\contrib\vstudio\vc14
msbuild zlibstat.vcxproj /property:Configuration=Debug /property:Platform="x86"
msbuild zlibstat.vcxproj /property:Configuration=ReleaseWithoutAsm /property:Platform="x86"
2017-09-06 09:12:27 +00:00
cd ..\..\..\..
2014-09-04 07:33:44 +00:00
2020-10-07 02:21:20 +00:00
git clone -b v4.0.1-rc2 https://github.com/mozilla/mozjpeg.git
cd mozjpeg
cmake . ^
2020-11-06 17:22:02 +00:00
-G "Visual Studio 16 2019" ^
-A Win32 ^
-DWITH_JPEG8=ON ^
-DPNG_SUPPORTED=OFF
2020-10-30 18:51:54 +00:00
cmake --build . --config Debug
cmake --build . --config Release
2020-10-07 02:21:20 +00:00
cd ..
2020-11-25 15:48:22 +00:00
git clone https://github.com/kcat/openal-soft.git
2016-04-26 15:26:18 +00:00
cd openal-soft
2020-11-25 15:48:22 +00:00
git checkout openal-soft-1.21.0
2017-09-06 09:12:27 +00:00
cd build
2020-09-15 20:14:10 +00:00
cmake .. ^
2020-11-06 17:22:02 +00:00
-G "Visual Studio 16 2019" ^
-A Win32 ^
-D LIBTYPE:STRING=STATIC ^
-D FORCE_STATIC_VCRT=ON
2018-11-08 11:26:44 +00:00
msbuild OpenAL.vcxproj /property:Configuration=Debug
2020-10-29 11:25:30 +00:00
msbuild OpenAL.vcxproj /property:Configuration=RelWithDebInfo
2017-09-06 09:12:27 +00:00
cd ..\..
git clone https://github.com/google/breakpad
cd breakpad
git checkout a1dbcdcb43
2020-10-08 06:55:23 +00:00
git apply ../patches/breakpad.diff
2017-09-06 09:12:27 +00:00
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 15:08:16 +00:00
cd tools\windows\dump_syms
gyp dump_syms.gyp
msbuild dump_syms.vcxproj /property:Configuration=Release
cd ..\..\..\..\..
2014-09-04 07:33:44 +00:00
2015-06-01 12:44:10 +00:00
git clone https://github.com/telegramdesktop/opus.git
2017-08-05 17:13:19 +00:00
cd opus
2017-09-06 09:12:27 +00: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"
2021-04-19 09:41:32 +00:00
cd ..\..\..
2014-09-04 07:33:44 +00:00
2021-04-15 13:55:13 +00:00
git clone https://github.com/desktop-app/rnnoise.git
cd rnnoise
mkdir out
cd out
cmake -A Win32 ..
cmake --build . --config Debug
cmake --build . --config Release
2021-04-19 09:41:32 +00:00
cd ..\..
2021-04-15 13:55:13 +00:00
2021-04-19 09:41:32 +00:00
cd ..
2017-09-06 09:12:27 +00:00
SET PATH_BACKUP_=%PATH%
SET PATH=%cd%\ThirdParty\msys64\usr\bin;%PATH%
cd Libraries
2014-09-04 07:33:44 +00:00
2015-10-19 21:24:39 +00:00
git clone https://github.com/FFmpeg/FFmpeg.git ffmpeg
cd ffmpeg
2020-11-05 17:18:11 +00:00
git checkout release/4.2
2014-09-04 07:33:44 +00:00
2017-09-06 09:12:27 +00:00
set CHERE_INVOKING=enabled_from_arguments
set MSYS2_PATH_TYPE=inherit
2020-10-08 06:55:23 +00:00
bash --login ../patches/build_ffmpeg_win.sh
2015-06-01 12:49:53 +00:00
2017-09-06 09:12:27 +00:00
SET PATH=%PATH_BACKUP_%
2017-09-11 11:04:25 +00:00
cd ..
2016-10-17 20:20:30 +00:00
2020-10-30 10:17:02 +00:00
SET LibrariesPath=%cd%
2020-12-07 11:50:22 +00:00
git clone git://code.qt.io/qt/qt5.git qt_5_15_2
cd qt_5_15_2
2015-10-19 21:24:39 +00:00
perl init-repository --module-subset=qtbase,qtimageformats
2020-12-07 11:50:22 +00:00
git checkout v5.15.2
2020-05-12 15:43:39 +00:00
git submodule update qtbase qtimageformats
2019-10-17 15:07:54 +00:00
cd qtbase
2020-12-07 11:50:22 +00:00
for /r %i in (..\..\patches\qtbase_5_15_2\*) do git apply %i
2020-06-12 05:07:02 +00:00
cd ..
2017-02-16 10:57:53 +00:00
2020-10-30 10:17:02 +00:00
configure ^
2020-12-07 11:50:22 +00:00
-prefix "%LibrariesPath%\Qt-5.15.2" ^
2020-10-30 10:17:02 +00:00
-debug-and-release ^
-force-debug-info ^
-opensource ^
-confirm-license ^
-static ^
-static-runtime ^
2021-05-18 10:16:34 +00:00
-opengl dynamic ^
2020-10-30 10:17:02 +00:00
-openssl-linked ^
-I "%LibrariesPath%\openssl_1_1_1\include" ^
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" ^
-I "%LibrariesPath%\mozjpeg" ^
LIBJPEG_LIBS_DEBUG="%LibrariesPath%\mozjpeg\Debug\jpeg-static.lib" ^
LIBJPEG_LIBS_RELEASE="%LibrariesPath%\mozjpeg\Release\jpeg-static.lib" ^
-mp ^
-nomake examples ^
-nomake tests ^
-platform win32-msvc
2017-02-16 10:57:53 +00:00
2020-10-08 06:55:23 +00:00
jom -j8
jom -j8 install
2016-05-19 11:29:06 +00:00
cd ..
2014-06-25 20:15:34 +00:00
2021-05-18 06:01:35 +00:00
git clone https://github.com/desktop-app/tg_owt.git
2020-08-20 12:45:54 +00:00
cd tg_owt
2021-05-24 19:45:32 +00:00
git checkout 792baa1e9f
2021-05-18 06:01:35 +00:00
git submodule init
git submodule update
2020-08-20 12:45:54 +00:00
mkdir out
cd out
mkdir Debug
cd Debug
2020-08-20 19:19:53 +00:00
cmake -G Ninja ^
2020-10-30 10:17:02 +00:00
-DCMAKE_BUILD_TYPE=Debug ^
2021-05-18 16:51:21 +00:00
-DTG_OWT_BUILD_AUDIO_BACKENDS=OFF ^
2020-10-30 10:17:02 +00:00
-DTG_OWT_SPECIAL_TARGET=win ^
-DTG_OWT_LIBJPEG_INCLUDE_PATH=%cd%/../../../mozjpeg ^
-DTG_OWT_OPENSSL_INCLUDE_PATH=%cd%/../../../openssl_1_1_1/include ^
-DTG_OWT_OPUS_INCLUDE_PATH=%cd%/../../../opus/include ^
-DTG_OWT_FFMPEG_INCLUDE_PATH=%cd%/../../../ffmpeg ../..
2020-08-20 12:45:54 +00:00
ninja
cd ..
mkdir Release
cd Release
2020-08-20 19:19:53 +00:00
cmake -G Ninja ^
2020-10-30 10:17:02 +00:00
-DCMAKE_BUILD_TYPE=Release ^
2021-05-18 16:51:21 +00:00
-DTG_OWT_BUILD_AUDIO_BACKENDS=OFF ^
2020-10-30 10:17:02 +00:00
-DTG_OWT_SPECIAL_TARGET=win ^
-DTG_OWT_LIBJPEG_INCLUDE_PATH=%cd%/../../../mozjpeg ^
-DTG_OWT_OPENSSL_INCLUDE_PATH=%cd%/../../../openssl_1_1_1/include ^
-DTG_OWT_OPUS_INCLUDE_PATH=%cd%/../../../opus/include ^
-DTG_OWT_FFMPEG_INCLUDE_PATH=%cd%/../../../ffmpeg ../..
2020-08-20 12:45:54 +00:00
ninja
2020-08-20 19:19:53 +00:00
cd ..\..\..
2020-07-09 17:38:26 +00:00
2017-09-06 09:12:27 +00:00
## Build the project
2017-02-18 19:23:50 +00:00
2019-12-31 12:08:56 +00:00
Go to ** *BuildPath*\\tdesktop\\Telegram** and run (using [your **api_id** and **api_hash** ](#obtain-your-api-credentials ))
2017-02-18 19:23:50 +00:00
2020-08-10 14:10:42 +00: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 18:41:31 +00:00
2019-12-31 12:08:56 +00:00
* Open ** *BuildPath*\\tdesktop\\out\\Telegram.sln** in Visual Studio 2019
2017-09-06 09:12:27 +00: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 18:41:31 +00:00
2017-09-06 09:12:27 +00:00
### Qt Visual Studio Tools
2016-08-14 18:41:31 +00:00
2017-09-06 09:12:27 +00:00
For better debugging you may want to install Qt Visual Studio Tools:
2016-08-14 18:41:31 +00:00
2020-06-10 04:08:51 +00:00
* Open **Extensions** -> **Manage Extensions**
2017-09-06 09:12:27 +00:00
* Go to **Online** tab
* Search for **Qt**
* Install **Qt Visual Studio Tools** extension
2018-11-04 10:29:30 +00:00
[api_credentials]: api_credentials.md