+2
Daily
9,441
stars
3,301
forks
420
watchers
263
prs
2,002
issues
31
releases
README
Telegram iOS Source Code Compilation Guide
We welcome all developers to use our API and source code to create applications on our platform.
There are several things we require from all developers for the moment.
Creating your Telegram Application
1. Obtain your own api_id for your application.
2. Please do not use the name Telegram for your app — or make sure your users understand that it is unofficial.
3. Kindly do not use our standard logo (white paper plane in a blue circle) as your app's logo.
3. Please study our security guidelines and take good care of your users' data and privacy.
4. Please remember to publish your code too in order to comply with the licences.
Quick Compilation Guide
Get the Code
git clone --recursive -j8 https://github.com/TelegramMessenger/Telegram-iOS.git
Setup Xcode
Install Xcode (directly from https://developer.apple.com/download/applications or using the App Store).
Adjust Configuration
1. Generate a random identifier:
openssl rand -hex 8
2. Create a new Xcode project. Use Telegram as the Product Name. Use org.{identifier from step 1} as the Organization Identifier.
3. Open Keychain Access and navigate to Certificates. Locate Apple Development: [email protected] (XXXXXXXXXX) and double tap the certificate. Under Details, locate Organizational Unit. This is the Team ID.
4. Edit build-system/template_minimal_development_configuration.json. Use data from the previous steps.
Generate an Xcode project
python3 build-system/Make/Make.py \
--cacheDir="$HOME/telegram-bazel-cache" \
generateProject \
--configurationPath=build-system/template_minimal_development_configuration.json \
--xcodeManagedCodesigning
Advanced Compilation Guide
Xcode
1. Copy and edit build-system/appstore-configuration.json.
2. Copy build-system/fake-codesigning. Create and download provisioning profiles, using the profiles folder as a reference for the entitlements.
3. Generate an Xcode project:
python3 build-system/Make/Make.py \
--cacheDir="$HOME/telegram-bazel-cache" \
generateProject \
--configurationPath=configuration_from_step_1.json \
--codesigningInformationPath=directory_from_step_2
IPA
1. Repeat the steps from the previous section. Use distribution provisioning profiles.
2. Run:
python3 build-system/Make/Make.py \
--cacheDir="$HOME/telegram-bazel-cache" \
build \
--configurationPath=...see previous section... \
--codesigningInformationPath=...see previous section... \
--buildNumber=100001 \
--configuration=release_arm64
FAQ
Xcode is stuck at "build-request.json not updated yet"
Occasionally, you might observe the following message in your build log:
"/Users/xxx/Library/Developer/Xcode/DerivedData/Telegram-xxx/Build/Intermediates.noindex/XCBuildData/xxx.xcbuilddata/build-request.json" not updated yet, waiting...
Should this occur, simply cancel the ongoing build and initiate a new one.
Telegram_xcodeproj: no such package
Following a system Top issues
#267accessibility related bugs with voiceover146 comments · 2020-03-30#81Background activity drains battery very fast138 comments · 2019-07-04#1410MiniApp, virtual keyboard overlaps the content and shifts window improperly49 comments · 2024-06-03#833Notifcations are only “You have a new message”47 comments · 2022-09-04#791Telegram Messenger v8.8 crashes on iPad4 running iOS 10.3.342 comments · 2022-06-22#2129[Bug] No pop-up notifications on official Telegram app (iOS 18.7.8, multiple devices)40 comments · 2026-04-30#280 scrolling the message view get stuck 37 comments · 2020-04-12#1543Autocomplete bug34 comments · 2024-09-08
Latest release
Telegram 10.0.3 (26855) build-26855 2023-09-13An unsigned build of Telegram for iOS 10.0.3 (26855)