17 | | ------------- |
| 17 | == Supported Platforms == |
| 18 | |
| 19 | * GNU/Linux (gcc, 32- and 64-bit) |
| 20 | * Microsoft Windows |
| 21 | * CYGWIN (w/ gcc and cl compilers, 32- and 64-bit) |
| 22 | * MinGW (w/ gcc and cl compilers, 32- and 64-bit) |
| 23 | * Visual C++ |
| 24 | * Mac OSX (gcc and clang) |
| 25 | |
| 26 | == Testing Status == |
| 27 | |
| 28 | Travis-CI (OS X and Linux) [[br]] |
| 29 | [[Image(https://travis-ci.org/coin-or/Cbc.svg?branch=master)]] [[br]] |
| 30 | Appveyor (Windows) [[br]] |
| 31 | [[Image(https://ci.appveyor.com/api/projects/status/l2hwifsxwhswng8y/branch/master?svg=true)]] |
| 32 | |
| 33 | == Download and Install == |
| 34 | |
| 35 | * '''Linux''': On Debian, Cbc has recently become available in the package {{{coinor-cbc}}} and can be installed with apt. On Fedora, Cbc is available in the package {{{coin-or-Cbc}}}. Pre-compiled binaries are also available as part of the [http://www.coin-or.org/download/binary/CoinAll COIN-OR Optimization Suite]. |
| 36 | * '''Windows''': The easiest way to get Cbc on Windows is to download the Windows installer for the [http://www.coin-or.org/download/binary/CoinAll COIN Optimization Suite], which provides Visual Studio compatible libraries and binaries. Binary archives are also available for other Windows platforms, such as MinGW and CYGWIN. |
| 37 | * '''OS X''': The easiest way to get Cbc on OSX is through Homebrew (recipe should be available soon). When the recipe is ready, it will be installable with {{{brew install cbc}}}. |
| 38 | |
| 39 | Due to license incompatibilities, pre-compiled binaries lack some functionality. If binaries are not available for your platform for the latest version and you would like to request them to be built and posted, feel free to let us know on the mailing list. |
| 40 | |
| 41 | '''Source code''' can be obtained either by |
| 42 | |
| 43 | * Downloading a snapshot of the source code for the latest release version of Cbc from the [http://www.coin-or.org/download/source/Cbc Cbc source code download page], or |
| 44 | * Checking out the latest stable source using a subversion client. |
| 45 | * Checking out the code from [https://github.com/coin-or/Cbc Github] |
| 46 | |
| 47 | The recommended method is to use subversion because it makes it easier to obtain updates. Below are some quick start guides for building on common platforms. '''More detailed build instructions are [BuildAndInstall here].''' |
| 48 | |
| 49 | '''Quick Start Guide for Unix-like Environments''' |
| 50 | |
| 51 | In a Unix-like environment (such as Linux or CYGWIN), the following commands may be used to obtain and build Cbc from source using either SVN or git in most cases. For SVN, do |
| 52 | {{{ |
| 53 | svn checkout https://projects.coin-or.org/svn/Cbc/releases/2.9.8 Cbc-2.9.8 |
| 54 | cd Cbc-2.9.8 |
| 55 | }}} |
| 56 | For git do |
| 57 | {{{ |
| 58 | git clone --branch=stable/2.9 https://github.com/coin-or/Cbc Cbc-2.9 |
| 59 | cd Cbc-2.9 |
| 60 | git clone --branch=stable/0.8 https://github.com/coin-or-tools/BuildTools/ |
| 61 | BuildTools/get.dependencies fetch |
| 62 | }}} |
| 63 | Finally, do |
| 64 | {{{ |
| 65 | ./configure |
| 66 | make |
| 67 | make install |
| 68 | }}} |
| 69 | Optionally, once could also execute {{{make test}}} to run Cbc's unit test. |
| 70 | |
| 71 | '''Quick Start Guide for Microsoft Visual C++ Users''' |
| 72 | |
| 73 | For Microsoft Visual C++ users, there are project files for version 10 available in the MSVisualStudio directory. First, obtain the source code using either a Windows subversion client (see the [http://www.coin-or.org/faqs.html#q4 COIN-OR FAQ]) or download a snapshot. In MSVC++ Version 10, open the solution file (this should be converted to whatever version of MSVC+ you are using) and build the Cbc project. The code should build out of the box with default settings. |
| 74 | |
| 75 | It is also possible to build Cbc with the Visual Studio compiler from the command line using the procedure for Unix-like environments, using the Msys2 shell or CYGWIN. This is the recommended and best-supported way of building Cbc in Windows. |