Проектное руководство

Wiki

Внешние ресурсы, связанные с проектом (важно)

• Критерии участия

Если вы хотите участвовать в разработке Peony, вам необходимо помнить о требованиях, изложенных в критериях участия. Я надеюсь, что Peony сохранит свою надёжность и удобство сопровождения, а также будет достаточно «простым». Никогда не следует пренебрегать важными принципами ради решения одной или нескольких проблем.

• Документация gitbook

Этот документ представляет собой некоторые записи, которые я написал ранее с точки зрения разработчика.

• Исходный код тестовых случаев

Эти графические интерфейсы предназначены для демонстрации текущего прогресса работы. В настоящее время около 95% кода в моей структуре относится к бэкэнду. После того как бэкэнд будет полностью доработан и стабилизирован, я буду реализовывать связанные с GUI части в соответствии с дизайном файлового менеджера UKUI3.0. Вы можете увидеть примеры реализованных функций в подпроекте example.

Как понять этот проект?

Что касается Peony, то на самом деле я просто хочу создать настольное приложение, называемое файловым менеджером UKUI3.0, которое не является ни сложным, ни инновационным. Что касается того, как это преподнести людям, специализирующимся в этой области, это их дело. Хотя процесс его реализации не имеет значения для пользователей и наблюдателей, он очень важен для разработчиков. Основываясь на моём опыте работы с UKUI 2.0 и анализе различных файловых менеджеров, я решил использовать libpeony-qt в качестве инструмента для реализации Peony.

У всех программистов есть мечта — сделать код один раз и пользоваться им всю жизнь. Конечно, у меня тоже есть такая мечта. Я считаю, что самое важное для программиста — это экономить время. Если мы можем выполнить работу за неделю за один день, это означает, что у нас есть максимум четыре дня свободного времени. Мы можем либо продолжать работать над улучшением ключевых показателей эффективности, либо углубляться в технологии, либо даже бездельничать.

На самом деле, сейчас я не думаю о ключевых показателях эффективности. Это может быть связано с тем, что я сейчас занимаюсь общественной работой. Так что насчёт изучения технологий или безделья? Без сомнения, это желание. Но всё это требует освобождения моих собственных производственных сил. Я совершенно не вижу надежды в старой версии Peony, но, возможно, я смогу увидеть проблеск света в новой версии. Честно говоря, переписать какое-либо приложение с помощью qt не было моей целью. Просто это необходимый шаг для достижения моих амбиций, учитывая мой текущий рабочий контекст.

Я немного отклонился от темы, но понимание пути мысли разработчика должно быть ключом к пониманию проекта, не так ли? Вернёмся к теме — чтобы понять этот проект, просто сказать недостаточно. Хотя я написал много markdown, чтобы помочь всем понять этот проект, этого может быть недостаточно, чтобы дать всем полное представление о нём.

В любом случае, я считаю, что начинать с исходного кода проекта нецелесообразно. Хотя мой README не очень хорош и содержит много китайского и английского языков, я всё же предлагаю сначала прочитать его. Помимо вышеперечисленных ресурсов, во многих подпапках этого проекта также есть README файлы, описывающие содержимое соответствующей папки. Кроме того, если вы действительно не хотите читать мои документы, вы также можете начать с просмотра исходного кода тестового примера. Для тех, кто имеет некоторый опыт разработки, эти примеры очень просты.

Чтобы глубоко понять структуру libpeony-qt, я рекомендую анализировать код, тестовые примеры, все документы markdown и предоставленный мной шаблон doxygen.

Как оценить прогресс работы?

Текущий проект Peony близок к первому этапу тестирования. Пожалуйста, следите за изменениями на платформах GitHub и launchpad:

Репозиторий исходного кода GitHub

Launchpad PPA

Сборка и тестирование

Условия

1. Системные требования: Ubuntu/UbuntuKylin 19.10

2. Зависимости компиляции: см. поле Build-Deps в файле debian/control

3. Рекомендуется: qt5-gtk2-platformtheme (для поддержки системных тем в среде рабочего стола gtk)

Шаги (на примере UbuntuKylin)

git clone https://github.com/ukui/peony.git

cd peony && mkdir build && cd build

qmake ..

make

Если здесь возникает ошибка, в большинстве случаев это связано с отсутствием зависимостей. Вы можете загрузить зависимости, указанные в debian/control, с помощью команды mk-build-deps.

sudo make install

/usr/bin/peony

peony-qt-desktop

peony-qt-desktop также является частью проекта Peony. Если вы хотите, чтобы он взял на себя управление DBus-сервисами рабочего стола и файлового менеджера, вам нужно:

/usr/bin/peony-qt-desktop -w -d