Import wtyczki

Środowisko PDE udostępnia kreator Import wtyczek służący do importowania wtyczek z systemu plików do obszaru roboczego. Jest on dostępny w menu najwyższego poziomu Plik > Import... > Programowanie wtyczek > Wtyczki.

Import wtyczek

 

Położenie importu

Domyślnie położeniem, z którego wtyczki są importowane, jest platforma docelowa określona na stronie preferencji Okna > Preferencje... > Programowanie wtyczek > Platforma docelowa.

Przycisk Platforma docelowa... jest skrótem otwierającym stronę preferencji Platforma docelowa w celu skontrolowania lub modyfikacji.

Aby wybrać importowanie wtyczek z dowolnego miejsca w systemie plików i nie zmieniać położenia platformy docelowej w preferencjach, należy usunąć zaznaczenie pola wyboru Platforma docelowa (zgodnie z preferencjami). Następnie za pomocą przycisku Przeglądaj... należy określić wybrany katalog.

 

Załączniki JAR z kodem źródłowym

Podczas importowania wtyczki środowisko PDE wyszukuje jej kod źródłowy, aby go przyłączyć do binarnego pliku JAR albo rozpakować - w zależności od rodzaju importu. W idealnej sytuacji kod źródłowy jest częścią samej wtyczki. Jeśli kod źródłowy jest spakowany w oddzielnych wtyczkach źródłowych, jak opisano szczegółowo na stronie Położenia kodu źródłowego, to środowisko PDE wyszukuje w tych miejscach kod źródłowy wtyczki do zaimportowania.

Przycisk Położenia kodu źródłowego... otwiera stronę preferencji Platforma docelowa, która umożliwia skontrolowanie lub uzupełnienie bieżącej listy położeń kodu źródłowego.

 

Zmienne ścieżek

Dozwolone jest użycie zmiennych środowiskowych w ścieżkach bibliotek dla ścieżki klasy (np. $ws$/swt.jar). Zmienne te są interpretowane przez środowisko PDE w sposób określony na karcie Środowisko strony preferencji Okna > Preferencje... > Programowanie wtyczek > Platforma docelowa.

Przycisk Zmienne środowiskowe... jest skrótem otwierającym stronę preferencji Zmienne środowiskowe... w celu skontrolowania lub modyfikacji.

 

Wtyczki i fragmenty do zaimportowania

Opcja Wybierz ze wszystkich wtyczek i fragmentów znalezionych w danym położeniu powoduje przejście do drugiej strony kreatora, która umożliwia przeglądanie wszystkich wtyczek i wybranie ich podzbioru do zaimportowania.

Import ze wszystkich

 

Opcja Importuj wtyczki i fragmenty wymagane przez wtyczki istniejące w obszarze roboczym jest przydatna podczas importowania wszystkich wstępnie wymaganych elementów dla wtyczki, która nie jest częścią platformy docelowej. Opcja ta powoduje przejście do drugiej strony kreatora, która jest prostsza, ale zapewnia mniejszą kontrolę nad importowanymi elementami.

Import dla istniejących

 

Format importu

Podczas importowania wtyczek dla każdej z nich tworzony jest projekt w obszarze roboczym. Ma on tę samą nazwę co identyfikator importowanej wtyczki.

Treść każdego projektu jest różna w zależności od formatu importu:

  1. Projekty binarne: treść wtyczki jest kopiowana do projektu. Kod binarny pozostaje nienaruszony w pliku JAR; natomiast pliki manifestu i inne zasoby są wyodrębniane z katalogu głównego projektu. Zaletą projektów binarnych jest to, że umożliwiają przeglądanie kodu bez konieczności kompilowania kodu źródłowego.
  2. Projekty binarne z dołączoną treścią: treść wtyczki nie jest kopiowana do projektu. Zamiast tego w projekcie tworzone są dowiązania w celu odwzorowania rzeczywistego fizycznego położenia plików JAR oraz innych plików i folderów na dysku. Zaletą tego typu importu w porównaniu ze zwykłym importem binarnym jest jego szybkość, ponieważ operacja polega tylko na tworzeniu dowiązań. Wadą tej metody jest to, że w przypadku zmiany ścieżki bezwzględnej do dowiązanych plików w systemie plików, tego typu projekty binarne mogą utracić synchronizację i wymagać ponownego zaimportowania.
  3. Projekty z folderami źródłowymi: kod źródłowy importowanych wtyczek jest wyodrębniany i umieszczany w folderach źródłowych. Zaletą tego typu importu jest możliwość modyfikacji zaimportowanego kodu źródłowego. Wadą jest to, że kod jest kompilowany, co powoduje narzut o wielkości proporcjonalnej do liczby i wielkości importowanych wtyczek.