By following the subsequent steps, you should be able to successfully compile Mira's source code. There are instructions for Linux, Mac OS X and Windows.
Please note that the provided instructions assume that your Linux distribution is Debian or Debian-based. If it is not, please install the packages using your distribution's installer.
You will need to download the following core packages (on Debian or Ubuntu, you can do so with the terminal command: sudo apt-get install PACKAGE_NAME);
It is best to install the latest version of Boost. To do so, you will need to download the latest revision from its source code repository using Subversion. If you do not already have the Subversion client installed, please see these instructions.
Next, to download Boost, please follow the anonymous SVN checkout instructions provided by Boost's developers. To then install Boost, run the following commands from the top level of the Boost download directory:
./bootstrap.sh sudo ./bjam install
The Mira Core Development Team is currently using Boost 1.42.
For more information regarding Boost, visit Boost.org.
The Qt 4 Application Development Open Source libraries can be downloaded from the Qt Software website. Visit the download page, choose LGPL / Free Downloads and download the Qt libraries for Linux/X11 package to your Desktop. Then run the following commands from a terminal window (make sure to replace the Qt version number with that of the one you downloaded):
cd ~/Desktop tar xzvf qt-x11-opensource-src-4.5.3.tar.gz cd qt-x11-opensource-src-4.5.3 ./configure make sudo make install
CMake is a cross-platform Open Source build system which is used to build both Mira Client and Mira Server. To install it, download the Linux source code from CMake's website and install it with the commands:
./configure make sudo make install
The Avahi development libraries are required to support LAN service discovery. You will need to download the following packages (on Debian or Ubuntu, you can do so with the terminal command: sudo apt-get install PACKAGE_NAME);
BitRock InstallBuilder is only required if you wish to configure and edit the installers for Mira Client or Server, NOT if you would like to install the applications themselves.
To install InstallBuilder, download the Enterprise version for Linux from BitRock's website. Then, in a terminal window, run:
chmod +x bitrock-installbuilder-6.3.bin ./bitrock-installbuilder-6.3.binAnd follow the instructions.
If you would like to unlock the full version, please request the Open Source licence (granted free of charge by the brilliant Sales team at BitRock) from Max Bossino on the Mira Development Mailing List.
To test your development environment, try to download and build both Mira Client and Mira Server using the instructions found here.
Please note that the provided instructions assume that you are using the latest version of Mac OS X, Snow Leopard (version 10.6).
The core build packages are included with Apple's Integrated Development Environment, Xcode. It is free to use Xcode for Mac OS X development: all you have to do is register for a free account on the Mac Dev Center, download the latest Universal binary (.dmg) installer package for Xcode and install it on your Mac.
The Mira Core Development Team is currently using Xcode 3.2.2.
Download the boost_1_42_0.tar.gz package from the Boost project's Downloads page on SourceForge: here.
Let's assume that you have downloaded the package to your ~/Downloads/ directory. Open a Terminal environment (Applications > Utilities > Terminal, in Finder) and run:
cd ~/Downloads/ tar xzvf boost_1_42_0.tar.gz cd boost_1_42_0/ ./bootstrap.sh sudo ./bjam install
You will need to enter your password to run the final command, which installs the Boost libraries.
The Mira Core Development Team is currently using Boost 1.42.
For more information regarding Boost, visit Boost.org.
For more information on installing Boost on Mac OS X, please see the Boost Getting Started guide.
The easiest way of installing the Qt 4 Application Development Open Source libraries is using MacPorts.
Visit the MacPorts install page, choose to download the dmg disk image for Snow Leopard and save it to your Downloads directory. Once it has downloaded, open your Downloads directory in Finder and double-click the dmg file to install MacPorts.
When it has finished installing, run the following commands from a Terminal environment:
sudo port selfupdate sudo port install qt4-mac
The Mira Core Development Team is currently using Qt 4.6.2.
For more information on Qt, visit Qt Centre.
For more information on using MacPorts, visit the MacPorts User Guide.
CMake is a cross-platform Open Source build system which is used to build both Mira Client and Mira Server. To install it, download the Mac OS X Universal .dmg installer from CMake's website, and run the installer. When you are prompted about installing the Command Line Links to /usr/bin/, choose to install them.
The Mira Core Development Team is currently using CMake 2.8.1.
BitRock InstallBuilder is only required if you wish to configure and edit the installers for Mira Client or Server, NOT if you would like to install the applications themselves.
To install InstallBuilder, download the Enterprise version for Mac OS x, PPC and Intel from BitRock's website. Then extract the installbuilder-enterprise-6.3.1-osx-installer.zip file and run the installer package.
If you would like to unlock the full version, please request the Open Source licence (granted free of charge by the brilliant Sales team at BitRock) from Max Bossino on the Mira Development Mailing List.
The Mira Core Development Team is currently using BitRock InstallBuilder Enterprise 6.3.1.
To test your development environment, try to download and build both Mira Client and Mira Server using the instructions found here.
Please note that the provided instructions have only been tested on Windows XP (32 bit).
Please note that these instructions are for the manual installation of MingW. The automated installer has not been tested.
For more information regarding MingW and MSYS, visit MingW.org.
MingW can be download from its SourceForge project page.
The following packages are necessary;
The Mira Core Development Team is currently using these versions.
Prerequisite
bjam is required to build Boost, and it is the command-line tool that drives the Boost Build system. To build Boost binaries, you'll invoke bjam from the Boost root.
bjam executable can be downloaded at here. For Windows platform, you'll need to download the bjam file that has the ntx86 suffix in the file name.
Once you have downloaded bjam and extracted the archive to a directory, you will need to change some User Environment Variables (follow this guide if you do not know how);
Now we have bjam setup, we'll continue the installation of Boost.
It is best to install the latest version of Boost. To do so, you will need to download the latest revision from its source code repository using Subversion. If you do not already have the Subversion client installed, please see these instructions.
Next, to download Boost, please follow the anonymous SVN checkout instructions provided by Boost's developers. Once downloaded, set the environment variable BOOST_ROOT to the directory boost is in.
The Mira Core Development Team is currently using Boost trunk (1.41 didn't work, but a fix is in for the next release. As soon as 1.42 is available, it will be tested and possibly used).
For more information regarding Boost, visit Boost.org.
Assuming you've boost installed in (c:/Libraries/boost)
To build all boost libraries, you can do the following
cd ${BOOST_ROOT}
mkdir build-boost
bjam --build-dir=build-boost --toolset=gcc stage
To build only the portion of the boost libraries that Mira is currently using, you can do the following
cd ${BOOST_ROOT}
mkdir build-boost
bjam --shows-libraries
bjam --build-dir=build-boost --toolset=gcc stage --with-date_time
bjam --build-dir=build-boost --toolset=gcc stage --with-filesystem
bjam --build-dir=build-boost --toolset=gcc stage --with-function_types
bjam --build-dir=build-boost --toolset=gcc stage --with-graph
bjam --build-dir=build-boost --toolset=gcc stage --with-iostreams
bjam --build-dir=build-boost --toolset=gcc stage --with-mpi
bjam --build-dir=build-boost --toolset=gcc stage --with-program_options
bjam --build-dir=build-boost --toolset=gcc stage --with-python
bjam --build-dir=build-boost --toolset=gcc stage --with-regex
bjam --build-dir=build-boost --toolset=gcc stage --with-serialization
bjam --build-dir=build-boost --toolset=gcc stage --with-signals
bjam --build-dir=build-boost --toolset=gcc stage --with-system
bjam --build-dir=build-boost --toolset=gcc stage --with-test
bjam --build-dir=build-boost --toolset=gcc stage --with-thread
bjam --build-dir=build-boost --toolset=gcc stage --with-wave
The command ”bjam –shows-libraries” will print a list of boost libraries you can build.
The command ”bjam –build-dir=build-boost –toolset=gcc stage –with-thread” will only build the thread command. If you want to build a different library say filesystem, then you will run this command ”bjam –build-dir=build-boost –toolset=gcc stage –with-filesystem”.
Download boost asio 1.0.0 from its SourceForge project page extract the boost files and copy them to ${BOOST_ROOT}
The Qt 4 Application Development Open Source libraries can be downloaded from the Qt Software website. Visit the download page, choose LGPL / Free Downloads and then download and install the Qt libraries for Windows package.
NB: These instructions are untested and might be incomplete.
CMake is a cross-platform Open Source build system which is used to build both Mira Client and Mira Server. To install it, download the Windows installer from CMake's website and run it.
The Avahi development libraries are required to support LAN service discovery. Instructions on installing them on Windows will be added once Mira's Avahi implementation has been tested on Windows.
BitRock InstallBuilder is only required if you wish to configure and edit the installers for Mira Client or Server, NOT if you would like to install the applications themselves.
To install InstallBuilder, download the Enterprise version for Windows from BitRock's website, and run the installer.
If you would like to unlock the full version, please request the Open Source licence (granted free of charge by the brilliant Sales team at BitRock) from Max Bossino on the Mira Development Mailing List.
To test your development environment, try to download and build both Mira Client and Mira Server using the instructions found here.
Discussion