Train Director - Istruzioni per la compilazione

 English   -    Italiano   -    Magyar

TGV alla stazione di Novara

 

Pagina Principale
Lista Scenari
Lista icone
Domande Frequenti
Manuale Utente
Creazione File Orario
Scritti
Localizzazioni
Istruzioni per Compilare
Gruppo Discussione

 

 

In questa pagina viene descritta la procedura da seguire se si vuole scaricare i sorgenti di Train Director 3 per poterli modificare e compilare per il proprio sistema.

Viene dapprima descritta la procedura per i sistemi Microsoft Windows, e quindi la procedura per compilare su sistemi Linux.

In entrambi i casi, è necessario scaricare i sorgenti del programma.

Prima però di poter compilare i sorgenti è necessario scaricare e compilare le librerie di run-time wxWidgets.
wxWidgets è una collezione di classi C++ molto versatile che rende molto facile create applicazioni multi-piattaforma di apparenza gradevole e dalle funzionalità molto avanzate.

Grazie a queste librerie esattamente lo stesso codice può essere compilato su sistemi Windows a Linux senza modifiche.

Compilare su Windows

Per compilare su Windows usando il file progetto incluso nel pacchetto sorgenti è necessario avere l'ambiente Microsoft Visual Studio 6.x. Si segua la procedura seguente:

  • Si scarichi la libreria wxWidgets 2.8.0 dal seguente sito: http://www.wxwidgets.org/download. Si installino i sorgenti in una directory a scelta. Personalmente io uso la seguente directory: C:\cg\projects\wxWidgets-2.8.0.
  • In Visual Studio si apra il file wxWidgets-2.8.0\build\msw\wx_dll.dsw.
  • Nella finestra progetto (Alt+0) dovrebbe essere automaticamente selezionato il progetto "adv". Se non lo è, si clicchi col bottone di destra del mouse sul progetto "adv" e si scelga "Set as active project".
  • Ci si assicuri della configurazione prescelta tramite il menù "Build" + "Set active configuration". La configurazione consigliata per uno sviluppatore è "adv - Win32 DLL Debug".
  • Si prema il tasto F7 per iniziare la compilazione. A seconda della potenza del proprio computer, la compilazione dovrebbe essere completata nel giro di 10 minuti.
  • Al termine della compilazione, è necessario compilare a mano il progetto "html". Per far ciò, si clicchi col bottone destro del mouse sul progetto "html" e si selezioni "Set as active project". Quindi si compili tale progetto con F7.

    Dopo aver compilato le librerie di run-time, si esca da Visual Studio.

  • È necessario a questo punto scaricare i sorgenti di Train Director 3 e scompattarli in una directory parallela a quella dove si è scaricato wxWidgets. Nel mio caso, i sorgenti di Train Director 3 risiedono nella directory C:\cg\projects\traindir3.
  • Si rientri in Visual Studio, e si apra il file traindir3\traindir3.dsw.
  • Ci si assicuri che la configurazione attiva corrisponda alla configurazione usata quando si sono compilate le librerie wxWidgets. Si usi il menu "Build" + "Set active configuration" e si scelga "traindir3 - Win32 Debug".
  • Se si sono scaricati i vari files nelle directory corrette dovrebbe essere sufficiente a questo punto premere F7 per creare l'eseguibile traindir3.exe.

Compilare su Linux

Compilare su Linux è più complicato a causa della grande variabilità delle distribuzioni e dei compilatori disponibili. I binari degli eseguibili e delle librerie disponibili sul sito sono stati compilati su un sistema Red Hat Enterprise Linux 3, usando il compilatore gcc 3.2.6 e l'ambiente Gnome.

Purtroppo tale configurazione può non essere compatibile con sistemi più recenti, quali Fedora Core 6.

Se è necessario ricompilare i binari, si segua la seguente procedura:

  • Si scarichi la libreria wxWidgets 2.8.0 dal seguente sito: http://www.wxwidgets.org/download. Si installino i sorgenti in una directory a scelta. Personalmente io uso la seguente directory: /home/gcaprino/wxWidgets-2.8.0.
  • In tale directory, si eseguano i seguenti comandi: 
    $ ./configure --with-libpng --with-libjpeg --with-libxpm \
     --with-gnomeprint --with-regex --with-zlib
$ make
    Questo creerà le librerie dinamiche che saranno linkate da Train Director 3.
  • Si scarichino i sorgenti di Train Director 3 e li si scompatti in una directory a piacere. Nel mio caso, i sorgenti di Train Director 3 risiedono nella directory ~/traindir3. Per esempio: 
    $ mkdir ~/traindir3
$ cd ~/traindir3
$ unzip -a tdir33src.zip
$ mkdir objs
  • A questo punto è necessario modificare il Makefile in modo da specificare dove si trovano le librerie wxWidgets. Si cambino le seguenti linee nel Makefile di Train Director: 
    top_srcdir = /home/gcaprino/wxWidgets-2.8.0
top_builddir = /home/gcaprino/wxWidgets-2.8.0
...
CXXFLAGS = -O2 -pthread -Wall -Wundef Wno-ctor-dtor-privacy
...
WX_RELEASE = 2.8
  • È possibile ora compilare Train Director 3 semplicemente digitando: 
    $ make
    Si noti che la compilazione produce numerosi "warnings". Questo è principalmente dovuto al fatto che gran parte di Train Director è stato scritto in C (versioni precedenti alla 3), e vari sorgenti sono semplicemente stati rinominati con l'estensione .cpp.
  • Al termine della compilazione dovrebbe essere disponibile un file eseguibile chiamato traindir3. Si esegua tale file per far partire il programma.

Come già accennato non posso assicurare che tale procedura funzioni su tutte le combinazioni di distribuzione e di compilatori.

Se qualcuno ha delle aggiunte o correzioni da fare mi mandi pure i file aggiornati e io correggerò il sito.

Questa pagina è mantenuta da g_caprino@gmail.com (Togliere il _ prima di inviare la mail.)
Data di creazione: 25 Dicembre 2006