subsurface/packaging/ios
Robert C. Helling c0a4ffead8 Build instructions to deplay on you own iOS device
... so others might have less trouble.

Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
2016-04-11 12:42:59 -07:00
..
Subsurface-mobile Move subsurface-core to core and qt-mobile to mobile-widgets 2016-04-04 22:33:58 -07:00
build.sh iOS build: create Info.plist with correct version information 2016-03-23 17:26:46 -07:00
deployment.pri iOS build: add various support files 2016-03-06 11:02:48 -08:00
Info.plist.in iOS build: fix typos 2016-03-24 21:36:42 -07:00
ios_build_instructions Build instructions to deplay on you own iOS device 2016-04-11 12:42:59 -07:00
iPhoneDeviceCMakeToolchain iOS build: add various support files 2016-03-06 11:02:48 -08:00
iPhoneSimulatorCMakeToolchain iOS build: add various support files 2016-03-06 11:02:48 -08:00
README iOS build: update the README 2016-03-23 17:26:46 -07:00
SubsurfaceMobileLaunch.xib iOS build: show correct program name on launch screen 2016-03-06 19:35:37 -08:00

Tool repo to crosscompile subsurface for iOS
--------------------------------------------

This is very rough - the interaction between the different tools seems quite
fragile.

Dependencies:

- This only works on a Mac
- XCode with iOS SDK and Qt5.6
- cmake

Steps to install:

Step 1.
Install current XCode with the iOS SDK
And QT for android from: http://qt-project.org/downloads, including the iOS bits

Step 2.
Extract and install these into known directories.
Have a look in the top of build.sh for where the cross build tool expects
them. By default thats is: ../../../Qt/5.6

Step 3.
Run bash build.sh in the terminal.
The script will download and build the whole dependency chain, but not the actual
Subsurface-mobile binary

Step 4.
Launch QtCreator with the Subsurface-mobile/Subsurface-mobile.pro
Build Subsurface-mobile in QtCreator - you can build for the simulator and for
a device and even deploy to a connected device.

This will likely require an Apple Developer account ($$$). In order to create a
bundle that can be distributed things get even more complex and the interaction
between QtCreator, Xcode and the Apple Developer Portal is still quite
confusing to me.

WARNING:
========

The version number used in the Subsurface-mobile app is created in step 3.
So whenever you pull the latest git or commit a change, you need to re-run the
build.sh script so that the Info.plist used by QtCreator (well, by Xcode under
the hood) gets updated. Otherwise you will continue to see the old version
number, even though the sources have been recompiled which can be very
confusing.