2003 2004 2007 2008 2009 2011 2012 2013 2014 Steffen Macke Steffen Macke sdteffen@gmail.com This document describes (step by step) how to compile Dia on Windows, Mac OS X and Ubuntu. Dia is a diagram editor. More information about dia is available from http://dia-installer.de. The Dia Development VM allows to compile the latest Dia version using a single mouse click. The VM uses Ubuntu and is available from http://dia-installer.de/developer/. This section describes how to compile Dia for Windows using Microsoft Visual C++ Version 6.0 and the GTK+ Development Environment. Understanding the folder structure is helpful especially when unzipping developer packages: c:\gtk | +---bin | +---include | +---lib Sometimes the zip files contain the bin, include and lib inside another folder. While unzipping, make sure that their contents end up in c:\gtk\bin, c:\gtk\include and c:\gtk\lib. Start the Visual C++ Installation Wizard () and click Next.

If you agree to the license (), put the checkmark and click Next.

Enter the registration information in the form () and click Next.

When asked for the installation location (), choose c:\Program Files\Microsoft Visual Studio\Common and click Next.

To continue with the installation processs (), click Next

Note down the Product ID () and click OK.

When asked for the setup type (), click on the Standard button.

When asked to register the environment variables (), you can leave the option to register the environment variables unchecked, though it does no harm to check this option. Click OK

Read the information about the NT debug symbols () and click OK.

Note that the Visual C++ setup has finished successfully () and click OK.

Start the MSDN setup () and verify that the option to install MSDN is checked. Click Next.

Enter the path of your CD-DROM drive () and click OK.

If you agree to the license terms (), click Next.

Note down the Product ID shown in for future reference and click OK.

If you agree to the license terms (), click I agree.

When asked for the installation type (), click on Standard.

When the MSDN Library setup is complete (), click OK.

You may register your Visual C++ copy online (). Click Finish to leave the installation wizard.

Download Visual Studio 6 Service Pack 6 can be downloaded from http://msdn2.microsoft.com/en-us/vstudio/Aa718364.aspx. Start the Visual Studio 6 Service Pack 6 setup. When asked for a location to place the extracted files (), specify a temporary folder, e.g. c:\tmp. Click OK>.

When asked if the temporary folder should be created (), click Yes.

Start the Visual Studio 6.0 Service Pack 6 setup () from the temporary folder and click Continue.

If you agree to the Visual Studio 6.0 Service Pack 6 license agreement (), click I Agree.

When asked for a Windows reboot (), click Windows reboot.

The GTK+ All-in-one bundle should be used and can be downloaded from Sourceforge. Unzip the contents of the folder to C:\GTK. Copy c:\gtk\bin\intl.dll to c:\gtk\bin\libintl.dll. While glib includes its own copy of iconv, libxml2 requires a separate iconv installation. The libxml2 iconv version can be downloaded from http://www.zlatkovic.com/libxml.en.html. Unzip the file and copy the contents of the iconv-1.9.2.win32 folder to C:\GTK. Download libxml2 from http://www.zlatkovic.com/libxml.en.html. Unzip the file and copy the contents of the libxml2-2.7.8.win32 folder to C:\GTK. The following software packages are optional, because they can be used to create the full Dia for Windows installer, but they are not necessary to just build the Dia binaries or compile a plug-in. LibArt_LGPL is the graphics library used by Dia's libart plugin. It is available from http://ftp.gnome.org/pub/gnome/binaries/win32/libart_lgpl/2.3/. Extract the contents of libart_lgpl-2.3.21-1_win32.zip and libart_lgpl-dev-2.3.21-1_win32.zip to c:\gtk. In case you don't want to compile the libart plugin, comment it out in plug-ins/makefile.msc. Use the following script to create libart_lgpl_2-2.lib: dumpbin /exports c:\gtk\bin\libart_lgpl_2-2.dll > c:\gtk\lib\libart_lgpl_2-2.dumpbin echo EXPORTS > c:\gtk\lib\libart_lgpl_2-2.def sed -n "/RVA/,/Summary/p" c:\gtk\lib\libart_lgpl_2-2.dumpbin | sed -n "/[0-9]/p" | sed "s/.* //" >> c:\gtk\lib\libart_lgpl_2-2.def lib /def:c:\gtk\lib\libart_lgpl_2-2.def /out:c:\gtk\lib\libart_lgpl_2-2.lib /machine:x86 NSIS is used to build the Dia installer. If you intend to build the Python plug-in, install Python 2.3 to c:\python23. Newer Python versions are not build against msvcrt.dll and thus require to rebuild all libraries that Dia is linked against. Therefore building Dia with newer Python versions is not covered by this document. In case you don't want to compile the Python plugin and language bindings, comment out the nmake calls for the bindings and plug-ins\python folders. Edit c:\gtk\dia\makefile.msc as indicated by the comments in the file (around lines 58 and 67). The swig command is required to build the Python bindings. Download swig from http://www.swig.org and unzip swig.exe and the lib folder to C:\GTK\bin. The LibXSLT library is used by the xslt plugin. Thus you won't be able to build the xslt plugin without LibXSLT. Download libxslt from http://www.zlatkovic.com/libxml.en.html. Unzip the file and copy the contents of the libxslt-1.1.26.win32 folder to C:\GTK. In case you don't want to compile the xslt plugin, comment it out in plug-ins/makefile.msc. The librsvg library is used to render SVG images as image objects. Note that librsvg is not used for the SVG import, SVG export or the Dia shapes. Download librsvg-dev_2.32.1.-1_win32.zip, librsvg_2.32.1-1_win32.zip and svg-gdk-pixbuf-loader_2.32.1-1_win32.zip from http://ftp.gnome.org/pub/GNOME/binaries/win32/librsvg/2.32/. Unzip those files and copy the contents to C:\GTK. Any serious Dia development should use the latest sources from the GNOME Git repository: git://git.gnome.org/. In case you don't know how to use Git or you don't want to use it, you can also use a source tarball from the Dia download pages. For the instructions of this tutorial to work, the Dia sources should be located in c:\gtk\dia. Download http://downloads.sourceforge.net/dia-installer/dia_extra_src_msvc_2009-11-05.zip and unzip the contents to c:\. Download and apply the following patch: 0001-Bug-679417-Work-around-libpixbufloaders-.dll-install.patch Using the Visual C++ 6.0 build environment (): Starting from c:\gtk\dia, the following commands are necessary to compile dia: C:\GTK\bin\diadev.bat cd \GTK\dia nmake /f makefile.msc In order to run dia sucessfully, the binaries have to be put in the correct file structure. Copy an existing Dia for Windows installation to C:\GTK\dia\build\win32. Delete the contents of C:\GTK\dia\build\win32\bin and C:\GTK\dia\build\win32\dia. Run the following commands: cd \GTK\dia nmake /f makefile.msc full Congratulations, you should now be able to run your copy of dia by executing C:\GTK\bin\dia. In order to enable debugging, run nmake -f makefile.msc DEBUG=1. In order to enable console output, use dia.exe, not diaw.exe. This allows to see error and warning messages produced by dia. Make sure to read the information provided by Hans Breuer and Tor Lillqvist, in particular the comments in the build files and the files named *.win32 in the glib, GTK+ and dia sources. The archives of the dia and gimpwin-dev mailing lists may contain useful information. If none of the above sources contain information to solve your problem, contact the author of this document: Steffen Macke sdteffen@gmail.com The MS Visual C++ compiler is used to compile dia for win32. Versions 5, 6 have been used successfully. The compiler is invoked using the cl command. When compiling with Visual C++ version 7, you'll have to recompile all libraries as you'll have to link against msvcrt7.dll instead of msvcrt.dll. This applies to all GTK+ libraries which you'll have to rebuild on your own. This also applies to newer Visual C++ versions. Compiling Dia for Windows with gcc from the MinGW distribution should be possible. However, compilation with gcc is not covered in this document. Make sure to check Dia's bugzilla for MinGW-related patches. The makefiles work with MS nmake. The nmake tool comes with MS Visual Studio. The standard MS command line interpreter cmd.exe is used to compile dia. With the setup mentioned above, you should be able to compile dia out of the box. However, you should know which files control the build process. In addition to the various makefile.msc's that are introduced below, there are two important files: $TOP\glib\build\win32\make.msc, included by makefile.msc $TOP\glib\build\win32\module.defs, included by make.msc If you're working with updated versions of some of the libraries you may have to edit these files. The cairo DLL (version 1.10.2) included in the GTK+ all-in-one bundle 2.24.10 has some bugs. See e.g. bug #679651. An updated cairo DLL (e.g. version 1.12.16) can be build using the openSUSE Build Service. You can branch the package to start your own development. When doing so, remember to add the windows:mingw:win32 repository via the advanced interface. This is necessary in order to locate libraries on which cairo depends. Starting from a vanilla Ubuntu 12.04 deskop installation, you can install the necessary packages using the following command: sudo apt-get install autoconf automake autotools-dev git git-core gsfonts-x11 \ intltool libatk1.0-dev libcairo-gobject2 libcairo2-dev liberror-perl \ libexpat1-dev libfontconfig1-dev libfreetype6-dev libgdiplus \ libgdk-pixbuf2.0-dev libgif4 libglib2.0-bin libglib2.0-dev \ libgtk2.0-dev libice-dev libltdl-dev libmono-accessibility2.0-cil \ libmono-data-tds2.0-cil libmono-messaging2.0-cil libmono-sqlite2.0-cil \ libmono-system-data2.0-cil libmono-system-messaging2.0-cil \ libmono-system-web2.0-cil libmono-wcf3.0-cil \ libmono-winforms2.0-cil libmono2.0-cil libpango1.0-dev libpixman-1-dev \ libpng12-dev libpthread-stubs0 libpthread-stubs0-dev libsm-dev libsqlite0 \ libssl-dev libtool libx11-dev libxau-dev libxcb-render0-dev libxcb-shm0-dev \ libxcb1-dev libxcomposite-dev libxcursor-dev libxdamage-dev libxdmcp-dev \ libxext-dev libxfixes-dev libxft-dev libxi-dev libxinerama-dev libxml2-dev \ libxrandr-dev libxrender-dev m4 python-sip python2.7-dev swig \ x11proto-composite-dev x11proto-core-dev x11proto-damage-dev x11proto-fixes-dev \ x11proto-input-dev x11proto-kb-dev x11proto-randr-dev x11proto-render-dev \ x11proto-xext-dev x11proto-xinerama-dev xtrans-dev zlib1g-dev libart-2.0-dev Clone the git repository, for example: git clone git://git.gnome.org/dia Enter the dia directory and start the build process using the following commands: cd dia ./autogen.sh ./configure --prefix=/usr --with-python --with-swig --with-libart make To install, run the following command: make install MacPorts can be used to compile Dia for Mac OS X. A readymade Portfile is available. The MacPorts documentation is great and contains everything you need to build Dia on your Mac. When compiling 32-bit on a 64-bit-capable CPU, remember to set build_arch to i386 in macports.conf before the installation of any ports. Sign the App bundle: codesign -s "Developer ID Application" Dia.app