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

45 lines
1.6 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 Linux using Docker
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Don't provide 'api_id' and 'api_hash' by default. We ask the developer to obtain his own api credentials, because the bundled 'api_id' / 'api_hash' are strictly limited by the server. The old credentials still could be used for test purposes, but the developer will need to explicitly opt-in to use them.
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].
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
### Clone source code
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Move build to Ubuntu 14.04 and GCC 7.2. To be able to run on the same distributions as before we need to have the same GLIBC version dependency as in Ubuntu 12.04, which is 2.15. For that we need to remove all usages of GLIBC features from 2.16 and above. Currently there are three methods used, so they're wrapped in a separate static library, linux_glibc_wraps. It is a separate library because it must be compiled without '-flto' flag, otherwise the inline __asm__ is not working and we get unresolved symbols.
2017-09-28 09:40:26 +00:00
git clone --recursive https://github.com/telegramdesktop/tdesktop.git
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
### Prepare libraries
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Use templating with Dockerfile in order to have less rebuilds
2022-06-28 11:32:29 +00:00
Install [poetry](https://python-poetry.org), go to the `tdesktop/Telegram/build/docker/centos_env` directory and run
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Use templating with Dockerfile in order to have less rebuilds
2022-06-28 11:32:29 +00:00
poetry install
Replace docker buildx with DOCKER_BUILDKIT=1 environment variable This seem to work better with distribution-provided Docker
2022-11-28 12:04:26 +00:00
poetry run gen_dockerfile | DOCKER_BUILDKIT=1 docker build -t tdesktop:centos_env -
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Move build to Ubuntu 14.04 and GCC 7.2. To be able to run on the same distributions as before we need to have the same GLIBC version dependency as in Ubuntu 12.04, which is 2.15. For that we need to remove all usages of GLIBC features from 2.16 and above. Currently there are three methods used, so they're wrapped in a separate static library, linux_glibc_wraps. It is a separate library because it must be compiled without '-flto' flag, otherwise the inline __asm__ is not working and we get unresolved symbols.
2017-09-28 09:40:26 +00:00
### Building the project
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Use templating with Dockerfile in order to have less rebuilds
2022-06-28 11:32:29 +00:00
Go up to the `tdesktop` directory and run (using [your **api_id** and **api_hash**](#obtain-your-api-credentials))
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
Run docker in interactive mode for colored output and Ctrl+C
2021-02-22 22:23:29 +00:00
docker run --rm -it \
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
-v $PWD:/usr/src/tdesktop \
tdesktop:centos_env \
/usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \
-D TDESKTOP_API_ID=YOUR_API_ID \
Use cmake_dependent_option to better declare variables that relate on other variables
2022-08-10 23:30:32 +00:00
-D TDESKTOP_API_HASH=YOUR_API_HASH
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
Or, to create a debug build, run (also using [your **api_id** and **api_hash**](#obtain-your-api-credentials))
Run docker in interactive mode for colored output and Ctrl+C
2021-02-22 22:23:29 +00:00
docker run --rm -it \
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
-v $PWD:/usr/src/tdesktop \
-e DEBUG=1 \
tdesktop:centos_env \
/usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \
-D TDESKTOP_API_ID=YOUR_API_ID \
Use cmake_dependent_option to better declare variables that relate on other variables
2022-08-10 23:30:32 +00:00
-D TDESKTOP_API_HASH=YOUR_API_HASH
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
Explain how to build a backward compatible binary on Linux
2022-11-08 17:11:28 +00:00
If you need a backward compatible binary (running on older OS like the official one), you should build the binary with LTO.
To do this, add `-D CMAKE_INTERPROCEDURAL_OPTIMIZATION=ON` option.
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru>
2020-12-13 06:16:37 +00:00
The built files will be in the `out` directory.
Moved all builds to GYP.
2016-09-12 11:45:41 +00:00
Don't provide 'api_id' and 'api_hash' by default. We ask the developer to obtain his own api credentials, because the bundled 'api_id' / 'api_hash' are strictly limited by the server. The old credentials still could be used for test purposes, but the developer will need to explicitly opt-in to use them.
2018-11-04 10:29:30 +00:00
[api_credentials]: api_credentials.md