From 87bc927d8757d6b9d7633260ff12580dcd48b3a4 Mon Sep 17 00:00:00 2001 From: Piotr Dziwinski Date: Fri, 22 Mar 2013 22:24:35 +0100 Subject: Updated README files, optional libsndfile * updated readme files * moved sndfile to optional * changed install paths on Windows --- HOWTO.txt | 113 -------------------------------------------------------------- 1 file changed, 113 deletions(-) delete mode 100644 HOWTO.txt (limited to 'HOWTO.txt') diff --git a/HOWTO.txt b/HOWTO.txt deleted file mode 100644 index cd236c4..0000000 --- a/HOWTO.txt +++ /dev/null @@ -1,113 +0,0 @@ -EN - -How to... - -1. Compile the game. - - 1.1 Windows: - - CROSS-COMPILING: see the instructions in HOWTO-MXE.txt on how to cross-compile the project - with MXE (http://mxe.cc/). - - NOTE: currently, there are some issues when compiling on Windows, connected mostly with - clashing macros defined in windows headers. Most probably, a special development package - will be provided, which will include MinGW, CMake and all necessary libraries. - - 1. Download and install MinGW and MSYS: - http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20111118/ - When installing, select all available components. - 2. Download and install CMake: - http://www.cmake.org/cmake/resources/software.html (the Windows zip file) - Unpack the contents of the archive to where MinGW is installed (files from bin/ should go into bin/, etc.) - 3. Download the following libraries, installing them in your MinGW directory like with CMake: - SDL >=1.2.10, SDL_image >= 1.2, SDL_ttf >= 2.0, libpng >= 1.2, GLEW >= 1.8.0, Boost >= 1.51 (with filesystem) - Note #1: For most libraries, you can download binary packages with compiled files. - However, you must ensure that they work with MinGW as some are built with MSVC - and may be incompatible. If that is the case, you should compile the libraries from sources - using MinGW. - Note #2: For GLEW, you need to compile from source under MinGW. Since there is no automated - make script for that, follow the instructions here: http://stackoverflow.com/questions/6005076/ - 4. Run MinGW console from the shortcut in menu start. - 5. Change to the directory where you have the Colobot sources by typing "cd /c/where/the/sources/are" - 6. Type "cmake -G 'MSYS Makefiles' ." - 7. Type "make" - 8. Everything should compile without errors. - - 1.2 Linux: - - Since you're running Linux, you probably know how to do this anyway ;) - But just in case, here's what you need: - gcc compiler (with gcc-g++), cmake, libraries with header files: GLEW, SDL, SDL_image, SDL_ttf, libpng, boost - Instructions are the same: - $ cmake . - $ make - - Note #1: For audio support you need libsndfile and openal. - - 1.3 Other platforms, compilers, etc. - - We haven't checked other platforms yet but the code isn't particularly tied to any compiler or platform, so in theory it should work. - If you can, please try to compile the code on your platform and let us know how it goes. - -2. Run the compiled game. - - 1. Download development data package - make sure you get the latest version as the files will be changed/moved around. - Currently the files are hosted at: http://colobot.info/files (packages are named colobot-data-YYYY-MM-DD.zip) - 2. Unpack the data package to any place you want. - 3. Run the game with commandline option "-datadir where_you_put_the_data_dir" and enjoy the game. - - -PL - -Jak... - -1. Skompilować grę. - - 1.1 Windows: - - CROSS-KOMPILACJA: zobacz plik HOWTO-MXE.txt z instrukcjami (po angielsku) jak cross-skompilować projekt używając - MXE (http://mxe.cc/). - - UWAGA: obecnie występują problemy z kompilacją na Windowsie, głównie ze względu na konflikt w makrach, - jakie definiują nagłówki windowsowe. Najprawdopodobniej, zostanie wydana specjalna paczka - dla developerów, która będzie zawierała MinGW, CMake i wszystkie potrzebne biblioteki. - - 1. Ściągamy i instalujemy MinGW i MSYS: - http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20111118/ - Przy instalacji zaznaczamy wszystkie komponenty do instalacji. - 2. Ściągamy i instalujemy CMake: - http://www.cmake.org/cmake/resources/software.html (plik zip dla Windowsa) - Zip rozpakowujemy do katalogu, gdzie zainstalowany jest MinGW (pliki z bin/ mają trafić do bin/ itd.). - 3. Ściągamy następujące biblioteki i instalujemy je tam, gdzie MinGW, podobnie jak z CMake: - SDL >= 1.2.10, SDL_image >= 1.2, SDL_ttf >= 2.0, libpng >= 1.2, Boost >= 1.51 (wraz z filesystem) - Uwaga #1: W większości wymienionych bibliotek można ściągnąć paczki binarne ze skompilowanymi plikami. - Jednak musisz się upewnić, że pliki te będą współpracowały z MinGW, bo część z nich - jest kompilowana MSVC i może być niezgodna. W takim wypadku, musisz skompilować bibliotekę - ze źródeł pod MinGW. - Uwaga #2: W przypadku GLEW, musisz skompilować bibliotekę ze źródeł pod MinGW. Ponieważ nie ma skryptu - make do tego, użyj poleceń opisanych tutaj: http://stackoverflow.com/questions/6005076/ - 4. Uruchamiamy MinGW console ze skrótu w menu start. - 5. Przechodzimy do katalogu, gdzie są źródła wpisując "cd /c/tam/gdzie/sa/zrodla" - 6. Wpisujemy "cmake -G 'MSYS Makefiles' ." - 7. Wpisujemy "make" - 8. Wszystko powinno się skomplikować bez błędów. - - 1.2 Linux: - - Skoro już masz Linuksa, to prawdopodobnie wiesz co robić ;) - Ale na wszelki wypadek, potrzebujesz tego: - kompilator gcc (razem z gcc-g++), cmake, biblioteki wraz z nagłówkami: SDL, SDL_image, SDL_ttf, libpng, boost - Polecenia są takie same: - $ cmake . - $ make - - 1.3 Inne platformy, kompilatory, etc. - - Nie sprawdzaliśmy jeszcze innych platform, ale kod nie jest jakoś specjalnie związany z danym kompilatorem czy platformą, więc w teorii powinien zadziałać. - Jeśli możesz, spróbuj skompilować kod na twojej platformie i daj nam znać jak poszło. - -2. Uruchomić skompilowaną grę. - - 1. Ściągamy paczkę developerską z plikami danych gry - upewnij się, że jest to najnowsza wersja, bo pliki będą zmieniane/przenoszone. - 2. Wypakowujemy pliki gdziekolwiek. - 3. Uruchamiamy grę wraz z opcją "-datadir tam_gdzie_rozpakowałeś_paczkę" i cieszymy się grą. -- cgit v1.2.3-1-g7c22