TGX-Android/Telegram-X

项目介绍

Telegram X 是 Telegram 的官方替代 Android 客户端，通过 TDLib 接入 Telegram API 和 MTProto 协议。仓库公开了客户端的完整源码与构建说明，面向想换一种 Telegram 使用体验的用户，以及需要查看或自行编译客户端的开发者。安装包可从 Google Play、华为应用市场和 GitHub Releases 获取 Telegram X on Google Play，版本变更和 APK 哈希发布在 Telegram 日志频道 APKs and Build Info。

从源码构建

这是一个完整的 Android 原生项目，不是可直接引用的库，需要准备工具链和足够的磁盘空间。

1. 安装带 LFS 的 git、JDK 25 或自带兼容 JDK 的 Android Studio，以及 rustup。在 macOS 或 Linux 上运行 scripts/setup-rust.sh，按 version.properties 中的版本安装 Rust，并输出 local.properties 需要的 rust.dir。Windows 需在 MSYS2 UCRT64 环境中构建，并另外设置 msys2.dir。
2. 带子模块克隆：git clone --recursive https://github.com/TGX-Android/Telegram-X tgx
3. 在项目根目录创建 local.properties，填入 sdk.dir、rust.dir；如需发布，再填入从 Telegram API credentials 申请的 telegram.api_id 和 telegram.api_hash。
4. 用 Android Studio 打开项目，或执行 ./gradlew assembleLatestDebug。要在已连接设备上安装调试包，可运行 ./gradlew :app:installLatestDebug -Pabi=arm64。

构建成功后得到所选 ABI 的应用；不传 -Pabi 会构建全部原生 ABI。可用 ./gradlew :app:validateGitSetup 检查子模块和 Git LFS 文件是否已拉取。

使用约束

构建至少需要 8 GB 内存；使用 --shallow-submodules --depth=1 克隆时约需 7.32 GB 磁盘，构建过程还会额外占用 2 到 5 倍空间。面向 Android 4.x 的 legacy flavor 需要旧版 NDK，并加上 -PuseLegacyNdk=true -Pabi=arm32。要以自己的应用身份发布，还需要 Telegram API 凭据，并用 Firebase 配置替换 google-services.json。

官方公开发布的构建是可复现的：README 按发布日期指定了应使用的 Ubuntu 版本，并说明了如何用 apkanalyzer apk compare 对比本地复现的 APK 与已发布 APK。对于侧载 APK，可计算 SHA-256 后到日志频道或验证机器人 @tgx_bot 查询。代码采用 GPL-3.0 许可，随包附带的第三方组件有各自的许可证。

HotRepo 点评

2026 年 11 月 12 日，该项目出现在 Java 日榜第 17 位，当时有 6,192 个 Star 和 1,189 个 Fork，当天新增 4 个 Star。这是单日的温和表现，并非爆发式增长，符合一个长期存在的成熟客户端：源码发布主要吸引 Android 开发者和 Telegram 用户。更值得关注的是可复现构建和 APK 哈希校验：它们给出了核对下载包是否与公开源码一致的可行方法，这在同类项目中并不常见。