mirror of
https://github.com/nextcloud/desktop.git
synced 2024-11-23 13:35:58 +03:00
Remove outdated pages, update Home links.
Signed-off-by: Camila Ayres <hello@camilasan.com>
Camila Ayres
parent
59d819779e
commit
1e5516720b
6 changed files with 2 additions and 237 deletions
|
|
@ -1,7 +0,0 @@
|
||||||
- Daily builds allow you to test Nextcloud Client improvements, bugfixes and so on.
|
|
||||||
- You can find the daily builds on [in the desktop/daily folder of our download server](https://download.nextcloud.com/desktop/daily)
|
|
||||||
- The daily builds based on the latest master are available for Linux, Mac, and Windows. That means any feature or bugfix merged to master can be tested in any platform.
|
|
||||||
- The Windows compilation is done with the cmake option --config Debug - which should give you a better stack trace when an crash happens.
|
|
||||||
- _Before you install it, make sure to have a backup of your current settings._ Going back to the older version is likely to not work after you tried the new one.
|
|
||||||
- Keep in mind that this is a testing version: it could eat your data! :boom:
|
|
||||||
- Please let us know about bugs you find in the [issue tracker](https://github.com/nextcloud/desktop/issues/new).
|
|
||||||
|
|
@ -1,2 +0,0 @@
|
||||||
* [Qt Creator IDE](https://www.qt.io/product/development-tools)
|
|
||||||
* [delta: A viewer for git and diff output](https://github.com/dandavison/delta)
|
|
||||||
3
Home.md
3
Home.md
|
|
@ -1,10 +1,11 @@
|
||||||
# :desktop_computer: The desktop client
|
# The desktop client
|
||||||
- :books: Don't forget the read the :memo: [README](https://github.com/nextcloud/desktop/blob/master/README.md) of the project first !
|
- :books: Don't forget the read the :memo: [README](https://github.com/nextcloud/desktop/blob/master/README.md) of the project first !
|
||||||
- :hammer: [How to build the desktop client on Windows](https://github.com/nextcloud/desktop-client-blueprints/)
|
- :hammer: [How to build the desktop client on Windows](https://github.com/nextcloud/desktop-client-blueprints/)
|
||||||
- :bug: [How to manage issues](https://github.com/nextcloud/desktop/wiki/How-to-manage-issues)
|
- :bug: [How to manage issues](https://github.com/nextcloud/desktop/wiki/How-to-manage-issues)
|
||||||
- :checkered_flag: [How to manage Pull Requests](https://github.com/nextcloud/desktop/wiki/How-to-manage-pull-requests)
|
- :checkered_flag: [How to manage Pull Requests](https://github.com/nextcloud/desktop/wiki/How-to-manage-pull-requests)
|
||||||
- :lock: [Backport to stable branches policy](https://github.com/nextcloud/desktop/wiki/Backport-policy-stable-branches)
|
- :lock: [Backport to stable branches policy](https://github.com/nextcloud/desktop/wiki/Backport-policy-stable-branches)
|
||||||
- :bug: [How to debug the embedded Qt WebEngine](https://github.com/nextcloud/desktop/wiki/How-to-debug-qt-webengine)
|
- :bug: [How to debug the embedded Qt WebEngine](https://github.com/nextcloud/desktop/wiki/How-to-debug-qt-webengine)
|
||||||
|
- :bug: [How to fix the error "Could not update metadata due to invalid modified time"](https://github.com/nextcloud/desktop/wiki/How-to-fix-the-error-invalid-or-negative-modification-date)
|
||||||
|
|
||||||
## Download
|
## Download
|
||||||
- :incoming_envelope: [Latest release](https://github.com/nextcloud-releases/desktop/releases)
|
- :incoming_envelope: [Latest release](https://github.com/nextcloud-releases/desktop/releases)
|
||||||
|
|
|
||||||
|
|
@ -1,154 +0,0 @@
|
||||||
> **Note:** This document is in the process of being merged with the official documentation and may be out of date. For the most up-to-date version of the build instructions, visit the source version of the official documentation page [here](https://github.com/nextcloud/desktop/blob/master/doc/building.rst).
|
|
||||||
|
|
||||||
# Step by step instructions
|
|
||||||
|
|
||||||
### 1. Clone the repo
|
|
||||||
|
|
||||||
You have two possibilities to clone the repo.
|
|
||||||
|
|
||||||
First option is as [remote URL](https://help.github.com/en/articles/which-remote-url-should-i-use) -- you can choose between cloning with HTTPS (which is recommended) or with SSH.
|
|
||||||
|
|
||||||
[https://github.com/nextcloud/desktop.git](https://github.com/nextcloud/desktop.git)
|
|
||||||
|
|
||||||
If you don't have an SSH key added to your GitHub account, or are not part of the Nextcloud Github organisation, clone with HTTPS:
|
|
||||||
|
|
||||||
```
|
|
||||||
$ git clone git@github.com:nextcloud/desktop.git
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. Create build directory:
|
|
||||||
```
|
|
||||||
$ cd desktop
|
|
||||||
$ mkdir build
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3. Compile and install
|
|
||||||
|
|
||||||
:information_source: **Optional** - depending on how you have your dev environment set up, you might need to define those paths as cmake flags or as environment variables:
|
|
||||||
* ```QTKEYCHAIN_LIBRARY```
|
|
||||||
* ```QTKEYCHAIN_INCLUDE_DIR```
|
|
||||||
* ```OPENSSL_ROOT_DIR```
|
|
||||||
* ```OPENSSL_INCLUDE_DIR```
|
|
||||||
|
|
||||||
:information_source: You can enable the build of the tests by setting the cmake flag ```BUILD_TESTING``` to ```1```.
|
|
||||||
|
|
||||||
:information_source: The cmake flag ```CMAKE_BUILD_TYPE``` has ```Debug``` and ```Release``` as options.
|
|
||||||
|
|
||||||
:warning: For development reasons it is better to **install the client on user space** instead on the global system. Mixing up libs/dll's of different version can lead to undefined behavior and crashes:
|
|
||||||
|
|
||||||
* You could use the **cmake flag** ```CMAKE_INSTALL_PREFIX``` as ```~/.local/``` in a **Linux** system. If you want to install system wide you could use ```/usr/local``` or ```/opt/nextcloud/```.
|
|
||||||
|
|
||||||
* On **Windows 10** [```$USERPROFILE```](https://docs.microsoft.com/en-us/windows/deployment/usmt/usmt-recognized-environment-variables#a-href-idbkmk-2avariables-that-are-recognized-only-in-the-user-context) refers to ```C:\Users\<USERNAME>```.
|
|
||||||
|
|
||||||
|
|
||||||
## :penguin: Linux
|
|
||||||
|
|
||||||
### Generate the build files:
|
|
||||||
```
|
|
||||||
$ cd build
|
|
||||||
$ cmake .. -DCMAKE_INSTALL_PREFIX=~/nextcloud-desktop-client -DCMAKE_BUILD_TYPE=Debug
|
|
||||||
```
|
|
||||||
|
|
||||||
### Compile and install:
|
|
||||||
```
|
|
||||||
$ make install
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## :door: Windows
|
|
||||||
|
|
||||||
#### Generate the build files:
|
|
||||||
|
|
||||||
```
|
|
||||||
$ cmake "-GVisual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=$USERPROFILE\nextcloud-desktop-client -DCMAKE_BUILD_TYPE=Debug
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Compile and install:
|
|
||||||
```
|
|
||||||
$ cmake --build . --config Debug --target install
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## :apple: Mac OS
|
|
||||||
|
|
||||||
#### macOS Universal binaries
|
|
||||||
There is no official support for M1 Arm binaries for Qt 5 only Qt 6.2 supports building M1 ARM and Intel binaries. So if you want to use Qt 5 you will have to compile Qt yourself (it's very important to use the latest public published commit of Qt5), OpenSSL and QtKeychain. To produce an universal binary you will to compile them all once for x86_64 and once for arm64.
|
|
||||||
|
|
||||||
It's also important to set the deployment target. This can be set by setting a environment variable before starting a build with `export MACOSX_DEPLOYMENT_TARGET=10.13`. We use 10.13 at the moment. The packages can then be compiled by following the guide below. Open a terminal and type:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
mkdir -p ~/nextcloud
|
|
||||||
cd ~/nextcloud
|
|
||||||
# Configure Qt5
|
|
||||||
git clone git://code.qt.io/qt/qt5.git
|
|
||||||
cd qt5
|
|
||||||
git checkout 5.15
|
|
||||||
./init-repository
|
|
||||||
cd ..
|
|
||||||
|
|
||||||
# Build Qt5 for x86_64
|
|
||||||
mkdir qt5-5.15-macOS-x86_64-release
|
|
||||||
cd qt5-5.15-macOS-x86_64-release
|
|
||||||
../qt5/configure -release -prefix ./qtbase -nomake examples -nomake tests QMAKE_APPLE_DEVICE_ARCHS=x86_64 -opensource -confirm-license -skip qt3d -skip qtwebengine
|
|
||||||
make -j15
|
|
||||||
cd ..
|
|
||||||
|
|
||||||
# Build Qt5 for arm64
|
|
||||||
mkdir qt5-5.15-macOS-arm64-release
|
|
||||||
cd qt5-5.15-macOS-x86_64-release
|
|
||||||
../qt5/configure -release -prefix ./qtbase -nomake examples -nomake tests QMAKE_APPLE_DEVICE_ARCHS=arm64 -opensource -confirm-license -skip qt3d -skip qtwebengine
|
|
||||||
make -j15
|
|
||||||
cd ..
|
|
||||||
|
|
||||||
# Configure OpenSSL
|
|
||||||
curl -O http://www.openssl.org/source/openssl-1.1.1k.tar.gz
|
|
||||||
|
|
||||||
# Build OpenSSL for x86_64
|
|
||||||
tar xvf openssl-1.1.1k.tar.gz
|
|
||||||
cd openssl-1.1.1k
|
|
||||||
# Switch to a x86 shell to use auto discovery of the platform in OpenSSL's config script
|
|
||||||
arch -x86_64 zsh
|
|
||||||
./config --prefix=/Users/nextcloud/nextcloud/openssl-1.1.1k-x86_64-release --openssldir=/Users/nextcloud/nextcloud/openssl-1.1.1k-x86_64-release
|
|
||||||
make -j15
|
|
||||||
make -j15 install
|
|
||||||
cd ..
|
|
||||||
rm -rf openssl-1.1.1k
|
|
||||||
# Exit from the x86 shell
|
|
||||||
exit
|
|
||||||
|
|
||||||
# Build OpenSSL for arm64
|
|
||||||
tar xvf openssl-1.1.1k.tar.gz
|
|
||||||
cd openssl-1.1.1k
|
|
||||||
./config --prefix=/Users/nextcloud/nextcloud/openssl-1.1.1k-arm64-release --openssldir=/Users/nextcloud/nextcloud/openssl-1.1.1k-arm64-release
|
|
||||||
make -j15
|
|
||||||
make -j15 install
|
|
||||||
cd ..
|
|
||||||
rm -rf openssl-1.1.1k
|
|
||||||
|
|
||||||
# Configure QtKeychain
|
|
||||||
git clone https://github.com/frankosterfeld/qtkeychain
|
|
||||||
|
|
||||||
# Build QtKeychain for x86_64
|
|
||||||
cd qtkeychain
|
|
||||||
mkdir build-x86_64
|
|
||||||
cd build-x86_64
|
|
||||||
cmake .. -DCMAKE_INSTALL_PREFIX=~/nextcloud/qtkeychain-x86_64-release -DCMAKE_OSX_ARCHITECTURES="x86_64"
|
|
||||||
make -j15
|
|
||||||
make -j15 install
|
|
||||||
cd ../..
|
|
||||||
|
|
||||||
# Build QtKeychain for arm64
|
|
||||||
cd qtkeychain
|
|
||||||
mkdir build-arm64
|
|
||||||
cd build-arm64
|
|
||||||
cmake .. -DCMAKE_INSTALL_PREFIX=~/nextcloud/qtkeychain-arm64-release -DCMAKE_OSX_ARCHITECTURES="arm64"
|
|
||||||
make -j15
|
|
||||||
make -j15 install
|
|
||||||
cd ../..
|
|
||||||
```
|
|
||||||
Now you can build two separate app packages of the desktop client (one for x86_64 and one for arm64) and then merge the binaries of these two app packages together to get a universal app package.
|
|
||||||
|
|
||||||
#### Compile the desktop client
|
|
||||||
After compiling Qt5, OpenSSL and QtKeychain, you can use this script (with the necessary modifications to match your environment and data) to compile, build, sign and notarize the package: [build.sh](https://github.com/nextcloud/client-building/blob/master/osx/daily/build.sh)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -1,25 +0,0 @@
|
||||||
## Step by step instructions for Visual Studio Community 2017 15.7.5
|
|
||||||
|
|
||||||
- Click with the right button on the desktop folder and pick to open on Visual Studio:
|
|
||||||
|
|
||||||
[[https://raw.githubusercontent.com/wiki/nextcloud/desktop/images/vs_opens_desktop.png|alt=Open cmake project on Visual Studio]]
|
|
||||||
|
|
||||||
- Open the [CMakeSettings.json](https://blogs.msdn.microsoft.com/vcblog/2017/08/14/cmake-support-in-visual-studio-customizing-your-environment/):
|
|
||||||
|
|
||||||
[[https://raw.githubusercontent.com/wiki/nextcloud/desktop/images/vs_open_cmake_json.png|alt=Open CMakeSettings.json]]
|
|
||||||
|
|
||||||
- Edit with the correct options - change the generator and disable Shibboleth:
|
|
||||||
|
|
||||||
[[https://raw.githubusercontent.com/wiki/nextcloud/desktop/images/vs_json_conf.png|alt=Edit CMakeSettings.json]]
|
|
||||||
|
|
||||||
- Pick the configuration you want to run:
|
|
||||||
|
|
||||||
[[https://raw.githubusercontent.com/wiki/nextcloud/desktop/images/vs_pick_debug.png|alt=Pick Debug or Release]]
|
|
||||||
|
|
||||||
- Build it:
|
|
||||||
|
|
||||||
[[https://raw.githubusercontent.com/wiki/nextcloud/desktop/images/vs_build_options.png|alt=Build Debug or Release]]
|
|
||||||
|
|
||||||
- Run the selected configuration:
|
|
||||||
|
|
||||||
[[https://raw.githubusercontent.com/wiki/nextcloud/desktop/images/vs_start_debug.png|alt=Run Debug or Release]]
|
|
||||||
|
|
@ -1,48 +0,0 @@
|
||||||
# Requirements
|
|
||||||
|
|
||||||
## General
|
|
||||||
- OpenSSL 1.1.x
|
|
||||||
- QtKeychain (https://github.com/frankosterfeld/qtkeychain)
|
|
||||||
- Qt 5.15
|
|
||||||
- zlib
|
|
||||||
- CMake
|
|
||||||
- A C++14 compiler
|
|
||||||
## Windows
|
|
||||||
- OpenSSL 1.1.x binaries: https://indy.fulgan.com/SSL/
|
|
||||||
- zlib binaries: https://github.com/maxirmx/Dist_zlib
|
|
||||||
- Visual Studio
|
|
||||||
- Recommended: Git bash (it comes with Git)
|
|
||||||
- Png2Icon - you need to use this version: https://github.com/hiiamok/png2ImageMagickICO
|
|
||||||
|
|
||||||
## Linux
|
|
||||||
On Ubuntu 20.04, install via terminal using this command:
|
|
||||||
```
|
|
||||||
sudo apt install cmake g++ qt5-default openssl libssl-dev libzip-dev qtbase5-private-dev qtdeclarative5-dev qtwebengine5-dev qt5keychain-dev qttools5-dev sqlite3 libsqlite3-dev libqt5svg5-dev zlib1g-dev libqt5websockets5-dev qtquickcontrols2-5-dev shared-mime-info
|
|
||||||
```
|
|
||||||
For Nautilus integration:
|
|
||||||
```
|
|
||||||
sudo apt install python-nautilus
|
|
||||||
wget -O ~/.local/share/nautilus-python/extensions/syncstate-Nextcloud.py "https://raw.githubusercontent.com/nextcloud/desktop/master/shell_integration/nautilus/syncstate.py"
|
|
||||||
```
|
|
||||||
|
|
||||||
For Dolphin integration:
|
|
||||||
- extra-cmake-modules
|
|
||||||
- libkf5kio-dev
|
|
||||||
|
|
||||||
## mac OS
|
|
||||||
- XCode...
|
|
||||||
- brew
|
|
||||||
- OpenSSL 1.1.x (brew install openssl@1.1)
|
|
||||||
- QtKeychain (brew install qtkeychain)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Loading…
Reference in a new issue