Dostosowywanie składnika podstawowego

Gdy używany jest mechanizm składnika podstawowego, dostosowywanie produktu działa w zupełnie inny sposób. Informacje dotyczące oznakowywania marką dla tego składnika znajdują się w module dodatkowym określonym przez składnik podstawowy (lub moduł dodatkowy o tej samej nazwie, co składnik podstawowy, jeśli żaden nie został określony). W przykładowej strukturze katalogów poniżej wyróżniono pliki określające i definiujące informacje dotyczące oznakowywania marką w hipotetycznym przykładzie aplikacji acmeweb:

acmeweb/
	acmeweb.exe (plik wykonywalny produktu - wywołuje plik eclipse.exe i określa składnik podstawowy)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg
		jre/
		features/
			com.example.acme.acmefeature_1.0.0/    (składnik podstawowy)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (moduł dodatkowy dla składnika podstawowego; zawiera informacje dotyczące oznakowywania marką)
				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/
			...

Informacje dotyczące oznakowywania marką danego produktu znajdują się w module dodatkowym powiązanym ze składnikiem podstawowym. Wiele elementów produktu można dostosowywać. Dostosowania na poziomie produktu są zdefiniowane przy użyciu pliku about.ini oraz innych plików w nim opisanych. Produkty mogą również kontrolować domyślne wartości preferencji innych modułów dodatkowych. W tym celu należy użyć pliku plugin_customization.ini.

Wracając jeszcze raz do modułu dodatkowego składnika podstawowego przykładowego produktu, przyjrzyjmy się bliżej sposobowi dostosowywania produktu.

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

Przejrzymy jeszcze raz dostosowania, które były przeglądane dla punktu rozszerzenia produktów, koncentrując się na różnicach w specyfikacji dotyczących przypadku użycia mechanizmu składnika podstawowego.

Okna dialogowe Informacje o

Tak jak w omówionym już przypadku dotyczącym dostosowywania na poziomie produktu, wszystkie składniki i moduły dodatkowe powinny dodawać plik about.html udostępniający informacje na temat konkretnego modułu dodatkowego.

Składnik podstawowy dostarcza również informacje i grafiki dla całego produktu. Do określenia tych informacji używane są dodatkowe pliki.

Obrazy w oknie

Do oznakowania marką okien tworzonych przez produkt można użyć kolorowego obrazu o rozmiarze 16x16 piksli. Będzie on wyświetlany w lewym górnym rogu okien produktu. Określa się go w atrybucie windowImage pliku about.ini. Ścieżka powinna zostać określona jako ścieżka względna modułu dodatkowego.  Prawidłowy wpis dla struktury katalogów przedstawionej powyżej wygląda następująco:

windowImage=acme.png

Strona powitania

Moduły dodatkowe używające mechanizmów powitania platformy Eclipse 2.1 powinny określać plik strony powitania w atrybucie welcomePage pliku about.ini. Ścieżka powinna zostać określona jako ścieżka względna modułu dodatkowego.  Prawidłowy wpis dla struktury katalogów przedstawionej powyżej wygląda następująco:

welcomePage=welcome.xml

Dla języka narodowego można również określić wyszukiwanie w pliku.  (Więcej szczegółów na ten temat zawiera sekcja Pliki charakterystyczne dla ustawień narodowych).

welcomePage=$nl$/welcome.xml

Ekrany startowe

Ekran startowy produktu jest dostarczany w pliku splash.bmp umieszczonym w katalogu modułu dodatkowego składnika podstawowego. Obraz powinien zostać dostarczony jako 24-bitowy kolorowy plik BMP (w formacje RGB) o rozmiarze ok. 500x330 piksli. Jeśli ekrany startowe mają być dostosowywane w zależności od różnych ustawień narodowych, mogą zostać umieszczone jako fragment modułu dodatkowego składnika podstawowego.

Wartości domyślne preferencji

Do ustawiania domyślnych wartości preferencji definiowanych przez inne moduły dodatkowe służy plik plugin_customization.ini. To jest plik w formacie java.io.Properties. Ten plik jest zazwyczaj używany do ustawiania wartości preferencji, które są publikowane jako część publicznego interfejsu API modułu dodatkowego. Oznacza to, że to użytkownik podejmuje ryzyko, odwołując się do preferencji, które są używane przez moduł dodatkowy, ale nie zostały formalnie zdefiniowane w interfejsie API.  

Jednym z powszechnych dostosowań jest ustawienie domyślnej perspektywy dla środowiska roboczego. Ta preferencja jest definiowana w module dodatkowym org.eclipse.ui. W poniższym przykładzie założono, że domyślną perspektywą dla uruchamianego produktu będzie perspektywa zasobów.

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

W przypadku konieczności zmiany domyślnej wartości preferencji innego modułu dodatkowego należy sprawdzić w dokumentacji interfejsu API danego modułu dodatkowego, czy nie jest to preferencja publiczna.

Plik plugin_customization.properties zawiera przetłumaczone łańcuchy dla pliku plugin_customization.ini.