mirror of
https://github.com/kotatogram/kotatogram-desktop
synced 2025-08-27 12:57:09 +00:00
67 lines
4.0 KiB
Markdown
67 lines
4.0 KiB
Markdown
# Build instructions for Windows
|
|
|
|
- [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**
|
|
* Download **Python 3.9** installer from [https://www.python.org/downloads/](https://www.python.org/downloads/) and install to ***BuildPath*\\ThirdParty\\Python39**
|
|
* 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**
|
|
|
|
Open **x86 Native Tools Command Prompt for VS 2019.bat**, go to ***BuildPath*** and run
|
|
|
|
python -m pip install pywin32
|
|
|
|
## 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\NuGet;%cd%\ThirdParty\Python39;%PATH%
|
|
|
|
git clone --recursive https://github.com/kotatogram/kotatogram-desktop.git
|
|
kotatogram-desktop\Telegram\build\prepare\win.bat
|
|
|
|
## Build the project
|
|
|
|
Go to ***BuildPath*\\kotatogram-desktop\\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=ON
|
|
|
|
If you want to build with crash reporter, use `-D DESKTOP_APP_DISABLE_CRASH_REPORTS=OFF` instead of `-D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON`.
|
|
|
|
* Open ***BuildPath*\\kotatogram-desktop\\out\\Telegram.sln** in Visual Studio 2019
|
|
* Select Telegram project and press Build > Build Telegram (Debug and Release configurations)
|
|
* The result Kotatogram.exe will be located in **D:\TBuild\kotatogram-desktop\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
|