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 pozwala określić format wyjściowy procesu budowania (zip, tar lub folder) jako parametr 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 za pomocą algorytmu pakującego dostarczonego przez środowisko 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 w czasie budowania, ustaw właściwość generateJnlp na true, ustaw właściwość jnlp.codebase na położenie, z którego będzie udostępniany plik JNLP (patrz atrybut codebase znacznika jnlp) i ustaw odpowiednią wartość znacznika jnlp.j2se.
Należy pamiętać, że nie powoduje to spakowania wtyczek i funkcji do postaci odpowiedniej dla serwisu aktualizacji - więcej informacji przedstawiona w temacie "Przygotowywanie wyników 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 procesie budowania
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.