Anleitung Netbeans. Diese Anleitung basiert auf der Netbeans Version 7.2 und dem Paket All, welche alle Umgebungen beinhaltet.

Transkript

1 Anleitung Netbeans Diese Anleitung basiert auf der Netbeans Version 7.2 und dem Paket All, welche alle Umgebungen beinhaltet. Inhaltsverzeichnis 1. Installation und Konfiguration Windows Linux Gesamtaufbau der IDE Projectbrowser Code-Fenster Navigator Output Fenster Implementierung Projekt anlegen Neue Klasse hinzufügen Getter/Setter Erzeugung für Klassenattribute Refactoring Codevervollständigung Includeauswahl Automatische Formatierung Test und Debugging Unit Tests Breakpoints und Debug Sonstiges Einbindung externer Bibliotheken Installation CPPUnit SVN Tastenkürzel Installation und Konfiguration Der Download der aktuellen Version ist unter möglich. Um eine spezielle Version auszuwählen muss oben rechts die Version ausgewählt werden. Hier kann auch die Sprache oder die Plattform gewählt werden. Je nach Anwendungszweck und geforderten Programmiersprache muss die entsprechende Version gewählt werden. Anleitung Netbeans 1 Version:

2 1.1. Windows Die Installation läuft wie gewohnt und normalerweise ohne Probleme mithilfe des Installers. Vor der Installation von Netbeans sollte erst die Unix-Umgebung installiert werden, da Netbeans danach die benötigten Einstellungen automatisch erkennen kann. Also Unix-Umgebung verwenden wir Cygwin. Nach dem Download der Software unter kann der Installer gestartet werden. Der Installer ist dabei nur ein Tool, welches die gewünschten Pakete aus dem Internet lädt. Daher sollte die Option Install from Internet gewählt werden. Das Root Verzeichnis befindet sich meist in C:\cygwin. Sollte ein Proxy in Ihrem Netz verwendet werden, müssen im Dialog Select Connection Type die richtigen Einstellungen gewählt werden. Im Netz der Hochschule wird kein Proxy verwendet und es können die Standardeinstellungen verwendet werden. Als nächstes muss ein Software Repository gewählt werden. Wählen Sie hier ein beliebiges aus, am besten eins aus Ihrer nähe. Im Dialog Select Packages müssen nun folgende Pakete ausgewählt werden: gcc-core: C Compiler gcc-g++: C++ Compiler gdb: GNU Debugger cppunit: Unit Test Umgebung make: GNU Version der 'make' utilitys Diese können am besten über das Suchfeld gefunden werden, oder im Baum Devel per Hand gesucht werden. Nach dem Download und der Installation von Cygwin müssen nun die Umgebungsvariablen des Systems angepasst werden. Dies geht in den Systemsteuerungen unter System und Sicherheit > System > Erweiterte Systemeinstellungen > Umgebungsvariablen. Dort muss im unteren Feld der Eintrag Path bearbeitet werden. Hier muss der Cygwin-Pfad zu dessen bin Verzeichnis hinzugefügt werden. In einer Standardinstallation muss also ;C:\cygwin\bin\ hinzugefügt werden. Netbeans sollte nun automatisch die richtigen Einstellungen finden Linux Neben dem oben genannten Download und der Installation mit Hilfe des Installers gibt es in vielen Distributionen auch das Netbeans Softwarepaket im Paketmanager. Diese sollte im Normalfall auch die Abhängigkeiten mit installieren und die Software komplett einrichten. Bitte schauen Sie zur Verwendung des Paketmanagers in die Dokumentation des Distributionsherstellers. Hierbei muss allerdings auf die Version von Netbeans geachtet werden. Beispiel (K)Ubuntu/Debian: sudo apt-get install netbeans Anleitung Netbeans 2 Version:

3 2. Gesamtaufbau der IDE Im folgenden werden die wichtigsten Teile der Entwicklungsumgebung vorgestellt Projectbrowser Im Projectbrowser(1) werden alle offenen Projekte angezeigt. Anhand des Symbols kann man den Projekttyp, bzw. die Programmiersprache erkennen. Ein Hauptprojekt muss dabei nicht ausgewählt werden. Netbeans kompiliert und startet immer das Projekt, welches zu der aktuelle geöffnete Datei gehört. Ein weiterer Reiter beinhaltet die Services. Hier werden die Verbindungen zu Servern, Datenbanken und anderen Services angezeigt und können bei Bedarf durchsucht werden. Bei den Web Services kann mit einem Rechtsklick die API Dokumentation angezeigt werden. Anleitung Netbeans 3 Version:

4 In anderen Knoten können beispielsweise neue Server und Dienste hinzugefügt werden oder bestehende gestoppt/gestartet werden Code-Fenster In diesem Fenster kann der Code bearbeitet werden. Hierzu stehen Funktionen für Codevervollständigung und Funktionen des Refactorings zur Verfügung die in späteren Kapiteln erläutert werden. Zur besseren Ansicht des Codes können einzelne Blöcke über das - am linken Rand ausgeblendet werden. Um eine schnelle Übersicht über die ersten Zeilen des ausgeblendeten Blocks zu erhalten muss die Maus einfach über die drei... gehalten werden. Dies kann helfen bereits fertig implementierte Funktionen auszublenden und lange Code-Dokumente übersichtlich zu halten. Am oberen Rand des Fensters gibt es einige Zusatzfunktionen. Es können Beispielsweise Codeblöcke auskommentiert werden oder zu den letzten Änderungen im Code gesprungen werden. Mit einem Rechtsklick auf verschiedene Elemente können weitere Funktionen ausgewählt werden Navigator Das Navigatorfenster bietet eine alphabetisch sortierte Ansicht der aktuell geöffneten Datei zur schnelleren Navigation Output Fenster Hier werden die Meldungen beim Kompilieren, die Ausgabe der Kommandozeilen Programme, Ergebnisse der Unit Tests und weitere Ausgaben angezeigt. 3. Implementierung 3.1. Projekt anlegen Neue Projekte können unter File > New Project angelegt werden. Dort muss unter Categories die entsprechende Programmiersprache gewählt werden. Meist verwenden wir hier C/C++ und im rechten Fenster wählen wir dazu C/C++ Application. Im nächsten Fenster müssen allgemeine Projektinformationen wie der Namen und der Speicherort gewählt werden. Dabei kann auch gewählt werden ob eine Main mit erzeugt werden soll und in welcher Sprache diese generiert werden soll. Dies sollte Standardmäßig gewählt werden. Das neue Projekt ist nun im Projectbrowser verfügbar. Anleitung Netbeans 4 Version:

5 3.2. Neue Klasse hinzufügen Netbeans bietet einen Assistenten für die Erzeugung neuer Klassen an. Hierzu kann entweder File>New File, das New File Symbol oder die Tastenkombination Strg+N gewählt werden. Achten Sie beim erzeugen darauf das oben das richtige Projekt ausgewählt ist. Zur Erzeugung einer Klasse wählen Sie C/C++ und C++ Class Getter/Setter Erzeugung für Klassenattribute Aus Klassenattributen können automatisch Getter und Setter erzeugt werden. Hierzu muss nach dem markieren des Attributes unter Refactor > encapsulate fields aufgerufen werden. Hier kann nun gewählt werden, welche Funktion implementiert werden sollen. Zur Änderung des Namens kann auch einfach in dem Feld der Text geändert werden Refactoring Neben der Automatischen Erstellung von Getter/Settern gibt es auch die Möglichkeit sowohl Variablen als auch Funktionen automatisch von Netbeans umbenennen oder in andere Klassen verschieben zu lassen. Dazu klicken Sie mit der rechten Maustaste auf das Objekt und schauen sich die Möglichkeiten unter Refactor an Codevervollständigung Mit Hilfe der Codevervollständigung werden Member eines Objektes angezeigt um die Auswahl zu vereinfachen. Hierbei wird auch die Dokumentation der Member angezeigt soweit diese verfügbar ist. Dadurch werden gleich alle Parameter mit Bedeutung angezeigt. Die Codevervollständigung wird von der IDE automatisch nach dem eintippen des., oder bei Pointern des ->, angezeigt. Die Codevervollständigung kann auch jederzeit mit der Tastenkombination Strg + Leertaste aufgerufen werden um alle verfügbaren Elemente anzuzeigen Includeauswahl Nach der Eingabe von #include und entweder < für Systemincludes, bzw für lokale Includes, werden die unter dem System verfügbaren Elemente angezeigt. Man kann dabei durch die Dateistruktur navigieren und so das gewünschte Element auswählen. Schreibt der Nutzer weiter, so wird die Auswahl eingeschränkt Automatische Formatierung Zur einheitlichen Formatierung des Codes bietet Netbeans eine Funktion an, welche automatisch den Code in eine einheitliche Form bringt. Diese kann unter Source > Format Anleitung Netbeans 5 Version:

6 aufgerufen werden. Vorteil hiervon ist eine erhöhte Lesbarkeit, da Blöcke auf eine Tab-Ebene normalisiert werden. 4. Test und Debugging 4.1. Unit Tests Netbeans bietet ab der Version 7.2 eine sehr komfortable Funktion zur automatischen Testgenerierung. Ein Test kann einfach per Rechtsklick auf die entsprechende Datei unter Create Test > New CppUnit Test erzeugt werden. In dem Assistent können nun die gewünschten Funktionen ausgewählt werden. Auf der nächsten Seite sollten die Namen eindeutig vergeben werden. Es wird nun automatisch ein Paket für die Testfälle erzeugt. In diesem befindet sich der Testrunner und die Test-Klasse in dem der Code zum testen der Funktionen hinzugefügt werden muss. Soll nachträglich neue Testmethoden hinzugefügt werden, muss neben der Definition der Funktion in dem Klassenheader auch ein Makro in folgender Form im Header hinzugefügt werden: CPPUNIT_TEST(newTestMethod); Zur Ausführung der Tests muss im Kontext eines einzelnen Paketes oder des gesamten Ordner Test Files Test bzw. Debug Test ausgewählt werden. Das Ergebnis wird unten im Output Fenster angezeigt. Die Tests werden dann wie bei Unit-Tests gewohnt anhand der Asserts formuliert. Beispielsweise mit CPPUNIT_ASSERT_EQUALS(expected, actual); Die Funktionen setup und teardown werden nach jedem Test erneut aufgerufen um die Testumgebung ordentlich aufzubauen bzw abzubauen Breakpoints und Debug Netbeans bietet mächtige Debug-Funktionalitäten. So können einzelne Befehle Schrittweise ausgeführt werden, Werte von Variablen zur Laufzeit geändert werden oder die Anleitung Netbeans 6 Version:

7 Befehlsreihenfolge verändert werden. Hierzu muss das Projekt im Debug-Modus gestartet werden. Um an zu beobachtenden Stellen automatisch anzuhalten werden Breakpoints gesetzt. Dazu muss die entsprechende Codezeile angewählt werden und links daneben auf die Zeilennummerierung geklickt werden. Nun sollte ein rotes Viereck erscheinen. Wenn diese Stelle im Code aufgerufen wird, wird das Programm pausiert und der Entwickler kann die Befehle per Hand durch gehen. Die Debug-Leiste bietet dafür einige Funktionen. Das Rote Viereck stoppt die Ausführung des Programms, der Kreispfeil startet das Programm erneut. Auch im laufenden Code kann Beispielsweise bei Endlosschleifen mit dem Pause-Knopf pausiert werden; auch gibt es die Möglichkeit das Programm weiter normal auszuführen; das 5. Symbol führt einzelne Codezeilen aus, springt aber in keine der Funktionen rein; um in die Funktion einzutauchen gibt es das 6. Symbol. Hier können dann tieferliegende Funktionen debuggt werden; Stepout beendet die gerade aktive Funktion und pausiert eine Ebene höher, also nach dem Aufruf der aktuellen Funktion; Run to Cursor führt den Code bis zur Position des Cursors im Texteditor aus. Andere IDE's bietet sogar Möglichkeiten den Cursor frei zu bewegen, gewisse Codezeilen zu überspringen oder erneut auszuführen. Netbeans bietet diese Funktionen für C++ zur Zeit allerdings noch nicht. 5. Sonstiges Im folgenden sollen unterschiedliche Themen von Interesse beschrieben werden Einbindung externer Bibliotheken Externe Bibliotheken müssen in den Projekteinstellungen hinzugefügt werden. Dazu einen Rechtsklick auf das Projekt im Projektbrowser ausführen und Properties wählen. Dort unter Build > Linker bei Libraries auf... gehen und mithilfe von Add Library File die Datei auswählen und hinzufügen Installation CPPUnit Während Junit direkt von Netbeans mitgeliefert wird, muss CPPUnit meist nachinstalliert werden. Unter Windows gibt es die Möglichkeit CPPUnit direkt mit Cygwin zu installieren. Dies wird weiter oben unter der Installation für Windows gezeigt. Linux Distributionen liefern CPPUnit auch nur selten mit. Sie kann aber meist über den Paketmanager nachinstalliert werden. Beipsiel (K)ubuntu: sudo apt-get install cppunit Anleitung Netbeans 7 Version:

8 5.3. SVN Netbeans bietet auch eine Integration vom Versionsverwaltungssoftware an. Es können Beispielsweise Projekte aus SVN Servern ausgecheckt werden. Hierzu gehen rufen Sie Team > Subversion > Checkout auf. Nach Eingabe der Serverinformationen kann der genaue Pfad gewählt werden. Unter Repository Revision kann mit Hilfe von Search auch eine bestimmte Revision vom SVN Server ausgewählt werden. Neue mit Netbeans angelegte Projekte können mit einem Rechtsklick auf das Projekt unter Versioning in git, Mercurial oder Subversion Server exportiert werden. Dort kann unter Angabe des Servers, der Authentifizierungsinformationen und des Pfades das Projekt hochgeladen werden. Es werden Standardmäßig alle Projektdateien hochgeladen. Es ist jedoch sinnvoll nur die Codedateien hochzuladen, da in verteilten Entwicklungsumgebungen verschiedene Netbeans Versionen und Betriebssysteme verwendet werden können. Achten Sie hier besonders auf die Vorgaben der Betreuer. Nun werden veränderte Zeilen im Editor farblich markiert. Geänderte Dateien können Beispielsweise unter Team > Subversion > Commit hochgeladen werden. Um den letzten Stand vom Server zu laden muss explizit Beispielsweise Team > Subversion > Update aufgerufen werden. 6. Tastenkürzel Tastenkombination Strg + Leertaste F11 F6 Strg + N Alt + Umschalt + F Strg + Alt + Pause F8 F7 Strg + F7 Befehl Codevervollständigung öffnen Build Projekt Run Projekt New File Code Formatieren Pausiert die Programmausführung für das Debugging Step Over Step In Step Out Anleitung Netbeans 8 Version: