# Краткое руководство по началу работы с продуктом

В этом учебнике приведены общие сведения о рабочей среде, а также краткие инструкции по созданию простых приложений. Более подробные объяснения, в том числе рисунки, приведены в руководстве пользователя рабочей среды.

Приступая к работе с рабочей средой

Задача | Описание

Создание простого проекта

1. Выберите Файл > Создать > Проект....
2. В Мастере Создать проект выберите Простой > Проект и нажмите Далее.
3. В поле Имя проекта введите имя создаваемого проекта.

4. Укажите расположение проекта, либо оставьте расположение по умолчанию.

5. Нажмите кнопку Готово.

Создание папки

1. Убедитесь, что существует по крайней мере один проект.
2. Выберите Файл > Создать > Папка.
3. В поле Имя папки мастера Создать папку введите имя для новой папки.
4. Нажмите кнопку Готово.

Создание файла

1. Убедитесь, что существует по крайней мере один проект.
2. Выберите Файл > Создать > Файл.
3. В поле Имя файла мастера Создать файл введите имя для нового файла.
4. Нажмите кнопку Готово.

Импорт ресурсов

1. Выберите Файл>Импорт.
2. Выберите источник импорта.
3. Нажмите Далее.
4. Выберите расположение, в котором расположен импортируемый ресурс, в соответствии с инструкциями мастера.
5. Нажмите кнопку Готово.

Экспорт ресурсов

1. Выберите Файл > Экспорт.
2. Выберите целевое расположение для экспорта.
3. Нажмите Далее.
4. Выберите расположение для экспорта, в соответствии с инструкциями мастера.
5. Нажмите кнопку Готово.

Создание проекта Java: Пример JUnit

1. Для того чтобы загрузить исходный код JUnit откройте страницу http://www.eclipse.org/downloads/ и найдите выпуск Eclipse, с которым вы работаете.
2. Прокрутите страницу до раздела Модули примера и загрузите архив примеров.
3. Извлеките содержимое файла Zip в каталог.
4. Вернитесь в Eclipse и выберите Файл > Создать > Проект....
5. Выберите Проект Java и нажмите Далее.
6. В поле Имя проекта введите JUnit.
7. Нажмите кнопку Готово.
8. В Структуре пакетов убедитесь, что выбран проект JUnit.
9. Выберите пункт меню Файл > Импортировать....
10. Выберите файл Zip и нажмите кнопку Далее.
11. Нажмите кнопку Обзор рядом с полем Файл Zip и в открывшемся списке выберите <ExamplesDownloadPath>eclipse/plugins/org.eclipse.jdt.ui.examples.projects_3.0.0/archive/junit/junit381src.jar.

12. В мастере импорта нажмите Выбрать все под иерархическим списком.

13. Убедитесь, что проект JUnit указан в качестве целевой папки в поле Папка и нажмите кнопку Готово.

14. Посмотрите на индикатор хода импортирования и заметьте, что импортируемые ресурсы компилируются по мере их импортирования в рабочую среду. Это происходит потому, что на странице параметров Рабочая среда отмечена опция Автоматическая компоновка. Вам будет предложено заменить файлы .classpath и .project в проекте JUnit. Причина в том, что ресурс .classpath был создан для вас, когда вы создавали проект JUnit. Эти файлы можно безболезненно заменить.
    В панели Структура пакетов разверните проект JUnit, чтобы просмотреть пакеты JUnit.

Создание класса Java: Пример JUnit

1. В панели Структура пакетов правой кнопкой мыши щелкните на проекте JUnit и выберите Создать > Пакет.
2. В поле Имя введите test в качестве имени нового пакета.
3. Нажмите кнопку Готово.
4. В панели Структура пакетов выберите пакет test и нажмите кнопку Создать класс Java, расположенную на панели инструментов. Убедитесь, что в поле Папка исходного кода указано значение JUnit, а в поле Пакет - значение test.
5. В поле Имя введите MyTestCase.
6. Нажмите кнопку Обзор, расположенную рядом с полем Суперкласс.
7. В поле Выбрать тип в окне Выбор базового класса введите Test, чтобы сократить список доступных базовых классов.
8. Выберите класс TestCase и нажмите OK.
9. Отметьте переключатель Конструкторы из базового класса.
10. Нажмите кнопку Готово.
11. Новый файл откроется в редакторе. В панели Схема выберите новый класс MyTestCase.Откройте контекстное меню и выберите Исходный код > Переопределить/Реализовать методы....
12. В окне Переопределить методы отметьте setUp() и tearDown() и нажмите OK.
13. Измените тело setUp() на container= new Vector();.
14. container и Vector будут подчеркнуты линией выделения неполадок, поскольку они не распознаются.В строке маркеров появится светящаяся лампочка. Поместите курсор на Vector и нажмите Ctrl+1 (или выберите Правка > Быстрое исправление). Выберите Импортировать 'Vector' (java.util), чтобы добавить недостающее объявление импорта.
15. Поместите курсор на container и нажмите Ctrl+1. Выберите Создать поле 'container', чтобы добавить новое поле.
16. В панели Схема выберите класс MyTestCase. Откройте контекстное меню и выберите Исходный код > Создать методы получения и установки....
17. Окно Создать методы получения и установки предлагает создать методы getContainer и setContainer. Выберите оба метода и нажмите OK. Будут добавлены методы получения и установки для поля container.
18. Сохраните файл.
19. Формат созданного кода можно настроить в пункте Окно > Параметры > Java > Стиль кода > Форматирование кода. Если вы задаете префикс или суффикс в именах полей, то это можно указать в пункте Окно > Параметры > Java > Стиль кода > Поля, чтобы создаваемые методы получения и установки предлагали имена методов без префикса и суффикса.

Запуск программы Java: Пример JUnit

1. В панели Структура пакетов найдите find junit.textui.TestRunner.java и дважды щелкните на нем, чтобы открыть его в редакторе.
2. В панели Схема обратите внимание на то, что класс TestRunner помечен значком, указывающим, что класс определяет метод main.
3. Правой кнопкой мыши щелкните на TestRunner.java в панели Структура пакетов и выберите Выполнить > Приложение Java.
4. Выберите Выполнить > Запуск.... Откроется окно Конфигурации запуска с выбранной конфигурацией запуска TestRunner.
5. Перейдите на вкладку Аргументы и введите junit.samples.VectorTest в области Аргументы программы.
6. Нажмите Выполнить. В этот раз программа будет успешно выполнена; в ее выводе будет указано число выполненных тестов.
7. Переключитесь на проекцию Отладка. В панели Отладка обратите внимание на то, что процесс последнего запуска программы был зарегистрирован.
8. Нажмите кнопку Выполнить, расположенную на панели инструментов рабочей среды. Этот список содержит ранее запущенные программы. Эти программы можно запустить повторно, выбрав их в хронологическом списке.
9. В контекстном меню панели Отладка (или эквивалентной кнопки панели инструментов) выберите Удалить все завершенные, чтобы очистить панель от завершенных процессов запуска.

Создание

модуля

1. Выберите Файл > Создать > Проект.
2. Выберите Проект модуля и нажмите кнопку Далее.
3. В поле Имя проекта введите имя создаваемого проекта и нажмите кнопку Далее.
4. На странице Содержимое модуля задаются данные, с помощью которых будет инициализирован файл plugin.xml, включая идентификатор модуля, версию и имя.
5. Выберите доступный шаблон и нажмите кнопку Далее.
6. Настройте расширение примера и нажмите кнопку Готово.

Запуск экземпляра рабочей среды Eclipse для тестирования модуля

1. Выберите Выполнить > Запуск....
2. В окне диалога Конфигурация запуска укажите имя конфигурации в поле Имя.
3. В поле Данные рабочей области нажмите кнопку Обзор и выберите рабочую область, которая будет использоваться динамической рабочей средой. Расположение этой динамической рабочей области должно отличаться от расположения рабочей области экземпляра хоста.
4. В поле Запустить приложение выберите приложение Eclipse org.eclipse.ui.ide.workbench.
5. Нажмите кнопку Выполнить.

Будет создан второй экземпляр рабочей среды, входящие в который модули включают модули рабочей области и модули, выбранные в параметрах на странице Целевая платформа. Динамическую рабочую среду можно протестировать с помощью выбранной JRE, которая не обязательно должна совпадать с той, в которой модули компилируются в рабочей области. Можно также указать аргументы VM, которые соответствуют условиям тестирования.

Автоматическая компоновка

1. Выберите Окно > Параметры.
2. В левой части окна выберите категорию Общие.
3. Выберите Автоматическая компоновка.
4. Нажмите OK.

Компоновка вручную

1. Выберите один или несколько проектов в панели Навигатор проекции Ресурсы.
2. Щелкните правой кнопкой мыши и выберите в меню Скомпоновать проект.

Приступая к работе с CVS

Примечание: Для создания расположения хранилища в Рабочей среде сервер CVS должен уже быть настроен на своем хосте.

Задача | Описание

Создание расположения хранилища CVS

1. Выберите Окно > Показать панель > Прочие...
2. Выберите CVS > Хранилища CVS.
3. Нажмите кнопку Добавить хранилище CVS.
4. Введите информацию, необходимую для подключения к расположению хранилища.
5. Нажмите кнопку Готово.

Соединение и настройка CVS с помощью SSH

1. Выберите Окно > Параметры.
2. Выберите Совместная работа > CVS > Способ подключения SSH2.
3. Перейдите на вкладку Общие, нажмите кнопку Добавить личный ключ и добавьте в список собственный личный ключ.
4. Укажите пароль для личного ключа и сохраните его.

Если пара ключей отсутствует, выполните следующие действия:

1. Выберите Окно > Параметры.
2. Выберите Совместная работа > CVS > Способ подключения SSH2.
3. Перейдите на вкладку Управление ключами.
4. Если сервер поддерживает версию 1 протокола, выберите Создать ключ RSA, для версии 2 выберите Создать ключа DSA. Будут созданы открытый и личный ключи. Открытый ключ будет показан в области текста только для чтения.
5. Скопируйте общий ключ на сервер. Если на сервере работает OpenSSH, выберите Экспортировать по sftp. В противном случае скопируйте общий ключ и вставьте его в удаленный файл ~/.ssh/authorized_keys.

Изъятие проекта из хранилища CVS

1. Откройте проекцию Обзор хранилища CVS.
2. В панели Хранилища CVS разверните расположение хранилища.
3. Разверните ветвь HEAD и выберите папки, которые требуется добавить как проекты в Рабочую среду.
4. В меню выбранных папок выберите одну из следующих опций:
   - Изъять - выбранные папки будут изъяты как проект локальной рабочей области с тем же именем, что и папка в хранилище.
   - Изъять как... - выбранные папки будут изъяты как пользовательский проект локальной рабочей области.

Синхронизация с хранилищем, обновление и фиксация изменений

1. В панели Навигатор выберите ресурсы, которые требуется синхронизировать.
2. Щелкните правой кнопкой мыши и в меню выберите Совместная работа > Синхронизировать с хранилищем.
3. На панели Синхронизация правой кнопкой мыши щелкните на ресурсе и выберите одну из следующих опций:
   - Фиксировать, для переопределения существующей версии CVS ресурса и сохранения текущей версии в хранилище.
   - Обновить, для загрузки в рабочую область версии из хранилища.