Dostosowywanie produktu

W przypadku produktu jest wiele aspektów, które można dostosowywać, na przykład ekran startowy, tekst okna dialogowego Informacje o, ikony okien itp. Większość z tych elementów jest definiowana w trakcie dodawania do punktu rozszerzenia org.eclipse.core.runtime.products.

Przyjrzyjmy się, w jaki sposób są definiowane najpowszechniejsze elementy dostosowywane.

Okna dialogowe Informacje o

Okno dialogowe "informacje o" platformy jest wyświetlane za każdym razem, gdy użytkownik wybierz opcję Pomoc > Informacje o w menu środowiska roboczego.   

Okno dialogowe informacji

W górnej części tego okna dialogowego wyświetlana jest wersja produktu, natomiast w dolnej wyświetlane są informacje o zainstalowanych składnikach (jeśli istnieją) i wtyczkach. Szczegóły dotyczące składnika (inaczej oznakowanie marką) są dostarczane w plikach about.ini, about.properties oraz about.html wtyczki powiązanej z danym składnikiem. Te informacje są wyświetlane, gdy użytkownik zażąda szczegółów składnika i zaznaczy konkretny składnik.

Oznakowanie marką produktu (górna część okna dialogowego) jest określane przez właściwości rozszerzenia, które opisują tekst oraz obrazy wyświetlane w tym oknie dialogowym. Oto przykład deklaracji dla platformy Eclipse.

	<property
		name="aboutText"
		value="%aboutText"/>
	<property
		name="aboutImage"
		value="icons/eclipse_lg.png"/>
	</product>

Więcej informacji na temat tych właściwości zawiera sekcja dotycząca interfejsu IProductConstants.

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 definicji rozszerzenia produktu. Ewentualnie może zostać użyty atrybut windowImages opisujący tablicę obrazów o różnych rozmiarach, które powinny być używane w lewym górnym rogu.

	<property
		name="windowImages"
		value="icons/eclipse.png,icons/eclipse32.png"/>

W przypadku, gdy określone są obie właściwości - windowImages i windowImage - pierwsza zastępuje drugą.

Strona powitania

Produkty używające mechanizmu strony powitania platformy Eclipse 2.1 mogą określić nazwę i położenie pliku strony powitania we właściwości welcomePage.

	<property
		name="welcomePage"
		value="$nl$/welcome.xml"/>

Obecnie nie zaleca się korzystania z tej właściwości. Zamiast niej należy stosować punkt rozszerzenia org.eclipse.ui.intro. Więcej informacji na temat nowych mechanizmów powitania i wprowadzanie zawiera punkt Obsługa powitania/wprowadzenia.

Wartości domyślne preferencji

Do określenia pliku zawierającego domyślne wartości preferencji dla produktu można użyć właściwości preferenceCustomization.

	<property
		name="preferenceCustomization"
		value="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 wtyczki. Oznacza to, że to użytkownik podejmuje ryzyko, odwołując się do preferencji, które są używane przez wtyczkę, ale nie zostały formalnie zdefiniowane w interfejsie API.  

Ekrany startowe

Ekran startowy produktu jest określony w pliku config.ini znajdującym się w jego katalogu configuration produktu. Właściwość osgi.splashPath w tym pliku opisuje miejsca, w których należy szukać pliku o nazwie splash.bmp. Właściwość osgi.splashLocation identyfikuje pełną i dokładną ścieżkę do pliku ekranu startowego, który ma zostać użyty. Określenie ścieżki do pliku ekranu startowego pozwala na używanie ekranów startowych dla konkretnych ustawień narodowych, ponieważ dana ścieżka wyszukiwania może wskazywać kilka wtyczek lub fragmentów do przeszukania, podobnie jak ścieżki w stylu $nl$. Kompletny opis właściwości, które można skonfigurować w tym pliku zawiera plik config.ini pakietu SDK platformy. Obraz powinien zostać dostarczony jako 24-bitowy kolorowy plik BMP (w formacje RGB) o rozmiarze około 500x330 piksli.

Położenie, wielkość i kolor paska postępu oraz komunikatu o postępie na ekranie startowym można konfigurować za pomocą właściwości startupProgressRect, startupMessageRect i startupForegroundColor. Więcej informacji na temat tych właściwości zawiera sekcja dotycząca interfejsu IProductConstants. Domyślnie podczas uruchamiania nie są wyświetlane informacje o postępie. Aby włączyć informowanie o postępie podczas uruchamiania, nadaj właściwości IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP wartość true (na przykład w pliku konfiguracyjnym preferencji).