Difference between revisions of "Installation on iOS"

From VCMI Project Wiki
Jump to: navigation, search
(Replaced content with "{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_iOS/}}")
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
You can run VCMI on iOS 12.0 and later, all devices are supported. If you wish to run on iOS 10 or 11, you should build from source, see [[How to build VCMI (iOS)]].
+
{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_iOS/}}
 
 
== Download and install VCMI ==
 
 
 
The latest release (recommended): https://github.com/vcmi/vcmi/releases/latest
 
 
 
Daily builds: https://builds.vcmi.download/branch/develop/iOS/
 
 
 
To run on a non-jailbroken device you need to sign the IPA file, you have the following options:
 
 
 
* ''[Easiest way]'' [https://altstore.io/ AltStore] or [https://sideloadly.io/ Sideloadly] - can be installed on Windows or macOS, don't require dealing with signing on your own
 
* if you're on iOS 14.0-15.4.1, you can try https://github.com/opa334/TrollStore
 
* Get signer tool [https://dantheman827.github.io/ios-app-signer/ here] and a guide [https://forum.kodi.tv/showthread.php?tid=245978 here] (it's for Kodi, but the logic is the same). Signing with this app can only be done on macOS.
 
* [https://github.com/kambala-decapitator/xcode-auto-signing-assets Create signing assets on macOS from terminal]. In the command replace <code>your.bundle.id</code> with something like <code>com.MY-NAME.vcmi</code>. After that use the above signer tool.
 
* [https://github.com/indygreg/PyOxidizer/tree/main/apple-codesign Sign from any OS]. You'd still need to find a way to create signing assets (private key and provisioning profile) though.
 
 
 
== Installing Heroes III data files ==
 
 
 
''Note: if you don't need in-game videos, you can omit downloading/copying file VIDEO.VID from data folder - it will save your time and space. The same applies to the Mp3 directory.''
 
 
 
=== Installing data files with Finder or Windows explorer ===
 
 
 
To play the game, you need to upload HoMM3 data files - '''Data''', '''Maps''' and '''Mp3''' directories - to the device. Use Finder (or iTunes, if you're on Windows or your macOS is 10.14 or earlier) for that. You can also add various [https://wiki.vcmi.eu/Mod_list mods] by uploading '''Mods''' directory. Follow [https://support.apple.com/en-us/HT210598 official Apple guide] and place files into VCMI app. Unfortunately, Finder doesn't display copy progress, give it about 10 minutes to finish.
 
 
 
=== Installing data files using iOS device only ===
 
 
 
If you have data somewhere on device or in shared folder or you have downloaded it, you can copy it directly on your iPhone/iPad using Files application.
 
 
 
Just move/copy '''Data''', '''Maps''' and '''Mp3''' folders into vcmi application - it will be visible in Files along with other applications' folders.
 
 
 
=== Installing data files with Xcode on macOS ===
 
You can also upload files with Xcode. You need to prepare "container" for that.
 
 
 
# Connect your device to your Mac
 
# Start Xcode
 
# Open Devices and Simulators window: Cmd+Shift+2 or Menu - Window - Devices and Simulators
 
# Select your device
 
# Select VCMI
 
# In the bottom find "three dots" or "cogwheel" button (it should be next to + - buttons) - click it - select Download Container...
 
# Place the game directories inside the downloaded container - AppData - Documents
 
# Click the "three dots" / "cogwheel" button in Xcode again - Replace Container... - select the downloaded container
 
# Wait until Xcode finishes copying, progress is visible (although it might be "indefinite")
 
 
 
== Game controls ==
 
* Tap = left click
 
* Tap and hold (long press) = right click
 
* Pinch with 2 fingers = spacebar (visit current object)
 
* Tap in the bottom area (status bar) to activate chat/console in the game
 
 
 
You can start game directly (avoiding the launcher) by changing setting in iOS Settings app - VCMI.
 
 
 
== Reporting bugs ==
 
* Please report about gameplay problem on forums: [https://forum.vcmi.eu/c/international-board/help-bugs Help & Bugs]
 
* Please report iOS-specific issues in [https://forum.vcmi.eu/t/ios-port/820 this forum thread] or (better) at [https://github.com/vcmi/vcmi/issues GitHub] with '''iOS''' label
 

Latest revision as of 16:15, 16 July 2024

Logo256.png    Page moved to VCMI-Homepage