--== How to build kicad using CMAKE ==-- First Written: 19-Dec-2007 Last Revised: 06-Jan-2008 Kicad needs wxWidgets, the multi platform G.U.I. Perform these steps in sequence. (Platform specific details are given in sections below.) 1) Install "msys" and "mingw". 2) Install wxWidgets and build it. 3) Install zlib and build it. 4) Install CMAKE 5) Install Boost C++ Template Libraries (*.hpp files) 6) Install the kicad source tree. 7) Use cmake to build the kicad makefiles. 8) Use make to build and install kicad. 9) Making a "Debug" build. ===== Step Details ==================================================== 1) Install "msys" and "mingw". Get msys and mingw here: http://mingw.org/ msys sets up a development environment that allows the bash shell to run. mingw is a set of tools that run on windows or under msys. You will need at least the following mingw packages: make, gcc, g++, binutils, autoconf and automake. ----------------------------------------------------------------------------- 4) Install wxWidgets and build it. Download http://www.wxwidgets.org/. Start msys so you have a bash shell. Decide where your wxWidgets build directory will be. It must be where you can access it from within the msys environment, such as home/. Edit your msys/1.0/etc/fstab file if needed to provide access to this build directory from msys. (Note that if you want you can build a "debug" version of the wxWidgets library at this point, instead of the release version, or in addition to the the release version.) Unzip the wmMWS zip file into the build directory. Change directories into there, and then: mkdir build-release mkdir build-debug -- release cd build-release ../configure --enable-unicode --enable-monolithic --disable-shared --with-msw --with-opengl make make install -- debug cd build-debug ../confgiure --enable-unicode --enable-monolithic --enable-debug --enable-debug_gdb --disable-shared --with-msw --with-opengl make make install I think the default is to install into /usr/local/wxMSW-2.8.7. You can probably pass --prefix= to configure above to change where "make install" puts everything. We will refer to again below. Without the --prefix= passed to configure, will likely be /usr/local/wxMSW-2.8.7 Verify that wx-config is in your path. Modify your PATH environment variable if need be so you can run wx-config from a command prompt. You may have to restart your msys shell, depending on how you modify your PATH. ----------------------------------------------------------------------------- 5) Install zlib and build it. If on windows, download http://www.zlib.net/ or a newer version. Start msys so you have a bash shell. Decide where your zlib build directory will be. It must be where you can access it from within the msys environment, such as home/. Edit your msys/1.0/etc/fstab file if needed to provide access to this build directory from msys. Unzip the zlib123.zip file into this build directory. Change directories into there, and then: ./configure (CHANGES NEEDED!!!) make make install Note (JP Charras): Under Linux, zlib is usually installed. if not found by wxWidget installation, wxWidgets creates an alternate zlib Under Windows, zlib is not installed, so my cmake buld try to use the wxWidgets zlib build. So, under windows kicad build should work without zlib install. ----------------------------------------------------------------------------- 6) Install CMAKE. If windows, download the installation binary for windows from cmake.org. Install that and choose to add cmake to your path during installation. You will have to restart and command shells for the new path to take effect. Verify that cmake is in your path by trying to run it from a command prompt. If linux, use your package manager to install cmake. You should get cmake 2.4.7 or later. If only an older one is available in your package repository, build 2.4.7 from source. Verify that cmake is in your path by trying to run it from a command prompt. 7) Install Boost C++ Libraries If windows, well I'm guessing, so somebody please try these two options and correct this text please according to which ever is easier: (optionA) Go to http://sourceforge.net/project/showfiles.php?group_id=7586 and download boost_1_34_1.zip or later and unzip it so as to put the files into C:\Program Files\boost\boost_1_34_1 (optionB) Go to http://www.boost-consulting.com/products/free and download the http://www.boost-consulting.com/boost_1_34_1_setup.exe file and run it. ----------------------------------------------------------------------------- 8) Install the kicad source tree. You can use the subversion repository or a tar file for this. See the wiki. ----------------------------------------------------------------------------- 9) Use cmake to create the kicad makefiles. Go into your msys shell and cd to kicad source directory. Run CMakeSetup.exe and set source and binary paths. CMakeSetup.exe will try and find the boost header files and will often fail. If it fails, you will have to point it to directory, where boost c++ is installed. You can safely turn minizip building to OFF, but if you want to build it with zlib, then under msys cd to zlib source dir, ./cofigure && make & make install. (I had to copy zconf.h and zlib.h to {kcad_source_dir}/kicad/minizip). So everything in CMakeSetup.exe is set, then press Configure. If all is OK, then press OK, otherwise try to resolve reported errors. ----------------------------------------------------------------------------- 10) Use make to build and install kicad. You compile Kicad here. run cmake . (yes it is cmake space dot) It will generate makefiles run make run make install You are now done. ----------------------------------------------------------------------------- Note: that it is easy to build only a specific binary such as pcbnew alone: make pcbnew ----------------------------------------------------------------------------- End of CMAKE related building.