Страница Путь компоновки Java

Опции на этой странице задают параметры пути компоновки для проекта Java. Перейти к этой странице можно со страницы Мастер Создать проект Java.

Путь к классам для компоновки - это список путей, доступных компилятору во время компоновки проекта.

Вкладка Исходный код

Папки исходного кода - это корневые папки пакетов, содержащих файлы .java. Компилятор преобразует эти файлы в файлы .class, которые будут записаны в выходную папку. Выходная папка определяется для каждого проекта отдельно, за исключением случая, когда папка исходного кода имеет собственную выходную папку. Для каждой папки исходного кода можно задавать фильтр исключения, указывающий, какие ресурсы папки не должны быть доступны компилятору.
Ресурсы, существующие в папках исходного кода, также копируются в выходную папку, если только параметр на странице параметров компилятора (Окно > Параметры > Java > Компилятор > Компоновка) не указывает, что данный ресурс должен быть отфильтрован.

Дерево показывает, как будет выглядеть проект при переключении Структуру пакетов. С помощью него также можно реорганизовать структуру проекта.

Значок Опция Описание
Добавить в путь компоновки Добавить в путь компоновки Позволяет добавлять папки или пакеты в путь компоновки Java, и делать их папками исходного кода. Папка исходного кода - это папка самого высокого уровня в иерархии проекта, используемая как корневая папка пакетов. Записи в пути компоновки, такие как папки исходного кода, доступны компилятору, и всё их содержимое (например, файлы .java) используется при компоновке проекта. Папки исходного кода позволяют организовать структуру проекта, например можно отделить пробный код от кода приложения. Одну папку исходного кода можно дополнительно структурировать с помощью пакетов.
Удалить из пути компоновки Удалить из пути компоновки Позволяет удалять папки исходного кода из пути компоновки делать их обычными папками. Всё содержимое папок (например, файлы .java) после этого не будут доступными компилятору и не будут включены при компоновке проекта.
Исключить Исключить Позволяет добавлять ресурсы в фильтр исключения папок, в которых они находятся. При этом все производные таких ресурсов станут недоступными компилятору. Это может быть полезно, например, когда некоторые пакеты не нужны в проекте и их компиляцию можно пропустить.
Включить Включить Это действие доступно для файлов или папок, занесенных в фильтр исключения. Оно позволяет снова сделать эти ресурсы доступными компилятору.
Настроить свойства папки исходного кода Настроить свойства папки исходного кода Изменения здесь могут понадобиться в двух случаях:

  1. Для изменения фильтров включения и исключения заданием шаблонов имён. Это может быть полезно если ресурсов, которые нужно включить или исключить, много, и их можно легко отличить от остальных. Наиболее часто используется звёздочка (например, исключить все ресурсы, начинающиеся с "Test*.java").
  2. Для установки выходной папки для папки исходного кода. При этом все файлы .class, генерируемые из файлов .java, находящихся в папке исходного кода, будут помещаться в отдельной папке вывода, а не в общей для всего проекта.
Обратите внимание, что это действие доступно только если выделен один объект.

Отменить все изменения Отменить все изменения Отменить все изменение в проекте, сделанные в этом мастере
Связать дополнительный источник с проектом Связать дополнительный источник с проектом При создании нового проекта, может оказаться так, что у вас уже будет некоторый код или другие ресурсы, которые могут быть использованы в проекте. Для того чтобы они стали доступны компилятору, свяжите папку, в которой они находятся с проектом. При этом будет создана только связь с папкой. Это означает, что любые изменения, произведенные в этих ресурсах, также отразятся в использующих их проектах.
Значок отсутствует Разрешить выходные папки для папок исходного кода Показывает или скрывает атрибут 'выходная папка' папок исходного кода. Если не отображается ни одной выходной папки, значит для сгенерированных файлов .class используется общая выходная папка проекта.

Обратите внимание, что более короткое описание всех действий отображается в области ниже дерева проектов (с меткой 'Описание'). При этом показываются только описания, подходящие к текущему выделению в проекте. Опытные пользователи могут скрыть область описаний для увеличения места на экране, отведенного для структуры проектов.

Вкладка Проекты

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

При добавлении обязательного проекта косвенно добавляются также все его записи путей к классам, помеченные как 'экспортированные'. Настройка записи пути к классам как экспортированной выполняется на вкладке Порядок и экспорт.

Выбранные здесь проекты автоматически добавляются в список связанных проектов. Список связанных проектов определяет порядок компоновки. Проект всегда компонуется после того, как будут скомпонованы все его связанные проекты.

Вкладка Библиотеки

На этой странице можно добавлять библиотеки в путь компоновки. Можно добавлять:

Файлы JAR можно также добавлять косвенно как переменные путей к классам.

По умолчанию список библиотек содержит запись, представляющую библиотеку времени выполнения Java. Эта запись указывает на JRE, выбранную в качестве JRE по умолчанию. JRE по умолчанию задается на странице параметров установленных JRE (Окно > Параметры > Java > Установленные JRE)

Опции вкладки Библиотеки
Опция Описание
Добавить JAR Позволяет переместиться по иерархии рабочей среды и выбрать файлы JAR для добавления в путь компоновки.
Добавить внешние JAR Позволяет переместиться по файловой системе (вне рабочей среды) и выбрать файлы JAR для добавления в путь компоновки.
Добавить переменную Позволяет добавить переменные путей к классам в путь компоновки. Переменные путей к классам - это косвенный способ указать файлы JAR, позволяющий избежать указания путей локальной файловой системы в пути к классам. Это необходимо при совместном использовании проектов.
Переменные можно создавать и редактировать на странице параметров переменных путей к классам (Окно > Параметры > Java > Путь компоновки > Переменные путей к классам)
Добавить библиотеку Позволяет добавить предопределенные библиотеки, такие как системная библиотека JRE. Такие библиотеки могут соответствовать произвольному числу записей (показаны в виде дочернего узла для узла библиотеки)
Добавить папку классов Позволяет переместиться по иерархии рабочей среды и выбрать папку классов для пути компоновки. Кроме того, в окне выбора можно создать папку.
Изменить Позволяет изменить текущую выбранную запись библиотеки или атрибут записи.
Удалить Удаляет выбранный элемент из пути компоновки. При этом ресурс не удаляется.

 Ниже перечислены атрибуты библиотек (представленные в виде дочерних узлов записи библиотеки):

Атрибуты записи библиотеки
Атрибут Описание
Расположение документации по Java Указывает, где находится документация по Java для библиотеки. Если это расположение задано, то, нажав Shift+F2 на элементе этой библиотеки, вы можете открыть документацию по этому элементу.
Прикрепление исходного кода Указывает, где находится исходный код библиотеки.

Вкладка Порядок и экспорт

В списке Порядок путей к классам для компоновки вы можете перемещать вверх и вниз выбранные записи путей для данного нового проекта с помощью кнопок Вверх и Вниз.

Помеченные записи списка отмечаются как экспортированные. Экспортированные записи доступны проектам, которым необходим данный проект. С помощью Выбрать все и Отменить выбор всех вы можете изменить состояние выбора сразу всех записей. Папки исходного кода всегда экспортированные, и отменить их выбор нельзя.

Выходная папка по умолчанию

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

Связанные концепции

Путь к классам для компоновки
Параметры переменных путей к классам

Связанные задачи

Использование путей компоновки
Прикрепление исходного кода к переменным
Присоединение исходного кода к файлу JAR

Связанные ссылки

Часто задаваемые вопросы о JDT
Параметры переменных путей к классам
Свойства компилятора Java