lqml/readme-prepare-ios.md

Define environment variable and alias

Put this in e.g. ~/.profile:

  export ECL_IOS='<path-to-cross-compiled-ecl>/ecl-ios'

  alias qmake-ios='<path-to-qt5.15>/ios/bin/qmake'

(Use source ~/.profile to make new environment variables take effect immediately in your current terminal session.)

Build cross-compiled ECL for iOS

As of May 2023, please use latest ECL from development branch.

Important: pay attention to file src/c/unixsys.d, function si_system(). Function system() inside of it needs to work when running the script 1, and needs not to be there when running script 2.

Different ECL versions handle this problem differently, but none of them worked for me, so you need to find a hack for yourself for achieving the above.

• extract a fresh copy of the ECL sources in e.g. ~/ecl, and rename ecl-21.2.1 to ios
• copy the 2 scripts from platforms/ios/build-ecl/ to ~/ecl/ios/
• run first script

  ./1-make-ecl-host.sh

Edit src/c/threads/process.d, search for pthread_attr_init (around line 588) and add the following below that line (iOS has quite limited stack size, but at least we provide double the stack size for threads):

  pthread_attr_setstacksize(&pthreadattr, 2 * 236 * 4096); // double default size

• run second script

  ./2-make-ecl-ios.sh

Now you should have your cross-compiled ECL under ~/ecl/ios/ecl-ios/, and your host ECL (for cross-compiling) under ~/ecl/ios/ecl-ios-host/.

Build for iOS Simulator (optional)

Note: only tested on Intel.

For this to work, you will need to upgrade your gmp library to the latest version (tested with gmp 6.2.1). Just substitute it in src/gmp/:

• download gmp

• extract it with tar -xvf gmp-6.2.1.tar.xz and replace the version in src/gmp/

• run second script again, passing sim

  ./2-make-ecl-ios.sh sim

This will first compile for the simulator, then combine both versions to universal binaries.