news-android/README.md
David-Development 83213c4b85 Update README.md
2013-07-21 19:31:20 +02:00

7 KiB

ownCloud News Reader - Android App

The ownCloud News Reader Android App is under AGPLv3 License terms.
Status: Beta
Bugs and enhancements can be reported under: https://github.com/owncloud/News-Android-App/issues

How to use the Beta App via Google Play ?

Please update your News App and Appframework to the latest version which is only available on GitHub.

ownCloud News App: https://github.com/owncloud/news

Appframework: https://github.com/owncloud/appframework

After this, join the following Google Group: https://groups.google.com/d/forum/owncloud-news-android-app there you can find a link to Google Play for registering as beta tester of the app.

Language

Is your language not supported yet ?
You can add your language easily on:
https://www.transifex.com/projects/p/owncloud/resource/android-news/

FAQ:

The app shows an empty Toast when trying to sync or sign-in (little dark box at the button of the screen)

  • Make sure you're using the latest version of the news app and the appframework from GitHub. Otherwise you can use the Android version <= 0.3.3 (via Google Play or GitHub Choose version).

Roadmap

My ToDo List is available on: http://www.strikeapp.com/#z6679l3t

How to compile the App

Requirements:

  1. Eclipse + ADT Plugin + Android SDK installed
  2. Git installed (you can do the following stuff without git but I'm not going to show how).

Download and install:

  1. Open cmd/terminal
  2. Navigate to your workspace
  3. Then type in:

git clone https://github.com/JakeWharton/ActionBarSherlock.git git clone https://github.com/David-Development/Android-PullToRefresh.git git clone https://github.com/owncloud/News-Android-App.git

Go to Eclipse and do the following:
--> File --> Import --> Android Project from Exsisting Source --> [...]/ActionBarSherlock/actionbarsherlock
--> File --> Import --> Android Project from Exsisting Source --> [...]/Android-PullToRefresh/library
--> File --> Import --> Android Project from Exsisting Source --> [...]/News-Android-App

Then make a right click on the News-Android-App Project and select "Properties". Select the tab "Android". In this Window you should see the Project Build Target at the top and Libarys at the buttom of the window. Two of them are maybe marked with a read cross. So remove them and add the ActionBarSherlock and the Android PullToRefresh Libary

If you get this error message:
"Found 2 versions of android-support-v4.jar in the dependency list, but not all the versions are identical (check is based on SHA-1 only at this time)." try to copy the [...]/News-Android-App/libs/android-support-v4.jar file to [...]/ActionBarSherlock/actionbarsherlock/android-support-v4.jar

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

Updates

0.3.9

  • Support for APIv1 and APIv2. (That means the app on Google Play will be updated, too!)
  • Small fixes
  • Improved memory usage while synchronizing
  • Auto sync of item state every 5 minutes
  • Changed font style to Roboto Light

0.3.8

0.3.7

0.3.6

0.3.5

0.3.4

  • Offline reading (Only when you sync items the marked/starred/unread/unstarred items get synchronized. This save a lot of network traffic
  • Offline image caching
  • Login is getting verified when you click sign-in
  • Strict-Hostname-Verification (Important Security Fix)
  • Simple or extended list view
  • Light or dark app Theme
  • Implemented #29 Mark all Article in one Column as readed
  • A lot of other new stuff and fixes

0.3.3

  • Dark/Light App Theme
  • Feed List Design Simple/Extended
  • many new languages have been added

0.3.2

  • Fixed app crash when leaving item detail view.

0.3.1

  • Polish language support added (thank you for translating Cyryl)
  • App crash fixed when no item header text is available
  • Go back in the item view if you press the home button
  • Added Up Button in detail view as fix for GitHub Issue #13
  • Other small fixes

0.3.0

  • Android 2.2+ Support added
  • small bugfixes