tdesktop/docs/building-msvc.md

292 lines
12 KiB
Markdown
Raw Normal View History

# Build instructions for Visual Studio 2019
2017-02-16 10:57:53 +00:00
- [Prepare folder](#prepare-folder)
- [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)
## Prepare folder
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**.
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.
### 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].
## Install third party software
* Download **Strawberry Perl** installer from [http://strawberryperl.com/](http://strawberryperl.com/) and install to ***BuildPath*\\ThirdParty\\Strawberry**
* 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**
* 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**
* Download **Git** installer from [https://git-scm.com/download/win](https://git-scm.com/download/win) and install it.
* 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**
* Download **depot_tools** bundle from [https://storage.googleapis.com/chrome-infra/depot_tools.zip](https://storage.googleapis.com/chrome-infra/depot_tools.zip) and extract it to ***BuildPath*\\ThirdParty\\depot_tools**
Open **x86 Native Tools Command Prompt for VS 2019.bat**, go to ***BuildPath*** and run
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
git checkout d051cbc
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
cd gyp
2019-10-02 11:43:54 +00:00
git checkout 9f2a7bb1
git apply ../patches/gyp.diff
cd ..\..
Add **depot_tools**, **GYP**, **Ninja** and **NuGet** to your PATH:
* Open **Control Panel** -> **System** -> **Advanced system settings**.
* Press **Environment Variables...**.
* Select **Path**.
* Press **Edit**.
* Add ***BuildPath*\\ThirdParty\\depot_tools** value.
* Add ***BuildPath*\\ThirdParty\\gyp** value.
* Add ***BuildPath*\\ThirdParty\\Ninja** value.
* Add ***BuildPath*\\ThirdParty\\NuGet** value.
* Make sure that **depot_tools** value goes before **%USERPROFILE%\AppData\Local\Microsoft\WindowsApps**, otherwise Python won't work.
* Add a global **DEPOT_TOOLS_WIN_TOOLCHAIN** environment variable with value **0**.
## Clone source code and prepare libraries
Open **x86 Native Tools Command Prompt for VS 2019.bat**, go to ***BuildPath*** and run
SET PATH=%cd%\ThirdParty\Strawberry\perl\bin;%cd%\ThirdParty\Python27;%cd%\ThirdParty\NASM;%cd%\ThirdParty\jom;%cd%\ThirdParty\cmake\bin;%cd%\ThirdParty\yasm;%PATH%
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
git checkout d051cbc
cd ..
2017-11-19 14:37:07 +00:00
git clone https://github.com/desktop-app/lzma.git
cd lzma\C\Util\LzmaLib
msbuild LzmaLib.sln /property:Configuration=Debug /property:Platform="x86"
msbuild LzmaLib.sln /property:Configuration=Release /property:Platform="x86"
cd ..\..\..\..
git clone https://github.com/openssl/openssl.git openssl_1_1_1
cd openssl_1_1_1
git checkout OpenSSL_1_1_1-stable
perl Configure no-shared no-tests debug-VC-WIN32
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
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
cd ..
git clone https://github.com/desktop-app/zlib.git
cd zlib\contrib\vstudio\vc14
msbuild zlibstat.vcxproj /property:Configuration=Debug /property:Platform="x86"
msbuild zlibstat.vcxproj /property:Configuration=ReleaseWithoutAsm /property:Platform="x86"
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 . ^
-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
cd openal-soft
2020-11-25 15:48:22 +00:00
git checkout openal-soft-1.21.0
cd build
2020-09-15 20:14:10 +00:00
cmake .. ^
-G "Visual Studio 16 2019" ^
-A Win32 ^
-D LIBTYPE:STRING=STATIC ^
-D FORCE_STATIC_VCRT=ON
msbuild OpenAL.vcxproj /property:Configuration=Debug
msbuild OpenAL.vcxproj /property:Configuration=RelWithDebInfo
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
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
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
cd opus
git checkout tdesktop
cd win32\VS2015
msbuild opus.sln /property:Configuration=Debug /property:Platform="Win32"
msbuild opus.sln /property:Configuration=Release /property:Platform="Win32"
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
cd ..\..
2021-04-15 13:55:13 +00:00
cd ..
SET PATH_BACKUP_=%PATH%
SET PATH=%cd%\ThirdParty\msys64\usr\bin;%PATH%
cd Libraries
2014-09-04 07:33:44 +00:00
git clone https://github.com/FFmpeg/FFmpeg.git ffmpeg
cd ffmpeg
2021-05-26 14:22:30 +00:00
git checkout release/4.4
2014-09-04 07:33:44 +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
SET PATH=%PATH_BACKUP_%
cd ..
git clone https://chromium.googlesource.com/angle/angle
cd angle
2021-07-01 06:48:52 +00:00
git checkout chromium/4472
python scripts/bootstrap.py
gclient sync
for /r %i in (..\patches\angle\*) do git apply %i
gn gen out/Debug --args="is_component_build=false is_debug=true target_cpu=\"x86\" is_clang=false enable_iterator_debugging=true angle_enable_swiftshader=false angle_enable_vulkan=false angle_default_d3d9=true"
gn gen out/Release --args="is_component_build=false is_debug=false target_cpu=\"x86\" is_clang=false enable_iterator_debugging=false angle_enable_swiftshader=false angle_enable_vulkan=false angle_default_d3d9=true"
ninja -C out/Debug libANGLE_static libGLESv2_static libEGL_static
ninja -C out/Release libANGLE_static libGLESv2_static libEGL_static
cd ..
2020-10-30 10:17:02 +00:00
SET LibrariesPath=%cd%
2021-07-01 06:48:52 +00:00
git clone git://code.qt.io/qt/qt5.git qt_5_15_2
cd qt_5_15_2
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 ^
2021-07-01 06:48:52 +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 ^
-opengl es2 -no-angle ^
-I "%LibrariesPath%\angle\include" ^
-D "GL_APICALL=" ^
2021-07-01 06:48:52 +00:00
QMAKE_LIBS_OPENGL_ES2_DEBUG="%LibrariesPath%\angle\out\Debug\obj\libGLESv2_static.lib %LibrariesPath%\angle\out\Debug\obj\libANGLE_static.lib d3d9.lib dxgi.lib dxguid.lib" ^
QMAKE_LIBS_OPENGL_ES2_RELEASE="%LibrariesPath%\angle\out\Release\obj\libGLESv2_static.lib %LibrariesPath%\angle\out\Release\obj\libANGLE_static.lib d3d9.lib dxgi.lib dxguid.lib" ^
-egl ^
-D "EGLAPI=" ^
2021-06-30 10:44:28 +00:00
-D "DESKTOP_APP_QT_STATIC_ANGLE=" ^
2021-07-01 06:48:52 +00:00
QMAKE_LIBS_EGL_DEBUG="%LibrariesPath%\angle\out\Debug\obj\libEGL_static.lib %LibrariesPath%\angle\out\Debug\obj\libGLESv2_static.lib %LibrariesPath%\angle\out\Debug\obj\libANGLE_static.lib d3d9.lib dxgi.lib dxguid.lib Gdi32.lib User32.lib" ^
QMAKE_LIBS_EGL_RELEASE="%LibrariesPath%\angle\out\Release\obj\libEGL_static.lib %LibrariesPath%\angle\out\Release\obj\libGLESv2_static.lib %LibrariesPath%\angle\out\Release\obj\libANGLE_static.lib d3d9.lib dxgi.lib dxguid.lib Gdi32.lib User32.lib" ^
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
cd ..
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-06-17 07:53:08 +00:00
git checkout f03ef05abf
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
cmake -G Ninja ^
2020-10-30 10:17:02 +00:00
-DCMAKE_BUILD_TYPE=Debug ^
-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
cmake -G Ninja ^
2020-10-30 10:17:02 +00:00
-DCMAKE_BUILD_TYPE=Release ^
-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 ..\..\..
2020-07-09 17:38:26 +00:00
## Build the project
Go to ***BuildPath*\\tdesktop\\Telegram** and run (using [your **api_id** and **api_hash**](#obtain-your-api-credentials))
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
* Open ***BuildPath*\\tdesktop\\out\\Telegram.sln** in Visual Studio 2019
* 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**)
### Qt Visual Studio Tools
For better debugging you may want to install Qt Visual Studio Tools:
2020-06-10 04:08:51 +00:00
* Open **Extensions** -> **Manage Extensions**
* Go to **Online** tab
* Search for **Qt**
* Install **Qt Visual Studio Tools** extension
[api_credentials]: api_credentials.md