Installazione Pygame
Python può essere installato tramite sorgenti, ma il modo più semplice è quello di utilizzare un pacchetto binario per il tipo di sistema operativo usato e in base alla versione di Python. Questo documento vi spiegherà ogni tipo di installazione.
Pacchetti Di Installazione Windows
Questo è probabilmente il più famoso metodo di installazione. Se state usando Windows, è altamente consigliato usare questo tipo di installazione. I pacchetti vengono creati con tutto ciò di cui avete bisogno, e hanno dei semplici metodi punta e clicca.
La prima cosa necessaria è l'installazione di Python. I pacchetti di Python rendono semplice l'installazione. Poichè i pacchetti di Pygame normalmente funzionano per le ultime 2 release di Python, vorrete essere aggiornati.
Arrivati a questo punto, scaricare il pacchetto appropriato per Windows. Dalla pagina dei download di Pygame potete trovare il .EXE di cui avete bisogno. Questo automaticamente installerà tutte le dipendenze di Pygame e di SDL. I pacchetti Windows hanno nomi come: "pygame-1.7.1.win32-py2.4.exe". Questo sarebbe il pacchetto di installazione per Pygame versione 1.7.1, per Python 2.4. Non dovreste avere problemi nella ricerca del pacchetto giusto nella sezione downloads per "Windows". http://www.pygame.org/download.shtml.
Probabilmente vorrete anche installare il pacchetto della documentazione e dell'installazione per Windows. Questo aggiungerà semplici link alle diverse documentazioni e a giochi che sono stati installati insieme con Pygame. Il pacchetto di installazione per quest'ultimo si trova in altri pacchetti binary per Windows. Il nome dovrebbe essere qualcosa come: "pygame-docs-1.7.1.exe". E questo installerebbe la documentazione e gli esempi per pygame-1.7.1
Un'altra cosa che manca ai pacchetti di installazione di Windows è il pacchetto Numeric Python. Potete facilmente installarlo separatamente e questo vi permetterà di usare il modulo "surfarray" di Pygame. Questo modulo è opzionale, quindi non ce n'è bisogno.
I pacchetti di installazione sono disponibili alla pagina di download.http://sourceforge.net/project/showfiles.php?group_id=1369
Numeric per Windows con Python 2.5 si trova alla pagina di download: http://www.pygame.org/download.shtml.
Pacchetti Di Installazione Unix
Per molti sistemi unix, il modo più semplice per installare Pygame è dai sorgenti. Tranquilli, ci sono pacchetti binari disponibili per molte distribuzioni.
Ci sono alcuni pacchetti RPM per sistemi Linux. Queste richiedono attualmente un po' di lavoro per l'installazione, poichè ci sarà bisogno di altri pacchetti RPM per le dipendenze. C'è una buona probabilità che la vostra distribuzione Linux abbia già le dipendenze richieste (come Python e SDL). I pacchetti RPM sono disponibili dal sito per ogni dipendenza.
Per i sistemi Debian, Pygame è attivamente sostenuto negli archivi Debian. Visitate la pagina Pygame per Debian per maggiori informazioni. http://packages.qa.debian.org/p/pygame.html
Anche FreeBSD ha un pacchetto attivo per Pygame. Dal momento che tecnicamente non è un pacchetto binario, è automaticamente costruito e installato dal [[Color(red,gestore dei ports)]]. Vedere la pagina dei pacchetti FreeBSD per maggiori informazioni. http://www.freebsd.org/cgi/ports.cgi?query=py-game&stype=name
Gentoo ha un pacchetto precostruito per Pygame. Questo è compilato per il sistema di installazione, come per BSD, http://www.gentoo.org/dyn/pkgs/dev-python/pygame.xml
Pacchetti Mac OS X
Per Mac OS X 10.3 e successive, i pacchetti binari sono disponibili dai pacchetti pythonmac.org: http://pythonmac.org/packages/
Questo pacchetto include quasi tutte le dipendenze richieste per Pygame (SDL, SDL_image, etc.), ma c'è bisogno di PyObjC 1.2 o successivo, e può richiedere Numeric e PyOpenGL.
Per costruire applicazioni Pygame autonome, dovreste usare py2app. Questo è un esempio: /Developer/Python/pygame/Examples/macosx/aliens_app_example
Installazione Dai Sorgenti
La compilazione e l'installazione di Pygame è gestita da distutils di Python. Anche in Pygame c'è qualche script per configurare automaticamente i flags richiesti per creare l'installazione di un gioco. Usare lo script "setup.py" per cominciare l'installazione.
La prima volta che eseguite uno script, questo chiamerà lo script "config.py". Questo creerà un file di "Setup" che raggruppa tutte le informazioni necessarie per compilare. "config.py" farà un buon lavoro nel verificare quali dipendenze sono disponibili e dove si trovano. Se non è tutto perfetto, è semplice costruirlo da soli, o modificando il file di testo creato "Setup". Questo file "Setup" è un semplice file di testo simile al Makefile. Definisce le variabili necessarie per usare ogni dipendenza, e in seguito abilita tutti i moduli di Pygame con le dipendenze trovate. Se avete problemi di compilazione, dovreste poterli risolvere facilmente all'interno del file "Setup".
Eseguendo lo script "setup.py" questo chiamerà distutils per creare e installare il pacchetto Pygame. Distutils attualmente supporta un' ampia scelta di opzioni di compilazione e installazione. Eseguendo "python setup.py help" questo comincerà a mostrare le diverse opzioni disponibili. Potete cambiare molte cose come la directory di installazione, il compilatore da usare, e molto altro. Chiamare lo script "setup.py" senza argomenti e questo chiederà se installarlo con i flag necessari di default per compilarlo e installarlo.
Informazioni Compilazione Windows
Compilare tutte le dipendenze su Windows è una vera fatica. Fortunatamente c'è un archivio zip con tutte le librerie e gli headers necessari per la compilazione. Dovreste chiaramente estrarne il contenuto nella cartella dei sorgenti di Pygame, e tutti i file vanno in una sottodirectory "precostruita". Lo script di autoconfigurazione "config.py" cercherà questa directory precostruita e ne renderà l'utilizzo per ciò che vi serve. http://www.pygame.org/ftp/win32-dependencies.zip. Se non utilizzate la directory precostruita, lo script di autoconfigurazione effettuerà una scansione dell'albero delle directory vicine per trovare le dipendenze.
Durante l'installazione su Windows, lo script "setup.py" copierà anche tutte i file .DLL usati nella directory di Pygame. Se si compila con VisualC, queste istruzioni sono tutto ciò di cui avete bisogno. Se si usa il compilatore gratuito Borland o cygwin, c'è bisogno di un passaggio extra.
C'è bisogno di convertire i file in formato .LIB di VisualC in un un formato usato dal compilatore usato. Entrambi Borland e Cygwin includono un comando per farlo. Per convertire una libreria Python il comando necessario con Borland è qualcosa come: COFF2OMF python22.lib python22_bcpp.lib. Per Cygwin, questo è il comando necessario: DLLTOOL --dllname python15.dll --def python15.def --output-lib libpython15.a. Avrete bisogno di effettuare questa conversione anche su tutti gli altri file LIB che derivano dalle dipendenze precostruite (nella directory precostruita /lib). Notate che con cygwin potete rimpiazzare il flag e l'argomento --def con --export-all-symbols visto che non derivano da file .def.
Mingw è ben supportato da SDL, ma un po' di meno per le estensioni Python. Qui c'è un link con molte informazioni per la compilazione con compilatori non-ms. http://www.python.org/doc/current/inst/non-ms-compilers.html
Informazioni Compilazione Unix
Compilare in Linux non dovrebbe darvi alcun problema. Una cosa da ricordare è che molti pacchetti RPM separano l'attuale libreria dai file "dev" necessari per la compilazione. Per crearla c'è bisogno di avere installato pacchetti come "SDL-dev".
Potete controllare se SDL è pronto per essere creato eseguendo il comando sdl-config e vedere se è stato trovato. Se lo script sdl-config non è nel path (o ne avete più di uno?) bisogna settare la variabile d'ambiente SDL_CONFIG dove è situato.
Talvolta avrete alcune librerie SDL installate in un posto, e altre SDL in un altro. Questo inganna gli script di configurazione di Pygame, ma potete aiutarlo impostando la variabile d'ambiente LOCALBASE a un prefisso path dove ci sono le altre librerie. Nella maggior parte dei casi SDL è installato in /usr e le altre librerie SDL in /usr/local. Il comando in questa situazione è "LOCALBASE"=/usr/local python setup.py install.
Informazioni Compilazione Mac OS X
Assicuratevi di avere installati Numeric, PyObjC 1.3 o superiore, PIL, e i framework SDL. La compilazione dovrebbe funzionare allo stesso modo delle istruzioni di compilazione per Unix. Sono richiesti Python 2.3 e Mac OS X 10.2.
Per creare un pacchetto di installazione per Mac OS X che includa Pygame, gli esempi, e i framework SDL usate il seguente comando: python setup.py bdist_mpkg