Telegram iOS Source Code Compilation Guide

Install Xcode (directly from https://developer.apple.com/download/more or using the App Store).
Clone the project from GitHub:

git clone --recursive https://github.com/TelegramMessenger/Telegram-iOS.git

Download Bazel 3.7.0

mkdir -p $HOME/bazel-dist
cd $HOME/bazel-dist
curl -O -L https://github.com/bazelbuild/bazel/releases/download/3.7.0/bazel-3.7.0-darwin-x86_64
mv bazel-3.7.0* bazel

Verify that it's working

chmod +x bazel
./bazel --version

Adjust configuration parameters

mkdir -p $HOME/telegram-configuration
cp -R build-system/example-configuration/* $HOME/telegram-configuration/

Modify the values in variables.bzl
Replace the provisioning profiles in provisioning with valid files

(Optional) Create a build cache directory to speed up rebuilds

mkdir -p "$HOME/telegram-bazel-cache"

Build the app

python3 build-system/Make/Make.py \
    --bazel="$HOME/bazel-dist/bazel" \
    --cacheDir="$HOME/telegram-bazel-cache" \
    build \
    --configurationPath="$HOME/telegram-configuration" \
    --buildNumber=100001 \
    --configuration=release_universal

(Optional) Generate an Xcode project

python3 build-system/Make/Make.py \
    --bazel="$HOME/bazel-dist/bazel" \
    --cacheDir="$HOME/telegram-bazel-cache" \
    generateProject \
    --configurationPath="$HOME/telegram-configuration" \
    --disableExtensions

Tip: use --disableExtensions when developing to speed up development by not building application extensions.

Tips

Bazel is used to build the app. To simplify the development setup a helper script is provided (build-system/Make/Make.py). See help:

python3 build-system/Make/Make.py --help
python3 build-system/Make/Make.py build --help
python3 build-system/Make/Make.py generateProject --help

Each release is built using specific Xcode and Bazel versions (see versions.json). The helper script checks the versions of installed software and reports an error if they don't match the ones specified in versions.json. There are flags that allow to bypass these checks:

python3 build-system/Make/Make.py --overrideBazelVersion build ... # Don't check the version of Bazel
python3 build-system/Make/Make.py --overrideXcodeVersion build ... # Don't check the version of Xcode

2.3 KiB Raw Blame History

Telegram iOS Source Code Compilation Guide

Tips

2.3 KiB

Raw Blame History