Difference between revisions of "Installation on iOS"

From VCMI Project Wiki
Jump to: navigation, search
m (changed repo URL)
(Replaced content with "{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_iOS/}}")
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
You can run VCMI on iOS 10.0 and later, all devices are supported.
+
{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_iOS/}}
 
 
== Download and install VCMI ==
 
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:
 
 
 
* [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
 
* 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 ==
 
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.
 
 
 
Note: currently iOS doesn't support music in mp3 format. If you want to listen to game music, convert mp3 to ogg, e.g. with FFmpeg. Place the ogg files in the "Mp3" directory.
 
 
 
=== 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 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 = tab (activates 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