Go to file
Tobias Kaminsky 639a7b9f53
Merge pull request #12587 from nextcloud/fixAuthNPE
On branded clients NPE can occur
2024-02-23 14:49:52 +01:00
.devcontainer Update ubuntu Docker tag to v22 2024-01-28 20:29:53 +00:00
.github 🔄 synced local '.github/workflows/' with remote 'config/workflows/' 2024-02-23 11:00:24 +00:00
.idea extract tests 2024-01-16 12:17:50 +01:00
.tx [tx-robot] Update transifex configuration 2022-10-19 09:33:47 +00:00
app Merge pull request #12587 from nextcloud/fixAuthNPE 2024-02-23 14:49:52 +01:00
appscan lock in on java17 2023-06-05 15:13:32 +02:00
doc Android screenshot 2017-10-20 13:06:57 +02:00
drawable_resources Remove unused icons from project directory 2023-10-06 10:48:30 +02:00
fastlane update fastlane 2024-02-20 08:29:04 +01:00
gradle Update dependency com.google.firebase:firebase-messaging to v23.4.1 2024-02-23 07:12:48 +00:00
scripts Exclude shot for normal builds 2024-02-22 15:55:00 +01:00
src Fix(l10n): Update translations from Transifex 2024-02-20 02:37:10 +00:00
user_manual fix image dimensions 2021-10-21 16:06:49 +02:00
.codecov.yml Codecov: post comment only if there are coverage changes AND 2 reports have been received 2023-01-31 09:39:10 +01:00
.drone.yml metadata needs photos app 2023-12-01 10:03:47 +01:00
.editorconfig Update editorconfig to latest spotless checks 2023-05-13 19:55:58 +02:00
.gitignore Add dependency checksums and signing key information 2024-01-29 00:33:11 +01:00
.pullapprove.yml only one review 2019-01-21 13:23:58 +01:00
CHANGELOG.md Add changelog for 3.28.0 2024-02-20 07:57:32 +01:00
CODE_OF_CONDUCT.md add code of conduct 2018-01-11 15:49:37 +01:00
CONTRIBUTING.md fix: typo error in CONTRIBUTING.md 2023-11-01 00:26:55 +05:30
Gemfile Add huawei upload 2020-07-22 14:43:44 +02:00
Gemfile.lock update fastlane 2024-02-20 08:29:04 +01:00
ICONS.txt #781 add icons to website/twitter on user info screen, cleanup 2017-03-27 17:45:00 +02:00
LICENSE.txt Copyright note fixes 2013-04-17 12:26:13 +02:00
README.md Update README: FAQ/known issues section + misc 2024-01-24 00:48:53 +01:00
SECURITY.md Create SECURITY.md 2021-06-14 11:52:33 +02:00
SETUP.md fix: typo error in SETUP.md 2023-11-01 00:18:36 +05:30
THIRD_PARTY.txt Remove third party licenses for libs we don't use (anymore) 2022-02-24 16:53:29 +01:00
build.gradle Exclude shot for normal builds 2024-02-22 15:55:00 +01:00
checkstyle.xml Incorporated Checkstyle, findbugs, pmd and lint 2016-10-09 00:33:12 +01:00
gradle.properties Add dependency checksums and signing key information 2024-01-29 00:33:11 +01:00
gradlew Update dependency gradle to v8.5 2024-01-28 20:47:04 +00:00
gradlew.bat Update dependency gradle to v8.6 2024-02-04 14:38:49 +00:00
jacoco.gradle Build(deps): Bump com.android.tools.build:gradle from 8.0.1 to 8.0.2 2023-06-05 15:13:32 +02:00
ndk.env Centralize NDK and CMAKE versions 2022-03-15 14:43:05 +01:00
renovate.json5 Renovate: sign off commits 2024-02-22 08:43:14 +01:00
ruleset.xml - rename ruleset 2019-04-12 07:44:25 +02:00
settings.gradle Extended AccountRemovalDialog 2023-11-27 13:25:47 +01:00
spotbugs-filter.xml spotbugs: ignore Room autogenerated classes 2022-11-15 10:02:46 +00:00
suppressions.xml Incorporated Checkstyle, findbugs, pmd and lint 2016-10-09 00:33:12 +01:00

README.md

Nextcloud Android app 📱

Build Status Codacy Badge Releases

Download from Google Play Get it on F-Droid

The Android client for Nextcloud. Easily work with your data on your Nextcloud.

App screenshots

Getting help ⛑️

Note: The section Known Problems / FAQs below may already document your situation.

If you need assistance or want to ask a question about the Android app, you are welcome to ask for support in the Nextcloud Help Forum. If you have found a probable bug or have an enhancement idea, feel free to open a new Issue on GitHub.

If you're not sure if something is a bug or a configuration matter (with your client, server, proxy, etc.), the Nextcloud Help Forum is probably the best place to start so that you can get feedback (you can always return here, after getting feedback there, to report a suspected bug).

Keep in mind, that this repository only manages the Android app. If you find bugs or have problems with the server/backend, you should use the Nextcloud Help Forum to ask for help or report the bug to the Nextcloud server team!

How to contribute 🚀

If you want to contribute to the Nextcloud Android client app, there are many ways to help whether or not you are a coder:

  • helping out other users on our forum at https://help.nextcloud.com
  • providing translations of the app on Transifex
  • reporting problems / suggesting enhancements by opening new issues
  • implementing proposed bug fixes and enhancement ideas by submitting PRs (associated with a corresponding issue preferably)
  • reviewing pull requests and providing feedback on code, implementation, and functionality
  • installing and testing pull request builds, daily/dev builds, or RCs/release candidate builds
  • enhancing Admin, User, or Developer documentation
  • hitting hard on the latest stable release by testing fundamental features and evaluating the user experience
  • proactively getting familiar with how to gather debug logs from your devices (so that you are prepared to provide a detailed report if you encounter a problem with the app in the future)

Contribution Guidelines & License 📜

GPLv2. All contributions to this repository from June, 16 2016 on are considered to be licensed under the AGPLv3 or any later version.

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>)

Please read the 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 to this repository.

More information on how to contribute: https://nextcloud.com/contribute/

Start contributing 🛠️

Make sure you read SETUP.md and 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 and working on starter issues.

Logs

Getting debug info via logcat 🔍

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

Note: You must have adb installed first!

On Windows:

  • download and install Minimal ADB and fastboot
  • 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> > "%USERPROFILE%\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 > "%USERPROFILE%\Downloads\logcatOutput.txt" (You might cancel the process after a while manually: it will not be exited automatically.)
  • For a PowerShell terminal, replace %USERPROFILE% with $env:USERPROFILE in the commands above.

On a device (with root) 🔧

  • 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

Note: Your device needs to be rooted for this approach!

Development version 🔨

Known Problems and FAQs

Push notifications do not work on F-Droid editions

Push Notifications are not currently supported in the F-Droid builds due to dependencies on Google Play services.

Remarks 📜

Google Play and the Google Play logo are trademarks of Google Inc.