news-android/README.md

5.8 KiB

Nextcloud News for Android

Android CI GitHub issues GitHub stars License: GPL v3 CHANGELOG.md PayPal this git repo

An Android client for Nextcloud News App.

▶️ Access

Latest Release F-Droid Release Beta channel

Get it on Play Store Get it on F-Droid Donate with PayPal

👀 Screenshots

1 2 3
Feed list Articles Details

👪 Join the team

How to compile the App

Requirements

  1. Android Studio

Download and install

  1. Open cmd/terminal
  2. Navigate to your workspace
  3. Then type in: git clone https://github.com/nextcloud/news-android.git
  4. Import the Project in Android Studio and start coding!

Testing with Android Auto

  1. Open Android Studio, click on "Tools" -> "SDK Manager"
  2. Select and install "Android Auto API Simulators"
  3. Open terminal, go to /extras/google/simulators (e.g. cd ~/Library/Android/sdk/extras/google/simulators)
  4. Install apk using adb (../../../platform-tools/adb install media-browser-simulator.apk)
  5. Install apk using adb (../../../platform-tools/adb install messaging-simulator.apk)

Advanced Testing Android Auto (e.g. Voice Features) Link

  1. Install Android 9 in an Emulator (Android 10 didn't work with the Android Auto App)
  2. Install Android Auto from PlayStore
  3. Follow instructions on training website (see link above)
  4. `~/Library/Android/sdk/platform-tools/adb forward tcp:5277 tcp:5277
  5. cd ~/Library/Android/sdk/extras/google/auto
  6. ./desktop-head-unit
  7. From inside the terminal type: mic play ./voice/pause.wav

That's all. I hope it works for you! If something is not working, please send me an email to david-dev@live.de

Updating the database schema

  • Edit Database Schema in LastestVersion.java
    • Make sure to increase version number inside getVersionNumber function
  • Open build.gradle and uncomment imports annotated with // Required for DAO generation
  • In Android Studio - choose "DatabaseOrmGenerator" configuration
  • Hit the "Run" Button

Updating Dependencies

This project uses Gradle's Dependency Verification Feature:

In case you get the following error "Dependency verification failed" or in case you updated a dependencies you need to run the following commands to allow the new version:

# run in the project root
./gradlew --write-verification-metadata pgp,sha256 help
./gradlew --export-keys

Analyze Dependencies

./gradlew build --scan  

Contributors