29ca63e4f9
2) Fixed the manual (added new key bindings for jump and look back, improved layout, added picture for description of race interface. (see r1589 on 0.4rc1 branch). git-svn-id: svn+ssh://svn.code.sf.net/p/supertuxkart/code/trunk/supertuxkart@1590 178a84e3-b1eb-0310-8ba1-8eac791a3b58
521 lines
9.5 KiB
Plaintext
521 lines
9.5 KiB
Plaintext
System requirements Mac:
|
|
PowerPC- or Intel-Mac with 800 MHz or more,
|
|
1 GHz recommended 3D-graphics card with 32 MB or more.
|
|
100 MB free disk space. Supporting Mac OS X 10.3.9 or later.
|
|
|
|
Compiling SuperTuxKart on OS X 10.4.x
|
|
|
|
01. Install all updates for OS X.
|
|
|
|
02. Download xcode 2.4.1_8m1910_6936315 from http://developer.apple.com/macosx/
|
|
|
|
You must be an Apple Developer Connection member to download this package.
|
|
|
|
03. Installing XCode.
|
|
|
|
04. Edit "/etc/profile":
|
|
|
|
--------------------------------------------------------------------------------------------------------
|
|
|
|
# System-wide .profile for sh(1)
|
|
|
|
PATH="/sw/bin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/X11R6/bin"
|
|
|
|
export PATH
|
|
|
|
PKG_CONFIG_PATH="/sw/lib/pkgconfig:/usr/lib/pkgconfig:/usr/X11R6/lib/pkgconfig:/usr/local/lib/pkgconfig"
|
|
|
|
export PKG_CONFIG_PATH
|
|
|
|
if [ "${BASH-no}" != "no" ]; then [ -r /etc/bashrc ] && . /etc/bashrc fi
|
|
|
|
--------------------------------------------------------------------------------------------------------
|
|
|
|
05. Download Fink from http://www.finkproject.org/download/index.php?phpLang=en
|
|
|
|
06. Installing Fink.
|
|
|
|
07. Copy the FinkCommander folder to Applications and launch FinkCommander.
|
|
|
|
08. Run selfupdate.
|
|
|
|
09. Run update-all.
|
|
|
|
10. Run the index command.
|
|
|
|
11. Installing the following 'fink' packages:
|
|
|
|
|
|
11.01 SDL
|
|
|
|
11.02 audiofile
|
|
|
|
11.03 esound
|
|
|
|
11.04 svn
|
|
|
|
11.05 svn-client
|
|
|
|
|
|
12. Download the SDL framework from http://www.libsdl.org/download-1.2.php and copy it to /Library/Frameworks.
|
|
|
|
13. Installing Vorbis.framework and Ogg.framework:
|
|
|
|
13.01 Download SuperTux from http://developer.berlios.de/project/showfiles.php?group_id=3467&release_id=11879
|
|
|
|
13.02 Right-click the SuperTux icon and select Show Package Contents from the context menu.
|
|
|
|
13.03 Change in the folder Contents:Frameworks. And copy Vorbis.framework and Ogg.framework to <hd>:Library:Frameworks.
|
|
|
|
|
|
14. Installing plib: ////////////////////////////////////////
|
|
|
|
|
|
14.01 Download PLIB from http://plib.sourceforge.net/download.html
|
|
|
|
|
|
14.02 Unpack plib-1.8.4.tar.gz.
|
|
|
|
|
|
14.03 Change in the folder PLIB.
|
|
|
|
|
|
14.04 Download "pwMacOSX.cxx"-patch from ftp://ftp.berlios.de/pub/supertuxkart/plib_patch_for_osx.zip
|
|
|
|
|
|
14.05 Installing pwMacOSX.cxx-patch.
|
|
|
|
|
|
14.06 Run ./configure --prefix=<..... Universal/plib_ppc>" in the folder PLIB.
|
|
|
|
|
|
e.g.: /Users/christian/Desktop/Universal/plib_ppc.
|
|
|
|
|
|
14.07 Modify the plib:
|
|
|
|
|
|
jsMacOSX.cxx:
|
|
|
|
|
|
#include <IOKit/IOkitLib.h>
|
|
|
|
|
|
replace with:
|
|
|
|
|
|
#include <IOKit/IOKitLib.h>
|
|
|
|
|
|
14.08 jsMacOSX.cxx:
|
|
|
|
|
|
static void os_specific_s::elementEnumerator( const void *element, void* vjs)
|
|
|
|
|
|
replace with:
|
|
|
|
|
|
void os_specific_s::elementEnumerator( const void *element, void* vjs)
|
|
|
|
|
|
14.09 make
|
|
|
|
14.10 make install
|
|
|
|
14.11 make clean
|
|
|
|
|
|
14.12 Run "./configure --prefix=<..... Universal/plib_x86>" in the folder PLIB.
|
|
|
|
e.g.: /Users/christian/Desktop/Universal/plib_x86.
|
|
|
|
14.13 Edit the following Makefiles:
|
|
|
|
<PLIB-Ordner>/Makefile
|
|
|
|
<PLIB-Ordner>/src/Makefile
|
|
|
|
<PLIB-Ordner>/src/fnt/Makefile
|
|
|
|
<PLIB-Ordner>/src/js/Makefile
|
|
|
|
<PLIB-Ordner>/src/net/Makefile
|
|
|
|
<PLIB-Ordner>/src/psl/Makefile
|
|
|
|
<PLIB-Ordner>/src/puAux/Makefile
|
|
|
|
<PLIB-Ordner>/src/pui/Makefile
|
|
|
|
<PLIB-Ordner>/src/pw/Makefile
|
|
|
|
<PLIB-Ordner>/src/sg/Makefile
|
|
|
|
<PLIB-Ordner>/src/sl/Makefile
|
|
|
|
<PLIB-Ordner>/src/ssg/Makefile
|
|
|
|
<PLIB-Ordner>/src/ssgAux/Makefile
|
|
|
|
<PLIB-Ordner>/src/util/Makefile
|
|
|
|
replace the line: "CXXFLAGS =" with "CXXFLAGS = -g -O2 -Wall -arch i386"
|
|
|
|
14.14 make install
|
|
|
|
14.15 Create a universal (multi-architecture) plib:
|
|
|
|
lipo -create /Users/christian/Desktop/Universal/plib_ppc/lib/libplibfnt.a /Users/christian/Desktop/Universal/
|
|
|
|
plib_x86/lib/libplibfnt.a -output /usr/lib/libplibfnt.a
|
|
|
|
Repeat this step for all libraries.
|
|
|
|
15. Installing Freealut-1.1.0 from OpenAL.org ////////////////////
|
|
|
|
15.01 Makefile.in:
|
|
|
|
Replace the line:
|
|
|
|
SUBDIRS = admin src include examples test_suite
|
|
|
|
with
|
|
|
|
SUBDIRS = admin src include
|
|
|
|
|
|
15.02 configure:
|
|
|
|
Replace the line
|
|
|
|
for ac_header in AL/alc.h AL/al.h basetsd.h ctype.h math.h stdio.h time.h
|
|
|
|
with
|
|
|
|
for ac_header in OpenAL/alc.h OpenAL/al.h basetsd.h ctype.h math.h stdio.h time.h
|
|
|
|
|
|
15.03 export CXXFLAGS="-framework OpenAL"
|
|
|
|
|
|
15.04 export LDFLAGS="-framework OpenAL"
|
|
|
|
|
|
15.05 ./configure --prefix=/usr
|
|
|
|
|
|
15.06 make
|
|
|
|
|
|
15.07 Open admin/pkgconfig/freealut.pc
|
|
|
|
Replace the line
|
|
|
|
Requires: openal
|
|
|
|
with
|
|
|
|
Requires:
|
|
|
|
|
|
15.08 Replace the line:
|
|
|
|
Libs: -L${libdir} -lalut Cflags: -I${includedir}
|
|
|
|
with
|
|
|
|
Libs: -framework OpenAL -L${libdir} -lalut Cflags: -framework OpenAL -I${includedir}
|
|
|
|
|
|
15.09 sudo make install
|
|
|
|
|
|
16. Copy the plib files to "/usr/local":
|
|
|
|
16.01 sudo cp /usr/lib/libplib* /usr/local/lib/
|
|
|
|
16.02 sudo cp -R /usr/include/plib /usr/local/include/
|
|
|
|
|
|
Installing SuperTuxKart //////////
|
|
|
|
|
|
1. Copy the following code and paste it in the new file "buildUB.sh".
|
|
|
|
|
|
buildUB.sh:
|
|
|
|
---------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
#!/bin/bash
|
|
|
|
if [ -r ./configure ]; then
|
|
|
|
echo "Configure found!"
|
|
|
|
else
|
|
|
|
echo "No Config file found! Runing autogen.sh..."
|
|
|
|
sh autogen.sh
|
|
|
|
fi
|
|
|
|
|
|
if [ -r ./config.guess ]; then
|
|
|
|
echo "config.guess found!"
|
|
|
|
else
|
|
|
|
echo "config.guess not present! Copying it..."
|
|
|
|
cp /usr/share/libtool/config.guess ./config.guess
|
|
|
|
fi
|
|
|
|
|
|
if [ -r ./config.sub ]; then
|
|
|
|
echo "config.sub found!"
|
|
|
|
else
|
|
|
|
echo "config.sub not present! Copying it..."
|
|
|
|
cp /usr/share/libtool/config.sub ./config.sub
|
|
|
|
fi
|
|
|
|
|
|
if [ -r ./Makefile ]; then
|
|
|
|
echo "Makefile found!"
|
|
|
|
else
|
|
|
|
echo "Makefile missing! Running ./configure..."
|
|
|
|
./configure
|
|
|
|
if [ -r ./Makefile ]; then
|
|
|
|
echo "Makefile present, ready to compile!"
|
|
|
|
else
|
|
|
|
echo "Configure not completed, Makefile still missing! Exiting..."
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
fi
|
|
|
|
|
|
echo "Setting environment variables..."
|
|
|
|
export sdl_LIBS=""
|
|
|
|
export LDFLAGS="-framework OpenAL -Wl,-framework,Cocoa -framework SDL -framework Cocoa -lSDLmain
|
|
|
|
-framework Vorbis -framework Ogg -L/usr/local/lib -L/opt/local/lib -L/sw/lib"
|
|
|
|
export openal_LIBS="/usr/local/lib/libmikmod.a"
|
|
|
|
|
|
if [ -r ./bin/supertuxkartPPC ]; then
|
|
|
|
echo "supertuxkartPPC is present, nothing to do."
|
|
|
|
else
|
|
|
|
echo "Cleaning up..."
|
|
|
|
make clean -s
|
|
|
|
|
|
echo "Building PPC Binary..."
|
|
|
|
make -e -s
|
|
|
|
|
|
echo "Copying PPC Binary..."
|
|
|
|
mkdir ./bin
|
|
|
|
if [ -r ./src/supertuxkart ]; then
|
|
|
|
cp ./src/supertuxkart ./bin/supertuxkartPPC
|
|
|
|
else
|
|
|
|
echo "Error!"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
fi
|
|
|
|
|
|
if [ -r ./bin/supertuxkartx86 ]; then
|
|
|
|
echo "supertuxkartx86 is present, nothing to do."
|
|
|
|
else
|
|
|
|
echo "Cleaning up..."
|
|
|
|
make clean -s
|
|
|
|
|
|
echo "Building x86 Binary..."
|
|
|
|
export CXXFLAGS="-g -O2 -Wall -arch i386 `sdl-config --cflags`"
|
|
|
|
export LDFLAGS=$LDFLAGS" -isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -L/usr/local/lib -L/opt/local/lib -L/sw/lib"
|
|
|
|
make -e -s
|
|
|
|
|
|
echo "Copying x86 Binary..."
|
|
|
|
if [ -r ./src/supertuxkart ]; then
|
|
|
|
cp ./src/supertuxkart ./bin/supertuxkartx86
|
|
|
|
else
|
|
|
|
echo "Error!"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
fi
|
|
|
|
|
|
echo "Creating Universal Binary..."
|
|
|
|
lipo -create ./bin/supertuxkartPPC ./bin/supertuxkartx86 -output ./bin/supertuxkart
|
|
|
|
|
|
echo "Done!"
|
|
|
|
|
|
-------------------------------------------------------------------------------------------------------------
|
|
|
|
2. Set the permissions for the script "buildUB.sh"
|
|
|
|
e.g.: chmod 744 buildUB.sh
|
|
|
|
|
|
3. Download SuperTuxKart-Source from "http://sourceforge.net/project/showfiles.php?group_id=202302".
|
|
|
|
|
|
4. Go in the folder SuperTuxKart.
|
|
|
|
|
|
5. Copy the script "buildUB.sh" in the directory "SuperTuxKart".
|
|
|
|
|
|
6. ./buildUB.sh
|
|
|
|
|
|
7. Check-up:
|
|
|
|
|
|
7.01 Go in the folder "bin".
|
|
|
|
|
|
7.02 ./supertuxkart --version
|
|
|
|
Print version information
|
|
|
|
e.g.:
|
|
-------------------------------------------------------------------------
|
|
SuperTuxKart, 0.3alpha.
|
|
|
|
SuperTuxKart, SVN revision number '975M'.
|
|
-------------------------------------------------------------------------
|
|
|
|
|
|
7.03 Is this a universal binary?
|
|
|
|
file supertuxkart
|
|
|
|
|
|
e.g.:
|
|
-------------------------------------------------------------------------
|
|
supertuxkart: Mach-O fat file with 2 architectures
|
|
|
|
supertuxkart (for architecture ppc): Mach-O executable ppc
|
|
|
|
supertuxkart (for architecture i386): Mach-O executable i386
|
|
-------------------------------------------------------------------------
|
|
|
|
|
|
7.04 otool -L supertuxkart
|
|
|
|
Print shared library dependencies.
|
|
|
|
e.g.:
|
|
------------------------------------------------------------------------------------------------
|
|
supertuxkart:
|
|
|
|
/System/Library/Frameworks/OpenAL.framework/Versions/A/OpenAL (compatibility version 1.0.0,
|
|
|
|
current version 1.0.0)
|
|
|
|
/System/Library/Frameworks/Cocoa.framework/Versions/A/Cocoa (compatibility version 1.0.0,
|
|
|
|
current version 11.0.0)
|
|
|
|
@executable_path/../Frameworks/SDL.framework/Versions/A/SDL (compatibility version 1.0.0, current
|
|
|
|
version 1.0.0)
|
|
|
|
@executable_path/../Frameworks/Vorbis.framework/Versions/A/Vorbis (compatibility version 1.0.0,
|
|
|
|
current version 1.0.0)
|
|
|
|
@executable_path/../Frameworks/Ogg.framework/Versions/A/Ogg (compatibility version 1.0.0, current
|
|
|
|
version 1.0.0)
|
|
|
|
/System/Library/Frameworks/Carbon.framework/Versions/A/Carbon (compatibility version 2.0.0, current
|
|
|
|
version 128.0.0)
|
|
|
|
/System/Library/Frameworks/OpenGL.framework/Versions/A/OpenGL (compatibility version 1.0.0, current
|
|
|
|
version 1.0.0)
|
|
|
|
/System/Library/Frameworks/IOKit.framework/Versions/A/IOKit (compatibility version 1.0.0, current
|
|
|
|
version 275.0.0)
|
|
|
|
/System/Library/Frameworks/AGL.framework/Versions/A/AGL (compatibility version 1.0.0, current version
|
|
|
|
1.0.0)
|
|
|
|
/usr/lib/libstdc++.6.dylib (compatibility version 7.0.0, current version 7.4.0)
|
|
|
|
/usr/lib/libgcc_s.1.dylib (compatibility version 1.0.0, current version 1.0.0)
|
|
|
|
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 88.1.8)
|
|
---------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
************* S T A R T T H E G A M E A N D H A V E F U N! **************
|
|
|
|
|
|
Please post to the development list if you have any problems.
|
|
|
|
|
|
|