aboutsummaryrefslogtreecommitdiff
path: root/backends/platform/iphone
diff options
context:
space:
mode:
authorVincent Bénony2015-12-02 18:07:57 +0100
committerVincent Bénony2016-01-06 16:17:31 +0100
commit5bea2b416dd483ed64c3901d5aebe1b39fa382e8 (patch)
tree695a4d195939737847c7aa6a771e3b43786f1754 /backends/platform/iphone
parentad98d038933904eafd0783d5a34e615f2218f255 (diff)
downloadscummvm-rg350-5bea2b416dd483ed64c3901d5aebe1b39fa382e8.tar.gz
scummvm-rg350-5bea2b416dd483ed64c3901d5aebe1b39fa382e8.tar.bz2
scummvm-rg350-5bea2b416dd483ed64c3901d5aebe1b39fa382e8.zip
IOS: Moves the compilation instructions in the platform directory
Diffstat (limited to 'backends/platform/iphone')
-rw-r--r--backends/platform/iphone/README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/backends/platform/iphone/README.md b/backends/platform/iphone/README.md
new file mode 100644
index 0000000000..5b558dc5a6
--- /dev/null
+++ b/backends/platform/iphone/README.md
@@ -0,0 +1,48 @@
+# ScummVM for iOS 9 #
+
+This is a quick fix of the latest ScummVM (1.8.0) for iOS 9. It has been tested on real iPhone 6S+, and iPad Pro, and also on all the available Xcode simulators.
+
+I tried to use all the latest iOS features to replace the old code. For instance, it uses gesture recognizers most of the time, it supports the new iPhones 6 / 6+ / 6s / 6s+ resolution, and you can copy your game files using iTunes.
+
+## Compilation ##
+
+First, clone the repository:
+```
+$ git clone -b ios-fix --recursive https://github.com/bSr43/scummvm.git
+```
+
+The next step is to compile the **create_project** tool. Open the Xcode project you'll found in the **devtools/create\_project/xcode/** directory. Once compiled, copy the binary somewhere in your *PATH*, and create a **build** directory somewhere on your harddisk. It is recommended to create this directory next to the cloned repository (they share the same parent).
+
+Execute the following commands in a terminal:
+```
+$ cd path_to_the_build_directory
+$ create_project path_to_scummvm_repository --xcode --disable-mad --disable-jpeg --disable-bink --disable-scalers --disable-hqscalers --disable-16bit --disable-mt32emu --disable-nasm --disable-opengl --disable-theora --disable-taskbar
+```
+
+This will create an Xcode project for ScummVM, for both the OS X, and the iOS target.
+
+Now, download the external libraries from http://bsr43.free.fr/scummvm/ScummVM-iOS-libraries.zip. Unzip the archive in your **build** directory. Please make sure that the **lib**, and **include** directories are at the root of the **build** directory, not in a subdirectory.
+
+Now, your **build** directory should contain:
+* a generated **engines** directory,
+* a generated **scummvm.xcodeproj** project,
+* an **include** directory,
+* a **lib** directory.
+
+You are ready to compile ScummVM: open the **scummvm.xcodeproj** project, and build it.
+
+## Usage ##
+
+The game data files can be copied on the iOS device using iTunes. Once done, add your games in ScummVM as usual.
+
+Here is a list of the in-game gestures:
+
+|Gesture|Description|
+|-------|-----------|
+|Two fingers swipe down|Display the ScummVM menu for loading, saving, etc.|
+|Two fingers swipe right|Enable / disable the touchpad mode|
+|Two fingers swipe up|Enable / disable the mouse-click-and-drag mode|
+|Two fingers tap|Simulate a right click. You should tap with one finger, and then tap with another while keeping your first finger on the screen.|
+|Two fingers double-tap|Skip the cinematic / video|
+
+The iOS keyboard is visible when the device is in portrait mode, and hidden in landscape mode.