Kontrolowanie formatu wyjściowego procesu budowania
W sekcji przedstawiono możliwości kontroli formatu wyjściowego procesu budowania funkcji lub produktu.
Kontrolowanie formatu wyjściowego
Właściwość archivesFormat umożliwia określenie formatu wyjściowego procesu
budowania (zip, tar lub folder) jako parametru konfiguracji. Format właściwości to
<konfiguracja> - <format>, gdzie wartość segmentu konfiguracji jest taka sama, jak
wartość określona we właściwości configs, a segment formatu przyjmuje jedną z
następujących wartości:
- folder - wynik procesu budowania zostanie zapisany w folderze w położeniu ${buildDirectory}/tmp/${archivePrefix}. Położenia docelowe zdefiniowane w pliku allElements.xml nie są w tym przypadku używane.
Ze względu na ograniczenia obecnej wersji, w przypadku formatu wyjściowego folder można budować tylko jedną konfigurację naraz.
- zip - wynik procesu budowania zostanie zapisany w pliku ZIP. Plik ZIP zostanie utworzony za pomocą programu zip.exe znalezionego na komputerze, na którym uruchomiony jest proces budowania. Możliwość ta przydaje się w przypadku pracy z wtyczkami niespakowanymi w archiwa JAR i zawierającymi pliki wymagające określonych uprawnień (dotyczy to przede wszystkich systemów uniksowych).
Właściwość zipargs umożliwia przekazywanie opcji do komendy zip.
- antZip - wynik procesu budowania zostanie zapisany w pliku ZIP. Plik zip zostanie
utworzony przez implementację kompresji zip zastosowaną w narzędziu Ant. Jest to wartość domyślna, używana w przypadku braku jawnie podanych opcji.
- tar - wynik procesu budowania zostanie zapisany w archiwum TAR spakowanym w formacie GZIP.
Użyte zostaną implementacje narzędzi tar i gzip dostarczone przez system operacyjny. Właściwość tarargs umożliwia przekazywanie opcji do komendy tar.
Należy pamiętać, że zmiana formatu wyjściowego nie spowoduje zmiany nazwy tworzonego pliku. Zmianę tę należy wprowadzić w pliku allElements.xml.
Generowanie manifestów JNLP
Aby włączyć generowanie manifestów JNLP podczas budowania, należy
ustawić właściwość generateJnlp na wartość true, właściwość
jnlp.codebase na wartość określającą, skąd plik JNLP będzie dostarczany (patrz atrybut
codebase znacznika jnlp), i właściwość jnlp.j2se.
Należy pamiętać, że nie powoduje to
spakowania wtyczek i funkcji do postaci odpowiedniej dla serwisu aktualizacji. Więcej informacji
przedstawiono w poniższym temacie Przygotowywanie danych wyjściowych dla serwisu aktualizacji lub serwisu
JNLP.
Ze względu na ograniczenia obecnej wersji, tworzenie manifestu JNLP jest możliwe wyłącznie w przypadku generowania wyników w postaci folderów.
Przygotowywanie wyników dla serwisu aktualizacji lub serwisu JNLP
Umieszczenie wtyczek i funkcji w serwisie aktualizacji lub serwisie Java Web Start wymaga ich odpowiedniego spakowania. W tym celu należy ustawić wartość właściwości outputUpdateJars na true. Należy pamiętać, że nie spowoduje to wygenerowania pliku site.xml dla serwisu aktualizacji Eclipse ani plików JNLP (patrz temat Generowanie plików JNLP).
Grupowanie wielu konfiguracji w jednym archiwum
Aby generować wyniki zawierające wtyczki i funkcje z wielu konfiguracji, ustaw wartość właściwości groupConfigurations na true.
Spowoduje to utworzenie archiwum zawierającego wszystkie wtyczki i funkcje odpowiadające konfiguracjom wymienionym w obrębie właściwości configs.
Korzystając z tej możliwości należy pamiętać o dodaniu położenia docelowego o nazwie <funkcja.id>.group.group.group w pliku allElements.xml.
Ze względu na ograniczenia obecnej wersji, skorzystanie z tej opcji spowoduje zignorowanie wartości podanej we właściwości archivesFormat i używanie formatu antZip jako domyślnego.
Podpisywanie plików JAR
Aby pliki JAR generowane w procesie budowania były podpisywane, ustaw wartość właściwości signJars na true i podaj odpowiednie wartości właściwości sign.alias, sign.keystore i sign.storepass.