src/adium/README.Adium

   1 Compiling SIPE plugin for Adium
   2 ===============================
   3
   4 To compile the Adium plugin you will need Xcode and the source code from
   5 the following URLs:
   6
   7 - Adium 1.5+:      http://trac.adium.im/wiki/GettingNewestAdiumSource
   8 - OpenSSL 0.9.8za: https://www.openssl.org/source/old/0.9.x/openssl-0.9.8za.tar.gz
   9 - SIPE:            http://sourceforge.net/projects/sipe/files/sipe/
  10
  11
  12 1. Get Adium
  13 ------------
  14
  15 NOTE: you only have to do this step once. If you don't change the Adium
  16       source code, then you can reuse the results from this step in future
  17       SIPEAdiumPlugin builds.
  18
  19 Follow the instructions at their URL above.
  20
  21 The directory needs to be called "adium" and must be located at the same
  22 level as the SIPE source code directory.
  23
  24
  25 2. Get OpenSSL
  26 --------------
  27
  28 NOTE: you only have to do this step once. If you don't change the OpenSSL
  29       source code, then you can reuse the results from this step in future
  30       SIPEAdiumPlugin builds.
  31
  32 Execute the following commands in the Terminal application to download and
  33 unpack the source code:
  34
  35     $ cd my_working_directory
  36     $ curl -o openssl-0.9.8za.tar.gz https://www.openssl.org/source/old/0.9.x/openssl-0.9.8za.tar.gz
  37     $ tar -xf openssl-0.9.8za.tar.gz
  38
  39 The directory needs to be called "openssl-0.9.8za" and must be located at
  40 the same level as the SIPE source code directory.
  41
  42
  43 3. Build the SIPEAdiumPlugin Xcode project
  44 ------------------------------------------
  45
  46 In Xcode go to the Menu File -> Open..., browse to the location of your SIPE
  47 source tree, go into the src/adium directory, select SIPEAdiumPlugin.xcodeproj
  48 and press "Open".
  49
  50 NOTE: please always make sure that the correct scheme has been selected by
  51       selecting the menu Product -> Scheme -> SIPEAdiumPlugin. Otherwise you
  52       will get cryptic build failures.
  53
  54 Now you can just select Product -> Build and after a short while you should
  55 get a SIPEAdiumPlugin binary that you can install into your Adium application.
  56
  57 NOTE: You can't use Xcode 9 (or newer) targeting SDK 10.13 (or newer), because
  58       the SDK doesn't have the linker libraries for OpenSSL 0.9.8.
  59
  60
  61 4. Build SIPEAdiumPlugin for an older Max OS X release
  62 ------------------------------------------------------
  63
  64 If your Xcode does not have the SDK for the older Mac OS X release then please
  65 see
  66
  67     https://github.com/devernay/xcodelegacy
  68
  69 how to extract & install SDKs for
  70
  71     - OS X 10.9 & 10.10 from the Xcode 6.4 installation package
  72     - OS X 10.11 from the Xcode 7.3.1 installation package
  73
  74 Installing all SDKs in one go seems to break Xcode builds, so please make sure
  75 to install each SDK separately with
  76
  77     $ sudo ./XcodeLegacy.sh -osxXXXX install
  78
  79 Xcode no longer seems to apply project build settings top-down. To make
  80 changes please
  81
  82     - select the SIPEAdiumPlugin or Adium project
  83     - select the "Build Settings" tab
  84     - change from "Basic" to "All" (on the left)
  85     - change from "Combined" to "Levels" (in the middle)
  86     - find the line with the setting you want to change (use search field)
  87     - select that line
  88     - change the setting at the right-most(!) place in that line
  89     - you will notice that all places to the left change automatically
  90
  91 Settings to change
  92
  93     SDK to    |  Base SDK  | Implicitly Link Objective-C  | Other
  94     build for |            | Runtime Support (Adium only) |
  95    -----------|------------|------------------------------|-------------------
  96      10.11    | OS X 10.11 |    <No change necessary>     |
  97      10.10    | OS X 10.10 |    <No change necessary>     | Adium <= 1.5.10.3
  98      10.9     | OS X 10.9  |            No                | Adium <= 1.5.10.3