info: netbeans

netbeans

Tartalomjegyzék

alapok
probléma, megoldás
beállítások
cache
encoding
font
.gitignore
keymap
memory use
plugin
git repository url módosítás
reset windows
unit test

alapok

Installálási könyvtár jelzése:
A netbeans konfigurációs fájl a netbeans.conf, mely az installálási könyvtárhoz viszonyítva itt található:
Újonnan telepített netbeans esetén a netbeans.conf fájlban a "netbeans_default_options" részhez hozzá kell adni a következő beállításokat:
Font méret + a maximálisan használható memória méret:

probléma, megoldás

Ctrl-c nem működik

A problémát abból vesszük észre, hogy ctrl-c után sehová sem tudjuk beilleszteni a szöveget ctrl-v billentyűkkel.
Netbeans-en belülre, és kívülre sem lehet beilleszteni.
Megoldás: nyomjuk le ismét a ctrl-c billentyűket úgy, hogy semmilyen szöveg ne legyen kijelölve. Ez helyreállítja a ctrl-c működését.

A git-információk megjelenítése hibás

Ha nem mutatja a bal oldali projects fülön, hogy a projektet még nem push-oltuk a távoli repository-ba,
vagyis hiányzik a felfelé mutató nyilacska, és a szám hogy hány commit nincs push-olva, akkor a megoldás:
Először töröljük a netbeans cache-t. Ha ez nem oldja meg a problémát akkor dobjuk el a távoli repository bejegyzést, és adjuk hozzá újra:

Az "Open Project" gomb megnyomásakor lassan nyílik meg a fájl választó popup ablak

A netbeans szerint ez egy JDK probléma.
A megoldás, hogy felvesszük a szokásos netbeans.conf fájlba a netbeans_default_options részhez ezt a bejegyzést:

MacOS-en nem indul a netbeans az ikonjára kattintáskor

1. megoldás: állítsuk be a NetBeans által használt JDK-t a netbeans.conf fájlban, például macOS esetén: 2. megoldás: készítsünk egy szimbolikus linket ami a netbeans indító scriptjére mutat: Így legközelebb csak be kell lépni egy terminálba, és a következő paranccsal indíthatjuk:

nbactions.xml-t folytonos verziózása

A netbeans az nbactions.xml fájlt kiveszi a verziókezelőből, majd újra visszateszi,
így a verziókezelő folyamatosan jelzi, hogy valamit még commit-olni kell, ami nagyon zavaró.
A megoldás: meg kell szabadulni az nbactions.xml fájltól.
Fel kell venni a projekthez egy xesj-config-ot: majd be kell állítani hogy a xesj-config legyen az aktív: Így a főablak bal felső lenyíló választóban a <default config> beállítás helyett már a <xesj-config> lesz látható, és ennek így is kell maradnia.
El kell érni, hogy létrejöjjön az nbactions-xesj-config.xml fájl, ehhez valamit módosítani kell a project properties-ben, ami konfigurációhoz kötött, például itt: Utána ellenőrizzük, hogy létrejött-e az nbactions-xesj-config.xml fájl. Ha létrejött, akkor a sima nbactions.xml már törölhető a fájlrendszerből.
A fenti megoldás egy másik problémát is kezel:
Ugyanezen projekt több fejlesztője saját ...-config -ot hozhat létre, melyben a fejlesztők más-más konfigurációt állíthatnak be a project futtatásához.

Nem tud csatlakozni a távoli git-repository-hoz

Ha a távoli repository tényleg létezik, akkor az lehet a probléma, hogy https vagy ssh protokollal csatlakozik, így ellenőrzésre kerül a tanúsítvány, ami esetleg ssl handshake error-t okoz. Ez látható ha a netbeans-ben megnézzük a "View -> IDE Log" ablakban.
Megoldás: ellenőrizzük, hogy a git alapbeállításai megfelelőek-e, ez a beállítás mindenképp szükséges:

A maven-default-http-blocker megakadályozza a projekt lefordítását

Nem lehet a projektet lefordítani, ha egy távoli repository http címen érhető el a https helyett.
A Netbeans 13 már egy új maven-t használ, ami nem szereti a http-t, ezért blokkolja az elérést, így a repository sem lesz hozzáférhető. A hiba úgy ismerhető fel, hogy a hibaüzenetben szerepel a "maven-default-http-blocker" kifejezés. A megoldás, hogy a settings.xml-ben kommentezni kell ezt a blocker-t. A netbeans egy bundled maven-t használ, tehát ahová a netbeans-t telepítettük, annak egy alkönyvtárában keressük meg a settings.xml fájlt, majd kommentezzük ezt a részt:

Nem jók az ékezetes karakterek az újabb netbeans-ek (13, 14, 15, ...) esetében windows-on

Nem tudtam a problémát normálisan megoldani.
Viszont a JDK 18-tól bevezették hogy operációs rendszertől függetlenül mindenhol UTF-8 a kódolás, így a JDK 18-at használva a netbeans-hez a probléma megoldódik.

beállítások

A "Home" billentyű a sor elejére menjen, ne pedig a szöveg elejére:
A JSP hibábat is felderítse a "build". Enélkül nem derül ki a JSP hiba, hacsak nem csinálunk compile műveletet:
A Glassfish ne indítsa el a JavaDB-t:
Importok beállítása:
A beállítások kiexportálása egy fájlba (import-tal betölthető egy másik gépen):
A NetBeans által használt JDK átállításához a netbeans.conf fájlban át kell írni a "netbeans_jdkhome" értékét.
Például macOs esetén: Például windows esetén:
Font alias letiltásához a netbeans.conf fájlban a "netbeans_default_options" részhez a következőt kell hozzáadni a dokumentáció szerint: Régi módszer: -J-Dswing.aatext=false -J-Dawt.useSystemAAFontSettings=gasp
Code template készítés, hogy pár karakter beírásával, hosszú kódrészleteket lehessen létrehozni:
String törés beállítás, töréskor a "+" jel a sor végén legyen, ne pedig a következő sor elején:
Forráskód template beállítás:
Beállítható hogy a html fájl létrehozása html5 formátumú legyen, illetve az Apache Wicket-nek megfelelő html5: Ezután a lemásolt pédánynak adjuk a "Wicket_html5" nevet, és szerkesszük meg a template-et.
Ugyanezzel a módszerrel érdemes átírni a "Java class"-t is.
Verzió változások színnel való jelzésének letiltása (az editor bal oldalán):
A verziókezelő aktuális branch-ének megjelenítése a projekt neve mellett []-ben:
Az editorban való fájlok váltogatása, ne módosítsa a Projects ablak kinézetét.
Tehát ne nyíljon ki a projects ablak mappája azért, mert a benne lévő fájl látható az editorban. Hogy az editorban lévő fájl mégis látható legyen a projects ablakban, a fájlon jobb egérgombot kell nyomni, majd a Select in Projects menüre kell kattintani.

cache

Ha a netbeans hibásan működik (például valótlan fordítási hibákat jelez pirossal), akkor érdemes kitötölni a cache-ét.
A cache helye a Help -> About menüpontban látható. A netbeans-ből való kilépés után lehet a cache-könyvtárat törölni.

encoding

Beállítható minden project-re a fájlok encoding-ja, vagyis a fájl írás/olvasás karakter kódolása:
A projekteken kívül nyitott fájlokra az encoding-ot a netbeans.conf fájlban kell megadni, ahol a netbeans_default_options részhez ezt kell beírni, idézőjelek között, a többi beállításhoz:
A konzol output ablakba írt ékezetes karakterek helyes megjelenítéséhez ezt kell beállítani:

font

"JetBrains Mono NL" font a forráskód editorban
Ez egy nagyon jól kinéző fontkészlet, mely ingyenesen letölthető.

A MacOS-en futó Intellij fejlesztőeszközben ez a default font. Viszont sem a MacOS, se a Windows nem tartalmazza ezt a fontkészletet, ezért telepíteni kell. Ki kell csomagolni a letöltött zip-fájlt, és a ttf könyvtárában lévő JetBrainsMonoNL-Regular.ttf fájlra kell kattintani, a felugró ablakban pedig a Telepítés gombra. Így települ fel az operációs rendszerre. Ha ez nem elég akkor a többi NL fájllal is meg kell tenni ezt a műveletet. Az NL jelentése "No Ligature", vagyis megakadályozza, hogy ha több karaktert gépelünk, az egyetlen karakternek látszódjon az editorban.

Sajnos a windows-os netbeans esetén ez a font telepítés nem elég, hanem a fontokat be is kell másolni ebbe a könyvtárba: A másolás ne a windows intézőjével történjen, mert az hamisan mutatja ennek a könyvtárnak a tartalmát, hanem a far manager vagy a total commander programmal.

A font telepítése után indítsuk újra a Netbeans-t, ekkor a font már kiválasztható lesz. Egy jó beállítás:
Font méret állítása a bal oldali navigátorban, és a menüben
A default font méret 11, ennek átállítása:
A netbeans.conf fájlban a "netbeans_default_options" részhez a következőt kell hozzáadni:
Egy másik alap fontkészlet használata
Ha nem akarjuk a JetBrains fontot, hanem az alap fontkészletekből válogatunk, akkor ezek a fontok néznek ki elfogadhatóan:
Windows esetén: Consolas 15
macOs esetén: Monaco 13

.gitignore

A .gitignore fájl beállítása Java project esetén:
A .gitignore fájl beállítása HTML5/JavaScript project esetén:

keymap

Így állítsuk be a hotkey-eket:

memory use

A memória használat megjelenítése, a netbeans felületén:
A használható memória méretének beállítása:
Legyen a minimális memória 1 gbyte, a maximum pedig 4 gbyte.
Ezt a netbeans.conf fájlban a netbeans_default_options részben kell beállítani:

plugin

A már installált plugin-ok az installed füleslapon látszódnak, de nem egyesével, hanem tömörítve. A részletes plugin listához állítsuk be:
The nb-javac plugin
Ez a plugin azért szükséges, hogy fejlesztéskor a projekthez be lehessen állítani a compile on save funkciót.
Git toolbar plugin
A jobb felső sarokban megjelennek azok az ikonok melyek a git-hez szükségesek.
Amelyek nem kellenek közülük, a toolbar-ra jobb egérgombbal kattintva a customize menüvel eltüntethetők.
Show and change line endings plugin
Megjelenik a jobb alsó sarokban az aktuális fájl sorvég karaktere. Ha erre kattintunk, meg is tudjuk változtatni.
Change line endings on save plugin
Ezzel be lehet állítani hogy fájlok mentésekor mi legyen a sorvég karakter.
Globális szintű beállítás: Projekt szintű beállítás:
Vannak olyan plugin-ek, melyeket a NetBeans nem sorol fel a saját felületén ezért itt kell keresni:
http://plugins.netbeans.org
Ezek általában zip fájlok melyek "nbm" (plugin distribution file) kiterjesztésű fájlokat tartalmaznak. Bontsuk ki a zip-fájlt, majd a netbeans felületén ki lehet őket választani, és berakni a netbeans alá:

git repository url módosítás

Ha a projekthez tartozó távoli repository url megváltozik, akkor ez netbeans-ben is módosítható. Az url ebben a fájlban van nyilvántartva: Módosítás a netbeans segítségével, mely ugyanezt a fájlt nyitja meg szerkesztésre:

reset windows

Ha a netbeans-en belül az ablakok nem megfelelően nyílnak meg, például az output window kitölti a teret, vagy a java forrást az output fül mellett nyitja meg, akkor ezt a menüt használjuk: Window -> Reset Windows

unit test

A NetBeans "normális teszt osztály"-nak csak azt tekinti, ahol az osztály név ilyen alakú: Ha az osztálynév nem ilyen, akkor nem hajlandó tesztként lefuttatni.
Maven project esetében ki lehet kapcsolni a unit teszt-ek futtatását.
Ha a "Clean and Build project" gombra kattintásnál akarjuk kikapcsolni a teszteket, akkor ezt kell beállítani: Ekkor megjelenik a Set Properties mezőben egy szöveg, melyben a true/false tetszőlegesen állítható: