Differences

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

--- etc:common_activities:slind:deb_producer [2007/11/10 20:36] – kkv
+++ etc:common_activities:slind:deb_producer [2008/03/23 23:16] (current) – zan
@@ Line 1: / Line 1: @@
-==== Плагин для сборки пакетов ====
+===== Плагин генерации .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   | <del>Должен поддерживаться managed проект</del>                                           | 2 | |
+| REQ5   | <del>Пользователь указывает местоположение файлов на целевой платформе вручную</del>      | 1 | |
+| REQ6   | Файлы, входящие в пакет берутся из CDT- проекта или из его целей                          | 1 | |
+| 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 |
-=== Требования верхнего уровня  ===
-FIXME: в работе
+==== План работ ====
+|Освоиться со сборкой source и binary пакетов|21.01|
+|Экспорт (доработка)|23.01|
+|Редактор control-файла|28.01|
+|Помощник changelog|28.01|
+|Генерация rules|6.02|
-=== Варианты использования (User story) ===
-FIXME: требует существенной переработки
+==== Определения ====
-  - **Выбор типа пакета**. Пользователь перед началом создания пакета, должен выбрать что он хочет сделать:
+  * **Standard makefile project** -- проект CDT в котором makefile пишется вручную, никогда не изменяется извне средствами разработки.
-        * сделать очередную версию уже существующего пакета
+  * **Managed makefile project** -- проект CDT в котором makefile каждый раз генерируется заново при изменении проекта.
-        * сделать первую версию нового пакета
+  * **DebianNature** -- свойство проекта CDT, которое означает что проект содержит каталог debian и для него может быть сгенерирован deb-пакет.
-  - **Выбор существующего пакета**. Если пользователь хотел сделать очередную версию, то он должен выбрать пакет с предыдузей версией.
-  - **Ввод основных данных о пакете**. Пользователь заполняет набор полей, которые необходимы для создания нового пакета.
-  - **Выбор файлов, входящих в пакет**. Пользователь находясь в окне, где прелставлены все файлы проекта, выделяет те файлы, которые он хочет поместить в пакет.
-  - **Указание каталога установки для файлов**. Пользователь видит список ранее выбраных фалов и указывает пути, куда должны быть установленны файлы. Чтобы указать место установки файлов, ему предоставляется возможность выделить один или несколько файлов и нажав на кнопку, в дереве каталогов выбрать необходимый каталог, либо создать новый, если необходимого нет.
-  - **Редактирование списка зависимостей нового пакета**. Пользователь видит список пакетов, от которых уже зависит данный пакет. При помощи выделения и кнопок он может удалить некоторые из них, либо добавить новые. Если пользователь нажимает на кнопку добавления нового пакета, ему предлагается ввести имя нового пакета, от которого будет зависить его пакет.
-  - **Добавление скриптов пре/пост инсталяции/деинсталяции**. Пользователь видит список возможных видов скриптов, которые он может добавить. Выбирает какой-то тип, после чего ему предлагается выбрать файл, хранящийся на диске, с этим скриптом. Пользователь может указать свой скрипт для каждого типа.
-  - **Ввод "изменений" в changelog пакета**. Пользователь просматривает существующий changelog. и имеет возможность ввести текст нового изменения. Все остальные поля проставленны автоматически. Редактировать изменения прошлых версий пользователь не может.
-  - **Сборка нового пакета**. Пользователь наблюдает все ранее введеные данные в наглядной форме, чтобы удостоверится, что он все сделал правильно и нажимает кнопку "Finish" чтобы собрать пакет.
-=== Уточняющая информация ===
+==== Реализация ====
-== Входные данные для генерации пакета ==
+  * Разработка пакета (плагина) org.slind.ei.debproducer
+  * Для standard-проектов пользователь вручную заполняет местоположение файлов внутри цели install
+  * <del>Для managed-проектов пользватель может отредактировать переменные указывающие пути для установи файлов в целевой системе(bin,doc,lib,...)</del>
+  * Если в проекте нет каталога debian, (в котором в том числе лежит changelog), то он генерируется помощником, и все файлы добавляются в проект
+  * Сборка пакета происходит из специально подготовленного каталога при помощи dpkg
+  * Подготовка каталога, где будет запущен dpkg, происходит при помощи make install и копирования директории debian экспортируемого проекта
-Чтобы сгенерировать пакет, необходимо иметь следующие данные:
-  * тип пакета (бинарный или с исходными текстами программы);
-  * список файлов, которые необходимо запаковать;
-  * в случае, если это бинарный пакет необходимо:
-     * список требуемых библиотек;*
-     * список предоставляемых библиотек;
-  * путь, куда ставить какой файл(разные файлы могут быть установлены в различные каталоги)
-== Сборка пакетов для другой платформы ==
-FIXME: в работе
+==== Интерфейс пользователя ====
-== Пакеты с исходниками: сборка и установка ==
+  * Генерация каталога DEBIAN (File->New->DEBIAN) ((заполнение файла control, rules для source-пакетов, генерация файла changelog))
+  * Редактор файла control: по аналогии с редактором для plugin.xml. Должен предоставлять возможность заполнения стандартных полей control-файла и добавление специальных полей для пакетов slind
+  * Дейсвия редактировани файла changelog: new item, new version, новая подверсия (non-maintainer)
+  * Экспорт пакета (File->Export->.deb package)
-FIXME: в работе
+==== Сценарии ====
+  * Предусловие: стандартный 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".
+Мастер имеет следующие экраны:
+^наименование ^обязательный ^назначение ^
+| export                | да  | путь для сохранения .deb|
+  * словно по волшебству, в указанной директории появляется deb-пакет...
+==== Подробности ====
+  * [[.:deb_producer:files_description   | Описание структуры файлов каталога DEBIAN]]
+  * [[.:deb_producer:gui          | Интерфейс пользователя]]
+==== Ссылки ====
+[[http://www.eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-275.html|плагин для редактирования скриптов]]
+~~DISCUSSION~~