Giter Club home page Giter Club logo

client_theming's Introduction

Nextcloud desktop client

Build Status

Theme and build instructions for the Nextcloud desktop client.

Based on https://github.com/owncloud/client/blob/master/doc/building.rst

Installing on Ubuntu

sudo add-apt-repository ppa:nextcloud-devs/client
sudo apt-get update
sudo apt-get install nextcloud-client

Launchpad: https://launchpad.net/~nextcloud-devs/+archive/ubuntu/client

Beta packages

sudo add-apt-repository ppa:nextcloud-devs/client-beta
sudo apt-get update
sudo apt-get install nextcloud-client

Launchpad: https://launchpad.net/~nextcloud-devs/+archive/ubuntu/client-beta

If you always want the latest versions (including the betas), add both repositories. If you want only the stable version, add the non-beta repository only.

Installing on Debian

You need to add to sources.list or a separate source list file one of the source lines below corresponding to your Debian version:

deb http://download.opensuse.org/repositories/home:/ivaradi/Debian_9.0_update/ /
deb http://download.opensuse.org/repositories/home:/ivaradi/Debian_9.0/ /
deb http://download.opensuse.org/repositories/home:/ivaradi/Debian_8.0/ /
deb http://download.opensuse.org/repositories/home:/ivaradi/Debian_7.0/ /

Before installing, you also need to add the respository's key to the list of trusted APT keys with a command line:

wget -q -O - <repository URL>/Release.key | apt-key add -y

For example (as root):

echo 'deb http://download.opensuse.org/repositories/home:/ivaradi/Debian_9.0/ /' > /etc/apt/sources.list.d/nextcloud-client.list
wget -q -O - http://download.opensuse.org/repositories/home:/ivaradi/Debian_9.0/Release.key | apt-key add -
apt-get update
apt-get install nextcloud-client

Beta packages

Beta packages are also available:

deb http://download.opensuse.org/repositories/home:/ivaradi:/beta/Debian_9.0_update/ /
deb http://download.opensuse.org/repositories/home:/ivaradi:/beta/Debian_9.0/ /
deb http://download.opensuse.org/repositories/home:/ivaradi:/beta/Debian_8.0/ /
deb http://download.opensuse.org/repositories/home:/ivaradi:/beta/Debian_7.0/ /

If you always want the latest versions (including the betas), add both the normal and the beta repositories. If you want only the stable version, add the non-beta repository only.

Snaps

Building the snap

cd linux
snapcraft

Installing via Snap package (supported distributions)

Download the snap package for your architecture

sudo snap install --dangerous nextcloud-client_*.snap

Installing a snap is very quick. Snaps are secure. They are isolated with all of their dependencies. Snaps also auto update when a new version is released. The snap is confined, thus the synced folders will be by default in ~/snap/<version>/, the client can access to the actual home, but not to the .dotted files, use symlinks if you need to.

Building on Linux

Getting repository ready

Run:

git submodule update --init --recursive

Run:

# If building on Ubuntu
sudo apt-get install libsqlite3-dev qt5-default libqt5webkit5-dev qt5keychain-dev libssl-dev

# All distributions
mkdir build-linux
cd build-linux
cmake -D OEM_THEME_DIR=$(realpath ../nextcloudtheme)  ../client
make
sudo make install

Building on Debian

Install required packages.

sudo apt-get install git libsqlite3-dev qt5-default libqt5webkit5-dev qt5keychain-dev cmake build-essential libowncloudsync0

If you are using Debian 9 install libssl1.0-dev

sudo apt-get install libssl1.0-dev

If you are using Debian 8 install libssl-dev

sudo apt-get install libssl-dev

Then:

git clone https://github.com/nextcloud/client_theming.git
cd client_theming
git submodule update --init --recursive
mkdir build-linux
cd build-linux
cmake -D OEM_THEME_DIR=$(realpath ../nextcloudtheme) -DCMAKE_INSTALL_PREFIX=/usr  ../client
make
sudo make install

Building on OSX

Attention: When building make sure to use an old Core 2 Duo build machine running OS X 10.10. Otherwise the resulting binary won't work properly for users of an older device. Have at least 180 GB free disk space when compiling Qt. Make sure your user is named "builder".

Install dependencies

  1. Install HomeBrew
  2. brew install openssl wget cmake
  3. wget https://github.com/sparkle-project/Sparkle/releases/download/1.14.0/Sparkle-1.14.0.tar.bz2
  4. tar -xf Sparkle-1.14.0.tar.bz2
  5. mv Sparkle.framework ~/Library/Frameworks/
  6. Install XCode 6.4 from http://adcdownload.apple.com/Developer_Tools/Xcode_6.4/Xcode_6.4.dmg
  7. sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  8. Generate Sparkle keys: ./bin/generate_keys. Keep those, if you loose it you won't be able to deploy updates anymore.
  9. Store the keys in osx/. Make sure to not make the dsa_priv.pem publicly available.
  10. Install http://s.sudre.free.fr/Software/Packages/about.html

Compile Qt

Because the desktop client comes with some custom patches you have to download the Qt 5.6.2 source and then apply all of them. Make sure to adjust with the login to the cloned client repository.

cd /tmp/
wget http://download.qt.io/official_releases/qt/5.6/5.6.2/single/qt-everywhere-opensource-src-5.6.2.tar.gz
tar -xf qt-everywhere-opensource-src-5.6.2.tar.gz
cd /tmp/qt-everywhere-opensource-src-5.6.2/qtbase
git apply <client>/admin/qt/patches/qtbase/*.patch
cd ..
./configure -sdk macosx10.9 -openssl -openssl-linked
make -j2
sudo make -j1 install

Build the client

sh osx/build.sh

Building on Windows

Building the docker image

The docker image contains the toolchain to build the windows binary. Build it:

docker build -t nextcloud-client-win32:<version> client/admin/win/docker/

Building the binary

docker run -v "$PWD:/home/user/" nextcloud-client-win32:2.2.2 /home/user/win/build.sh $(id -u)

Building a release

When we build releases there are two additional cmake parameters to consider:

  • -DMIRALL_VERSION_SUFFIX=<STRING>: for a generic suffix name such as beta or rc1
  • -DMIRALL_VERSION_BUILD=<INT>: an internal build number. Should be strictly increasing. This allows update detection from rc to final

Note that this had mostly usage on Windows and OS X. On linux the package manager will take care of all this.

client_theming's People

Contributors

rullzer avatar probonopd avatar ivaradi avatar lukasreschke avatar 3v1n0 avatar jancborchardt avatar vladimiroff avatar mario avatar juliushaertl avatar dennisheitmann avatar yadutaf avatar ledfan avatar mariusbluem avatar flexiondotorg avatar pablohn26 avatar kungknut avatar severo avatar theassassin avatar tpokorra avatar g-perez-scornik avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.