diff options
| -rw-r--r-- | cpp/BuildInstructionsOSX.md | 22 | ||||
| -rw-r--r-- | objective-c/BuildInstructions.md | 59 |
2 files changed, 69 insertions, 12 deletions
diff --git a/cpp/BuildInstructionsOSX.md b/cpp/BuildInstructionsOSX.md index 462c4558266..066495ca61a 100644 --- a/cpp/BuildInstructionsOSX.md +++ b/cpp/BuildInstructionsOSX.md @@ -17,15 +17,14 @@ listed for our [supported platforms][2]. Ice has dependencies on a number of third-party libraries: - [expat][3] 2.0 - - [OpenSSL][4] 0.9.8 or later - - [bzip][5] 1.0 - - [Berkeley DB][6] 5.3 - - [mcpp][7] 2.7.2 (with patches) + - [bzip][4] 1.0 + - [Berkeley DB][5] 5.3 + - [mcpp][6] 2.7.2 (with patches) -Expat, OpenSSL and bzip are included with your system. For Berkeley DB and mcpp, -you have a couple of options: +Expat and bzip are included with your system. For Berkeley DB and mcpp, you have +a couple of options: -- Using [Homebrew][8], install Berkeley DB and mcpp with these commands: +- Using [Homebrew][7], install Berkeley DB and mcpp with these commands: $ brew tap zeroc-ice/tap $ brew install berkeley-db53 [--without-java] @@ -89,8 +88,7 @@ failure, the tests abort with `failed`. [1]: https://doc.zeroc.com/display/Ice36/Using+the+OS+X+Binary+Distribution [2]: https://doc.zeroc.com/display/Ice36/Supported+Platforms+for+Ice+3.6.0 [3]: http://expat.sourceforge.net -[4]: http://openssl.org -[5]: http://bzip.org -[6]: http://www.oracle.com/us/products/database/berkeley-db/overview/index.htm -[7]: https://github.com/zeroc-ice/mcpp -[8]: http://brew.sh +[4]: http://bzip.org +[5]: http://www.oracle.com/us/products/database/berkeley-db/overview/index.htm +[6]: https://github.com/zeroc-ice/mcpp +[7]: http://brew.sh diff --git a/objective-c/BuildInstructions.md b/objective-c/BuildInstructions.md new file mode 100644 index 00000000000..ef1d4514722 --- /dev/null +++ b/objective-c/BuildInstructions.md @@ -0,0 +1,59 @@ +# Building Ice for Objective-C on OS X + +This page describes how to build and install Ice for Objective-C from source +code on OS X. If you prefer, you can install a [Homebrew][1] package instead. + +## Objective-C Build Requirements + +### Operating Systems and Compilers + +Ice for Objective-C is currently only supported on OS X, and was extensively +tested using the operating system and compiler versions listed for our +[supported platforms][2]. + +### Ice Development Kit + +You will need the Ice development kit for C++, which you can install as a binary +distribution or compile from source yourself. + +## Building Ice for Objective-C + +Change to the Ice for Objective-C source subdirectory: + + $ cd objective-c + +If you have not built Ice for C++ in the `cpp` subdirectory, set `ICE_HOME` to +the directory of your Ice for C++ installation. For example: + + $ export ICE_HOME=/opt/Ice + +Edit `config/Make.rules` to establish your build configuration. The comments in +the file provide more information. + +Run `make` to build the Ice Objective-C libraries. + +## Installing an Objective-C Source Build + +Simply run `make install`. This will install Ice in the directory specified by +the `prefix` variable in `config/Make.rules`. + +When compiling Ice programs, you must pass the location of the +`<prefix>/include` directory to the compiler with the `-I` option, and the +location of the library directory with the `-L` option. + +## Running the Test Suite + +Python is required to run the test suite. After a successful source build, you +can run the tests as follows: + + $ make test + +This command is equivalent to: + + $ python allTests.py + +If everything worked out, you should see lots of `ok` messages. In case of a +failure, the tests abort with `failed`. + +[1]: https://doc.zeroc.com/display/Ice36/Using+the+OS+X+Binary+Distribution +[2]: https://zeroc.com/platforms_3_6_0.html |