Создание проекта Kenai в среде IDE NetBeans
В этом учебном курсе описана процедура создания проекта на сайте Kenai с использованием среды IDE NetBeans При создании проекта на сайте Kenai вы создаете среду, которая упрощает взаимодействие разработчиков, работающих совместно над одним проектом. Если вы являетесь участником проекта, то у вас есть доступ к инфраструктуре разработки, включающей в себя службы размещения исходного кода, функцию отслеживания неполадок и различные средства связи для разработчиков. Многие службы, представленные проектом Kenai полностью интегрированы и доступны непосредственно из среды IDE NetBeans.
Существует два способа создания проекта на сайте Kenai из среды IDE. Выбор способа в основном зависит от требований проекта, а также от того, на какой стадии цикла разработки вы находитесь. Если у вас уже есть проект NetBeans, вы можете использовать мастер размещения для совместного использования на сайте Kenai. С его помощью вы создадите для данного проекта проект на сайте Kenai. Создать проект на сайте Kenai можно и на начальном этапе, когда исходный код отсутствует. Например, можно создать проект и сохранить требования к нему на вики-странице проекта, объединить требуемые файлы в архив для загрузки и добавить участников к проекту перед началом создания кода.
Когда проект будет создан, другие разработчики смогут просмотреть подробные сведения о нем на странице проекта на сайте Kenai, открыть проект и загрузить исходные файлы из среды IDE. В большинстве случаев для просмотра исходных файлов и страниц проекта разработчикам не требуется быть участниками проекта. Разработчики, заинтересованные в совместной работе и в участии в проекте, могут подать заявку на получение статуса участника проекта. Администратор проекта может добавлять участников и присваивать роли со страницы проекта на сайте Kenai.
Кроме создания новых проектов вы можете также открывать и извлекать исходные файлы проекта Kenai из среды IDE. В большинстве случаев для открытия проекта Kenai не требуется быть участником проекта. Для получения дополнительных сведений см. раздел Открытие проекта Kenai в среде IDE NetBeans.
Просмотрите видеоролик о создании проекта Kenai в среде IDE NetBeans.
Содержание
Для работы с этим учебным курсом требуется программное обеспечение и ресурсы, перечисленные ниже.
Перед изучением этого учебного курса можно ознакомиться с приведенной ниже документацией по проекту Kenai.
Создание учетной записи на сайте Kenai
Для создания проекта в Kenai необходимо создать учетную запись на веб-сайте Kenai.com. Учетную запись невозможно создать из среды IDE.
Пропустите это упражнение, если у вас уже есть учетная запись.
- Выберите в главном меню "Team" > "Login to Kenai".
- Выберите команду Sign up now для открытия страницы регистрации Kenai в обозревателе.
Также можно перейти по ссылке https://kenai.com/people/new в обозревателе.
- Введите подробные данные для учетной записи в форме регистрации на портале Kenai, отображаемой в браузере. Нажмите кнопку "Create Account".
После отправки формы для подтверждения регистрации вы получите сообщение электронной почты.
- Подтвердите регистрацию.
По завершении процесса регистрации вы можете войти на сайт Kenai.com и изменить профиль, выбрав команду "Edit My Profile" в элементе "Profile" в левом столбце.
Для получения дополнительных сведений об изменении профиля просмотрите экранную демонстрацию "Настройка профиля пользователя". Эта экранная демонстрация находится в списке "Экранные демонстрации и учебные курсы" в разделе Справка по Kenai.
Вход на сайт Kenai
Если у вас уже есть учетная запись на сайте Kenai, вы можете выполнить вход на сайт непосредственно из среды IDE.
- Для открытия диалогового окна входа на сайт Kenai выберите "Группа" > "Авторизация в Kenai".
Можно также выбрать команду "Login to Kenai" на инструментальной панели Kenai или команду "Window" > "Kenai Dashboard" в главном меню.
- Введите имя пользователя и пароль.
- (Необязательно) Можно также выбрать элемент "В сети" в меню "Чат" для входа на сервер чата.
- Нажмите кнопку "Login".
При нажатии на кнопку "Login" в среде IDE откроется инструментальная панель Kenai. Инструментальная панель Kenai отображает ваши открытые проекты Kenai и позволяет вам работать с неполадками проекта и загружать его исходные файлы.
Создание проекта на сайте Kenai
Созданный на сайте Kenai проект – это не только репозиторий исходного кода с возможностью управления версиями. Для каждого проекта в Kenai предоставляются ресурсы и службы, необходимые при работе с проектом, в особенности при участии в проекте большого числа разработчиков. Каждое лицо является участником проекта; участники могут иметь разные роли. Некоторые участники проекта, являясь разработчиками, могут также отвечать за проектирование пользовательского интерфейса, тестирование качества, написание документации, управление циклом построения и т. п. В проекте Kenai все участники постоянно находятся на связи и имеют доступ к актуальным сведениям.
Разработка проекта может выполняться разными способами. В некоторых случаях, например, при разработке проекта "с нуля", может возникнуть необходимость настройки инфраструктуры проекта до начала создания кода. В других случаях проект может быть уже запущен, и к нему может быть создан определенный объем кода, однако из-за существенного увеличения масштаба проекта к работе над ним требуется привлечь дополнительных разработчиков.
Примечание. Проекты на сайте Kenai являются общедоступными и соответствуют лицензии проекта и Условиям использования проекта Kenai.
Создание проекта Kenai
Для создания проекта на сайте Kenai.com можно использовать мастер создания проектов Kenai среды IDE. Можно создать проект Kenai для имеющегося локально сохраненного проекта с исходными файлами, но также можно создать проект без исходных файлов для дальнейшего изменения и добавления служб, например репозитория или средства отслеживания ошибок.
При возникновении необходимости в создании репозитория в отдельном проекте NetBeans будет выполнена автоматическая инициализация корневой папки проекта как корневой папки локального репозитория Subversion.
В этом упражнении описывается метод создания проекта на сайте Kenai при условии, что проект NetBeans недоступен для вас или вы не готовы добавить исходные файлы в удаленное хранилище. Вы можете создать проект и начать использовать службы Kenai, а впоследствии добавить исходные файлы, когда они будут готовы.
Примечание. Мастер создания проекта Kenai не предназначен для добавления проекта NetBeans в существующий репозиторий.
В среде IDE выполняются следующие задачи:
- создает проект на сайте Kenai;
- создается средство отслеживания ошибок в проекте;
- создается удаленный репозиторий;
- исходные файлы проекта размещаются в удаленном репозитории (необязательно);
- инициализируется каталог локального репозитория;
- создается чат-комната для проекта.
Для создания проекта на сайте Kenai следует выполнить перечисленные ниже действия.
- Выполните вход на сайт Kenai (если вход еще не выполнен).
- Выберите "Группа" > "Kenai" > "Новый проект Kenai" в главном меню.
Для создания проекта Kenai для NetBeans откройте проект NetBeans, щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите "Выгрузить на Kenai". В мастер создания проектов Kenai будет включен путь к проекту NetBeans.
- Проверьте правильность местоположения проекта.
- Введите имя проекта Kenai.
Имя проекта используется для создания страницы проекта на сайте Kenai.com. По умолчанию среда IDE использует имя проекта NetBeans.
- Введите заголовок проекта.
Заголовок проекта – это имя, отображаемое на странице проекта на сайте Kenai.com и в среде IDE.
- Введите описание проекта (необязательно).
- Выберите лицензию проекта. Нажмите кнопку "Далее".
Необходимо выбрать лицензию; впоследствии лицензию можно будет изменить. Участники проекта должны также подтвердить согласие с условиями лицензионного соглашения проекта.
- Выберите тип репозитория для проекта и имя для добавления в репозиторий.
Среда IDE имеет интегрированную поддержку Subversion и Mercurial. При отсутствии исходных файлов проекта выберите "Отсутствует" в контекстном меню. Репозиторий можно создать позже на странице проекта на сайте Kenai.com.
- Укажите местоположение для локального репозитория.
Местоположение локального репозитория должно быть пустым каталогом.
- Укажите проекты или папки, которые необходимо добавить в репозиторий.
- (Необязательно) Выберите параметр "Commit the source into the repository".
Если этот параметр выбран, среда IDE добавит исходные файлы в удаленное хранилище при нажатии кнопки "Finish". Если проект содержит большое число исходных файлов, этот процесс может занять некоторое время.
- Выберите систему отслеживания ошибок. Нажмите кнопку "Далее".
- Просмотрите сводные данные. Нажмите кнопку "Готово".
При нажатии кнопки "Готово" на сайте Kenai будет создан проект, который будет добавлен в список собственных проектов My Projects на инструментальной панели Kenai.
При создании проекта вы автоматически становитесь участником проекта с ролью администратора.
Все добавленные проекты выводятся списком в элементе My Projects на инструментальной панели Kenai. Для получения дополнительных сведений о проекте щелкните значок Open для открытия проектов в списке открытых проектов Open Projects.
Для просмотра записей об ошибках и сообщений проекта можно развернуть узел проекта, расположенный под элементом Open Projects.
Размещение исходных файлов
Kenai предлагает репозитории с системой управления версиями Subversion и Mercurial в качестве одной из служб, доступных для размещенных на сайте проектов. При создании репозитория для локального проекта NetBeans в мастере создания проектов Kenai управление исходными файлами проекта будет осуществляться в системе управления версиями. Если вы создали новый проект, можно начать добавление исходных файлов в локальное хранилище, указанное в мастере. Если исходные файлы находятся в локальном хранилище, среда IDE распознает это и позволяет выполнить задачи по управлению версиями из окон "Projects", "Files" и "Favorites".
Для получения дополнительных сведений о поддержке проектом Kenai систем управления версиями см. документацию по проекту Kenai в разделе Управление исходным кодом.
В этом разделе показана процедура размещения исходных файлов в удаленном хранилище Subversion на сайте Kenai.
- Откройте окно "Projects" в среде IDE.
Имена файлов, являющихся новыми в хранилище, выделяются зеленым цветом. Значки на каталогах указывают, что они содержат файлы, которые следует разместить.
- Щелкните правой кнопкой мыши файл или каталог, который требуется разместить в хранилище, и выберите "Subversion" > "Commit".
- В диалоговом окне "Commit" введите сообщение, описывающее размещаемые данные. Нажмите кнопку "Commit".
Если вы размещаете данные, связанные с определенной неполадкой, вы можете указать эту неполадку в диалоговом окне "Commit", открыв панель "Update Issue" и определив средство отслеживания неполадок и идентификатор неполадки. Для изменения статуса неполадки на "Resolved" следует выбрать "Resolve as FIXED".
Для получения дополнительных сведений об использовании Subversion в среде IDE NetBeans см. Обзор Subversion.
Управление настройками проекта
При создании проекта на сайте Kenai пользователю автоматически назначается роль администратора проекта. Администратор проекта обладает полномочиями на изменение таких параметров как заголовок проекта и лицензии, а также на настройку возможностей Kenai, разрешенных для проекта.
У каждого проекта на сайте Kenai существует страница проекта, на которой администратор может выполнить управление настройками проекта. Параметры невозможно изменить из среды IDE: для открытия страницы проекта в обозревателе следует перейти по ссылке details для проекта, находящейся на инструментальной панели Kenai. Для изменения настроек проекта нужно войти на сайт Kenai.com.
Для получения дополнительных сведений см. указанную ниже документацию по сайту Kenai.com:
Добавление участников к проекту
Администратор проекта может добавить к проекту участников и присвоить каждому участнику роль. Администратор может добавить к проекту в качестве участника любого зарегистрированного на сайте Kenai пользователя.
Пользователь сайта Kenai может стать участником любого проекта, установив для него закладку. Пользователь, установивший закладку для проекта, добавляется к нему в качестве участника с ролью "Observer".
Определения других ролей см. в документации проекта Kenai по вкладке "Members".
Для добавления участника к проекту выполните перечисленные ниже действия.
- Для открытия проекта на сайте Kenai.com выберите в инструментальной панели Kenai и щелкните элемент details рядом с именем проекта.
- Нажмите на странице проекта Manage This Project.
- Для просмотра списка участников проекта выберите вкладку "Members".
- Нажмите кнопку Add Member. Введите имя пользователя проекта Kenai и выберите роль из раскрывающегося списка. Нажмите кнопку "Add".
При изменении степени участия в проекте администратор может изменить роль участника, нажав кнопку edit рядом с его именем и выбрав роль из раскрывающегося списка. Администратор также может изменить полномочия по умолчанию, присвоенные каждой роли.
Настройка полномочий роли
Уровень доступа, который имеют зарегистрированные в проекте Kenai пользователи (а также пользователи с отмененной регистрацией) к каждой функции проекта, определяется полномочиями, присвоенными роли. Администратор проекта управляет полномочиями для участников проекта, присваивая каждому участнику роль. Для каждой функции проекта администратор также может изменить полномочия по умолчанию, присвоенные каждой роли.
Для получения дополнительных сведений о настройке функций и ролей проекта см. указанную ниже документацию по проекту Kenai:
Вкладка "Features" используется для назначения ролям полномочий для каждой функции Kenai, доступной в проекте.
- Для открытия проекта на сайте Kenai.com выберите в инструментальной панели Kenai и щелкните элемент details рядом с именем проекта.
- Нажмите на странице проекта Manage This Project.
- Для просмотра списка функций Kenai, доступных в проекте, выберите вкладку "Features".
- Выберите элемент More рядом с функцией, которую требуется изменить, а затем выберите команду Set Role Permissions.
- Установите флажки в матрице, чтобы связать полномочия и роли.
Дополнительные материалы
Для получения дополнительных сведений об использовании среды IDE NetBeans в среде общей разработки см. перечисленные ниже учебные курсы.
