---

[ user manual - third party - technical papers - components - build instructions - install instructions ]

Build From Source

• Requirements

• Qucs needs Qt® by Digia®. The current version requires Qt 4 or later.

• Installation From Distibutable Sources

• Unpack the distribution tarball:

  $ tar xvzf qucs-<version>.tar.gz               (using GNU tar)
  $ gzip -cd qucs-<version>.tar.gz | tar xvf -   (using another tar)
  

  Change into the source directory:

  $ cd qucs-<version>
  

  Configure the source package for your system:

  $ ./configure
  

  Now compile the package:

  $ make
  

  Install Qucs:

  $ make install
  

  You must have root privileges if you want to install the package in the standard location (/usr/local) or in any location that is only writable by root. Run configure --help for information on installing elswhere. For further information on installing the package, please consult the file INSTALL included in the distribution.
  
  Please note: Users of the FreeBSD OS may use a GNU make (probably gmake) to compile and install the package.

Build Development Sources from Git Repository

• Requirements

• • Autoconf version 2.64 (at least)
  • GNU automake 1.7.0 (at least)
  • flex 2.5.31 (but at least 2.5.9)
  • GNU Bison 1.875d
  • Qt installation >= version 4 (by Digia)
  • GNU M4 (any version)
  • GNU gperf 3.0.1

• Building

• For each of the main source directories, qucs, qucs-core and qucs-doc it is necessary to:

  $ sh autogen.sh
  $ ./configure --enable-maintainer-mode --prefix=/installation/path
  

• Testing

• For testing purposes the user has to install the package previously.

  $ make install
  $ cd /installation/path/bin
  

Note that Qucs comes bundled with a version of ADMS known to be compatible. By default, this version is built and installed with the commands above. If you would prefer to use a different version of ADMS, you may supply the --diable-adms option to configure.

Build instructions for Win32

There are different methods how to compile the package for Win32:

• Cygwin natively -- tested

• This works out of the box very likely on a usual GNU/Linux system. Of course Qt® and the X-Server including development files must be installed.

• MinGW32 natively -- untested
• MinGW32 cross-compiling -- tested

• This is the preferred method to build Qucs for Win32. On an Debian system the mingw32-cross compiler is available. The Q../Free version can be built using either cross-compiling or also natively. Once this has been accomplished it is possible to compile Qucs.

  $ QTDIR=/path/to/qt i386-mingw32-configure --prefix=/mingw
  $ make
  $ make install
  

• MSVC natively -- tested

• The Git sources contain some extra *.ap files and a perl script which produces the appropriate project files (*.dsp and *.dsw).

  $ sh autodsp.sh
  

  With the Q../Free version compiled using MSVC and setting QTDIR appropriately it is possible to use the qucs.dsw and qucscore.dsw files to compile Qucs with MSVC.

Build instructions for MacOSX

The following instructions are relevant for Qucs version 0.0.16. Newer versions have not been tested on Mac. If you do so and find problems, or even better, solutions, contact the Qucs team so we can update these instructions. Newer versions of Qucs require Qt4.

In order to build Qucs on a MacOSX you need to have Apple's X11 installed. Also a native build of Qt3/Mac is necessary. This will make the native Aqua widget set available for Qucs.

• Build Qt3/Mac

• First download latest Qt3/Mac (version 3.3.8) from e.g. qt-mac-free-3.3.8.tar.gz. Then unpack it:

      $ cd /Developer
      $ tar xvzf ~/qt-mac-free-3.3.8.tar.gz
      $ mv qt-mac-free-3.3.8 qt3
      $ cd qt3
      
  

  For MacOSX 10.5 (Leopard) you need to apply a patch.

      $ patch < ~/qt3-leopard.diff
      
  

  Then configure and build Qt.

      $ export QTDIR=/Developer/qt3
      $ export PATH=$PATH:$QTDIR/bin
      $ export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$QTDIR/lib
      $ ./configure -shared -release -thread
      $ make
      
  

  This takes some time now. After that you have a working Qt3/Mac on your computer.

• Build Qucs

• In order to build and install Qucs you use now the previously built Qt3/Mac.

      $ tar xvzf qucs-<version>.tar.gz
      $ cd qucs-<version>
      $ ./configure --prefix=/usr/local
      $ make
      $ make install
      
  

  Under MacOSX applications are actually directory structures where the binaries, icons, etc. are stored. These are created during the last Makefile install step from Qucs version 0.0.15 on.
  
  Finally you can link the main Qucs application into your Applications folder by running the following command.

      $ ln -s /usr/local/bin/qucs.app /Applications/qucs.app
      
  

  You're finally done!

---