PolanieOnLine na Eclipse
- |
W tym przewodniku opisano, jak skonfigurować środowisko programistyczne w Eclipse dla PolanieOnLine.
Spis treści
Pobierz Javę
- Jeśli możesz grać w PolanieOnLine, masz już Javę to możesz pominąć ten krok.
- Jeśli nie masz zainstalowanej javy, pobierz ją https://java.com
(jeśli korzystasz z Linuksa, użyj swojego menedżera pakietów)
Uwaga: Dla wszelkich początkujących programistów, zaczynających dopiero zabawę z otwartym źródłem PolanieOnLine w Eclipse zalecamy zainstalować Java Development Kit 8 (JDK 8) do poprawnego działania wszelkich funkcji
Pobierz Eclipse
- Przejdź na https://www.eclipse.org/downloads/
- Pobierz: "Eclipse IDE for Java Developers"
- Rozpakuj pobrany plik i uruchom Eclipse
- W Eclipse zamknij okno Welcome
Możesz kliknąć poniższe obrazy, aby zobaczyć je w powiększeniu.
Podczas pierwszego uruchomienia Eclipse wyświetlane jest to okno Welcome Zamknij to.
Typowy układ okna z Eksploratorem pakietów po lewej stronie i pustym obszarem dla edytorów pośrodku
Uwaga:
- Jeśli zainstalowałeś Eclipse w Ubuntu za pomocą menedżera pakietów, zainstaluj także: "eclipse-egit"
- Do poprawnego działa wymagana jest instalacja Eclipse w wersji 4.16.0
Nowy projekt z Git
- Otwórz menu "File -> Import"
- W oknie dialogowym wybierz: "Git -> Projects from Git" i kliknij "Next".
- Wybierz "Clone URI" i kliknij "Next".
- Podaj następujące informacje:
URI:https://github.com/PolanieOnLine/PolanieOnLine.git
(jeśli masz konto github, przejdź do https://github.com/PolanieOnLine/PolanieOnLine i kliknij na "Fork", aby utworzyć własną kopię repozytorium, a następnie użyć jej w Eclipse) - Wynik pól wypełnia się automatycznie, kliknij "Next"
- Na stronie wyboru oddziału pozostaw wszystko zaznaczone i kliknij "Next"
- W sekcji "Destination" wybierz katalog, w którym chcesz pobrać kod źródłowy i wybierz "Next".
- Eclipse pobierze teraz PolanieOnLine z git, może to chwilę potrwać
- "Import existing projects" i wybierz "Next"
- Import projektu PolanieOnLine zakończ przyciskiem "Finish"
Kliknij zrzuty ekranu, aby je powiększyć, jeśli potrzebujesz pomocy w którymkolwiek z kroków:
Otwórz File -> Import
Import z Git
Sklonuj URI
Wypełnij URI i obserwuj, jak pozostałe pola wypełniają się automatycznie
Po prostu kliknij "next" przy wyborze oddziału
Po prostu kliknij "next" w miejscu docelowym
Poczekaj na zakończenie pobierania. Może to trochę potrwać
Importuj istniejący projekt
Potwierdź import projektu "PolanieOnLine" klikając "finish"
Rozwiązywanie problemów
Po zakończeniu kreatora importu środowisko Eclipse powinno wyglądać jak na poniższym zrzucie ekranu:
W widoku eksploratora pakietów znajduje się projekt o nazwie "PolanieOnLine". Przed niebieską ikoną projektu może znajdować się mały żółty trójkąt. Ale jeśli zobaczysz czerwone kółko lub czerwony wykrzyknik, coś poszło nie tak. W takim przypadku pojawi się błąd w widoku "Problems" na dole.
Uruchomienie serwera
- Na pasku narzędzi znajduje się przycisk "Debug", który wygląda jak mały, zielony robak. Po prawej stronie znajduje się mała czarna strzałka.
- Spowoduje to otwarcie menu, wybierz "Debug configurations..." ("Open Debug Dialog..." w starszych wersjach)
- Następnie w oknie dialogowym wybierz "Java Application" i kliknij ikonę "new" w lewym górnym rogu.
Name: StendhalServer Main class: games.stendhal.server.StendhalServer
- Wszystkie inne ustawienia ("include system libries", "Stop in main", ... można pozostawić na ich wartości domyślnej.
- w zakładce [Arguments]: VM arguments: -Xmx128M
- w zakładce [Classpath]: kliknij "User Entries" - przycisk "Advanced" - (*) add folder | OK - oraz wybierz projekt "polanieonline" jako root folder | OK
- przycisk [Debug]
A potem serwer powinien zostać uruchomiony.
UWAGA: W nowszych wersjach środowiska Eclipse [Classpath Entries (wpisy ścieżki klas)] znajdują się w karcie Dependencies (Zależności).
Uruchomienie Klienta PolanieOnLine
- Otwórz games.stendhal.client.update.Starter.java w edytorze (wykorzystaj edytor w Eclipse)
- Potem znowu mała czarna strzałka po prawej stronie zielonego robaka.
- Wybierz "Debug Configurations" (lub "Run Configurations...").
- Wybierz Java Application oraz kliknij przycisk "New" w lewym górnym rogu.
- W zakładce [Classpath] wybierz "User Entries" - przycisk "Advanced" - (*) add folder | OK - oraz wybierz projekt jako root folder. | OK
Robienie łatek
Jeśli zmodyfikowałeś i przetestowałeś kod i chcesz wysłać nam łatkę, zobacz Jak stworzyć łatkę dla PolanieOnLine.
Uruchamianie testów JUnit w Eclipse
To jest zaawansowany temat. Jeśli wprowadzisz zmiany w kodzie Java, dobrym pomysłem jest uruchomienie testu automatycznego.
Konfigurowanie testów JUnit w Eclipse:
- Kliknij strzałkę obok zielonego przycisku "Run" lub "Debug".
- Wybierz "Run/Debug Configurations...".
- Wybierz "JUnit" w lewej kolumnie i naciśnij "New launch configuration" u góry lewej kolumny.
- Nadaj mu unikalną nazwę, na przykład "PolanieOnLine Tests".
- Wybierz "Run all tests in the selected project, package or source folder".
- OPCJONALNIE: (ten krok po prostu zmniejsza liczbę katalogów, w których Eclipse będzie wyszukiwać testy)
- Kliknij "Search".
- Wybierz folder "tests" w katalogu głównym PolanieOnLine i naciśnij "OK".
- W sekcji "Test runner" wybierz "JUnit 4".
- W zakładce "Classpath" wybierz "User Entries" i naciśnij "Advanced" w prawym panelu.
- UWAGA: W sekcji "User Entries" powinien już znajdować się folder z sufiksem "(default classpath)". Nie usuwaj tego folderu.
- Wybierz "Add Folders" i naciśnij "OK".
- Wybierz folder główny PolanieOnLine i naciśnij "OK".
- Teraz kliknij "Add JARs..." w prawym panelu.
- W folderze głównym PolanieOnLine wybierz wszystkie pliki .jar w libs i naciśnij OK.
- Teraz naciśnij "Apply", aby zapisać konfigurację lub "Run", aby ją zapisać i uruchomić.
UWAGA: W nowszych wersjach środowiska Eclipse [Classpath Entries (wpisy ścieżki klas)] znajdują się w karcie Dependencies (Zależności).
