en de es
Diese Website verwendet Cookies, um die Spracheinstellungen zu speichern und das Nutzungserlebnis zu verbessern. Wenn Sie damit einverstanden sind, ignorieren Sie diesen Hinweis. Falls nicht, lernen Sie hier mehr über Cookies und wie sie diese deaktivieren können.

JD ist Open Source

Dies bedeutet, dass jeder der gerne etwas am Programm ändern möchte, es auch kann. So wie jeder sein eigenes zu Hause modifizieren und anpassen oder anpassen lassen kann wie er möchte. So ist es u.a. möglich, dass falls JDownloader auf deiner Lieblingsseite nicht funktionieren sollte, du selbst eine Erweiterung dafür schreiben kannst, welche dann von Millionen von Nutzern benutzt werden kann!

Schnelleinstieg Übersetze JD DLC Container API Developer Chatroom

So wirst du zum JD Developer!

Der Großteil unseres Teams nutzt die kostenlose Java Entwicklungsumgebung Eclipse um JDownloader zu verbessern. Der Quellcode ist auf einem Subversion-Server gespeichert. Um den aktuellen Quellcode herunterzuladen und deine Änderungen zu speichern, brauchst du also einen Subversion-Client. Wir bevorzugen hierfür eine in die Entwicklungsumgebung integrierte Lösung, und benutzen deshalb das Eclipse Addon 'Subversive'. Wie du dieses installierst und benutzt erklären wir später in diesem Tutorial. Außerdem empfehlen wir eine aktuelle Version des Oracle Java JDKs zu installieren. Dies findest du auf Oracle's website.

Installiere alle benötigten Komponenten

Downloade und installiere diese Tools in der angegebenen Reihenfolge

Java JDK Eclipse IDE for Java Developers

Eclipse richtig einstellen

Starte Eclipse. Eclipse fordert dich dazu auf einen 'Workspace' zu erstellen. Dies ist der Ordner in dem Eclipse all deinen Code sowie deine Projekteinstellungen speichern wird.

Select Workspace

Füge das installierte Java JDK hinzu, indem du in der Menüleiste auf [Fenster] -> [Einstellungen] klickst.

Window -> Preferences

Navigiere zu [Java] -> [Installierte JRE]
Falls das JDK nicht gelistet ist, klicke [Hinzufügen], fahre mit der Standard VM fort [Weiter] und klicke auf [Directory] um dein JDK Installationsverzeich auszuwählen. Dies ist normalerweise etwas wie C:\Programme\Java\jdk1.8.0_45 (für Windows). Die aktuelle Version ist i.d.R. höher.

Add JDK

Stelle sicher, dass das JDK als Standard gesetzt ist und klicke auf [Finish]:

Add JDK 2

Schließe den Dialog mit [OK]

Installiere Subclipse

Es gibt zwei einfache Wege Subclipse zu installieren. Klicke im Menü entweder auf [Hilfe]‚->[Eclipse Marktplatz], suche dort nach "Subclipse" und installiere die aktuellste Version (aktuell 1.10), oder klicke im Hauptmenü auf [Hilfe]‚->[Neue Software installieren] und folge den Schritten in dieser Anleitung.

Help -> Eclipse Marketplace...

Install Subversive

Einrichtung der Projekte

Klicke im Menü auf ‚->[File]‚->[New]‚->[Project] (NICHT auf Java-Project)

File -> New -> Project

Wähle [Checkout Project from SVN] und klicke auf [Next]. Wähle dann im nächsten Bildschirm ‚ÄúCreate new respository location‚Äù.

New Project Wizard

Trage nun die erste Projekt SVN-URL ein:

Choose Connector

Wähle das Root-Verzeichnis und klicke auf [Next]

Choose Install Items

Checke nun das Projekt als neues Projekt im Workspace aus:

Select Head Revision

Klicke [Finish] und stimme allen folgenden Dialogen mit [Yes] bzw. [OK] zu. Eclipse lädt dann das Projekt herunter und richtet es im Workspace ein. Schließe den Willkommensbildschirm um das erste Projekt zu sehen.

Check out AppWorkUtils

Hinweis:
Beim hinzufügen des SVN Repositorys solltest du einen Fortschrittsbalken in der rechten unteren Leiste von Eclipse sehen. Sollte zu diesem Zeitpunkt ein Fehler auftreten, die Ordnerstruktur des SVN Containers nicht angezeigt werden oder bei 0% hängen bleiben, liegt dies höchstwahrscheinlich daran, dass deine Firewall nicht richtig eingestellt ist.

Wiederhole diese Schritte mit:

Use default workspace location

Repeat these steps with:

  • svn://svn.jdownloader.org/jdownloader/browser
  • svn://svn.jdownloader.org/jdownloader/trunk
  • svn://svn.jdownloader.org/jdownloader/MyJDownloaderClient

In case the following window pops up, asking you if you wish to normalize URL by cutting its last segment off, just click NO.

Eclipse Overview 2

Normal Run

Run As -> Run Configurations

  • Im Package Explorer Tab von Eclipse musst du den src Ordner aufklappen, und danach den jd Ordner
  • In /src/jd/ findest du die Datei: Main.java Klicke mit der rechten Maustaste darauf, wähle Run As aus und öffne die Run Configuration.
  • Das Run Configuration Fenster öffnet sich
  • Wähle das "Arguments tab" aus, und trage unter dem Punkt "arguments" den JVM Parameter -Xmx512m ein. [Wenn du dies nicht tust, bekommst du i.d.R. einen memory error beim ausführen]
  • Füge -debug -n bei Program Arguments hinzu. Dies führt bei jedem Start eine neue Instanz aus (-n), und aktiviert erweiterte debug logs (-debug)

Run Configurations

  • Klicke auf Apply, und dann auf Run. Nach dem ersten Start wird JD sich auf die neueste Version aktualisieren.
  • Jetzt kannst du die aktuellste Betaversion von JDownloader testen und dich mit dem Code vertraut machen. Wenn du so weit bist um Änderungen am Code vorzunehmen oder Fragen hast, komme in unseren IRC channel und frage Jiaz, Coalado oder lx1 nach Zugangsdaten.

Appwork Code Formater einstellen

Damit Code Layouts bei allen Entwicklern, unabhängig von deren IDE gleich bleiben, bevorzugen wir, wenn alle Commits entsprechend unseres Code Formates gemacht werden.

Window → Preferences → Java → Code Style → Formatter → Import...

Import Dialog 1

Import Dialog 2

Wie kann ich meine Änderungen hochladen (committen/schreiben)?

Um auf den Codeserver hochladen zu können, benötigst du Schreibrechte. Theoretisch kann jeder Schreibrechte bekommen, man muss sich allerdings an gewisse Regeln halten:

  • Don't be evil
  • JDownloader unterliegt aktuell der GPL, aber wird bald zu einer anderen OpenSource/Commercial Duallicense wechseln.
Um Schreibzugriff zu erhalten, schreibe also bitte noch ein Ticket mit dem folgenden Inhalt per Mail:
  • Username (Dein Code wird unter diesem Namen veröffentlicht)
  • Erlaubniss, um deine Commits unter einer anderen Lizenz zu veröffentlichen. Bspw.:

Herby I allow AppWork GmbH, Schwabacherstr. 117, 90763 Fürth, to re-license my (as user '<YOUR USERNAME>') commits to the JDownloader Code Server (svn.jdownloader.org). Re-licensing, in this case, means modifying and distributing my changes under a new license.