PolanieOnLine na Eclipse: Różnice pomiędzy wersjami

Aktualna wersja na dzień 20:06, 4 lip 2021

W tym przewodniku opisano, jak skonfigurować środowisko programistyczne w Eclipse dla PolanieOnLine.

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

1. Otwórz games.stendhal.client.update.Starter.java w edytorze (wykorzystaj edytor w Eclipse)
2. Potem znowu mała czarna strzałka po prawej stronie zielonego robaka.
3. Wybierz "Debug Configurations" (lub "Run Configurations...").
4. Wybierz Java Application oraz kliknij przycisk "New" w lewym górnym rogu.
5. 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:

1. Kliknij strzałkę obok zielonego przycisku "Run" lub "Debug".
2. Wybierz "Run/Debug Configurations...".
3. Wybierz "JUnit" w lewej kolumnie i naciśnij "New launch configuration" u góry lewej kolumny.
4. Nadaj mu unikalną nazwę, na przykład "PolanieOnLine Tests".
5. Wybierz "Run all tests in the selected project, package or source folder".
6. OPCJONALNIE: (ten krok po prostu zmniejsza liczbę katalogów, w których Eclipse będzie wyszukiwać testy)
   1. Kliknij "Search".
   2. Wybierz folder "tests" w katalogu głównym PolanieOnLine i naciśnij "OK".
7. W sekcji "Test runner" wybierz "JUnit 4".
8. 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.
9. Wybierz "Add Folders" i naciśnij "OK".
10. Wybierz folder główny PolanieOnLine i naciśnij "OK".
11. Teraz kliknij "Add JARs..." w prawym panelu.
12. W folderze głównym PolanieOnLine wybierz wszystkie pliki .jar w libs i naciśnij OK.
13. 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).