Настройка основного комплекта

Если используется механизм основного комплекта, настройка продукта выполняется другим способом. Сведения о комплекте расположены в модуле, который определяется основным комплектом (если это не указано, используется модуль с тем же именем, что и основной комплект). Файлы, содержащиеся информацию о бренде гипотетического приложения acmeweb, выделены в следующем примере структуры каталогов:

acmeweb/
	acmeweb.exe	(исполняемый файл - запускает eclipse.exe и задает основной комплект)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg
		jre/
		features/
			com.example.acme.acmefeature_1.0.0/    (основной комплект)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (модуль для основного комплекта. Содержит сведения о продукте.)
				plugin.xml
				about.ini
				about.html
				about.mappings
				about.properties
				acme.png
				plugin_customization.ini
				splash.jpg
				welcome.xml
			com.example.acme.acmewebsupport_1.0.0/
			...
		links/
			...

Модуль, связанный с основным комплектом, указан в сведениях о продукте.  Продукт содержит большое число настраиваемых параметров.  Параметры продукта настраиваются в файле about.ini и других файлах (см. ниже).  Продукты могут управлять стандартными значениями параметров других модулей.  Для этого используется файл plugin_customization.ini.

Рассмотрим более подробно процедуру настройки продукта.

com.example.acme.acmefeature_1.0.0/
		plugin.xml
		about.ini
		about.html
		about.mappings
		about.properties
		acme.png
		plugin_customization.ini
		plugin_customization.properties
		splash.bmp
		welcome.xml

Здесь будут рассмотрены те же параметры, что и для точки расширения, с акцентом на их отличиях для механизма основного комплекта.

Окно О программе

Все комплекты и модули должны добавить свою информацию в файл about.html.

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

Изображения для окон

В окнах продукта можно использовать цветное изображение размером 16x16 пиксел.  Оно отображается в верхнем левом углу окна.  Изображение указывается в атрибуте windowImage файла about.ini.  Адрес изображения должен быть указан в виде относительного пути модуля.  Для структуры каталогов, приведенной выше, правильная запись должна выглядеть следующим образом:

windowImage=acme.png

Начальная страница

Модули, использующие механизмы начальных страниц Eclipse 2.1, должны указать начальную страницу в атрибуте welcomePage файла about.ini. Адрес должен быть указан в виде относительного пути модуля.  Для структуры каталогов, приведенной выше, правильная запись должна выглядеть следующим образом:

welcomePage=welcome.xml

Также можно указать преобразование национального языка для файла.  (Дополнительную информацию см. в разделе Файлы, зависящие от локали.)

welcomePage=$nl$/welcome.xml

Заставки

Заставка продукта задается в файлеsplash.bmp, расположенном в каталоге модулей основного комплекта.  Изображение должно иметь формат BMP с глубиной цвета 24 бита (формат RGB), размер файла должен быть около 500x330 пиксел.  Если для разных локалей должны существовать различные заставки, их можно поместить в фрагмент модуля основного комплекта.

Параметры по умолчанию

В файле plugin_customization.ini задаются стандартные значения параметров, определенные другими модулями.  Файл имеет формат java.io.Properties. Обычно этот файл используется для задания значений параметров, которые публикуются как часть общего API модуля.  Таким образом, если параметры, которые используются модулями, не определены формально в API, существует вероятность возникновения ошибок.  

Часто настраивается также выбор стандартной проекции для рабочей среды.  Этот параметр определяется в модуле org.eclipse.ui .   В следующем примере проекцией по умолчанию является проекция Ресурсы.

org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective

Если вы хотите изменить значение по умолчанию для других параметров модуля, обратитесь к документации API для данного модуля, чтобы проверить, является ли этот параметр общим.

Файл plugin_customization.properties содержит переведенные строки для файла plugin_customization.ini.