An Android library to parse a RSS Feed
Switch branches/tags
Clone or download
Latest commit 72bdede Dec 9, 2018

README.md

RSS Parser

Download License API

Important Notice

Versions 1.4 and 1.4.1 have been deleted due to a critical dependency error. Please forgive me and update to version 1.4.4

About

This is an Android library to parse a RSS Feed. You can retrive the following information about an article:

  • Title
  • Author
  • Description
  • Content
  • Main Image
  • Link
  • Publication Date
  • Categories

Disclaimer: This library has been built starting from RSS feed generated from a Wordpress Site. Of course it's compatible with RSS feed generated from other tipe of sites; Here you can find an example of RSS feed.

How to

Import:

The library is uploaded in jCenter, so you can easily add the dependency:

dependencies {
  compile 'com.prof.rssparser:rssparser:1.4.4'
}

Use:

import com.prof.rssparser.Article;
import com.prof.rssparser.Parser;

//url of RSS feed
String urlString = "http://www.androidcentral.com/feed";
Parser parser = new Parser();
parser.execute(urlString);
parser.onFinish(new Parser.OnTaskCompleted() {
    
    @Override
    public void onTaskCompleted(ArrayList<Article> list) {
      //what to do when the parsing is done
      //the Array List contains all article's data. For example you can use it for your adapter. 
    }

    @Override
    public void onError() {
      //what to do in case of error
    }
});

Sample app

I wrote a simple app that shows articles from Android Authority. If in the article's content there isn't a image, a placeholder will be load.

You can browse the code in this repo. You can also download the apk file to try it!

Please use the issues tracker only to report issues. If you have any kind of question you can ask it on the blog post on my website

Changelog

  • 8 December 2018 - Include thrown exception in onError() callback (PR #22) - Version 1.4.5
  • 7 Semptember 2018 - Add more sources for the featured image. Removed unused resources and improved the parsing of the image. Fixed dependency errors. - Version 1.4.4
  • 14 December 2017 - Little fixes on Error Management - Version 1.3.1
  • 13 December 2017 - Improved Error Management - Version 1.3
  • 10 December 2017 - Added support for the categories - Version 1.2
  • 12 August 2017 - Fixed the Library Manifest and updated the dependencies - Version 1.1
  • 18 June 2016 - First release - Version 1.0

License

   Copyright 2016 Marco Gomiero

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.