Core commit. Compile and run on the OpenPandora

[mupen64plus-pandora.git] / source / mupen64plus-core / tools / osx_build_instructions.txt

diff --git a/source/mupen64plus-core/tools/osx_build_instructions.txt b/source/mupen64plus-core/tools/osx_build_instructions.txt
new file mode 100644 (file)
index 0000000..61f953c
--- /dev/null
+++ b/source/mupen64plus-core/tools/osx_build_instructions.txt
@@ -0,0 +1,52 @@
+OSX build instructions (using OSX 10.8.3 and Xcode 4.6.2):
+
+1. Install SDL framework
+   - go to http://www.libsdl.org/download-1.2.php
+     - download SDL-1.2.15.dmg
+   - Open the DMG and copy SDL.framework to /Library/Frameworks
+     - also, copy devel-lite to your desktop
+   - Build SDLMain.m_o:
+     - open terminal, cd ~/Desktop/devel-lite
+     - run: gcc -c -O3 -I./ -I/Library/Frameworks/SDL.framework/Headers -o SDLMain.m_o SDLMain.m
+2. Install macports
+3. Install the following ports (sudo port install <name>):
+   - bzip2
+   - freetype
+   - libpng
+   - libsamplerate
+   - speex
+   - zlib
+4. Boost requires some special stuff. We must compile with clang and libc++.
+   - edit your /opt/local/etc/macports/macports.conf
+     - add to end: default_compiler    clang
+   - sudo port edit boost
+     - change this line:
+       write_jam "using darwin : : ${configure.cxx} : <cxxflags>\"${configure.cxxflags}\" ${compileflags} <linkflags>\"${configure.ldflags}\" : ;" 
+     - to this:
+       write_jam "using darwin : : ${configure.cxx} : <cxxflags>\"${configure.cxxflags} -std=c++11 -stdlib=libc++\" ${compileflags} <linkflags>\"${configure.ldflags} -stdlib=libc++\" : ;" 
+   - if you have boost already installed in macports, remove it:
+     - sudo port uninstall boost
+   - reinstall boost from source:
+     - sudo port -s install boost
+5. Download the Mupen64Plus source code:
+   - Open terminal window, create build directory for Mupen64Plus
+   - Download and unpack the latest m64p_helper_scripts.tar.gz from: https://code.google.com/p/mupen64plus/wiki/CompilingFromHg
+   - run ./m64p_get.sh
+6. Hack your ui-console makefile to build against SDLMain.m_o:
+   - edit source/mupen64plus-ui-console/projects/unix/Makefile
+     - change line:
+       CFLAGS += $(SDL_CFLAGS)
+     - to:
+       CFLAGS += $(SDL_CFLAGS) ~/devel-lite/SDLMain.m_o -framework Cocoa
+7. Hack your m64p_build.sh script to build under OSX:
+   - change line:
+     "$MAKE" -C source/mupen64plus-${component}/projects/unix all $@
+   - to:
+      if [ "${component}" = "ui-console" ]; then
+          "$MAKE" -C source/mupen64plus-${component}/projects/unix all -j4 V=1 CC=clang CXX=clang++ OSX_SDK=10.7 SDL_CFLAGS="-I/opt/local/include -D__APPLE__ -I/Library/Frameworks/SDL.framework/Headers" SDL_LDLIBS="-F/Library/Frameworks -framework SDL -framework Foundation" OPTFLAGS="-O3" LDFLAGS="-Wl,-rpath -Wl,@executable_path/../Frameworks"
+      else
+          "$MAKE" -C source/mupen64plus-${component}/projects/unix all -j4 V=1 CC=clang CXX=clang++ OSX_SDK=10.7 SDL_CFLAGS="-I/opt/local/include -D__APPLE__ -I/Library/Frameworks/SDL.framework/Headers" SDL_LDLIBS="-F/Library/Frameworks -framework SDL -framework Foundation" OPTFLAGS="-O3"
+      fi
+8. Build it
+   - copy osx_build_bundle.sh from source/mupen64plus-core/tools to current directory
+   - run ./osx_build_bundle.sh