Установка Qgit Viewer на Ubuntu

Qgit — удобный графический интерфейс для просмотра истории и работы с патчами Git. Он особенно полезен тем, кто хочет пользоваться возможностями Git без постоянной работы в терминале. Ниже приведён подробный пошаговый гид по сборке и установке Qgit из исходников в Ubuntu и подобных дистрибутивах Linux.

Подготовка исходников и зависимостей

Перед сборкой требуются библиотеки и инструменты из экосистемы Qt4 и набор инструментов сборки. В оригинальной инструкции автор использовал шаблон с глобом для установки всех компонентов Qt4; это удобно, но иногда требует корректировок в зависимости от версии дистрибутива.

Оригинальная команда автора (обратите внимание: в исходном тексте могли встречаться опечатки):

sudo apt install qt4*git

Рекомендованная рабочая команда (с пробелом между шаблоном и git):

sudo apt update
sudo apt install qt4* git

Если в вашей системе шаблон (glob) не подбирает пакеты, установите типичные пакеты разработки Qt4 и инструменты сборки (пример для старых выпусков Ubuntu):

sudo apt install git qt4-dev-tools libqt4-dev build-essential

Примечание: в современных версиях Ubuntu Qt4 может быть удалён из репозиториев. В таком случае рассмотрите варианты: установить совместимые пакеты из сторонних репозиториев/PPAs, собрать Qgit с Qt5‑портом (если доступен), либо использовать готовые двоичные пакеты или альтернативные GUI‑клиенты (см. раздел «Альтернативы»).

Затем загрузите и распакуйте исходный код Qgit. Перейдите в каталог с исходниками:

cd qgit

Сборка Qgit

Сборка выполняется стандартно: qmake → make → make install. Команды ниже — исправленные и проверенные по синтаксису.

1. Генерация Makefile:

qmake

2. Компиляция:

make

3. Установка в систему (потребуются права root):

sudo make install

Иногда авторы в исходных текстах допускают опечатки (например, makeinstall вместо make install). Следите за правильностью команд: каждая часть должна быть отдельной.

После успешной сборки в каталоге сборки должен появиться подкаталог bin с исполняемым файлом qgit.

Запуск Qgit

Лучше первый запуск выполнять из терминала — так вы увидите диагностические сообщения, если чего‑то не хватает.

Перейдите в папку с бинарём и запустите:

cd ~/Downloads/qgit/bin
./qgit

Если вы видите ошибки о недостающих библиотеках или символах, вернитесь к разделу зависимостей и установите недостающие пакеты. Журнал в терминале обычно сообщает, каких именно библиотек не хватает.

Создание значка на рабочем столе и интеграция в меню

Перенесите исполняемый файл в стандартный путь, чтобы запускать его из любого места. В оригинальной статье встречалась опечатка sudomv; правильная команда:

sudo mv qgit /usr/bin/

Создайте файл .desktop для интеграции в меню приложений. Откройте текстовый редактор и вставьте содержимое, затем сохраните как qgit-viewer.desktop:

[Desktop Entry]
Name=Qgit Viewer
Comment=Просмотрщик Git с графическим интерфейсом на Qt/C++
Exec=/usr/bin/qgit
Terminal=false
Type=Application
Categories=Development;VersionControl;

Сделайте файл исполняемым и переместите его в каталог приложений:

chmod +x qgit-viewer.desktop
sudo mv qgit-viewer.desktop /usr/share/applications/

После этого Qgit появится в списке приложений. Если вы хотите значок на рабочем столе, скопируйте .desktop в папку рабочего стола и убедитесь, что для файла разрешено выполнение через свойства файла.

Устранение неполадок — что чаще всего идёт не так

• qmake не найден: установите qt4/qt5 инструменты (например, qt4-dev-tools или qt5-qmake) и убедитесь, что команда qmake в PATH.
• Ошибки компоновки о недостающих заголовках Qt: установите соответствующие -dev пакеты (libqt4-dev или Qt5 development packages).
• make падает с ошибками сборки: проверьте версию компилятора (gcc/g++), установите build-essential.
• Программа запускается, но интерфейс плохо отображается: возможно, требуется другая версия Qt. Попробуйте собрать с соответствующей Qt‑версией или использовать предсобранный пакет.

Краткая последовательность диагностики при ошибке:

1. Запустить ./qgit из терминала и прочитать ошибку.
2. Если сообщение про отсутствующую библиотеку — установить соответствующий пакет через apt.
3. Если проблема — несовместимость Qt, проверить доступные Qt‑пакеты в вашей версии Ubuntu.

Альтернативы и когда собирать Qgit не имеет смысла

Если у вас не получается собрать Qgit или Qt4 отсутствует, рассмотрите готовые GUI‑клиенты Git:

• GitKraken (проприетарный, кроссплатформенный)
• Gitg (легковесный для GNOME)
• Git Cola
• GitAhead
• Sourcetree (только для macOS/Windows)
• tig (текстовый интерфейс)

Выбор зависит от предпочтений: если нужна простая навигация по коммитам — gitg или gitk, если графический менеджер патчей и сравнения — GitAhead или GitKraken.

Профиль действий: чеклист для быстрой установки (роль: разработчик)

• [ ] Обновить списки пакетов: sudo apt update.
• [ ] Установить git и инструменты сборки: sudo apt install git build-essential.
• [ ] Установить зависимости Qt (qt4 или qt5): sudo apt install qt4* git или конкретные -dev пакеты.
• Скачать и распаковать исходники Qgit.
• [ ] Перейти в папку исходников: cd qgit.
• [ ] Выполнить: qmake && make && sudo make install.
• [ ] Запустить: ./qgit и проверить работу.
• [ ] Создать .desktop и переместить в /usr/share/applications.

Мини‑методология: как принимать успешную сборку

Критерии приёмки:

• Программа запускается без ошибок из терминала: ./qgit.
• Главное окно отображает историю репозитория и позволяет открывать диффы.
• Ярлык в меню открывает приложение.

Мероприятие по отладке: диаграмма решения (Mermaid)

flowchart TD
  A[Начало: запуск ./qgit] --> B{Ошибка при старте?}
  B -- Нет --> C[Готово]
  B -- Да --> D[Проверить сообщение об ошибке в терминале]
  D --> E{Отсутствует библиотека?}
  E -- Да --> F[Установить нужный пакет через apt]
  E -- Нет --> G{Ошибка компиляции}
  G -- Да --> H[Проверить gcc/g++ и зависимости -dev]
  G -- Нет --> I[Проверить совместимость Qt]
  F --> A
  H --> A
  I --> A

Краткий глоссарий

• qmake — инструмент Qt для генерации Makefile.
• Makefile — файл с правилами сборки проекта.
• .desktop — файл описания приложения для рабочего стола Linux.

Итог

Qgit остаётся полезным инструментом для визуального просмотра истории и работы с патчами Git. Сборка из исходников требует установки Qt‑зависимостей и базовых инструментов сборки. Если сборка оказывается сложной из‑за отсутствия Qt4 в репозиториях, рассмотрите альтернативные GUI‑клиенты или сборку с другой версией Qt.

Важно: при возникновении ошибок запуска первым шагом всегда выполняйте запуск из терминала — он показывает точные сообщения об отсутствии библиотек или проблемах при запуске.