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
  58 4. Build SIPEAdiumPlugin for an older Max OS X release
  59 ------------------------------------------------------
  60
  61 If your Xcode does not have the SDK for the older Mac OS X release then please
  62 see
  63
  64     https://github.com/devernay/xcodelegacy
  65
  66 how to extract & install SDKs for
  67
  68     - OS X 10.9 & 10.10 from the Xcode 6.4 installation package
  69     - OS X 10.11 from the Xcode 7.3.1 installation package
  70
  71 Installing all SDKs in one go seems to break Xcode builds, so please make sure
  72 to install each SDK separately with
  73
  74     $ sudo ./XcodeLegacy.sh -osxXXXX install
  75
  76 Xcode no longer seems to apply project build settings top-down. To make
  77 changes please
  78
  79     - select the SIPEAdiumPlugin or Adium project
  80     - select the "Build Settings" tab
  81     - change from "Basic" to "All" (on the left)
  82     - change from "Combined" to "Levels" (in the middle)
  83     - find the line with the setting you want to change (use search field)
  84     - select that line
  85     - change the setting at the right-most(!) place in that line
  86     - you will notice that all places to the left change automatically
  87
  88 Settings to change
  89
  90     SDK to    |  Base SDK  | Implicitly Link Objective-C  | Other
  91     build for |            | Runtime Support (Adium only) |
  92    -----------|------------|------------------------------|-------------------
  93      10.11    | OS X 10.11 |    <No change necessary>     |
  94      10.10    | OS X 10.10 |    <No change necessary>     | Adium <= 1.5.10.3
  95      10.9     | OS X 10.9  |            No                | Adium <= 1.5.10.3