GLFW3

La scorsa notte stavo lavorando fino a tardi cercando di creare i pacchetti GLFW 3 per Linux dai sorgenti. Questo processo mi ha richiesto molto tempo, circa 3 ore in totale, in parte perché non ho familiarità con CMake e in parte perché non conoscevo GLFW.

Spero che questo post ti salverà dalle difficoltà che ho avuto ieri! Ho pensato di dover scrivere un breve resoconto e, si spera, di salvarti diverse ore della tua vita ...

Grazie a "urraka", "b6" e "niklas" sul canale IRC #glfw, sono riuscito a far funzionare glfw versione 3.0.1.

Si scopre che questo non è un processo banale (certamente non per me, non sono un esperto) in quanto non c'è molta documentazione sul web su glfw3, in particolare sulla sua configurazione con CMake.

Mi è stato chiesto di dividerlo in una sezione di domande e risposte, quindi l'ho fatto e le parti di risposta sono ora di seguito.

Sei un manutentore di GLFW o un membro del team GLFW?

Se qualcuno dei manutentori di GLFW3 lo vede, il mio messaggio è per favore di aggiungere una sezione "configurazione di GLFW3 su Windows, Mac OS X e Linux" al tuo sito web! È abbastanza facile scrivere programmi con GLFW, poiché la documentazione in linea è abbastanza buona, una rapida scansione di tutte le classi e moduli disponibili e sarai pronto per partire. Anche l'esempio di un progetto di prova qui presentato è molto buono. I due problemi principali che ho riscontrato sono stati, in primo luogo come si configura GLFW3 sul mio sistema e in secondo luogo come si costruisce un progetto GLFW3? Queste due cose forse non sono abbastanza chiare per un non esperto.

modificare

Ho dato una breve occhiata oggi (Data: 2014-01-14) sembra che il sito web GLFW abbia subito pesanti cambiamenti dall'ultima volta che l'ho guardato e ora c'è una sezione sulla compilazione di GLFW e sui programmi di buliding con GLFW, che penso siano nuovi.

Passaggio 1: installazione di GLFW 3 sul sistema con CMAKE

Per questa installazione, stavo usando KUbuntu 13.04, 64 bit.

Il primo passo è scaricare l'ultima versione (assumendo che in futuro le versioni funzionino in modo simile) da www.glfw.org , probabilmente usando questo collegamento .

Il prossimo passo è estrarre l'archivio e aprire un terminale. cdnella directory glfw-3.XX ed eseguire cmake -G "Unix Makefiles"potresti aver bisogno di privilegi elevati e potresti anche aver bisogno di installare prima le dipendenze di build . Per fare questo, provare sudo apt-get build-dep glfw o sudo apt-get build-dep glfw3 o farlo manualmente , come ho fatto con sudo apt-get install cmake xorg-dev libglu1-mesa-dev... Ci possono essere altre librerie si richiedono, come le librerie di pthread ... A quanto pare li avevo già. (Vedi le opzioni -l fornite allo stage g ++ linker, di seguito.)

Ora puoi digitare makee poi make install, cosa che probabilmente richiederà sudoprima.

Va bene, dovresti ottenere un output dettagliato sulle ultime tre fasi di CMake, che ti dice cosa è stato costruito o dove è stato posizionato. (In /usr/include, per esempio.)

Passaggio 2: creare un programma di test e compilare

Il passo successivo è avviare vim ("cosa ?! vim ?!" dici) o il tuo IDE / editor di testo preferito ... Non ho usato vim, ho usato Kate, perché sono su KUbuntu 13.04 ... Ad ogni modo, scarica o copia il programma di test da qui (in fondo alla pagina) e salva, esci.

Ora compila usando g++ -std=c++11 -c main.cpp- non sono sicuro se c ++ 11 sia richiesto ma l'ho usato nullptrcosì, ne avevo bisogno ... Potrebbe essere necessario aggiornare il tuo gcc alla versione 4.7, o alla prossima versione 4.8 ... Informazioni su questo qui .

Quindi correggi i tuoi errori se hai digitato il programma a mano o hai cercato di essere "troppo intelligente" e qualcosa non ha funzionato ... Quindi collegalo usando questo mostro! g++ main.o -o main.exec -lGL -lGLU -lglfw3 -lX11 -lXxf86vm -lXrandr -lpthread -lXiQuindi vedi, nella parte "installa le dipendenze di compilazione", potresti anche voler controllare di avere le librerie di sviluppo GL, GLU, X11 Xxf86vm (qualunque essa sia) Xrandr posix-thread e Xi (qualunque essa sia) installate. Forse aggiorna anche i tuoi driver grafici, penso che GLFW 3 possa richiedere OpenGL versione 3 o successiva? Forse qualcuno può confermarlo? Potrebbe anche essere necessario aggiungere le opzioni del linker -ldl -lXinerama -lXcursorper farlo funzionare correttamente se si ottengono riferimenti indefiniti a dlclose(credito a @ user2255242).

E sì, avevo davvero bisogno di così tante -ls!

Passaggio 3: hai finito, buona giornata!

Spero che queste informazioni fossero corrette e che tutto abbia funzionato per te, e ti è piaciuto scrivere il programma di test GLFW. Si spera anche che questa guida abbia aiutato, o aiuterà, alcune persone in futuro che stavano lottando come lo ero io oggi ieri!

A proposito, tutti i tag sono le cose che ho cercato su stackoverflow alla ricerca di una risposta che non esisteva. (Fino ad ora.) Si spera che siano ciò che cercavi se fossi in una posizione simile alla mia.

Nota dell'autore:

Questa potrebbe non essere una buona idea. Questo metodo (usando sudo make install) potrebbe essere pericoloso per il tuo sistema. (Vedi Non rompere Debian)

Idealmente io, o qualcun altro, dovrei proporre una soluzione che non si limita a installare i file lib ecc. Nelle directory predefinite del sistema, poiché dovrebbero essere gestiti da gestori di pacchetti come apt, e ciò potrebbe causare un conflitto e interrompere il sistema di gestione dei pacchetti.

Vedere la nuova "risposta 2020" per una soluzione alternativa.

L'ho risolto in questo modo

Un file pkg-config descrive tutti i flag e le dipendenze in fase di compilazione e di collegamento necessari per utilizzare una libreria.

pkg-config --static --libs glfw3

me lo mostra

-L/usr/local/lib -lglfw3 -lrt -lXrandr -lXinerama -lXi -lXcursor -lGL -lm -ldl -lXrender -ldrm -lXdamage -lX11-xcb -lxcb-glx -lxcb-dri2 -lxcb-dri3 -lxcb-present -lxcb-sync -lxshmfence -lXxf86vm -lXfixes -lXext -lX11 -lpthread -lxcb -lXau -lXdmcp  

Non so se tutte queste librerie siano effettivamente necessarie per la compilazione ma per me funziona ...

Nota che non hai bisogno di molti -ls se installi glfw con l' BUILD_SHARED_LIBSopzione. (Puoi abilitare questa opzione eseguendo ccmakeprima).

In questo modo sudo make installinstallerà la libreria condivisa in /usr/local/lib/libglfw.so. È quindi possibile compilare il file di esempio con un semplice:

g++ main.cpp -L /usr/local/lib/ -lglfw

Quindi non dimenticare di aggiungere / usr / local / lib / al percorso di ricerca per le librerie condivise prima di eseguire il programma. Questo può essere fatto usando:

export LD_LIBRARY_PATH=/usr/local/lib:${LD_LIBRARY_PATH}

E puoi metterlo nel tuo in ~/.bashrcmodo da non doverlo digitare tutto il tempo.

Poiché la risposta accettata non consente ulteriori modifiche, la riassumerò con un singolo comando copia-incolla (Sostituisci 3.2.1 con l'ultima versione disponibile nella prima riga):

version="3.2.1" && \
wget "https://github.com/glfw/glfw/releases/download/${version}/glfw-${version}.zip" && \
unzip glfw-${version}.zip && \
cd glfw-${version} && \
sudo apt-get install cmake xorg-dev libglu1-mesa-dev && \
sudo cmake -G "Unix Makefiles" && \
sudo make && \
sudo make install

Se vuoi compilare un programma usa i seguenti comandi:

g++ -std=c++11 -c main.cpp && \
g++ main.o -o main.exec -lGL -lGLU -lglfw3 -lX11 -lXxf86vm -lXrandr -lpthread -lXi -ldl -lXinerama -lXcursor

Se stai seguendo il tutorial di learnopengl.com potresti dover configurare anche GLAD. In tal caso, fare clic su questo collegamento

http://glad.dav1d.de/#profile=core&specification=gl&api=gl%3D3.3&api=gles1%3Dnone&api=gles2%3Dnone&api=glsc2%3Dnone&language=c&loader=on

quindi fare clic sul pulsante "Genera" nell'angolo in basso a destra del sito Web e scaricare il file zip. Estrailo e compila i sorgenti con il seguente comando:

g++ glad/src/glad.c -c -Iglad/include

Ora, i comandi per compilare il tuo programma diventano così:

g++ -std=c++11 -c main.cpp -Iglad/include && \
g++ main.o glad.o -o main.exec -lGL -lGLU -lglfw3 -lX11 -lXxf86vm -lXrandr -lpthread -lXi -ldl -lXinerama -lXcursor

Ottima guida, grazie. Dato la maggior parte delle istruzioni qui, è quasi costruito per me ma ho avuto un errore rimanente.

/usr/bin/ld: //usr/local/lib/libglfw3.a(glx_context.c.o): undefined reference to symbol 'dlclose@@GLIBC_2.2.5'
//lib/x86_64-linux-gnu/libdl.so.2: error adding symbols: DSO missing from command line
collect2: error: ld returned 1 exit status

Dopo aver cercato questo errore, ho dovuto aggiungere -ldlalla riga di comando.

g++ main.cpp -lglfw3 -lX11 -lXrandr -lXinerama -lXi -lXxf86vm -lXcursor -lGL -lpthread -ldl

Quindi l'app di esempio "hello GLFW" è stata compilata e collegata.

Sono abbastanza nuovo su Linux quindi non sono completamente sicuro di cosa faccia esattamente questa libreria extra ... oltre a correggere il mio errore di collegamento. Tuttavia, vedo quell'interruttore di linea cmd nel post sopra.

Se qualcuno sta diventando pigro e forse forse non sa come configurare la shell per tutte quelle librerie e -l s, allora ho creato uno script python (devi avere python3, la maggior parte degli utenti linux ce l'ha) che ti permette di compilare facilmente script ed eseguirli senza preoccuparsi troppo, ha solo chiamate di sistema regolari, solo organizzate in modo ordinato, l'ho creato per me stesso ma forse sarebbe utile: eccolo

La risposta ben descritta è già lì, ma ho seguito questa ricetta PIÙ BREVE :

1. Installa Linuxbrew
2. $ brew install glfw
3. cd /home/linuxbrew/.linuxbrew/Cellar/glfw/X.X/include
4. sudo cp -R GLFW /usr/include

Spiegazione: riusciamo a compilare GLFW da CMAKE che è fatto da Linuxbrew (il port su Linux dell'amato Homebrew). Quindi copia i file di intestazione in cui Linux legge da ( /usr/include).

Risposta aggiornata del 2020

È il 2020 (7 anni dopo) e in questo periodo ho imparato di più su Linux. In particolare, potrebbe non essere una buona idea eseguirla sudo make installdurante l'installazione delle librerie, poiché potrebbero interferire con il sistema di gestione dei pacchetti. (In questo caso, aptpoiché sto usando Debian 10.)

Se questo non è corretto, correggimi nei commenti.

Soluzione proposta alternativa

Queste informazioni sono prese dai documenti GLFW, tuttavia ho ampliato / ottimizzato le informazioni rilevanti per gli utenti Linux.

• Vai alla home directory e clona il repository glfw da GitHub

cd ~
git clone https://github.com/glfw/glfw.git
cd glfw

• A questo punto puoi creare una directory di build e seguire le istruzioni qui ( istruzioni di build glfw ), tuttavia ho scelto di non farlo. Il seguente comando sembra ancora funzionare nel 2020, tuttavia non è esplicitamente dichiarato dalle istruzioni online glfw.

cmake -G "Unix Makefiles"

• Potrebbe essere necessario eseguire sudo apt-get build-dep glfw3prima (?). Ho eseguito sia questo comando sudo apt install xorg-devche secondo le istruzioni.

• Finalmente corri make

• Ora nella directory del tuo progetto, fai quanto segue. (Vai al tuo progetto che usa le librerie glfw)

• Crea un CMakeLists.txt, il mio assomiglia a questo

CMAKE_MINIMUM_REQUIRED(VERSION 3.7)
PROJECT(project)

SET(CMAKE_CXX_STANDARD 14)
SET(CMAKE_BUILD_TYPE DEBUG)

set(GLFW_BUILD_DOCS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_TESTS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)

add_subdirectory(/home/<user>/glfw /home/<user>/glfw/src)


FIND_PACKAGE(OpenGL REQUIRED)

SET(SOURCE_FILES main.cpp)

ADD_EXECUTABLE(project ${SOURCE_FILES})
TARGET_LINK_LIBRARIES(project glfw)
TARGET_LINK_LIBRARIES(project OpenGL::GL)

• Se non ti piace CMake, mi scuso ma secondo me è il modo più semplice per far funzionare rapidamente il tuo progetto. Consiglierei di imparare a usarlo, almeno a un livello base. Purtroppo non conosco nessun buon tutorial su CMake

• Quindi fai cmake .e make, il tuo progetto dovrebbe essere costruito e collegato alla libreria condivisa glfw3

• C'è un modo per creare una libreria dinamica collegata. Credo di aver usato il metodo statico qui. Per favore commenta / aggiungi una sezione in questa risposta qui sotto se ne sai più di me

• Questo dovrebbe funzionare su altri sistemi, altrimenti fammelo sapere e ti aiuterò se sarò in grado di farlo