WindowsBuildDocs
From Develop
Contents |
Building Miro Windows
This page documents how to build Miro for Windows. We need more brave souls willing to help us conquer this platform.
Note:
If you are building Miro 3.0 or previous then you should look at WindowsBuildDocs3.0.
Getting started
The supported Windows port of Miro uses GTK for Windows.
Requirements
- Visual C++ 9.0 / Visual Studio 2008 -- You can build Miro with Visual Studio 2008 Express which is "free" and available at http://www.microsoft.com/visualstudio/en-us/products/2008-editions/express . Don't install Visual Studio 2010--that won't work. (Is this still true - I believe the current build box uses Visual Studio 2010 janet 06:35, 25 May 2012 (EDT))
- cygwin -- http://www.cygwin.com/
- git (can be installed through Cygwin: all "git" packages in the "Devel" category)
- wget (can be installed through Cygwin: in "Web" category)
Note:
We use Cygwin bash for all our shell scripts. While Miro on Windows doesn't _require_ Cygwin to build, it'll make it a lot easier and we don't actively support anything else.
Building the build environment
First, install Visual Studio 2008 from the link above.
Second, install cygwin. Make sure to install the git package.
Once you have those installed, clone the repository by running Cygwin Terminal and typing:
$ git clone git://github.com/pculture/miro.git
We have a web-based version of the repository at https://github.com/pculture/miro .
When cloning is done, type:
$ cd miro/tv/windows/ $ ./setup_binarykits.sh
That will download and untar the binary kit. After that's done, you need to install all the things in the tv/windows/miro-binary-kit-xxxxxxxx/requirements/ directory in this order:
- Python -- run the installer
- Py2exe -- run the installer
- Pyrex -- untar the file, then run <tt>python setup.py install</tt>
- Nullsoft Installer -- run the installer
- PyGTK -- run the installer
- PyGobject -- run the installer
- PyCairo -- run the installer
- PyCurl -- run the installer
Warning:
Deviating from the specific packages in the binary kit or from the order of installing things above will probably make your life more difficult. We actively support the above configuration. We don't support other configurations. However, if you find other configurations that work, please let us know.
Note:
If you get an error message when trying to run some installers, navigate to the tv/windows/miro-binary-kit-xxxxxxxx/requirements/ directory in the Cygwin shell and run the command chmod +x *
Building, developing, testing
To build Miro and run it in place, do:
$ cd tv/windows/ $ ./run.sh
To build Miro and run the tests, do:
$ cd tv/windows/ $ ./test.sh
To clean up any build files, do:
$ cd tv/windows/ $ ./clean.sh
To build Miro and package it up into an installer, do:
$ cd tv/windows/ $ python setup.py bdist_nsis
Note:
If you get an error message when building the installer, check that the NSIS_PATH variable in setup.py is set to the correct NSIS installation directory. For example in Windows 7 64-bit NSIS is by default installed to "Program Files (x86)" not "Program Files".
Useful tools
Research
Troubleshooting
Spaces in paths
Try moving your build directory to some place without a space in the path http://bugzilla.pculture.org/show_bug.cgi?id=9741
Getting help
Ask on IRC if you're having problems.
Recompiling binary-kit stuff
Binary kit stuff is located in a git repository at http://git.participatoryculture.org/miro-binary-kit-win/ .
Recompiling Mozilla
You shouldn't have to do this unless you're debugging Mozilla specific issues. The first time, set aside a few days to figure out how to do it.
Compile Mozilla according to the instructions found here using Mozilla 1.9.
BuildingXULRunner has Miro specific instructions
Recompiling VLC
Instructions are located in binary-kit/libvlc/README.
Recompiling Libtorrent
Instructions are located in binary-kit/libtorrent/README.
