# Podręcznik szybkiego startu

Ten kurs umożliwia zapoznanie się ze środowiskiem roboczym, przedstawiając krótki przegląd kroków, które należy wykonać, aby utworzyć proste aplikacje. Bardziej szczegółowe wyjaśnienia zawierające obrazki można znaleźć w Podręczniku użytkownika środowiska roboczego.

Środowisko robocze: Szybki start

Czynność | Opis

Tworzenie prostego projektu

1. Wybierz opcję Plik > Nowy > Projekt.
2. W oknie kreatora Nowy projekt wybierz opcję Prosty > Projekt i kliknij przycisk Dalej.
3. W polu Nazwa projektu wpisz nazwę nowego projektu.

4. Określ położenie projektu lub użyj położenia domyślnego.

5. Kliknij przycisk Zakończ.

Tworzenie folderu

1. Upewnij się, że istnieje co najmniej jeden projekt.
2. Wybierz opcję Plik > Nowy > Folder.
3. W polu Nazwa folderu kreatora nowego folderu wpisz nazwę nowego folderu.
4. Kliknij przycisk Zakończ.

Tworzenie pliku

1. Upewnij się, że istnieje co najmniej jeden projekt.
2. Wybierz opcję Plik > Nowy > Plik.
3. W polu Nazwa pliku kreatora nowego pliku wpisz nazwę nowego pliku.
4. Kliknij przycisk Zakończ.

Importowanie zasobów

1. Wybierz opcję Plik > Importuj.
2. Wybierz źródło importu.
3. Kliknij przycisk Dalej.
4. Wykonując kroki odpowiedniego kreatora, wybierz położenie importowania zawierające dany zasób.
5. Kliknij przycisk Zakończ.

Eksportowanie zasobów

1. Wybierz opcję Plik > Eksportuj.
2. Wybierz położenie docelowe eksportowania.
3. Kliknij przycisk Dalej.
4. Wykonując kroki odpowiedniego kreatora, wybierz docelowe położenie eksportowania.
5. Kliknij przycisk Zakończ.

Tworzenie projektu Java: Przykład środowiska JUnit

1. Aby pobrać kod źródłowy środowiska JUnit, przejdź pod adres http://www.eclipse.org/downloads/ i wyszukaj posiadaną wersję środowiska Eclipse.
2. Przewiń do sekcji Example Plug-ins (Przykładowe moduły dodatkowe) i pobierz archiwum przykładów.
3. Wyodrębnij treść pliku ZIP do katalogu.
4. Wróć do środowiska Eclipse i wybierz opcję Plik > Nowy > Projekt.
5. Wybierz opcję Projekt Java, a następnie kliknij przycisk Dalej.
6. W polu Nazwa projektu wpisz JUnit.
7. Kliknij przycisk Zakończ.
8. Upewnij się, że w Eksploratorze pakietów wybrany został projekt JUnit.
9. Wybierz z menu opcję Plik > Importuj.
10. Wybierz opcję Plik zip, a następnie kliknij przycisk Dalej.
11. Kliknij przycisk Przeglądaj obok pola pliku ZIP i wyszukaj plik <ścieżka_do_pobranych_przykładów>eclipse/plugins/org.eclipse.jdt.ui.examples.projects_3.0.0/archive/junit/junit381src.jar.

12. W kreatorze importu kliknij opcję Wybierz wszystko znajdującą się poniżej listy hierarchii.

13. Gdy projekt JUnit jest już wyświetlany w polu folderu docelowego Folder, kliknij przycisk Zakończ.

14. Śledząc wskaźnik postępu importu, zwróć uwagę na fakt, że importowane zasoby są kompilowane w miarę ich importowania do środowiska roboczego. Jest to spowodowane tym, że na stronie preferencji środowiska roboczego zaznaczono opcję Buduj automatycznie. Zostanie wyświetlone pytanie o nadpisanie plików .classpath i .project w projekcie JUnit. Jest to spowodowane tym, że podczas tworzenia projektu JUnit został utworzony zasób .classpath. Można bez obaw nadpisać te pliki.
    W widoku Eksplorator pakietów rozwiń projekt JUnit, aby wyświetlić pakiety JUnit.

Tworzenie klasy Java: Przykład środowiska JUnit

1. W widoku Eksplorator pakietów kliknij prawym przyciskiem myszy projekt JUnit i wybierz opcję Nowy > Pakiet.
2. W poluNazwa wpisztest jako nazwę nowego pakietu.
3. Kliknij przycisk Zakończ.
4. W widoku Eksplorator pakietów wybierz nowy pakiet testów i kliknij opcję Nowa klasa Java na pasku narzędzi. Upewnij się, że w polu Folder źródłowy znajduje się nazwa JUnit, a w polu Pakiet - nazwa test.
5. W polu Nazwa wpisz MyTestCase.
6. Kliknij przycisk Przeglądaj znajdujący się obok pola Nadklasa.
7. W poluWybierz typ w oknie dialogowym Wybór nadklasy wpiszTest, aby zawęzić listę dostępnych nadklas.
8. Wybierz klasęTestCase i kliknij przyciskOK.
9. Zaznacz pole wyboruKonstruktory z nadklasy.
10. Kliknij przycisk Zakończ.
11. Nowy plik zostanie otwarty w edytorze. W widoku Schemat wybierz nową klasęMyTestCase.Otwórz menu kontekstowe i wybierz opcjęŹródło > Przesłoń/implementuj metody.
12. W oknie dialogowym Przesłanianie metod zaznacz metody setUp() i tearDown(), a następnie kliknij przycisk OK.
13. Zmień treść metody setUp() na container= new Vector();.
14. Elementy container i Vector zostaną wyróżnione za pomocą linii podświetlenia problemu, ponieważ nie można ich rozpoznać.Na pasku znaczników zostanie wyświetlona ikona żarówki. Ustaw kursor wewnątrz elementu Vector i naciśnij kombinację klawiszy Ctrl+1 (albo wybierz z paska menu opcję Edycja > Szybka poprawka). Wybierz opcję Importuj Vector (java.util). Spowoduje to dodanie brakującej deklaracji importu.
15. Ustaw kursor w obrębie elementu container i naciśnij kombinację klawiszy Ctrl+1. Wybierz opcję Utwórz pole container, aby dodać nowe pole.
16. W widoku Schemat wybierz klasę MyTestCase.Otwórz menu kontekstowe i wybierz opcję Źródło > Generuj metody pobierające i ustawiające.
17. W oknie Generowanie metod pobierających i ustawiających zostanie wyświetlona zachęta do utworzenia metod getContainer i setContainer. Wybierz obie opcje i kliknij przycisk OK. Spowoduje to dodanie metod pobierających i ustawiających dla pola container.
18. Zapisz plik.
19. Formatowanie wygenerowanego kodu można skonfigurować w sekcji Okna > Preferencje > Java > Styl kodu > Formater kodu. Jeśli w nazwach pól mają być używane przedrostki lub przyrostki, można ustawić odpowiednią opcję w sekcji Okna > Preferencje > Java > Styl kodu > Pola, dzięki czemu podczas generowania metod pobierających i ustawiających będą sugerowane nazwy metod bez przedrostków lub przyrostków.

Uruchamianie programu Java: Przykład środowiska JUnit

1. W widoku Eksplorator pakietów znajdź pakiet junit.textui.TestRunner.java i kliknij go dwukrotnie, aby otworzyć go w edytorze.
2. Zauważ, że klasa TestRunner została oznaczona w widoku Schemat ikoną, która wskazuje na zdefiniowaną w tej klasie metodę main.
3. W Eksploratorze pakietów kliknij prawym przyciskiem myszy pakiet TestRunner.java i wybierz opcję Wykonaj > Aplikacja Java.
4. Wybierz opcję Wykonaj > Wykonaj. Zostanie otwarte okno dialogowe Konfiguracje startowe z wybraną konfiguracją startową TestRunner.
5. W oknie dialogowym Konfiguracje startowe wybierz kartę Argumenty i wpisz junit.samples.VectorTest w sekcji Argumenty programu.
6. Kliknij przycisk Wykonaj. Tym razem program zostanie uruchomiony poprawnie, wskazując liczbę przeprowadzonych testów.
7. Przełącz się do perspektywy Debugowanie. Zauważ, że w widoku Debugowanie przy ostatnim uruchomieniu programu został zarejestrowany proces.
8. Kliknij przycisk Wykonaj na pasku narzędzi środowiska roboczego. Ta lista zawiera uruchamiane wcześniej programy. Programy te można uruchomić ponownie, wybierając je z listy historii.
9. Z menu kontekstowego w widoku Debugowanie wybierz opcję Usuń wszystkie zakończone, aby usunąć z widoku zakończone procesy uruchamiania (można także użyć odpowiedniego przycisku na pasku narzędzi).

Tworzenie

modułu dodatkowego

1. Wybierz opcję Plik > Nowy > Projekt.
2. Wybierz opcję Projekt modułu dodatkowego i kliknij przycisk Dalej.
3. W polu Nazwa projektu wpisz nazwę projektu i kliknij przycisk Dalej.
4. Na stronie Treść modułu dodatkowego określ dane używane do inicjowania pliku plugin.xml, w tym identyfikator, wersję i nazwę modułu.
5. Wybierz dostępny szablon i kliknij przycisk Dalej.
6. Dostosuj przykładowe rozszerzenie i kliknij przycisk Zakończ.

Uruchamianie instancji wykonawczego środowiska roboczego Eclipse w celu przetestowania modułu dodatkowego

1. Wybierz opcję Wykonaj > Wykonaj.
2. W oknie dialogowym Konfiguracje startowe wpisz w polu Nazwa nazwę konfiguracji.
3. W polu Dane obszaru roboczego kliknij przycisk Przeglądaj, aby zdefiniować obszar roboczy, który będzie używany przez wykonawcze środowisko robocze. Położenie tego wykonawczego obszaru roboczego musi być inne niż położenie obszaru roboczego instancji macierzystej.
4. W polu Uruchom aplikację wybierz domyślną aplikację Eclipse org.eclipse.ui.ide.workbench.
5. Kliknij przycisk Wykonaj.

Spowoduje to wyświetlenie drugiej instancji środowiska roboczego, składającej się z modułów dodatkowych obszaru roboczego i modułów dodatkowych wybranych na stronie preferencji Platforma docelowa. Wykonawcze środowisko robocze można przetestować przy użyciu dowolnego środowiska JRE, które nie musi być takie samo, jak środowisko, w odniesieniu do którego moduły dodatkowe były kompilowane w obszarze roboczym. Można także określić dowolne argumenty maszyny wirtualnej odpowiednie do celów testowania.

Budowanie automatyczne

1. Wybierz opcję Okna > Preferencje.
2. Na lewym panelu wybierz kategorię Ogólne.
3. Wybierz opcję Buduj automatycznie.
4. Kliknij przycisk OK.

Budowanie ręczne

1. W widoku nawigatora perspektywy Zasób wybierz jeden lub kilka projektów.
2. Kliknij prawym przyciskiem myszy i wybierz z menu podręcznego opcję Buduj projekt.

Repozytorium CVS: Szybki start

Uwaga: Do utworzenia prawidłowego położenia repozytorium w środowisku roboczym konieczny jest skonfigurowany serwer CVS działający na komputerze hosta.

Czynność | Opis

Tworzenie położenia repozytorium CVS

1. Wybierz opcję Okna > Pokaż widok > Inne.
2. Wybierz opcję System CVS > Repozytoria CVS.
3. Kliknij przycisk Dodaj repozytorium CVS.
4. Wprowadź informacje wymagane do określenia położenia repozytorium i nawiązania z nim połączenia.
5. Kliknij przycisk Zakończ.

Łączenie się z systemem CVS i konfigurowanie go za pomocą protokołu SSH

1. Wybierz opcję Okna > Preferencje.
2. Wybierz opcję Zespół > System CVS > Metoda łączenia SSH2.
3. Wybierz kartę Ogólne, kliknij przycisk Dodaj klucz prywatny i dodaj klucz prywatny do listy.
4. Podaj hasło do klucza prywatnego i zapisz go w komputerze.

W przypadku braku pary klucza:

1. Wybierz opcję Okna > Preferencje.
2. Wybierz opcję Zespół > System CVS > Metoda łączenia SSH2.
3. Wybierz kartę Zarządzanie kluczami.
4. Jeśli serwer obsługuje pierwszą wersję protokołu, wybierz opcję Generuj klucz RSA, natomiast dla wersji drugiej wybierz opcję Generuj klucz DSA. Zostaną wygenerowane klucze prywatny i publiczny. Klucz publiczny zostanie wyświetlony w obszarze tekstowym tylko do odczytu.
5. Skopiuj klucz publiczny na serwer. Jeśli na serwerze uruchomiony jest serwer OpenSSH, kliknij przycisk Eksportuj za pośrednictwem protokołu sftp. W przeciwnym razie skopiuj i wklej klucz publiczny do zdalnego pliku ~/.ssh/authorized_keys.

Pobieranie projektu z repozytorium CVS

1. Przełącz się do perspektywy Eksplorowanie repozytorium CVS.
2. W widoku Repozytoria CVS rozwiń położenie repozytorium.
3. Rozwiń pozycję HEAD i wybierz foldery, które mają zostać dodane do środowiska roboczego jako projekty.
4. Z menu wybranych folderów wybierz jedną z poniższych opcji:
   - Pobierz - spowoduje pobranie do lokalnego obszaru roboczego wszystkich zaznaczonych folderów jako projektów z nazwą odpowiadającą nazwie folderu w repozytorium.
   - Pobierz jako - spowoduje pobranie zaznaczonych folderów do niestandardowego projektu w lokalnym obszarze roboczym.

Synchronizowanie z repozytorium oraz aktualizowanie bądź zatwierdzanie zmian

1. W widoku nawigatora wybierz zasoby do zsynchronizowania.
2. Kliknij prawym przyciskiem myszy i wybierz kolejno opcje Zespół > Synchronizuj z repozytorium.
3. W widoku Synchronizacja kliknij zasób prawym przyciskiem myszy i wybierz jedną z poniższych opcji:
   - Zatwierdź, aby zastąpić istniejącą w repozytorium CVS wersję zasobu i zapisać w nim własną wersję.
   - Aktualizuj, aby zaktualizować obszar roboczy wersją zapisaną w repozytorium.