summaryrefslogtreecommitdiffstats
path: root/HOWTO.txt
diff options
context:
space:
mode:
Diffstat (limited to 'HOWTO.txt')
-rw-r--r--HOWTO.txt113
1 files changed, 0 insertions, 113 deletions
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ą.