From 783b99f3e730660e52c184a23f257f738e52ba95 Mon Sep 17 00:00:00 2001
From: Ihar Hubchyk <ihar.hubchyk@gmail.com>
Date: Wed, 10 Dec 2025 11:49:38 +0800
Subject: [PATCH] Fix multiple iOS issues and add iOS compilation (#10426)

---
 .github/workflows/ios.yml                     |  36 ++++++++
 .github/workflows/pull_request.yml            |   5 ++
 .gitignore                                    |   4 +
 docs/DEVELOPMENT.md                           |   9 +-
 .../AppIcon.appiconset/Contents.json          |   3 +-
 .../AppIcon.appiconset/icon.jpg               | Bin 0 -> 24791 bytes
 ios/fheroes2.xcodeproj/project.pbxproj        |  12 +--
 script/ios/README.md                          |   3 +
 script/ios/install_packages.sh                |  82 ++++++++++++++++++
 src/engine/system.cpp                         |  10 +--
 src/fheroes2/gui/interface_events.cpp         |   8 +-
 11 files changed, 151 insertions(+), 21 deletions(-)
 create mode 100644 .github/workflows/ios.yml
 create mode 100644 ios/Assets.xcassets/AppIcon.appiconset/icon.jpg
 create mode 100644 script/ios/README.md
 create mode 100755 script/ios/install_packages.sh

diff --git a/.github/workflows/ios.yml b/.github/workflows/ios.yml
new file mode 100644
index 000000000..0726d2681
--- /dev/null
+++ b/.github/workflows/ios.yml
@@ -0,0 +1,36 @@
+name: iOS
+
+on:
+  workflow_call:
+
+permissions:
+  contents: write
+
+jobs:
+  ios:
+    name: iOS
+    runs-on: macos-latest
+    timeout-minutes: 30
+    steps:
+    - uses: actions/checkout@v6
+    - name: check Xcode version
+      run: |
+        /usr/bin/xcodebuild -version
+    - name: Install dependencies
+      run: |
+        ./script/ios/install_packages.sh
+    # TODO: remove this step once we figure out how to build without the need of resources.
+    - name: Prepare build
+      run: |
+        mkdir anim
+        mkdir data
+        mkdir music
+    - name: Build
+      # TODO: compile for a proper target, not for simulator.
+      run: |
+        cd ios
+        xcodebuild -project fheroes2.xcodeproj \
+          -scheme fheroes2 \
+          -destination 'platform=iOS Simulator,name=iPhone 16' \
+          build
+    # TODO: add signing stage.
diff --git a/.github/workflows/pull_request.yml b/.github/workflows/pull_request.yml
index 9e595ce6c..052b07ffc 100644
--- a/.github/workflows/pull_request.yml
+++ b/.github/workflows/pull_request.yml
@@ -98,3 +98,8 @@ jobs:
     needs:
     - msvc
     uses: ./.github/workflows/make.yml
+  ios:
+    name: iOS
+    needs:
+    - msvc
+    uses: ./.github/workflows/ios.yml
diff --git a/.gitignore b/.gitignore
index 85e88bb21..e96930005 100644
--- a/.gitignore
+++ b/.gitignore
@@ -98,6 +98,10 @@ android/app/src/main/assets/
 ios/*/xcuserdata
 ios/**/xcuserdata
 
+# Third-party packages for XCode
+ios/SDL2/
+ios/SDL2_mixer/
+
 # Mac magic folders
 .DS_Store
 
diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index d501472f4..5c65e6681 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -39,15 +39,8 @@ Please follow the instructions below to be able to build the project from source
 
 * To build this build you need to have the necessary Data, Anim, Maps and Music folders for the engine present in the fheroes2 project's folder.
 * Download and install Xcode on your macos device. Download the iOS SDK during installation.
+* Go to the directory `script/ios` and run the file `install_packages.sh`. This script will install all the required packages to build the project using Xcode.
 * Open `fheroes2.xcodeproj` in the "iOS" folder".
-* Download SDL2 and SDL_mixer source codes from their GitHub repositories's release pages. Make sure you get SDL2 and not SDL3.
-* Paste the SDL2 and SDL_mixer folders in the same parent directory as your fheroes2 source folder. This means that next to the folder containing
-your fheroes2 local clone, you will have the two SDL folders.
-* Remove any version number from the name of the SDL2 and SDL_mixer folder so that their names are respectively `SDL` and `SDL_mixer`.
-* In Xcode SDL and SDL_mixer should now be recognized in the Navigator area, recognized by them not having read names. Open on `SDL_mixer` in the Navigator on the left side.
-* Click "fheroes2" in the Navigator area on the left side of Xcode.
-* In the right side Editor area select "fheroes2" under "Project". Open the `Build Settings` tab. Make sure to set `All` options and scroll down to `Search Paths`.
-* Open up the `User Header Search Paths` and add `$(SRCROOT)/../../SDL/include` to the list of paths.
 * In the Editor area select "fheroes2" under the "Targets" menu instead of "Projects". Open the "Signing & Capabilities" tab. Under "Signing", add your AppleID in
 the "Team" field.
 * Connect your iOS device to your mac device with the necessary cable. Select the device in the devices in Xcode's upper Toolbar.
diff --git a/ios/Assets.xcassets/AppIcon.appiconset/Contents.json b/ios/Assets.xcassets/AppIcon.appiconset/Contents.json
index 13613e3ee..d6c51b6c6 100644
--- a/ios/Assets.xcassets/AppIcon.appiconset/Contents.json
+++ b/ios/Assets.xcassets/AppIcon.appiconset/Contents.json
@@ -1,9 +1,10 @@
 {
   "images" : [
     {
+      "filename" : "icon.jpg",
       "idiom" : "universal",
       "platform" : "ios",
-      "size" : "1024x1024"
+      "size" : "256x256"
     }
   ],
   "info" : {
diff --git a/ios/Assets.xcassets/AppIcon.appiconset/icon.jpg b/ios/Assets.xcassets/AppIcon.appiconset/icon.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e060ee19bd2445fe55fc2d1c3a4e2e5ae8ef3981
GIT binary patch
literal 24791
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
Jr=g$^|Jjo<AOQdX

literal 0
HcmV?d00001

diff --git a/ios/fheroes2.xcodeproj/project.pbxproj b/ios/fheroes2.xcodeproj/project.pbxproj
index c1cc4ce58..e630965c0 100644
--- a/ios/fheroes2.xcodeproj/project.pbxproj
+++ b/ios/fheroes2.xcodeproj/project.pbxproj
@@ -157,9 +157,9 @@
 		EA54669E29FE02FF00A9D8B2 /* Shaders.metal */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.metal; path = Shaders.metal; sourceTree = "<group>"; };
 		EA5466A329FE02FF00A9D8B2 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
 		EA5466A629FE02FF00A9D8B2 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
-		EA67D2A229FE04380004F40F /* SDL.xcodeproj */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.pb-project"; name = SDL.xcodeproj; path = ../../SDL/Xcode/SDL/SDL.xcodeproj; sourceTree = "<group>"; };
+		EA67D2A229FE04380004F40F /* SDL.xcodeproj */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.pb-project"; name = SDL.xcodeproj; path = SDL2/Xcode/SDL/SDL.xcodeproj; sourceTree = "<group>"; };
 		EA67D2CB29FE05030004F40F /* SDL_uikit_main.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = SDL_uikit_main.c; sourceTree = "<group>"; };
-		EA67D5DE29FE0B350004F40F /* SDL_mixer.xcodeproj */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.pb-project"; name = SDL_mixer.xcodeproj; path = ../../SDL_mixer/Xcode/SDL_mixer.xcodeproj; sourceTree = "<group>"; };
+		EA67D5DE29FE0B350004F40F /* SDL_mixer.xcodeproj */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.pb-project"; name = SDL_mixer.xcodeproj; path = SDL2_mixer/Xcode/SDL_mixer.xcodeproj; sourceTree = "<group>"; };
 		EA67D5F229FE0C8C0004F40F /* libz.tbd */ = {isa = PBXFileReference; lastKnownFileType = "sourcecode.text-based-dylib-definition"; name = libz.tbd; path = usr/lib/libz.tbd; sourceTree = SDKROOT; };
 		EA67D60129FE186F0004F40F /* CoreFoundation.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = CoreFoundation.framework; path = System/Library/Frameworks/CoreFoundation.framework; sourceTree = SDKROOT; };
 /* End PBXFileReference section */
@@ -669,9 +669,9 @@
 				SWIFT_OBJC_BRIDGING_HEADER = ShaderTypes.h;
 				SWIFT_VERSION = 5.0;
 				SYSTEM_HEADER_SEARCH_PATHS = (
-					"\"$(SRCROOT)/../../SDL/include\"",
+					"\"$(SRCROOT)/SDL2/include\"",
 					"\"$(SRCROOT)/../src\"/**",
-					"\"$(SRCROOT)/../../SDL_mixer/include\"/**",
+					"\"$(SRCROOT)/SDL2_mixer/include\"/**",
 				);
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
@@ -705,9 +705,9 @@
 				SWIFT_OBJC_BRIDGING_HEADER = ShaderTypes.h;
 				SWIFT_VERSION = 5.0;
 				SYSTEM_HEADER_SEARCH_PATHS = (
-					"\"$(SRCROOT)/../../SDL/include\"",
+					"\"$(SRCROOT)/SDL2/include\"",
 					"\"$(SRCROOT)/../src\"/**",
-					"\"$(SRCROOT)/../../SDL_mixer/include\"/**",
+					"\"$(SRCROOT)/SDL2_mixer/include\"/**",
 				);
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
diff --git a/script/ios/README.md b/script/ios/README.md
new file mode 100644
index 000000000..0683bf5d9
--- /dev/null
+++ b/script/ios/README.md
@@ -0,0 +1,3 @@
+# Package installation for XCode
+
+Run the `install_packages.sh` and it will try to install everything at once.
diff --git a/script/ios/install_packages.sh b/script/ios/install_packages.sh
new file mode 100755
index 000000000..d741a45e2
--- /dev/null
+++ b/script/ios/install_packages.sh
@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+
+###########################################################################
+#   fheroes2: https://github.com/ihhub/fheroes2                           #
+#   Copyright (C) 2025                                                    #
+#                                                                         #
+#   This program is free software; you can redistribute it and/or modify  #
+#   it under the terms of the GNU General Public License as published by  #
+#   the Free Software Foundation; either version 2 of the License, or     #
+#   (at your option) any later version.                                   #
+#                                                                         #
+#   This program is distributed in the hope that it will be useful,       #
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of        #
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         #
+#   GNU General Public License for more details.                          #
+#                                                                         #
+#   You should have received a copy of the GNU General Public License     #
+#   along with this program; if not, write to the                         #
+#   Free Software Foundation, Inc.,                                       #
+#   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             #
+###########################################################################
+
+set -e -o pipefail
+
+# We might need to move packages into https://github.com/fheroes2/fheroes2-prebuilt-deps
+# repository as we did for other packages.
+PKG_NAME="release-2.32.10"
+PKG_FILE="$PKG_NAME.zip"
+PKG_FILE_SHA256="7a3c207b8509edc487d658df357ad764cd852d68fe248d307b25c0741d52fdf0"
+PKG_URL="https://github.com/libsdl-org/SDL/archive/refs/tags/$PKG_FILE"
+
+TMP_DIR="$(mktemp -d)"
+
+if [[ -n "$(command -v wget)" ]]; then
+    wget -O "$TMP_DIR/$PKG_FILE" "$PKG_URL"
+elif [[ -n "$(command -v curl)" ]]; then
+    curl -o "$TMP_DIR/$PKG_FILE" -L "$PKG_URL"
+else
+    echo "Neither wget nor curl were found in your system. Unable to download the package archive. Installation aborted."
+    exit 1
+fi
+
+echo "$PKG_FILE_SHA256 *$PKG_FILE" > "$TMP_DIR/checksums"
+
+if [[ -n "$(command -v shasum)" ]]; then
+    (cd "$TMP_DIR" && shasum --check --algorithm 256 checksums)
+elif [[ -n "$(command -v sha256sum)" ]]; then
+    (cd "$TMP_DIR" && sha256sum --check --strict checksums)
+else
+    echo "Neither shasum nor sha256sum were found in your system. Unable to verify the downloaded file. Installation aborted."
+    exit 1
+fi
+
+unzip -d "$(dirname "$0")/../../ios" "$TMP_DIR/$PKG_FILE"
+
+mv "$(dirname "$0")/../../ios/SDL-$PKG_NAME" "$(dirname "$0")/../../ios/SDL2"
+
+PKG_NAME="release-2.8.1"
+PKG_FILE="$PKG_NAME.zip"
+PKG_FILE_SHA256="3738827df73c86268dfa52898780769d1a796316d73b535e2ab5ff2d8d0ff44f"
+PKG_URL="https://github.com/libsdl-org/SDL_mixer/archive/refs/tags/$PKG_FILE"
+
+if [[ -n "$(command -v wget)" ]]; then
+    wget -O "$TMP_DIR/$PKG_FILE" "$PKG_URL"
+elif [[ -n "$(command -v curl)" ]]; then
+    curl -o "$TMP_DIR/$PKG_FILE" -L "$PKG_URL"
+else
+    echo "Neither wget nor curl were found in your system. Unable to download the package archive. Installation aborted."
+    exit 1
+fi
+
+echo "$PKG_FILE_SHA256 *$PKG_FILE" > "$TMP_DIR/checksums"
+
+unzip -d "$(dirname "$0")/../../ios" "$TMP_DIR/$PKG_FILE"
+
+mv "$(dirname "$0")/../../ios/SDL_Mixer-$PKG_NAME" "$(dirname "$0")/../../ios/SDL2_Mixer"
+
+# Patch SDL_Mixer project.
+# It is needed since we are trying to build SDL Mixer using the latest SDL2 version.
+# Also, SDL Mixer doesn't support iPhone Simulator so we have to change this code or another one.
+sed -i '' 's#$(SRCROOT)/$(PLATFORM)/SDL2.framework/Headers#$(SRCROOT)/../../SDL2/include#' \
+    ios/SDL2_Mixer/Xcode/SDL_mixer.xcodeproj/project.pbxproj
diff --git a/src/engine/system.cpp b/src/engine/system.cpp
index c1f0f69aa..88bf718fb 100644
--- a/src/engine/system.cpp
+++ b/src/engine/system.cpp
@@ -1,6 +1,6 @@
 /***************************************************************************
  *   fheroes2: https://github.com/ihhub/fheroes2                           *
- *   Copyright (C) 2019 - 2024                                             *
+ *   Copyright (C) 2019 - 2025                                             *
  *                                                                         *
  *   Free Heroes2 Engine: http://sourceforge.net/projects/fheroes2         *
  *   Copyright (C) 2009 by Andrey Afletdinov <fheroes2@gmail.com>          *
@@ -95,7 +95,7 @@ namespace
         {
             const char * homeEnvPath = getenv( "HOME" );
 
-#if defined( MACOS_APP_BUNDLE )
+#if defined( MACOS_APP_BUNDLE ) || defined( __IPHONEOS__ )
             if ( homeEnvPath != nullptr ) {
                 return System::concatPath( System::concatPath( homeEnvPath, "Library/Preferences" ), appName );
             }
@@ -267,7 +267,7 @@ namespace
 
 bool System::isHandheldDevice()
 {
-#if defined( ANDROID )
+#if defined( ANDROID ) || defined( __IPHONEOS__ )
     return true;
 #else
     return false;
@@ -281,7 +281,7 @@ bool System::isTouchInputAvailable()
 
 bool System::isVirtualKeyboardSupported()
 {
-#if defined( ANDROID ) || defined( TARGET_PS_VITA ) || defined( TARGET_NINTENDO_SWITCH )
+#if defined( ANDROID ) || defined( TARGET_PS_VITA ) || defined( TARGET_NINTENDO_SWITCH ) || defined( __IPHONEOS__ )
     return true;
 #else
     return false;
@@ -382,7 +382,7 @@ std::string System::GetDataDirectory( const std::string_view appName )
         }
 
         return {};
-#elif defined( MACOS_APP_BUNDLE )
+#elif defined( MACOS_APP_BUNDLE ) || defined( __IPHONEOS__ )
         if ( const char * homeEnv = getenv( "HOME" ); homeEnv != nullptr ) {
             return concatPath( concatPath( homeEnv, "Library/Application Support" ), appName );
         }
diff --git a/src/fheroes2/gui/interface_events.cpp b/src/fheroes2/gui/interface_events.cpp
index 0ea8da4c0..1f67fba7f 100644
--- a/src/fheroes2/gui/interface_events.cpp
+++ b/src/fheroes2/gui/interface_events.cpp
@@ -301,8 +301,14 @@ void Interface::AdventureMap::EventSystemDialog() const
 
 fheroes2::GameMode Interface::BaseInterface::EventExit()
 {
-    if ( Dialog::YES & fheroes2::showStandardTextMessage( _( "Quit" ), _( "Are you sure you want to quit?" ), Dialog::YES | Dialog::NO ) )
+#if defined( __IPHONEOS__ )
+    // iOS discourages to exit a running application.
+    fheroes2::showStandardTextMessage( _( "Quit" ), _( "To exit fheroes2, press the Home button or swipe up." ), Dialog::OK );
+#else
+    if ( Dialog::YES & fheroes2::showStandardTextMessage( _( "Quit" ), _( "Are you sure you want to quit?" ), Dialog::YES | Dialog::NO ) ) {
         return fheroes2::GameMode::QUIT_GAME;
+    }
+#endif
 
     return fheroes2::GameMode::CANCEL;
 }