Как собрать собственную версию Телеграма и стать коммитерром в ArchLinux за 15 минут!

Привет, Голос!

Сегодня у меня был интересный опыт по сборке ПО и обновлению его в AUR (Archlinux). И я решил написать инструкцию, как отсылать собственные пакеты в AUR, а также как вообще с ними работать.

С одной стороны, мне надоела "стандартная" версия телеграма, где "из коробки" снабжается какой-то неудачный шрифт, а сообщения отображаются урезанные по горизонтали (не на всю ширину окна). Waste of space and it looks really bad!

Вначале у меня был просто посыл собрать recent telegram (2.5.1) на основе обновлённого pkgbuild файла, но потом я решил, что если у меня получится, то надо бы это и в AUR отправить!

Проведу вас вктарце по процессу редактирования пакета, а также расскажу, как стать коммитером и обновить пакет в репозиториях AUR, тем самым вы поможите всему сообществу!

Для тех, кто в танках...

Кто не знает, что такое AUR или PKGBUILD, но дочитал досюда...

• AUR - это пользовательские репозитории в ArchLinux, куда люди выкладывают готовые "рецепты" по сборке определённых программ из исходного кода (или по адаптации готовых бинарников, такое тоже бывает).
• PKGBUILD - это основной файл с инструкциями сборки, которому следует ОС при выполнении команды сборки пакета "makepkg".
• Здесь я не буду затрагивать написание PKGBUILD с нуля - вместо этого я просто объединю рабочий PKGBUILD с другим, нужным мне, но устаревшем и нерабочим PKGBUILD.
• Любой зарегистрированный на сайте Archlinux может добавлять свои AUR-пакеты, а также "усыновлять" брошенные другими пакеты.
• Для следования инструкциям и пониманию всего процесса, вам желательны базовые знания по следующим пунктам: работа с файловой системой, сетью, git, ssh-ключами, будет также полезно если вы уже собирали ПО из исходного кода и/или были package maintainer'ом в каком-то другом дистрибутиве.

Готовы испачкать руки? :) Приступаем прямо сейчас!

Шаг 1. Найдите PKGBUILD к пакету, который захотите обновить

Для меня, как уже рассказал выше, это будет телеграм. Итак, есть два интересных пакета:

1. https://aur.archlinux.org/packages/tdesktop-x64/ - текущая версия телеграма. Собирается из исходников без ошибок, но имеет стандартные шрифты и ограниченную ширину текстового поля, что меня не устраивает.
2. https://aur.archlinux.org/packages/telegram-desktop-wide/ - классная (на всю ширину и со своими шрифтами) версия телеграма, но устаревшая - 2.2.0 (сейчас уже по этому адресу мною обновлённая версия, но 30 минут назад была другая).

Мы будем делать некий гибрид из этих двух пакетов. Важно отметить, что для успешного продолжения желательно, чтобы у вас на входе была хотя бы какая-то версия ПО (PKGBUILD'а), которая компилируется, иначе придётся действовать наобум. Это не страшно для маленьких программ, но total nightmare для больших проектов, как например телеграм.

В идеале, чтобы не ждать, пока вас сделают мэйнтейнером, нужно найти пакет, который требует внимания ("усыновления"). Зайдите в ваш аккаунт на сайте ArchLinux и поищите пакет, у которого справа в Package Actions будет кнопка "Adopt Package":

Кликните на эту кнопку и давайте продолжим.

Шаг 2. Скачайте себе репозиторий AUR-скрипта

Я "усныловил" для себя пакет telegram-desktop-wide, который был помечен как "old version", т.е. устаревший. Сразу после этого для вас появится на странице пакета подобного вида ссылка:

ssh://[email protected]/telegram-desktop-wide.git (click to copy)

Однако, вы не сможете склонировать репозиторий по данному адресу, если ещё не добавили свой ключ в ваш аккаунт на странице Archlinux. Сделать это можно в самом конце вот тут: https://aur.archlinux.org/account/ВАШНИК/edit/ (подставьте ваш ник вместо ВАШНИК!). Внизу вставьте собственный SSH-ключ, подтвердите это действие паролем от учётки и нажмите "Update". Готово.

Теперь мы можем клонировать себе "усыновлённый" пакет. Сделайте это именно через SSH ссылку, тогда вам не придётся ничего дополнительно настраивать для гита, что удобно!
git clone ssh://[email protected]/telegram-desktop-wide.git

Второй пакет нам нужен только для того, чтобы подсмотреть в нём некоторые нюансы, поэтому не обязательно качать весь его репозиторий. Можно просто открыть PKGBUILD в браузере (кнопка View PKGBUILD, когда вы на AUR-странице нужного пакета), например, вот актуальная рабочая версия обычного "текущего" 2.5.1-го телеграма: https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=tdesktop-x64

Шаг 3. Делаем Version Bump

Итак, всё что нужно, это сделать "version bump", а затем попытаться собрать ПО и посмотреть, есть ли баги при сборке (и исправить их, если есть).

Или, иначе говоря, "подтягиваем" версию в устаревшем пакете до текущей. Для этого:
3.1. Открываем любым редактором файл PKGBUILD в склонированной папке "telegram-desktop-wide".

Я не буду цитировать тут целиком файлы PKGBUILD - вы при желании сможете их открыть и сами посмотреть, что там и как. Но вот строчки, которые вам надо исправить:

• версия пакета - изменил строку pkgver на актуальную: pkgver=2.5.1
• массив sha512sums - у меня там осталось 2 файла для исправления "полной ширины" и "сборки qt" - я их не трогал, но версия файла с исходным кодом поменялась, поэтому 1 из 3 переменных внутри массива sha512sums нужно обновить. А если конкретно - первую переменную. Новую контрольную сумму получаем, скачав .tar.gz телеграма версии 2.5.1. с гитхаба и выполнив команду: sha512sum tdesktop-2.5.1-full.tar.gz. Итоговую длинную контрольную сумму вставляем вместо первого числа в кавычках.
• следующий шаг я нашёл не сразу. Вначале сборка у меня проваливалась - так что я открыл тот самый PKGBUILD из успешно-собираемого 2.5.1 (tdesktop-x64) и посмотрел, что там отличается от моего файла. Сразу приметилась функция prepare, а точней, в ней были такие строчки:

cd cmake
 echo "target_link_libraries(external_webrtc INTERFACE jpeg)" | tee -a external/webrtc/CMakeLists.txt

Моя ошибка при сборке была как-раз что-то про libjpeg. Так что, я подумал, ВОТ ОНО! Не долго думая, я скопировал эти строки в свой PKGBUILD. Функции build() и package() я не трогал, остальное, - тоже.

Сохраняем файл. Теперь надо проверить, что всё работает, собрав, установив и протестировав телеграм. Делаем это, находясь в папке репозитория telegram-desktop-wide:
makepkg
Да, вот так просто. Без всяких аргументов и условий. =) Налейте себе кофе, сборка займёт несколько минут, в зависимости от мощности вашего железа.

После сборки, если всё прошло успешно, установите себе свежесобранный пакет:
sudo pacman -U ./telegram-desktop-wide-2.5.1-1-x86_64.pkg.tar.zst
Теперь запустите телеграм:
telegram-desktop
Проверьте, что всё работает. Если всё хорошо, можем переходить к финальному, не менее важному этапу - коммит нашей классной работы в репозиторий Arch Linux User Repository, AUR!

Шаг 4. Коммитим изменения в AUR

Для начала, надо сообщить скрытому инфо-файлу ".SRCINFO" о том, что мы успешно обновили пакет. Откройте его любимым текстовым редактором, и исправьте там несколько строк:

• строку pkgver - точно как в прошлый раз - я сделал тут pkgver = 2.5.1
• строку source - замените на URL файла с телегой - я сделал так source = https://github.com/telegramdesktop/tdesktop/releases/download/v2.5.1/tdesktop-2.5.1-full.tar.gz
• sha512sums - по аналогии с предыдущим файлом - вставьте корректную контрольную сумму от файла с исходным кодом телеги

Готово, сохраните и закройте файл .SRCINFO. Наконец-то мы можем закоммитить нашу работу, а именно, в данном примере, четыре файла - исправленный PKGBUILD и .SRCINFO, а также неизменившиеся файлы "wide-messages.patch" и "fix-qt-build.patch" обратно в AUR. Для этого в директории проекта делаем:
git add . # Это добавит все файлы в листинг
git commit -am "Bumping telegram version to 2.5.1" # Делаем коммит и указываем сообщение о том, что мы сделали
git push

Ждём несколько секунд. Теперь открываем страничку https://aur.archlinux.org/packages/telegram-desktop-wide чтобы убедиться, что ваша обновлённая версия телеги доступна любому желающему!

Теперь вы, как и любой другой человек в мире, может установить telegram-desktop-wide как через графический менеджер пакетов в пару-тройку кликов, так и одной командой, через yay, yaourt, pikaur и прочие AUR-helper'ы, например вот так:
pikaur -S telegram-desktop-wide, ну а пакет больше не помечен, как устаревший!

Вот так (фрагмент) выглядит результат:

Отмечу напоследок, что у меня ранее не получалось успешно собрать telegram-desktop-wide на основе последнего кода телеграма, и я раньше никогда не коммитил в AUR. Это мой первый AUR-PKGBUILD-скрипт, и я разобрался как это сделать без всяких мануалов. На сборку телеги и все разбирательства ушло ~40 минут. На то, чтобы разобраться, как отправить обновлённый пакет в AUR, ~15 минут. На мой взгляд, неплохой результат, всего за час.

Пойду посмотрю, есть ли какие-то другие классные пакеты, в которых я смог бы стать мэйнтейнером! Чего и вам желаю.

Ура-ура! :)
С вами был ночной @sxiii aka Den,
из Oslo
CYA!