Telegram安卓版源码使用指南

技术背景

Telegram 是一款专注于速度和安全的即时通讯应用，它具有快速、简单且免费的特点。该仓库包含了 Telegram 安卓应用的官方源代码，开发者可以利用其 API 和源代码在 Telegram 平台上创建应用。

实现步骤

创建 Telegram 应用

1. 为你的应用获取自己的 api_id。
2. 不要在你的应用中使用 “Telegram” 这个名称，或者确保你的用户明白这是非官方应用。
3. 不要使用 Telegram 的标准 logo（蓝色圆圈中的白色纸飞机）作为你的应用 logo。
4. 研究 Telegram 的安全指南，保护好用户的数据和隐私。
5. 为了符合许可证要求，记得发布你的代码。

编译指南

1. 为了支持可重复构建，该仓库包含了虚拟的 release.keystore、google-services.json 以及 BuildVars.java 中的填充变量。在发布自己的 APK 之前，请确保用你自己的文件替换这些文件。
2. 你需要 Android Studio 3.4、Android NDK rev. 20 和 Android SDK 8.1。
3. 从 https://github.com/DrKLO/Telegram 下载 Telegram 源代码：

git clone https://github.com/DrKLO/Telegram.git

4. 将你的 release.keystore 复制到 TMessagesProj/config 目录。
5. 在 gradle.properties 中填写 RELEASE_KEY_PASSWORD、RELEASE_KEY_ALIAS、RELEASE_STORE_PASSWORD 以访问你的 release.keystore。
6. 访问 https://console.firebase.google.com/，创建两个 Android 应用，应用 ID 分别为 org.telegram.messenger 和 org.telegram.messenger.beta，开启 Firebase 消息传递功能并下载 google-services.json，将其复制到 TMessagesProj 所在的同一目录。
7. 在 Android Studio 中打开项目（注意是打开，而不是导入）。
8. 在 TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java 中填写值，每个变量都有链接显示从哪里获取以及获取哪些数据。
9. 完成以上步骤后，你就可以编译 Telegram 了。

本地化

所有翻译文件已移至 https://translations.telegram.org/en/android/，请使用该链接进行本地化操作。

核心代码

代码主要涉及 Java 语言，以下是部分关键代码所在位置：

• TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java：包含编译所需的变量。
• gradle.properties：包含访问 release.keystore 的密码和别名等信息。

最佳实践

• 在开发之前，仔细阅读 Telegram 的 API 手册（https://core.telegram.org/api）和 MTproto 协议手册（https://core.telegram.org/mtproto），了解 Telegram 的技术架构和协议规范。
• 严格遵守 Telegram 对开发者的要求，确保应用的合法性和规范性。
• 在编译过程中，按照步骤逐步操作，确保每个文件和变量都正确配置。

常见问题

• 编译失败：检查是否按照编译指南正确替换了 release.keystore、google-services.json 等文件，以及是否在 gradle.properties 和 BuildVars.java 中正确填写了相关信息。
• API 使用问题：参考 Telegram 的 API 手册和 MTproto 协议手册，或者在 Telegram 的开发者社区寻求帮助。
• 本地化问题：确保使用 https://translations.telegram.org/en/android/ 进行翻译，遵循其翻译规范。