Telegram iOS Source Code Compilation Guide

Last update: Jan 6, 2023

Related tags

Content App Telegram-iOS

Overview

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

Obtain your own api_id for your application.
Please do not use the name Telegram for your app — or make sure your users understand that it is unofficial.
Kindly do not use our standard logo (white paper plane in a blue circle) as your app's logo.
Please study our security guidelines and take good care of your users' data and privacy.
Please remember to publish your code too in order to comply with the licences.

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 -j8 https://github.com/TelegramMessenger/Telegram-iOS.git

Download Bazel 4.0.0

mkdir -p $HOME/bazel-dist
cd $HOME/bazel-dist
curl -O -L https://github.com/bazelbuild/bazel/releases/download/4.0.0/bazel-4.0.0-darwin-x86_64
mv bazel-* 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

It is possible to generate a project that does not require any codesigning certificates to be installed: add --disableProvisioningProfiles flag:

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

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

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

Comments

Build failed version 6.3
Hello Has anyone encountered a same problem?

Checklist

[x] I am reporting an issue in existing functionality that does not work as intended

[x] I've searched for existing GitHub issues

Screenshots and Videos

Description

Undefined symbols for architecture x86_64: "static UIKit.UIPointerShape.defaultCornerRadius.getter : CoreGraphics.CGFloat", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "enum case for UIKit.UIPointerShape.roundedRect(UIKit.UIPointerShape.Type) -> (__C.CGRect, CoreGraphics.CGFloat) -> UIKit.UIPointerShape", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "enum case for UIKit.UIPointerEffect.highlight(UIKit.UIPointerEffect.Type) -> (__C.UITargetedPreview) -> UIKit.UIPointerEffect", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "(extension in UIKit):__C.UIPointerStyle.init(shape: UIKit.UIPointerShape, constrainedAxes: __C.UIAxis) -> __C.UIPointerStyle", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "enum case for UIKit.UIPointerShape.path(UIKit.UIPointerShape.Type) -> (__C.UIBezierPath) -> UIKit.UIPointerShape", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "enum case for UIKit.UIPointerEffect.lift(UIKit.UIPointerEffect.Type) -> (__C.UITargetedPreview) -> UIKit.UIPointerEffect", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "type metadata accessor for UIKit.UIPointerEffect", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "type metadata accessor for UIKit.UIPointerEffect.TintMode", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "type metadata accessor for UIKit.UIPointerShape", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o default argument 1 of (extension in UIKit):__C.UIPointerStyle.init(effect: UIKit.UIPointerEffect, shape: UIKit.UIPointerShape?) -> __C.UIPointerStyle in PointerInteraction.o "enum case for UIKit.UIPointerEffect.hover(UIKit.UIPointerEffect.Type) -> (__C.UITargetedPreview, UIKit.UIPointerEffect.TintMode, Swift.Bool, Swift.Bool) -> UIKit.UIPointerEffect", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "enum case for UIKit.UIPointerEffect.TintMode.none(UIKit.UIPointerEffect.TintMode.Type) -> UIKit.UIPointerEffect.TintMode", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "enum case for UIKit.UIPointerShape.verticalBeam(UIKit.UIPointerShape.Type) -> (CoreGraphics.CGFloat) -> UIKit.UIPointerShape", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o "(extension in UIKit):__C.UIPointerStyle.init(effect: UIKit.UIPointerEffect, shape: UIKit.UIPointerShape?) -> __C.UIPointerStyle", referenced from: Display.(PointerInteractionImpl in B39DD7E7F85F24DF4F7212BCFE28692F).pointerInteraction(: __C.UIPointerInteraction, styleFor: __C.UIPointerRegion) -> __C.UIPointerStyle? in PointerInteraction.o ld: symbol(s) not found for architecture x86_64 clang: error: linker command failed with exit code 1 (use -v to see invocation)

Steps to Reproduce

Generate Telegram_Buck.xcworkspace

Change entilements

Run

Environment

macOS: 10.15.5 xcode: 11.6
bug
opened by SergeyKolokolnikov 42
Video from Android is blurred (sound works)

When I receive an .mp4 footage from an Android phone, my iPhone cannot play that. The video shows a blurred version of the first frame and sound works as expected.

iPhone specs (receiver): iPhone 7 iOS 12.1 Telegram version: 5.0.17

Android specs (sender): LG G6 Android 8.0.0 Telegram version: 4.9.1

The same video works on the desktop version, and people with Android devices can play it. I also tried receiving the same footage on WhatsApp and it worked.

opened by merttoka 21
Horizontal sticker pack scrolling randomly breaks since 8.7
Checklist

[x] I am reporting an issue in existing functionality that does not work as intended

[x] I've searched for existing GitHub issues

Description

When trying to scroll through sticker packs, scrolling randomly fails since 8.7 update.

Expected Behavior

I expect scrolling to work.

Actual Behavior

Scrolling randomly doesn't work.

Steps to Reproduce

Enter random chat

Select stickers in the input bar

Swipe sticker pack list to the left. 1st swipe works, consecutive swipes randomly don't. Sometimes you have to wait until sticker pack icons are minimized again, sometimes you don't.

This happens more often when swiping to the left (i.e. scrolling forward). If it happens when swiping to the right (scrolling backwards towards the 1st sticker pack), the unresponsiveness can even cause Telegram to exit the current convo and go back to the chat list. *

(* Normally, going back to chat list only happens if I'm swiping from the left edge of the screen OR I'm scrolled all the way to the first sticker, but with this glitch it can also happen if I'm in the middle of the sticker list and I'm only touching the right half of the screen.)

Environment

Device: iPhone 12

iOS version: 15.4.1

App version: 8.7
bug
opened by bviktor 20
Unable to format (bold/italic/underlined/hidden) text in iOS16
Checklist

[X] I am reporting an issue in existing functionality that does not work as intended

[X] I've searched for existing GitHub issues

Description

After updating to iOS16 I can no longer format text in the menu after selecting text

Expected Behavior

After selecting text in the menu that came up, you could select text formatting (bold, italic, etc.)

Actual Behavior

After selecting text in the menu that appears, no items responsible for selecting formatting (bold, italic, etc.)

Steps to Reproduce

Enter text

Select all or part of it

Scroll through the menu that appears and look for the button responsible for text formatting

Screenshots and Videos

Environment

Device: iPhone

iOS version: 16

App version: 8.9.1 (23989)
bug
opened by choodique 18
Add option to disable quick reactions

On old Telegram versions, double tapping opened the menu for the message. On iMessage as well, double tapping opens the reactions menu with a reply button.

Please add an option to disable quick reactions and revert to the old behavior.

opened by dancojocaru2000 15
[iPad] Inconsistent Input From Bluetooth Keyboard

I’m not sure myself how to pinpoint this issue, but I have tested enough to know it is specific to Telegram and not an issue with my keyboard. I have the Logitech Slim Folio for my iPad and it works perfectly in every other app I have tried typing in. When I am typing in the message box I have to intentionally slow my typing speed to a point that is almost uncomfortable to avoid bizarre behavior. Sometime it just misses a keystroke, others it essentially replaces any given keystroke with a backspace input, sometimes letters get swapped around. I could message you a gif of such behavior if that would help.

opened by thomas-williams 14
Telegram for iOS crashes when some users opens my channel

Hello, I have a channel where I post messages using @chelpbot and adding images preview using the Instant View testing link. (I sent my templates).

But recently, some users written me that their iOS Telegram app crashes when clicking my channel. With other channels this does not happen.

iOS Version: 13 Beta

Thanks for reading

opened by ghost 14
What is APP_CONFIG_DATA ?

In version Telegram 5.5, I saw from BuildConfig.m in Telegram-iOS that it reads a constant called APP_CONFIG_DATA in line 277. It is added at commit f5880c1a3c63a77179f1c4790716da0bc7e3a6c0.

What should be the value of it? Thanks.

opened by shivanraptor 14
Adopt Communication Notifications in iOS 15

iOS 15 adds new notification types. One of them is Communication Notifications. They a big profile picture of the sender and a small app icon in the corner. This is different to standard notification which only display the icon.

The behavior is also different, because the user can select individual people that they want to see messages from when the device is in each given Focus mode (without allowing notifications from a specific app), they don't end up in the Notification Summary and they are read by default if Siri Announce Notifications feature is enabled on device.

For more details see Apple Human Interface Guidelines on Notifications.

opened by gracjankn 13
Reply button doesn't work on Apple Watch
Checklist

[x] I am reporting an issue in existing functionality that does not work as intended

[x] I've searched for existing GitHub issues

Description

When user receives a message, notification on Apple Watch appears with two buttons – Reply and Close. The first one doesn't work, there is only animation of tapping.

Expected Behavior

Ability to use "Reply" button to reply.

Actual Behavior

No ability to use "Reply" button to reply :)

Steps to Reproduce

Receive a message on Apple Watch

Scroll down to Reply button

Press the button

Environment

Device: Apple Watch Series 4, 44 mm

iOS version: 14.3

watchOS version: 7.2

App version: 7.3.1
bug
opened by lolka4toli 13
"This channel can't be displayed because it was used to spread pornographic content".

I have entered a telegram channel with NSFW art, and no real-life porn on it, from App Store version of MacOS App, and the app displayed me that message.

I've tried downloading an app version which is offered from the telegram's website, and stoped seeing that message.

But that message appears me when I'm trying to see that channel from iOS App.

That message has stopped appearing me when I've singed in on Telegram Web from my iPhone.

It seems, Apple is blocking NSFW channels in telegram applications, because the same is not happening in the app for android and the app for other computer operating systems.

Will it be solved in a future update?

I've seen some Text Channels on some Discord Servers, which contains NSFW content on it, and I haven't had a problem like this. I think because Discord has an option to mark a Text Channel on a Server has NSFW Channel, and display a waring before entering on that channel.

I suggest: Adding an option to mark a Telegram Channel, or a Telegram Group as NSFW, to add a waring before entering in a channel or a group.

Previously posted on r/Telegram.

opened by Victorio115 13
crashes instantly ipad mini 2
Checklist

[ ] I am reporting an issue in existing functionality that does not work as intended

[ ] I've searched for existing GitHub issues

Description

telegram crashes on ipad mini, iphone 5s, ipad 4, ipad air 1 on ios 9. 10 and 12

invalidating your last excuse for letting it be broken for thousands of users

Expected Behavior

um, telegram should open and not crash the moment it comes in contact with your stickers

Actual Behavior

telegram crashes upon loading same for ALL telegram forks

Steps to Reproduce

download telegram or alt telegram app on ios 9.35, 10.x, 11x,12.x, or even early 15 on a ipad mini 2, ipad 4, ipad air 1 or iphone 5s.1

run it

crashes, like many other apps taht used to work on all these devices before randomly crashing one day. please step up to the plate

Environment

Device: `ipad mini 2 (also tested others)

iOS version: `9.3.5 (also tested 10.x, 11.x, 12.5.6 and early 15.x on iphone 6. same issue

App version: impossible to get because app crashes
bug
opened by thiccelf83 1
Support is not working

I apologize for the question that is not related to code problems. But I have to write this because I can't find other ways to solve this problem.

Almost half a year ago, competitors organized the blocking of my account and since then I have been writing to all telegram contacts, but I have never received a single response from a person who could consider my situation. I wrote to all the emails I found, to Twitter, even to the telegram premium seller...

I even tried to find support at the telegram office in Dubai, but there is no one in their office. Probably the staff work in some other, secret place...

Does anyone know at least some work contacts that I can write to so that they will consider the problem of wrong blocking of my profile?

P.S. Don't think that I have nothing to do and that's why I'm writing here off topic... I had a lot of working contacts and information, after being blocked, I suffered huge reputational and financial losses, and now I'm trying to somehow figure out this unpleasant situation.

opened by jaholper 0
Forum list view bug
Checklist

[x] I am reporting an issue in existing functionality that does not work as intended

[x] I've searched for existing GitHub issues

Description

iOS client has a problem with a list in a forum group. swipe top in a group and after that fast swiping down in a group of this type shows an empty first line of the list instead of the first pinned one. when you swipe down again, everything is restored as it should be. Screenshots and videos are attached.

Expected Behavior

There will be no empty forum subgroup line in the list

Actual Behavior

empty subgroup string in forum list

Steps to Reproduce

have a group with the forum type and several pinned posts, as well as an archive

go to the forum

swipe top

fast swipe down - now u will see the empty line

swipe down again - now you will see what you need

Screenshots and Videos

Video

Environment

Device: iPhone 13

iOS version: 16.1.1

App version: 9.2.1
bug
opened by hardlemondrink 2
Increase the photo size limit to 2560px. Telegram API is already allow to send photos with that size
Checklist

[x] I am reporting an issue in existing functionality that does not work as intended

[x] I've searched for existing GitHub issues

Description

For now Telegram for iOS is don't allow to send large images with 2560px size. But Telegram API already allows to send large images with 2560px. Also users can send 2560px images from Telegram Web K (Z is still don't support it).

Expected Behavior

Telegram API allows to send images as 2560px, so sending images of this size should be allowed

Actual Behavior

When images larger than 1280px are sent - they are compressed to 1280px

Steps to Reproduce

Send image larger than 1280px

Image will be downscaled to 1280px

Environment

Device: iPhone XR

iOS version: 16.2

App version: 9.2.1
bug
opened by Neurotoxin001 8
Maximum 6 month of active session while Desktop client gives 12 Months
Checklist

[x] I am reporting an issue in existing functionality that does not work as intended

[x] I've searched for existing GitHub issues

Description

In iOS client i can put maximum 6 month of active session while Desktop client gives me possibility to choose 1 year instead, which makes inconsistent iOS client version.

Expected Behavior

iOS client should allow to choose 1 year instead of 6 months as maximum.

Actual Behavior

Only 6 month available

Steps to Reproduce

Open telegram

Go to devices

In section "automatically end session" press on item

Environment

Device: iPhone 8 Plus

iOS version: 16.2

App version: 9.2.1
bug
opened by VetaLioSTV 1