Compilarea librăriilor din sursa Metin2: ordinea corectă și verificarea

Programele `game` și `db` nu se construiesc dintr-o bucată. Ele folosesc câteva **librării**, bucăți de cod comune, care trebuie compilate înaintea lor. E ca la o casă: întâi torni fundația și ridici zidurile, abia apoi pui acoperișul. Dacă sari peste o librărie, compilarea lui `game` se oprește cu erori greu de înțeles. Lecția îți arată ordinea și cum verifici fiecare pas.

Nivel: Avansat. Ce trebuie să știi înainte: lecția despre mediul de compilare (uneltele instalate și GAMEDIR schimbat) și ce sunt game, db și sursa.

Cuvinte pe care le vei întâlni

Pasul 1: Află ordinea din rețeta principală

Nu copia ordinea de pe un forum. Citește-o din Makefile-ul din rădăcina sursei:

cd /usr/home/sursa
grep -n "^default" Makefile

În sursa verificată de noi, rândul arată așa:

default: libthecore libpoly libgame liblua libsql libserverkey game db

Asta e ordinea: întâi cele 6 librării, apoi game și db. Pe scurt, ce face fiecare:

Pasul 2: Fă o copie înainte

Sursa vine deja cu librăriile compilate (fișierele .a). Compilarea le va șterge și le va construi din nou. Păstrează o copie a întregului folder, ca să ai mereu de unde reveni:

cp -Rp /usr/home/sursa /usr/home/sursa-copie-2026-11-02

-R copiază tot folderul, -p păstrează datele și permisiunile fișierelor.

Pasul 3: Compilează librăriile una câte una

Poți rula gmake direct din rădăcină, dar pentru prima dată e mai clar să le faci pe rând. Pentru fiecare librărie, rețeta principală face patru lucruri: creează fișierul Depend, calculează dependențele, curăță, compilează. Repetăm exact asta. Exemplu pentru prima:

cd /usr/home/sursa/libthecore/src
touch Depend
gmake dep
gmake clean
gmake 2>&1 | tee /usr/home/build/libthecore.log

Explicat bucată cu bucată:

• touch Depend creează un fișier gol numit Depend, dacă nu există.
• gmake dep scrie în el legăturile dintre fișiere (folosește makedepend).
• gmake clean șterge rezultatele vechi.
• gmake 2>&1 | tee ... compilează, îți arată textul pe ecran și îl salvează în fișierul .log.

Ce ar trebui să vezi: la final, rânduri cu ar cru ../lib/libthecore.a ... și ranlib, fără error.

Repetă pentru celelalte, în ordine, în folderele lor:

Pasul 4: Verifică rezultatul

După toate, verifică că fișierele există și au data de azi:

cd /usr/home/sursa
ls -l libthecore/lib/libthecore.a libpoly/libpoly.a libgame/lib/libgame.a liblua/lib/liblua.a libsql/libsql.a libserverkey/libserverkey.a

Apoi verifică arhitectura pe un fișier .o:

file libthecore/src/socket.o

Ce ar trebui să vezi: ELF 32-bit LSB relocatable, Intel i386 pe un sistem de test i386. Dacă scrie 64-bit iar game-ul tău e pe 32 de biți, oprește-te: le-ai amestecat. Revezi pasul despre arhitectură din lecția anterioară.

Varianta rapidă: totul din rădăcină

Odată ce ai înțeles pașii, poți rula din rădăcina sursei:

cd /usr/home/sursa
gmake 2>&1 | tee /usr/home/build/build-tot.log

Două lucruri bune de știut despre Makefile-ul verificat de noi:

• Pentru game și db, liniile care compilează efectiv sunt comentate (încep cu #). Rețeta principală doar pregătește folderele lor. Le compilezi separat, în lecțiile următoare.
• Pasul limit_time rulează python2.7. Dacă nu ai Python 2.7, vei vedea python2.7: not found după ce librăriile s-au compilat deja. Fișierul limit_time.h există deja în sursă, iar funcția legată de el e dezactivată, deci în sursa verificată poți trece peste. La tine, verifică.

Ce vezi și ce faci

Greșeli des întâlnite

• Sari peste o librărie sau schimbi ordinea. game va da apoi undefined reference.
• Citești doar ultimul rând din log. Prima eroare e cea care contează.
• Copiezi .a-uri de pe internet. Pot fi pe altă arhitectură sau din altă versiune a sursei.
• Lucrezi fără copie. Dacă ceva se strică, nu mai ai librăriile originale.

Întrebări frecvente

Trebuie să recompilez librăriile de fiecare dată?

Nu. Doar când le schimbi codul sau când schimbi compilatorul ori flag-urile. Pentru o modificare doar în game/src, compilezi game.

Cât durează?

Librăriile, de obicei câteva minute. Depinde de procesor.

Ce înseamnă -j2 din alte tutoriale?

Îi spune lui gmake să compileze două fișiere în paralel. E mai rapid, dar erorile se amestecă în log. Pentru prima compilare, lasă-l deoparte.

Ce urmează

Librăriile sunt gata. Mergi la compilarea db. Toate lecțiile sunt în lista tutorialelor Metin2.