|
@@ -1,24 +1,25 @@
|
|
# [Nextcloud](https://nextcloud.com) Android app :iphone:
|
|
# [Nextcloud](https://nextcloud.com) Android app :iphone:
|
|
|
|
|
|
-[](https://drone.nextcloud.com/nextcloud/android) [](https://www.codacy.com/app/Nextcloud/android?utm_source=github.com&utm_medium=referral&utm_content=nextcloud/android&utm_campaign=Badge_Grade) [](https://github.com/nextcloud/android/releases/latest)
|
|
|
|
|
|
+[](https://drone.nextcloud.com/nextcloud/android) [](https://www.codacy.com/app/Nextcloud/android?utm_source=github.com\&utm_medium=referral\&utm_content=nextcloud/android\&utm_campaign=Badge_Grade) [](https://github.com/nextcloud/android/releases/latest)
|
|
|
|
|
|
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png"
|
|
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png"
|
|
- alt="Download from Google Play"
|
|
|
|
- height="80">](https://play.google.com/store/apps/details?id=com.nextcloud.client)
|
|
|
|
|
|
+alt="Download from Google Play"
|
|
|
|
+height="80">](https://play.google.com/store/apps/details?id=com.nextcloud.client)
|
|
[<img src="https://f-droid.org/badge/get-it-on.png"
|
|
[<img src="https://f-droid.org/badge/get-it-on.png"
|
|
- alt="Get it on F-Droid"
|
|
|
|
- height="80">](https://f-droid.org/packages/com.nextcloud.client/)
|
|
|
|
|
|
+alt="Get it on F-Droid"
|
|
|
|
+height="80">](https://f-droid.org/packages/com.nextcloud.client/)
|
|
|
|
|
|
**The Android client for [Nextcloud](https://nextcloud.com). Easily work with your data on your Nextcloud.**
|
|
**The Android client for [Nextcloud](https://nextcloud.com). Easily work with your data on your Nextcloud.**
|
|
|
|
|
|

|
|

|
|
|
|
|
|
## How to contribute :rocket:
|
|
## How to contribute :rocket:
|
|
-If you want to [contribute](https://nextcloud.com/contribute/) to Nextcloud, you are very welcome:
|
|
|
|
|
|
|
|
-- our forum at https://help.nextcloud.com
|
|
|
|
-- for translations of the app on [Transifex](https://www.transifex.com/nextcloud/nextcloud/android/)
|
|
|
|
-- opening issues and PRs (including a corresponding issue)
|
|
|
|
|
|
+If you want to [contribute](https://nextcloud.com/contribute/) to Nextcloud, you are very welcome:
|
|
|
|
+
|
|
|
|
+* our forum at https://help.nextcloud.com
|
|
|
|
+* for translations of the app on [Transifex](https://www.transifex.com/nextcloud/nextcloud/android/)
|
|
|
|
+* opening issues and PRs (including a corresponding issue)
|
|
|
|
|
|
## Contribution Guidelines & License :scroll:
|
|
## Contribution Guidelines & License :scroll:
|
|
|
|
|
|
@@ -26,52 +27,56 @@ If you want to [contribute](https://nextcloud.com/contribute/) to Nextcloud, you
|
|
|
|
|
|
Nextcloud doesn't require a CLA (Contributor License Agreement). The copyright belongs to all the individual contributors. Therefore we recommend that every contributor adds following line to the header of a file, if they changed it substantially:
|
|
Nextcloud doesn't require a CLA (Contributor License Agreement). The copyright belongs to all the individual contributors. Therefore we recommend that every contributor adds following line to the header of a file, if they changed it substantially:
|
|
|
|
|
|
-```
|
|
|
|
-@copyright Copyright (c) <year>, <your name> (<your email address>)
|
|
|
|
-```
|
|
|
|
|
|
+ @copyright Copyright (c) <year>, <your name> (<your email address>)
|
|
|
|
|
|
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.
|
|
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.
|
|
|
|
|
|
Please review the [guidelines for contributing](https://github.com/nextcloud/android/blob/master/CONTRIBUTING.md) to this repository.
|
|
Please review the [guidelines for contributing](https://github.com/nextcloud/android/blob/master/CONTRIBUTING.md) to this repository.
|
|
|
|
|
|
-More information how to contribute: [https://nextcloud.com/contribute/](https://nextcloud.com/contribute/)
|
|
|
|
|
|
+More information how to contribute: <https://nextcloud.com/contribute/>
|
|
|
|
+
|
|
|
|
+## Start contributing :hammer\_and\_wrench:
|
|
|
|
|
|
-## Start contributing :hammer_and_wrench:
|
|
|
|
Make sure you read [SETUP.md](https://github.com/nextcloud/android/blob/master/SETUP.md) and [CONTRIBUTING.md](https://github.com/nextcloud/android/blob/master/CONTRIBUTING.md) before you start working on this project. But basically: fork this repository and contribute back using pull requests to the master branch.
|
|
Make sure you read [SETUP.md](https://github.com/nextcloud/android/blob/master/SETUP.md) and [CONTRIBUTING.md](https://github.com/nextcloud/android/blob/master/CONTRIBUTING.md) before you start working on this project. But basically: fork this repository and contribute back using pull requests to the master branch.
|
|
Easy starting points are also reviewing [pull requests](https://github.com/nextcloud/android/pulls) and working on [starter issues](https://github.com/nextcloud/android/issues?q=is%3Aopen+is%3Aissue+label%3A%22starter+issue%22).
|
|
Easy starting points are also reviewing [pull requests](https://github.com/nextcloud/android/pulls) and working on [starter issues](https://github.com/nextcloud/android/issues?q=is%3Aopen+is%3Aissue+label%3A%22starter+issue%22).
|
|
|
|
|
|
### Getting debug info via logcat :mag:
|
|
### Getting debug info via logcat :mag:
|
|
|
|
+
|
|
#### With a linux computer:
|
|
#### With a linux computer:
|
|
-- enable USB-Debugging in your smartphones developer settings and connect it via USB
|
|
|
|
-- open command prompt/terminal
|
|
|
|
-- enter `adb logcat --pid=$(adb shell pidof -s 'com.nextcloud.client') > logcatOutput.txt` to save the output to this file
|
|
|
|
|
|
+
|
|
|
|
+* enable USB-Debugging in your smartphones developer settings and connect it via USB
|
|
|
|
+* open command prompt/terminal
|
|
|
|
+* enter `adb logcat --pid=$(adb shell pidof -s 'com.nextcloud.client') > logcatOutput.txt` to save the output to this file
|
|
|
|
|
|
**Note:** You must have [adb](https://developer.android.com/studio/releases/platform-tools.html) installed first!
|
|
**Note:** You must have [adb](https://developer.android.com/studio/releases/platform-tools.html) installed first!
|
|
|
|
|
|
#### On Windows:
|
|
#### On Windows:
|
|
-- download and install [Minimal ADB and fastboot](https://forum.xda-developers.com/t/tool-minimal-adb-and-fastboot-2-9-18.2317790/#post-42407269)
|
|
|
|
-- enable USB-Debugging in your smartphones developer settings and connect it via USB
|
|
|
|
-- launch Minimal ADB and fastboot
|
|
|
|
-- enter `adb shell pidof -s 'com.nextcloud.client` and use the output as `<processID>` in the following command:
|
|
|
|
-- `adb logcat --pid=<processID> > %HOMEPATH%\Downloads\logcatOutput.txt` (This will produce a `logcatOutput.txt` file in your downloads)
|
|
|
|
-- if the processID is `18841`, an example command is: `adb logcat --pid=18841 > %HOMEPATH%\Downloads\logcatOutput.txt` (You might cancel the process after a while manually: it will not be exited automatically.)
|
|
|
|
|
|
+
|
|
|
|
+* download and install [Minimal ADB and fastboot](https://forum.xda-developers.com/t/tool-minimal-adb-and-fastboot-2-9-18.2317790/#post-42407269)
|
|
|
|
+* enable USB-Debugging in your smartphones developer settings and connect it via USB
|
|
|
|
+* launch Minimal ADB and fastboot
|
|
|
|
+* enter `adb shell pidof -s 'com.nextcloud.client` and use the output as `<processID>` in the following command:
|
|
|
|
+* `adb logcat --pid=<processID> > %HOMEPATH%\Downloads\logcatOutput.txt` (This will produce a `logcatOutput.txt` file in your downloads)
|
|
|
|
+* if the processID is `18841`, an example command is: `adb logcat --pid=18841 > %HOMEPATH%\Downloads\logcatOutput.txt` (You might cancel the process after a while manually: it will not be exited automatically.)
|
|
|
|
|
|
#### On a device (with root) :wrench:
|
|
#### On a device (with root) :wrench:
|
|
-- open terminal app *(can be enabled in developer options)*
|
|
|
|
-- get root access via "su"
|
|
|
|
-- enter `logcat -d --pid $(pidof -s com.nextcloud.client) -f /sdcard/logcatOutput.txt`
|
|
|
|
|
|
|
|
-or
|
|
|
|
|
|
+* open terminal app *(can be enabled in developer options)*
|
|
|
|
+* get root access via "su"
|
|
|
|
+* enter `logcat -d --pid $(pidof -s com.nextcloud.client) -f /sdcard/logcatOutput.txt`
|
|
|
|
+
|
|
|
|
+or
|
|
|
|
|
|
-- use [CatLog](https://play.google.com/store/apps/details?id=com.nolanlawson.logcat) or [aLogcat](https://play.google.com/store/apps/details?id=org.jtb.alogcat)
|
|
|
|
|
|
+* use [CatLog](https://play.google.com/store/apps/details?id=com.nolanlawson.logcat) or [aLogcat](https://play.google.com/store/apps/details?id=org.jtb.alogcat)
|
|
|
|
|
|
**Note:** Your device needs to be rooted for this approach!
|
|
**Note:** Your device needs to be rooted for this approach!
|
|
|
|
|
|
## Development version :hammer:
|
|
## Development version :hammer:
|
|
-- [APK (direct download)](https://download.nextcloud.com/android/dev/latest.apk)
|
|
|
|
-- [F-Droid](https://f-droid.org/en/packages/com.nextcloud.android.beta/)
|
|
|
|
|
|
|
|
-## Support :rescue_worker_helmet:
|
|
|
|
|
|
+* [APK (direct download)](https://download.nextcloud.com/android/dev/latest.apk)
|
|
|
|
+* [F-Droid](https://f-droid.org/en/packages/com.nextcloud.android.beta/)
|
|
|
|
+
|
|
|
|
+## Support :rescue\_worker\_helmet:
|
|
|
|
|
|
If you need assistance or want to ask a question about the Android app, you are welcome to [ask for support](https://help.nextcloud.com/c/clients/android) in our Forums. If you have found a bug, feel free to [open a new Issue on GitHub](https://github.com/nextcloud/android/issues). Keep in mind, that this repository only manages the Android app. If you find bugs or have problems with the server/backend, you should ask the [Nextcloud server team](https://github.com/nextcloud/server) for help!
|
|
If you need assistance or want to ask a question about the Android app, you are welcome to [ask for support](https://help.nextcloud.com/c/clients/android) in our Forums. If you have found a bug, feel free to [open a new Issue on GitHub](https://github.com/nextcloud/android/issues). Keep in mind, that this repository only manages the Android app. If you find bugs or have problems with the server/backend, you should ask the [Nextcloud server team](https://github.com/nextcloud/server) for help!
|
|
|
|
|