Differences

This shows you the differences between two versions of the page.

--- etc:common_activities:slind:deb_producer [2007/11/24 22:00] – kkv
+++ etc:common_activities:slind:deb_producer [2008/03/23 23:16] (current) – zan
@@ Line 1: / Line 1: @@
-===== Плагин работы с .deb пакетами =====
+===== Плагин генерации .deb пакетов =====
+<note>
+для тестирования плагина в cvs(projects/slind/eclipse/tst/) лежат исходные коды less. Чтобы вручную собрать deb-пакет достаточно((при условии, что установленны все необходимые для сборки пакеты)) выполнить debuild.
+</note>
+Требования к плагину приведены в таблице.
 ^Id    ^Описание ^P((приоритет: 1-maх,3-min)) ^Комментарий ^
 | REQ1   | Должен быть расширением стандартного проекта CDT                                          | 1 | |
 | REQ2   | Структура дерева файлов пакета должна определяться целью install в makefile               | 1 | |
 | REQ3   | Должен поддерживаться standard проект                                                     | 1 | |
-| REQ4   | Должен поддерживаться managed проект                                                      | 2 | |
+| REQ4   | <del>Должен поддерживаться managed проект</del>                                           | 2 | |
-| REQ5   | Пользователь указывает местоположение файлов на целевой платформе вручную                 | 1 | |
+| REQ5   | <del>Пользователь указывает местоположение файлов на целевой платформе вручную</del>      | 1 | |
 | REQ6   | Файлы, входящие в пакет берутся из CDT- проекта или из его целей                          | 1 | |
-| REQ7   | Должен быть предоставлен интерфейс описания пакетов (файл control)                        | 3 | |
+| REQ7   | Должен быть предоставлен интерфейс описания пакетов (файл control)                        | 1 | |
 | REQ8   | Должна быть возможность редактирования скриптов установки / удаления  пакета              | 3 | |
 | REQ9   | Пользователь должен уметь изменять changelog                                              | 2 | |
 | REQ10  | Должна быть возможность генерации бинарного пакета для целевой платформы                  | 1 | |
 | REQ11  | Проект должен экспортироваться в deb-пакет выбором меню File/Export выбор debian package  | 1 | |
+| REQ12  | Должен быть предоставлен помощник создания каталога debian, генерирующий  файлы control, changelog, rules (для source-пакетов)| 1 |не использовать dh_make |
+==== План работ ====
+|Освоиться со сборкой source и binary пакетов|21.01|
+|Экспорт (доработка)|23.01|
+|Редактор control-файла|28.01|
+|Помощник changelog|28.01|
+|Генерация rules|6.02|
 ==== Определения ====
-  * **Standard makefile project** -- проект CDT в котором makefile пишется вручную, никогда не изменяется извне струдствами разработки.
+  * **Standard makefile project** -- проект CDT в котором makefile пишется вручную, никогда не изменяется извне средствами разработки.
   * **Managed makefile project** -- проект CDT в котором makefile каждый раз генерируется заново при изменении проекта.
+  * **DebianNature** -- свойство проекта CDT, которое означает что проект содержит каталог debian и для него может быть сгенерирован deb-пакет.
 ==== Реализация ====
@@ Line 23: / Line 41: @@
   * Разработка пакета (плагина) org.slind.ei.debproducer
   * Для standard-проектов пользователь вручную заполняет местоположение файлов внутри цели install
-  * Для managed-проектов пользватель может отредактировать переменные указывающие пути для установи файлов в целевой системе(bin,doc,lib,...)
+  * <del>Для managed-проектов пользватель может отредактировать переменные указывающие пути для установи файлов в целевой системе(bin,doc,lib,...)</del>
-  * Если в проекте нет каталога debian, (в котором в том числе лежит changelog), то он генерируется  dh_make и все файлы добавляются в проект
+  * Если в проекте нет каталога debian, (в котором в том числе лежит changelog), то он генерируется помощником, и все файлы добавляются в проект
-  * Любой из шагов экспорта проекта в deb-пакет может завершиться ошибкой
+  * Сборка пакета происходит из специально подготовленного каталога при помощи dpkg
+  * Подготовка каталога, где будет запущен dpkg, происходит при помощи make install и копирования директории debian экспортируемого проекта
-==== Интерфейс пользователя ====
-  * Редактирование переменных
-  * Шаг: control
-  * Шаг: changelog
-  * Шаги: файлы из каталога debian
-==== Сценарии ====
+==== Интерфейс пользователя ====
-=== Экспорт проекта в deb-пакет ===
+  * Генерация каталога DEBIAN (File->New->DEBIAN) ((заполнение файла control, rules для source-пакетов, генерация файла changelog))
- * Предусловие: В makefile проекта есть цель install, зависящая от DESTDIR
+  * Редактор файла control: по аналогии с редактором для plugin.xml. Должен предоставлять возможность заполнения стандартных полей control-файла и добавление специальных полей для пакетов slind
- * Предусловие: Для managed-проектов заданы пути((есть ли уже такие переменные в eclipse:doc,bin,lib,...)) для
+  * Дейсвия редактировани файла changelog: new item, new version, новая подверсия (non-maintainer)
+  * Экспорт пакета (File->Export->.deb package)
-Пользователь выбирает меню File/export или Export в контекстном меню проекта. В появившемся дилоге
+==== Сценарии ====
+  * Предусловие: стандартный cdt-проект. В makefile проекта есть цель install, зависящая от DESTDIR
+=== Генерация директории DEBIAN ===
+  * Пользователь выбирает пункт меню File->New->DEBIAN
+[[.:deb_producer:gui | Мастер]] имеет следующие экраны:
+^наименование ^обязательный ^назначение ^
+| Package type                  | да  | выбор типа пакета, указание пути к директории debian от корня проекта|
+|Source description|source|Описание общей части|
+|Packages descrition|source|Описание бинарных пакетов|
+|Package description|binary|Описание бинарного пакета|
+  * В полях мастера пользователь заполняет поля для файла control
+  * Генерируется директория debian, содержащая файлы control, changelog и rules((для source-пакетов))
+  * Пользователь имеет возможность редактировать полученные файлы и добавлять необязательные файлы в созданный каталог
+=== Экспорт .deb-пакета ===
+  * Пользователь выбирает меню File/export или Export в контекстном меню проекта. В появившемся дилоге
 выбирает пункт "General/Debian package".
 Мастер имеет следующие экраны:
 ^наименование ^обязательный ^назначение ^
-| control              | да  | выбор каталога для пакета, описание зависимостей, архитектуры, разработчик, описание пакета, версия |
+| export                | да  | путь для сохранения .deb|
-| changelog            | да  | описание изменени (текстовый редактор текущего изменения)        |
-| ?                    | нет | интерфейсы для редактирования файлов в каталоге debian           |
+  * словно по волшебству, в указанной директории появляется deb-пакет...
-Кнопка Finish генерирует deb-пакет.
 ==== Подробности ====
-  * [[.:deb_producer:automation   | Обзор deb-helper ]]
+  * [[.:deb_producer:files_description   | Описание структуры файлов каталога DEBIAN]]
   * [[.:deb_producer:gui          | Интерфейс пользователя]]
-  * FIXME: проверить наличие всех нужных полей в интерфейсе пользователя
-  * FIXME: удалить все снизу, перенеся подробности реализации в раздел **Реализация**
-FIXME: проверить наличие всех нужных полей в интерфейсе пользователя
-FIXME: проверить наличие всех нужных полей в интерфейсе пользователя
-FIXME: проверить наличие всех нужных полей в интерфейсе пользователя
-=== Список полей, заполняемых в мастере ===
-  - Имя пакета.
-  - Версия пакета.
-  - Зависимости пакета(пока просто имена, вводимые вручную).
-  - changelog.
-  - Скрипты пред-/пост-инсталляции(создаются, если не существуют).
-  - Папка, в которой выполняется сборка пакета(по умолчанию build).\\
-FIXME дополнить список
-=== Поля, неявно заполняемые в мастером ===
-  - Целевая архитектура.
-==== Подход к решению задачи ====
-=== Создание debian-каталога к проекту ===
-  - Проверяем наличие makefile'а в проекта, если есть работаем дальше, если нет то добавляем в Makefile Generator генерацию цели install.
-  - Зовём debhelp утилиты в правильном порядке - они всё делают.
-=== Генерация пакета ===
-  - При вызове генерации пакета выполняется цель install makefile'а c заменой переменной DESTDIR на путь к какой-то временной папке.
-  - Просто запускаем dpkg.
-==== Текущие вопросы ====
-  * Какие поля должны заполняться для debian-каталога обязательно(читай спрашиваться в мастере)?
-  * Какие утилиты debhelp'а нам нужны, какие данные потребуются для их вызова?
-  * Как подключиться к Makefile Generator?
-  * Как "правильно" скормить полученные знания и файлики dpkg?
-==== Общие вопросы ====
-  - Почему для SLIND выбран именно debian?
-==== Возможные направления дальнейшего развития(2 итерация) ====
-  * Редактор control-файла, выполненый аналогично редактору plugin.xml в PDE.
-  * Автоматическое заполнение зависимостей пакета.
-  * Автоматическое создание цели install в makefile если, её нет.
-  * Создание мастера обновления версии(Дополнние changelog, увеличение номера версии, редактирование зависимостей и их перепроверка).
 ==== Ссылки ====