Building WME Lite from sources

• Obtain sources from Mercurial repository: https://bitbucket.org/MnemonicWME/wmelite/
• Download dependencies for Visual Studio (dep_visualc2008.zip): https://bitbucket.org/MnemonicWME/wmelite/downloads
• Unpack the dependencies to visualc\dep directory.
• Open the solution file (visualc\wmelite.sln) in Visual Studio and compile.

Provided are solution and project files for Visual Studio 2008.

• Obtain sources from Mercurial repository: https://bitbucket.org/MnemonicWME/wmelite/
• Download dependencies for XCode (dep_xcode.zip): https://bitbucket.org/MnemonicWME/wmelite/downloads
• Unpack the dependencies to xcode/dep directory.
• Copy your game package (data.dcp) to xcode/wmelite directory (note: if your game package uses a different name or if you need to use multiple .dcp files, you will have to modify the xcode project).
• Open the project file (xcode/wmelite/wmelite.xcodeproj) in XCode and compile.

• Obtain sources from Mercurial repository: https://bitbucket.org/MnemonicWME/wmelite
• Download dependencies for XCode (dep_xcode_ios.zip): https://bitbucket.org/MnemonicWME/wmelite/downloads
• Unpack the dependencies to xcode-ios/dep directory.
• Copy your game package (data.dcp) to xcode-ios/wmelite directory (note: if your game package uses a different name or if you need to use multiple .dcp files, you will have to modify the xcode project).
• Replace Default.png and IconXXX.png images in xcode-ios/wmelite with your custom graphics (Default.png isn't mandatory, you can delete it).
• Edit Info.plist and change at least the "CFBundleIdentifier" key to your company and product name (edit: in XCode 4 you can change the properties directly in XCode, no need to edit Info.plist manually).
• Open the project file (xcode-ios/wmelite/wmelite.xcodeproj) in XCode and compile.

• Note: Building wmelite is only supported for 32 bit architectures. For 64 bit you are on your own (for now).
• Obtain sources from Mercurial repository: https://bitbucket.org/MnemonicWME/wmelite
• Install libfreetype and libfreeimage (including the corresponding development packages) from your distribution's package manager.
• Obtain a SDL2.0 snapshot from here: http://www.libsdl.org/hg.php Build and install by following the instructions on the website.
• Obtain the BASS libraries from here: http://www.un4seen.com/ Put "bass.h" in /usr/local/include/bass and "libbass.so" in /usr/local/lib. Execute "ldconfig" as root.
• Go to the "linux" directory of the wmelite sources. If necessary, adapt include paths in the makefile.
• Run "make wmelite" to build wmelite executable.

• Note: ARM is currently the only supported platform. There are no BASS libraries (yet) for X86 and MIPS.

• Note: Before starting, make sure you are capable of building an Android app using one of the examples from the Android SDK.
• If not already done, install the SDK platform for Android 2.3.3 (API 10).
• Obtain sources from Mercurial repository: https://bitbucket.org/MnemonicWME/wmelite
• Download dependencies for Android (dep_android_*.zip): https://bitbucket.org/MnemonicWME/wmelite/downloads
• Unpack dependencies into the wmelite/android folder.
• Place your game files into the wmelite/android/assets/raw folder and rename them from ".dcp" to ".png". If you are going to distribute your game via the Google Play store, your game must not be bigger than 50 MB in total.
• Change the package and class name of org/example/yourapppackagename/YourGameName.java located at wmelite/android/src/ into something meaningful for your game.
• You need to change the AndroidManifest.xml as well, which is located at wmelite/android/, to reflect your changes. Edit package="org.libsdl.app" and android:name="SDLActivity" to match your changes.
• Edit res/values/strings.xml located at wmelite/android/ to fill in the name of your app.
• Modify the game package and file path to point at the asset directory. Edit org/deadcode/wmelite/WMELiteFunctions.java located at wmelite/android/ and change the return values of the getGamePackagePath() and getGameFilePath() from "/mnt/sdcard" to "asset://raw".
• If you use bitmap fonts with a different locale than "US-ASCII", fill in the proper locale in the functions getEncodedString() and getUTFString().
• Build the Android app.

• Make sure you have the Android NDK installed properly. Windows users will need to install Cygwin. The command ndk-build should be in your path.
• Obtain sources for the dependencies from Mercurial repository: https://bitbucket.org/hardcoredaniel/wmelite-dependencies-for-linux-and-android
• In the dependencies/ directory, sequentially enter the directories "FreeImage3154", "libfreetype-android" and "SDL". In each of them, call the build.sh script.
• Go to the prebuilt/ directory and call the copy_android_prebuilt_libs.sh script.
• Copy the dependencies/ and prebuilt/ directories to the place where you put the wmelite sources obtained from here: https://bitbucket.org/MnemonicWME/wmelite
• Go to the android/ directory in the wmelite sources and call the build.sh script.
• All required libraries shall be available in the wmelite/android/libs directory. You may now proceed with building the game package.