Ovaj vodič objašnjava proces preuzimanja izvornog koda QwebX pretraživača i korak-po-korak uputstva za kompajliranje finalnih distribucija (.deb, AppImage, .zip, Portable EXE) koristeći Node.js, npm, i Electron Builder.
1. 💻 Preduslovi za Kompajliranje
Za uspešno kompajliranje QwebX-a neophodno je da imate instaliran sledeći softver:
| Softver | Minimalna Verzija | Svrha |
|---|---|---|
| Node.js | 16.x ili novija | Izvršavanje JavaScript okruženja. |
| npm | 8.x ili novija | Upravljanje projektnim zavisnostima. |
| Git | Najnovija stabilna | Preuzimanje izvornog koda. |
| Python | 3.x (Potrebno za neke npm module) | Dodatna zavisnost. |
Napomena: Za kompajliranje Mac paketa na Linuxu ili Windowsu, kao i za Windows pakete na Macu, možda ćete morati da instalirate dodatne sistemske alate i sertifikate.
2. 📥 Priprema i Instalacija Zavisnosti
2.1. Kloniranje Repozitorijuma
Preuzmite kompletan izvorni kod projekta pomoću Gita:
git clone https://github.com/SaleMaricic/QwebX.git
cd QwebX
2.2. Instalacija Zavisnosti
Instalirajte sve neophodne zavisnosti definisane u package.json (uključujući electron i electron-builder):
npm install
3. 🚀 Kompajliranje za Specifične Platforme
QwebX koristi electron-builder za automatsko pakovanje. Svi potrebni skriptovi su već definisani u sekciji “scripts” u package.json.
3.1. Pokretanje u Razvojnom Modu (Testiranje)
Za brzo testiranje aplikacije bez kompajliranja finalnog paketa:
npm run start
3.2. Kompajliranje za Linux
QwebX podržava dva najpopularnija Linux formata:
DEB paket (Debian, Ubuntu, Mint):
npm run build-deb
AppImage (Univerzalni format):
npm run build-appimage
3.3. Kompajliranje za Windows
QwebX je konfigurisan da generiše **Portable EXE** fajl koji ne zahteva instalaciju:
npm run build-win
3.4. Kompajliranje za macOS
Definisani su skriptovi za generisanje ZIP arhive, što je standardni format za distribuciju na Macu:
ZIP paket:
npm run build-mac
Alternativni, ručni ZIP (Koristi electron-packager):
npm run create-mac-zip
4. 🎨 Generisanje Sistemskih Ikona
Ukoliko menjate izvornu build/icon.png, morate ponovo generisati sve formatirane ikone koje su potrebne za Windows (.ico) i macOS (.icns). Ova komanda koristi skripte definisane u package.json:
npm run icons
5. 📦 Izlazni Direktorijum
Svi finalni, kompajlirani paketi će se nalaziti u direktorijumu:
QwebX/dist/
U ovom folderu ćete pronaći fajlove kao što su QwebX-1.2.4.AppImage, QwebX Setup 1.2.4.exe ili QwebX-1.2.4-mac.zip.
Važno: Tokom kompajliranja, elektronska baza koda (main.js, preload.js) automatski implementira sve optimizacione *switcheve* i komande za forsiranje GPU akceleracije, koje su ključne za performanse na starijim računarima.