Об этом проекте
Этот репозиторий содержит официальный исходный код приложения Telegram messenger для Android, клиента, распространяемого в Google Play как org.telegram.messenger. Telegram описывается как мессенджер, ориентированный на скорость и безопасность, и проект бесплатен для использования.
Что предоставляет репозиторий:
- Полный исходный код Android-клиента, включая нативные компоненты, собираемые через Android NDK.
- Руководство для разработчиков, желающих создать собственное приложение на основе Telegram, используя API платформы и этот код.
- Указатели на руководства по API Telegram и документацию по протоколу MTProto для работы на уровне протокола.
- Процесс локализации: переводы управляются через портал переводов Telegram, а не через файлы ресурсов в репозитории.
Требования и план сборки:
- В качестве предварительных условий указаны Android Studio 2025.1.4, Android NDK 27.2.12479018 и Android SDK 36.
- Исходный код должен быть клонирован рекурсивно с подмодулями; в README также объясняется, как инициализировать подмодули, если флаг рекурсивности был пропущен.
- Release-keystore должен быть помещён в TMessagesProj/config, а соответствующие пароль, alias и пароль хранилища должны быть установлены в gradle.properties.
- Для обмена сообщениями используется Firebase: в консоли Firebase необходимо создать два приложения Android (org.telegram.messenger и org.telegram.messenger.beta), а полученный google-services.json разместить рядом с TMessagesProj.
- Проект следует открывать в Android Studio, а не импортировать, и необходимо заполнить значения BuildVars.java, с ссылками, указывающими, откуда берётся каждое значение.
В README отмечается, что репозиторий содержит фиктивные release.keystore, google-services.json и предварительно заполненные значения BuildVars.java для поддержки воспроизводимых сборок; разработчикам, публикующим свои собственные APK, рекомендуется заменить их своими файлами.
Ожидания от разработчиков, заявленные проектом:
- Получите личный api_id для приложения.
- Не используйте имя Telegram таким образом, чтобы подразумевать официальный статус, и не используйте стандартный логотип Telegram.
- Изучите рекомендации по безопасности и внимательно обращайтесь с пользовательскими данными и конфиденциальностью.
- Публикуйте и свой собственный код, чтобы соблюдать лицензии.
В целом, это эталонная реализация клиента для разработчиков, которые хотят изучить или форкнуть приложение Telegram для Android, или создать совместимый мессенджер на основе API Telegram и протокола MTProto.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.