ios/README

   1 Somewhat obsolete README for the LibreOfficeLight iOS app and LibreOfficeKit.
   2
   3 -- LibreOfficeLight
   4 a swift based UI, very much work in progress
   5
   6 -- support
   7 the arm64 and simulator are the only supported processors,
   8 old 32 bit iPhones are not supported.
   9
  10 The swift app are done for 3 structures
  11   simulator + full debug libraries
  12   arm64 + full debug libraries
  13   arm64 + optimized libraries
  14
  15 -- SETUP
  16 Due to the 3 modes, at least 3 workdirs are needed together with a
  17 separated UI workdir.
  18
  19 Because the main work is done on the UI, where it is convenient to
  20 switch fast between arm64 and simulator, it is advantageous to compile
  21 the 3 configurations of LO first, and then link against those.
  22
  23 Due to the multiple workdirs a separate work directories are needed as follows:
  24 (names/locations can be changes, they are "linked" together by running autogen.sh)
  25    ./core - libreoffice git clone (name can be changed)
  26    ./ios-arm64 - workdir for production
  27    ./ios-arm64-debug - workdir for debug on device
  28    ./ios-simulator - workdir for simulator-debug
  29
  30 -- Steps to generate
  31 1) copy ./core/distro-configs/LibreOfficeiOS.conf to autogen.input in
  32    ./ios-arm64, ./ios-arm64-debug, ./ios-simulator
  33    Correct as defined in the conf file,
  34    add your local setup (e.g. location of tarballs)
  35 2) run ../core/autogen.sh in ios-arm64, ios-arm64-debug and ios-simulator
  36 3) run make in ios-arm64, ios-arm64-debug and ios-simulator
  37    this will generate core/loApp.xcconfig which prepares LO to be compiled
  38    and build LOkit is 3 configurations and store the preparedLibreOfficeKit
  39    in ./core/ios/generated as:
  40            release/libKit.a
  41            release/libKit.dylib
  42            debug/libKit.a
  43            debug/libKit.dylib
  44            simulator/libKit.a
  45            simulator/libKit.dylib
  46 5) open xcode with LibreOfficeLight select scheme and build/test/run.
  47 6) enjoy
  48
  49