This section explains how to build the ownCloud Client from source for all major platforms. You should read this section if you want to develop for the desktop client.
Note
Building instruction are subject to change as development proceeds. Please check the version for which you want to built.
The instructions contained in this topic were updated to work with version 1.5 of the ownCloud Client.
- Debian/Ubuntu: apt-get update; apt-get build-dep owncloud-client
- openSUSE: zypper ref; zypper si -d owncloud-client
- Fedora/CentOS: yum install yum-utils; yum-builddep owncloud-client
In additon to needing XCode (along with the command line tools), developing in the MAC OS X environment requires extra dependencies. You can install these dependencies through MacPorts or Homebrew. These dependencies are required only on the build machine, because non-standard libs are deployed in the app bundle.
The tested and preferred way to develop in this environment is through the use of HomeBrew. The ownCloud team has its own repository containing non-standard recipes.
To set up your build enviroment for development using HomeBrew:
brew tap owncloud/owncloud
brew install $(brew deps mirall)
To build mirall, follow the generic build instructions.
Note
Because the product from the mirall build is an app bundle, do not call make install at any time. Instead, call make package to create an install-ready disk image.
Due to the large number of dependencies, building the client for Windows is currently only supported on openSUSE, by using the MinGW cross compiler. You can set up openSUSE 12.1, 12.2, or 13.1 in a virtual machine if you do not have it installed already.
To cross-compile:
- zypper ar http://download.opensuse.org/repositories/windows:/mingw:/win32/openSUSE_13.1/windows:mingw:win32.repo
- zypper ar http://download.opensuse.org/repositories/windows:/mingw/openSUSE_13.1/windows:mingw.repo
- ``zypper install cmake make mingw32-cross-binutils mingw32-cross-cpp mingw32-cross-gcc
- mingw32-cross-gcc-c++ mingw32-cross-pkg-config mingw32-filesystem mingw32-headers mingw32-runtime site-config mingw32-libqt4-sql mingw32-libqt4-sql-sqlite mingw32-sqlite mingw32-libsqlite-devel mingw32-dlfcn-devel mingw32-libssh2-devel kdewin-png2ico mingw32-libqt4 mingw32-libqt4-devel mingw32-libgcrypt mingw32-libgnutls mingw32-libneon-openssl mingw32-libneon-devel mingw32-libbeecrypt mingw32-libopenssl mingw32-openssl mingw32-libpng-devel mingw32-libsqlite mingw32-qtkeychain mingw32-qtkeychain-devel mingw32-dlfcn mingw32-libintl-devel mingw32-libneon-devel mingw32-libopenssl-devel mingw32-libproxy-devel mingw32-libxml2-devel mingw32-zlib-devel``
zypper install mingw32-cross-nsis
Install the following plugin:
``mingw32-cross-nsis-plugin-processes mingw32-cross-nsis-plugin-uac``
Note
This plugin is typically required. However, due to a current bug in mingw, the plugins do not currently build properly from source.
..note:: These files operate using openSUSE 12.2 and newer.
- rpm -ihv http://download.tomahawk-player.org/packman/mingw:32/openSUSE_12.1/x86_64/mingw32-cross-nsis-plugin-processes-0-1.1.x86_64.rpm
- rpm -ihv http://download.tomahawk-player.org/packman/mingw:32/openSUSE_12.1/x86_64/mingw32-cross-nsis-plugin-uac-0-3.1.x86_64.rpm
Note
When building for Windows platforms, you must specify a special toolchain file that enables cmake to locate the platform-specific tools. To add this parameter to the call to cmake, enter DCMAKE_TOOLCHAIN_FILE=../mirall/admin/win/Toolchain-mingw32-openSUSE.cmake.
- ..note:: Using make package produces an NSIS-based installer, provided
- the NSIS mingw32 packages are installed.
Compared to previous versions, building Mirall has become easier. Unlike earlier versions, CSync, which is the sync engine library of Mirall, is now part of the Mirall source repository and not a separate module.
You can download Mirall from the ownCloud Client Download Page.
To build the most up to date version of the client:
git clone git://github.com/owncloud/mirall.git
mkdir mirall-build
cd ../mirall-build cmake -DCMAKE_BUILD_TYPE="Debug" ../mirall
..note:: You must use absolute pathes for the include and library directories.
The owncloud binary appear in the bin directory.
..note:: This step requires the mingw32-cross-nsis packages be installed on Windows.
The following are known cmake parameters:
Used for stored credentials. When compiling with Qt5, the library is called qt5keychain.dylib. You need to compile QtKeychain with the same Qt version.
WITH_DOC=TRUE: Creates doc and manpages through running make; also
adds install statements, providing the ability to install using ``make
install``.
CMAKE_PREFIX_PATH=/path/to/Qt5.2.0/5.2.0/yourarch/lib/cmake/: Builds using Qt5.
BUILD_WITH_QT4=ON: Builds using Qt4 (even if Qt5 is found).