|
|
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/tugger-code-signing 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
| |
− | * before v1.3: 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
| |