Building Tomboy on Windows
As of version 0.13.0, Tomboy successfully builds under Windows.
Prerequisites
Tomboy relies on GTK# 2.12.8 or greater. Please install Novell's GTK# installer and reboot.
Getting the Tomboy source code
Working with git
The Tomboy source is kept in Git. It's recommended that you use the latest code from the repository when making changes to the project, as this will allow the developers to more easily apply your changes and improvements to the project.
Stand-alone git clients exist for Windows, such as TortoiseGit which integrates into Windows Explorer. This requires you to first install msysgit. When installing msysgit, make sure you choose the following options:
- "Run Git from the Windows Command Prompt (only adds git to PATH)
- Choose Plink, not openSSH (this is only important if you have developer access to git)
- Choose to always use Windows line endings
Another options are Git Extensions which provide Windows Explorer integration and a rudimentary Visual Studio plugin. It bundles all requirements in one installer.
Github has a nice guide for getting started with git on Windows, including instructions for using git GUI tools.
If using the command line version of git, you can get the source with:
git clone git://git.gnome.org/tomboy
If you have a GNOME SVN acccount, use the following:
git clone ssh://[login]@git.gnome.org/git/tomboy
Building
Tomboy will build in various versions of Microsoft Visual Studio, including VS2005, VS2008, and the free VS2008 Express Edition, which can be downloaded from http://www.microsoft.com/express/download/default.aspx. It also works well in SharpDevelop 3.0.
Depending on which IDE you are using, you may not be able to open the project for the installer, and may be presented with an error that Setup.wixproj cannot be opened. This can be safely ignored unless you plan to do work on the Windows installer.
Open the Tomboy.sln file and Build the solution. This should create a runnable executable. Press F5 to run your newly-built Tomboy!
Submitting Patches
Before submitting patches, please read the following:
Questions
If any of this doesn't work for you, feel free to get in touch with the developers on IRC: #tomboy on irc.gnome.org or join the Mailing List