Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Lightweight Android library to read parts of RSS 2.0 feeds.
Java
branch: master

Merge pull request #23 from JorisvanWinden/readme

Add markdown extension to README.
latest commit 3fd577a83e
ahorn authored

README.md

Package: org.mcsoxford.rss License: Apache License Version 2.0 Authors: A. Horn Description: Lightweight Android library to read parts of RSS 2.0 feeds.

== Installation ==

Fetch the source code with Git:

git clone https://ahorn@github.com/ahorn/android-rss.git

Alternatively, you can download the sources from github.com/ahorn.

To reference the downloaded library from within your Android mobile app, navigate to the /tools/ directory and use the following command:

android update project \ --target \ --path path/to/your/project \ --library path/to/android-rss

This command appends to the "default.properties" file in your Android project a new "android.library.reference" property. The value of this new property should be the relative path to the directory which you created when you fetched the Android RSS library source code.

Henceforth, android-rss is compiled when ant builds the app which was specified in the --path argument above.

However, Eclipse does not work using this method because it does not reference anything that is not an Eclipse project. When you try to transform android-rss into an Eclipse project you encounter errors due to the testing directory. To fix these, you have to change the source directory by editing the .classpath file to set "/src/main/java" as the source folder.

For additional questions, see also the Troubleshooting section below.

== Troubleshooting ==

Error "android resolve to a path with no default.properties file for project": http://groups.google.com/group/android-developers/browse_thread/thread/37e7728cc2e8f315

Android library project documentation: http://developer.android.com/guide/developing/projects/projects-cmdline.html#ReferencingLibraryProject

Eclipse reports the error: "Default target help does not exist in this project" https://github.com/ahorn/android-rss/issues/2

== API Usage ==

RSSReader reader = new RSSReader(); String uri = "http://feeds.bbci.co.uk/news/world/rss.xml"; RSSFeed feed = reader.load(uri);

== Discussion ==

http://groups.google.com/group/android-developers/browse_thread/thread/b3de98eab436be20

Something went wrong with that request. Please try again.