view doc/README.iOS @ 533:71c884e610f0

- integration of patches from Raphael Luba, Thekla, Inc.: * integration of aggregate-by-value (struct, union) support patch for x64 (win and sysv) * windows/x64 asm additions to specify how stack unwinds (help for debuggers, exception handling, etc.) * see Changelog for details - new calling convention modes for thiscalls (platform agnostic, was specific before) * new signature character for platform agnostic thiscalls ('*' / DC_SIGCHAR_CC_THISCALL) - dcCallF(), dcVCallF(), dcArgF() and dcVArgF(): * added support for aggregates-by-value (wasn't part of patch) * change that those functions don't implicitly call dcReset() anymore, which was unflexible (breaking change) - added macros to feature test implementation for aggregate-by-value and syscall support - changed libdyncall_s.lib and libdyncallback_s.lib order in callback test makefiles, as some toolchains are picky about order - doc: * man page updates to describe aggregate interface * manual overview changes to highlight platforms with aggregate-by-value support - test/plain: replaced tests w/ old/stale sctruct interface with new aggregate one
author Tassilo Philipp
date Thu, 21 Apr 2022 13:35:47 +0200
parents 3e629dc19168
children
line wrap: on
line source

Building DynCall for apple's iOS platforms (iPhone, iPod touch, iPad)
=====================================================================


Environment Setup for Cross-Compilation using iPhone SDK:

  $ source ./buildsys/scripts/setenv-sdk-ios.sh


Package Configuration

  $ ./configure --target=iOS --sdk=<MAJOR>.<MINOR>


Building

  $ make 
  


Details:

This builds by default universal binaries (armv7,arm64).

Required configure switches:

  --target=[iOS|iPhoneSimulator]
  
  --sdk=<version> (tested versions 2.0..4.0, 6.1, 8.3)


Supported Tool-chains

  gcc, clang





Other ways to build
-------------------

Building directly with Makefile.embedded ..

  ARMv7 for iOS 6.1

  $ make -f Makefile.embedded ios61-os
  $ cd test && make -f Makefile.embedded ios61-os

  ARMv7 (no thumb) for iOS 6.1

  $ make -f Makefile.embedded ios61-os-nothumb
  $ cd test && make -f Makefile.embedded ios61-os-nothumb

  Simulator for iOS 6.1

  $ make -f Makefile.embedded ios61-sim
  $ cd test && make -f Makefile.embedded ios61-sim

  ARMv7/ARM64 Universal build for iOS 8.3

  $ make -f Makefile.embedded ios83-os-universal
  $ cd test && make -f Makefile.embedded ios83-os-universal

  Tested Mac OS X platforms: 10.[7,8,10]
  Tested Xcode toolchains: 4.6, 6.3


Building directly with Makefile.generic ..

  $ source buildsys/scripts/setenv-sdk-ios.sh
  $ source buildsys/scripts/setenv-cross-ios.sh

  make -f Makefile.generic ...

  uses armv6 and sdk 4.3 as default, can be changed in 'setenv-cross-ios.sh'.