arch/all-ios/README.txt

   1  1. INTRODUCTION.
   2
   3  This is TOTALLY EXPERIMENTAL start of Apple iOS-hosted port of AROS.
   4 Bootstrap builds and works for both targets (Simulator and Device). Workbench and hosted strap
   5 build okay for simulator. I haven't tried to build them for device because of missing ARM CPU
   6 support in AROS.
   7  Things to do (in the order of increasing complexity):
   8  1. Complete Darwin-hosted port (untie kickstart from static linking, use hostlib.resource for
   9     access to host OS functions instead) and build the board support package.
  10  2. Implement ARM CPU support (write ARM atomic operations)
  11  3. Implement Cocoa display driver.
  12  After completion of these two tasks we'll get AROS running hosted on all Apple devices.
  13
  14  2. COMPILING.
  15
  16  In order to compile iOS-hosted AROS you currently need Apple XCode with iOS SDK. This assumes you
  17 are running on Mac. Cross-compiling of the port seems to be possible using source code of Darwin tools,
  18 but i haven't tried it yet.
  19  The following iOS-specific options are added to configure for supporting this build:
  20  --with-xcode       - specifies where XCode is located on your machine. Default is /Developer (this is where
  21                       XCode v3.2.4 installed itself by default on my machine)
  22  --with-ios-version - specifies minimum supported iOS version, defaults to 2.0. Actually this value is supplied
  23                       to gcc via -miphoneos-version-min and nothing else.
  24  --with-ios-sdk     - specifies iOS SDK version to use. Defaults to 4.1 (the latest SDK available with my XCode).
  25                       Actually this value sets the SDK's root directory (used for locating headers and libraries) in the form of:
  26                       $aros_xcode_path/Platforms/$aros_ios_platform.platform/Developer/SDKs/$aros_ios_platform$aros_ios_sdk.sdk
  27                       where:
  28                         $aros_xcode_path   - what is supplied by --with-xcode
  29                         $aros_ios_platform - "iPhoneSimulator" for ios-i386 target and "iPhoneOS" for ios-arm target
  30                         $aros_ios_sdk      - what is supplied by --with-ios-sdk
  31
  32  The bootstrap expects to locate AROS root directory inside Documents directory of its sandbox (i.e. Documents/AROS). The root does
  33 not have to contain the bootstrap itself.
  34
  35  3. RUNNING.
  36
  37  Simulator version runs without problems. Device version is of course not signed, it runs only on jailbroken machines. There is
  38 some support for creating signed version, but because of proprietary nature of the thing i won't describe it here. In fact it's very
  39 easy to discover how to create a signed bundle, just read the mmakefile.src and accompanying shell scripts. Of course you need a
  40 developer certificate and provisioning profile for this. I use my company's test profile and it works. However i would not expect
  41 that Apple would ever permit to release such an application in their AppStore, so code signing is a purely experimental feature,
  42 written as part of my company's research project.
  43
  44                                                                         Pavel Fedin <pavel_fedin@mail.ru>