RepoMirrors
/
tdesktop
mirror of https://github.com/telegramdesktop/tdesktop
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
tdesktop/docs/building-win-x64.md

72 lines
4.1 KiB
Markdown
Raw Normal View History

Remove old instructions & patches they referred to (& rename instructions to the actual state) Old instruction names were from the time when tdesktop used GYP that had MSVC, XCode and CMake backends. But tdesktop uses CMake now, so these names are no longer correct.
2021-07-20 02:41:11 +00:00
# Build instructions for Windows 64-bit
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +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 **x64 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**
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
* Download **Python 3.9** installer from [https://www.python.org/downloads/](https://www.python.org/downloads/) and install to ***BuildPath*\\ThirdParty\\Python27**
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +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**
* Download **Git** installer from [https://git-scm.com/download/win](https://git-scm.com/download/win) and install it.
Fixed NuGet link in instructions for Windows build.
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**
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +00:00
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
Add **Python 3.9** and **NuGet** to your PATH:
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +00:00
Add depot_tools information to build instructions.
2021-07-06 08:37:32 +00:00
* Open **Control Panel** -> **System** -> **Advanced system settings**.
* Press **Environment Variables...**.
* Select **Path**.
* Press **Edit**.
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
* Add ***BuildPath*\\ThirdParty\\Python39** value.
Add depot_tools information to build instructions.
2021-07-06 08:37:32 +00:00
* Add ***BuildPath*\\ThirdParty\\NuGet** value.
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +00:00
Open **x64 Native Tools Command Prompt for VS 2019.bat**, go to ***BuildPath*** and run
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
python -m pip install pywin32
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +00:00
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
## Clone source code and prepare libraries
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +00:00
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
Open **x64 Native Tools Command Prompt for VS 2019.bat**, go to ***BuildPath*** and run
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +00:00
Build dependencies by script on Windows and macOS.
2021-08-25 09:46:32 +00:00
git clone --recursive https://github.com/telegramdesktop/tdesktop.git
tdesktop\Telegram\build\prepare\win.bat
Add possibility to build on Windows for x64.
2020-11-06 17:22:02 +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 x64 -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:
* Open **Extensions** -> **Manage Extensions**
* Go to **Online** tab
* Search for **Qt**
* Install **Qt Visual Studio Tools** extension
[api_credentials]: api_credentials.md