diff -r 869c787e818d -r 06b6991194d1 BuildingForIos.wiki --- a/BuildingForIos.wiki Thu Oct 10 06:07:05 2019 +0100 +++ b/BuildingForIos.wiki Thu Oct 10 06:09:55 2019 +0100 @@ -4,9 +4,9 @@ = Building on iOS = == Prerequisites == - * XCode must be installed, and you should have some skills in usig it - * We need Mercurial to grab external dependencies - * You should be familiar with the BuildingOnMac instructions + * XCode must be installed, and you should have some skills in using it + * We need Mercurial to grab external dependencies + * You should be familiar with the BuildingOnMac instructions === Necessary libraries === @@ -14,9 +14,9 @@ All hard-to-find/hard-to-build libraries are bundled in the source, while SDL and SDL satellites are to be downloaded with HG. For easier handling all libraries come with an Xcode project file so that you just can use the graphical interface to build them; remember to build both Release and Debug for all the Architectures available. - * Tremor - misc/libtremor/Xcode - is an ogg variant suited for embedded devices - * Freetype - misc/libfreetype/Xcode - is a trimmed down version of the popular font rendering library - * Lua - misc/liblua/Xcode - can also be skipped if you specify LUA_DISABLED in hedgewars config.inc file + * Tremor - `misc/libtremor/Xcode` - is an ogg variant suited for embedded devices + * Freetype - `misc/libfreetype/Xcode` - is a trimmed down version of the popular font rendering library + * Lua - `misc/liblua/Xcode` - can also be skipped if you specify `LUA_DISABLED` in Hedgewars' `config.inc` file ==== Compiling SDL for iOS ==== @@ -34,24 +34,24 @@ hg clone http://hg.libsdl.org/SDL_mixer }}} -Each library has its own iOS project file under the folder Xcode-iOS/; also here you need to build both Release and Debug for all the Architectures available. After this step remeber to update the include paths and linker information in the main Xcode project file. +Each library has its own iOS project file under the folder Xcode-iOS/; also here you need to build both Release and Debug for all the architectures available. After this step remeber to update the include paths and linker information in the main Xcode project file. === Necessary tools === Besides the iOS SDK, you need a special variant of Freepascal to build the engine as well as the standard Freepascal compiler. So let's download and install (in order): - * [http://sourceforge.net/projects/freepascal/files/Mac%20OS%20X/2.6.0/fpc-2.6.0.intel-macosx.dmg/download fpc-intel-macosx] - * [http://sourceforge.net/projects/freepascal/files/Mac%20OS%20X/2.6.0/fpc-2.6.0.arm-ios.dmg/download fpc-arm-ios] + * [http://sourceforge.net/projects/freepascal/files/Mac%20OS%20X/2.6.0/fpc-2.6.0.intel-macosx.dmg/download fpc-intel-macosx] + * [http://sourceforge.net/projects/freepascal/files/Mac%20OS%20X/2.6.0/fpc-2.6.0.arm-ios.dmg/download fpc-arm-ios] -The latter one will run a script on its own, let it finish and if no errors are reported, your system is ready! If you get stuck anywhere, luckily there is a full documentation about this process on the [http://wiki.lazarus.freepascal.org/iPhone/iPod_development Freepascal Wiki] +The latter one will run a script on its own, let it finish and if no errors are reported, your system is ready! If you get stuck anywhere, luckily there is a full documentation about this process on the [http://wiki.lazarus.freepascal.org/iPhone/iPod_development FreePascal Wiki]. == Building process == And now we should be able to finally open the main Hedgewars.xcodeproj file! There are yet two steps before getting a working build. - # select the target UpdateDataFolder and hit 'build' (not 'build and run') so the the resources folder gets filled with data; you should do this periodically or when there is new content in the share/hedgewars/Data folder - # set the proper linking path of all the libries maked in red; the bundled ones should have a correct path, while you need to tell Xcode where are SDL static libraries. In order to do that I suggest that you right click on a red library, press "Get Info", in the "Path" line press 'Choose' and locate the correct xcodeproj file. Luckily this step is done only once. + # select the target `UpdateDataFolder` and hit 'build' (not 'build and run') so the the resources folder gets filled with data; you should do this periodically or when there is new content in the `share/hedgewars/Data` folder + # set the proper linking path of all the libries maked in red; the bundled ones should have a correct path, while you need to tell Xcode where are SDL static libraries. In order to do that I suggest that you right click on a red library, press "Get Info", in the "Path" line press 'Choose' and locate the correct xcodeproj file. Luckily this step is done only once. -You should be done by now! Hit "Build and Run" and the iOS Simulator should run! Note that for a bug in Freepascal Debug works only on the Simulator, while Release only for Device. +You should be done by now! Hit "Build and Run" and the iOS Simulator should run! Note that for a bug in !FreePascal, `Debug` works only on the Simulator, while `Release` only for Device. Enjoy!