зеркало из https://github.com/nextcloud/desktop.git
Коммит
ab38bbf10e
140
README.md
140
README.md
|
@ -1,96 +1,94 @@
|
||||||
# Nextcloud Desktop Client
|
# Nextcloud Desktop Client
|
||||||
|
|
||||||
The :computer: Nextcloud Desktop Client is a tool to synchronize files from Nextcloud Server
|
The Nextcloud Desktop Client is a tool to synchronize files from Nextcloud Server with your computer.
|
||||||
with your computer.
|
|
||||||
|
|
||||||
## 📥 Download Binaries
|
|
||||||
|
|
||||||
### https://github.com/nextcloud-releases/desktop/releases
|
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="doc/images/main_dialog_christine.png" alt="Desktop Client on Windows" width="450">
|
<img src="doc/images/main_dialog_christine.png" alt="Desktop Client on Windows" width="450">
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## :blue_heart: :tada: Contributing
|
## :rocket: Releases
|
||||||
|
For the latest stable recommended version, please refer to the [download page https://nextcloud.com/install/#install-clients](https://nextcloud.com/install/#install-clients)
|
||||||
|
|
||||||
### :hammer_and_wrench: How to compile the desktop client
|
## Contributing to the desktop client
|
||||||
|
:v: Please read the [Code of Conduct](https://nextcloud.com/community/code-of-conduct/). This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere and to explain how together we can strengthen and support each other.
|
||||||
|
|
||||||
:building_construction: [System requirements](https://github.com/nextcloud/desktop/wiki/System-requirements-for-compiling-the-desktop-client) includes OpenSSL 1.1.x, QtKeychain, Qt 5.x.x and zlib.
|
### 👪 Join the team
|
||||||
|
There are many ways to contribute, of which development is only one! Find out [how to get involved](https://nextcloud.com/contribute/), including as a translator, designer, tester, helping others, and much more! 😍
|
||||||
|
|
||||||
#### :memo: Step by step instructions
|
### Help testing
|
||||||
|
Download and install the client:<br>
|
||||||
|
[🔽 All releases](https://github.com/nextcloud-releases/desktop/releases)<br>
|
||||||
|
[🔽 Daily master builds](https://download.nextcloud.com/desktop/daily)
|
||||||
|
|
||||||
##### Clone the repo
|
### Reporting issues
|
||||||
|
If you find any bugs or have any suggestion for improvement, please
|
||||||
|
[open an issue in this repository](https://github.com/nextcloud/desktop/issues).
|
||||||
|
|
||||||
|
### Bug fixing and development
|
||||||
|
#### 1. 🚀 Set up your local development environment
|
||||||
|
|
||||||
|
1.1 System requirements
|
||||||
|
- [Windows 10, Windows 11]((https://github.com/nextcloud/desktop-client-blueprints/)), Mac OS > 10.14 or Linux
|
||||||
|
|
||||||
|
> [!NOTE]
|
||||||
|
> Find the system requirements and instructions on [how to work on Windows with KDE Craft](https://github.com/nextcloud/desktop-client-blueprints/) on our [desktop client blueprints repository](https://github.com/nextcloud/desktop-client-blueprints/).
|
||||||
|
|
||||||
|
- [🔽 Inkscape (to generate icons)](https://inkscape.org/release/)
|
||||||
|
- Developer tools: cmake, clang/gcc/g++:
|
||||||
|
- Qt6 since 3.14, Qt5 for earlier versions
|
||||||
|
- OpenSSL
|
||||||
|
- [🔽 QtKeychain](https://github.com/frankosterfeld/qtkeychain)
|
||||||
|
- SQLite
|
||||||
|
|
||||||
|
1.2 Optional
|
||||||
|
- [Qt Creator IDE](https://www.qt.io/product/development-tools)
|
||||||
|
- [delta: A viewer for git and diff output](https://github.com/dandavison/delta)
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> We highly recommend [Nextcloud development environment on Docker Compose](https://juliushaertl.github.io/nextcloud-docker-dev/) for testing/bug fixing/development.<br>
|
||||||
|
> ▶️ https://juliushaertl.github.io/nextcloud-docker-dev/
|
||||||
|
|
||||||
|
1.3 Step by step instructions on how to build the client
|
||||||
|
1. Clone the Github repository:
|
||||||
```
|
```
|
||||||
$ git clone https://github.com/nextcloud/desktop.git
|
git clone https://github.com/nextcloud/desktop.git
|
||||||
$ cd desktop
|
|
||||||
```
|
```
|
||||||
##### Compile and install
|
2. Create <build directory>:
|
||||||
|
|
||||||
: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>```.
|
|
||||||
|
|
||||||
##### Linux & Mac OS
|
|
||||||
|
|
||||||
```
|
```
|
||||||
$ cmake -S . -B build -DCMAKE_INSTALL_PREFIX=~/nextcloud-desktop-client -DCMAKE_BUILD_TYPE=Debug
|
mkdir <build directory>
|
||||||
$ cmake --build build --target install
|
```
|
||||||
|
3. Compile:
|
||||||
|
```
|
||||||
|
cd <build directory>
|
||||||
|
cmake -S <cloned desktop repo> -B build -DCMAKE_INSTALL_PREFIX=<dependencies> -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=. -DNEXTCLOUD_DEV=ON
|
||||||
```
|
```
|
||||||
|
|
||||||
##### Windows
|
> [!TIP]
|
||||||
|
> The cmake variabel NEXTCLOUD_DEV allows you to run your own build of the client while developing in parallel with an installed version of the client.
|
||||||
|
|
||||||
|
4. Build it:
|
||||||
|
- Windows:
|
||||||
```
|
```
|
||||||
$ cmake -S . -B build -G "Visual Studio 15 2017 Win64" -DCMAKE_INSTALL_PREFIX=$USERPROFILE\nextcloud-desktop-client -DCMAKE_BUILD_TYPE=Debug
|
cmake --build .
|
||||||
$ cmake --build . --config Debug --target install
|
```
|
||||||
|
- Other platforms:
|
||||||
|
```
|
||||||
|
make
|
||||||
```
|
```
|
||||||
|
|
||||||
:information_source: More detailed instructions can be found at the [Desktop Client Wiki](https://github.com/nextcloud/desktop/wiki).
|
#### 2. 🐛 [Pick a good first issue](https://github.com/nextcloud/desktop/labels/good%20first%20issue)
|
||||||
|
#### 3. 👩🔧 Create a branch and make your changes. Remember to sign off your commits using `git commit -sm "Your commit message"`
|
||||||
|
#### 4. ⬆ Create a [pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) and `@mention` the people from the issue to review
|
||||||
|
#### 5. 👍 Fix things that come up during a review
|
||||||
|
#### 6. 🎉 Wait for it to get merged!
|
||||||
|
|
||||||
### :inbox_tray: Where to find binaries to download
|
## Get in touch 💬
|
||||||
|
* [📋 Forum](https://help.nextcloud.com)
|
||||||
|
* [👥 Facebook](https://www.facebook.com/nextclouders)
|
||||||
|
* [🐣 Twitter](https://twitter.com/Nextclouders)
|
||||||
|
* [🐘 Mastodon](https://mastodon.xyz/@nextcloud)
|
||||||
|
|
||||||
#### :high_brightness: Daily builds
|
You can also [get support for Nextcloud](https://nextcloud.com/support)!
|
||||||
|
|
||||||
- Daily builds based on the latest master are available for Linux :penguin:, Mac, and Windows
|
|
||||||
[in the desktop/daily folder of our download server](https://download.nextcloud.com/desktop/daily).
|
|
||||||
For more info: [Wiki/Daily Builds](https://github.com/nextcloud/desktop/wiki/Daily-Builds).
|
|
||||||
|
|
||||||
#### :rocket: Releases
|
|
||||||
|
|
||||||
- Refer to the [download page https://nextcloud.com/install/#install-clients](https://nextcloud.com/install/#install-clients)
|
|
||||||
|
|
||||||
### :bomb: Reporting issues
|
|
||||||
|
|
||||||
- If you find any bugs or have any suggestion for improvement, please
|
|
||||||
file an issue at https://github.com/nextcloud/desktop/issues. Do not
|
|
||||||
contact the authors directly by mail, as this increases the chance
|
|
||||||
of your report being lost. :boom:
|
|
||||||
|
|
||||||
### :smiley: :trophy: Pull requests
|
|
||||||
|
|
||||||
- If you created a patch :heart_eyes:, please submit a [Pull
|
|
||||||
Request](https://github.com/nextcloud/desktop/pulls).
|
|
||||||
- How to create a pull request? This guide will help you get started: [Opening a pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) :heart:
|
|
||||||
|
|
||||||
|
|
||||||
## :satellite: Contact us
|
|
||||||
|
|
||||||
If you want to contact us, e.g. before starting a more complex feature, for questions :question:
|
|
||||||
you can join us at
|
|
||||||
[#nextcloud-client](https://webchat.freenode.net/?channels=nextcloud-client).
|
|
||||||
|
|
||||||
## :v: Code of conduct
|
|
||||||
|
|
||||||
The Nextcloud community has core values that are shared between all members during conferences, hackweeks and on all interactions in online platforms including [Github](https://github.com/nextcloud) and [Forums](https://help.nextcloud.com). If you contribute, participate or interact with this community, please respect [our shared values](https://nextcloud.com/code-of-conduct/). :relieved:
|
|
||||||
|
|
||||||
## :memo: Source code
|
|
||||||
|
|
||||||
The Nextcloud Desktop Client is developed in Git. Since Git makes it easy to
|
|
||||||
fork and improve the source code and to adapt it to your need, many copies
|
|
||||||
can be found on the Internet, in particular on GitHub. However, the
|
|
||||||
authoritative repository maintained by the developers is located at
|
|
||||||
https://github.com/nextcloud/desktop.
|
|
||||||
|
|
||||||
## :scroll: License
|
## :scroll: License
|
||||||
|
|
||||||
|
|
Загрузка…
Ссылка в новой задаче