TelegramMessenger/Telegram
效率与系统工具Telegram 安卓客户端的官方 Java 源码,面向需要构建、二次开发或研究该客户端的开发者。
项目介绍
这个仓库是 Telegram 安卓客户端的官方 Java 源代码,与 Google Play 上分发的客户端同源 Play Store 页面。代码涵盖消息界面以及客户端对 Telegram API 和 MTProto 协议的调用 API 文档、MTProto 文档。它面向想构建自己的 Telegram 客户端、做二次开发或研究大型安卓即时通讯应用结构的开发者,而不是寻找 APK 的普通用户。
构建要求
- Android Studio 2025.1.4
- Android NDK 27.2.12479018
- Android SDK 36
- 自己的 Telegram API 凭据,按官方流程申请
api_id获取 api_id - 发布用 keystore,以及推送所需的 Firebase 项目配置
仓库自带占位的 release.keystore、占位的 google-services.json 和已填好某些值的 BuildVars.java,因此首次构建可以走通,但对外发布前必须全部替换为自己的文件 可复现构建说明。
快速构建
-
带子模块克隆:
git clone --recursive --shallow-submodules https://github.com/DrKLO/Telegram.git Telegram如果克隆时漏了
--recursive,进入目录后执行git submodule init && git submodule update --init --recursive --depth=1。 -
把
release.keystore复制到TMessagesProj/config。 -
在
gradle.properties中填写RELEASE_KEY_PASSWORD、RELEASE_KEY_ALIAS和RELEASE_STORE_PASSWORD。 -
在 Firebase 控制台创建两个应用 ID 分别为
org.telegram.messenger和org.telegram.messenger.beta的 Android 应用,开启 Firebase 消息推送,把下载的google-services.json放到与TMessagesProj同级目录。 -
用 Android Studio 打开项目(是打开,不是导入)。
-
填写
TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java中的变量,每个变量都附有取值的链接。 -
编译。
翻译已迁移到 Telegram 翻译平台。
使用约束
- GPL-2.0 许可证要求基于此代码的衍生应用同样公开源码,README 中对第三方客户端的要求也写明这一点。
- 独立应用不能使用 Telegram 名称和标准纸飞机图标,并且要让用户明白它不是官方版本。
- 必须使用自己的
api_id,仓库内置的占位凭据不能用于真实应用。 - 客户端开发需按 Telegram 的安全指南处理用户数据。
- 构建依赖完整的安卓工具链,仓库不提供预编译 APK。
HotRepo 点评
仓库从 2013 年公开至今积累约 3 万 Star 和 1.06 万 Fork。在 2026-11-16 的 Java 语言日榜记录中,当天新增 8 个 Star,最好名次为第 16。这是一份推进缓慢的成熟代码库,而非热度攀升的新项目,这也符合官方客户端的定位:它的价值主要在于参考实现和上面这套构建流程。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- TelegramMessenger/Telegram-AndroidTelegram 安卓客户端的官方源码,面向想研究或基于其 API 自建客户端的开发者。
- DrKLO/TelegramTelegram 官方 Android 客户端源码,适合想基于它构建或研究聊天应用的人,不适合当作私有聊天工具。
- TGX-Android/Telegram-X基于 TDLib 的 Telegram 官方替代 Android 客户端,提供完整源码和可复现构建说明。
- telegramdesktop/tdesktopTelegram 桌面客户端的官方完整源码,可自行构建或在 Windows、macOS、Linux 上直接使用。
- FoxCoderGit/AstraGram基于 Telegram 源码的 Android 客户端,附加媒体、插件与更新工具。