BBC News App

Communication

Our chat channel is on gitter.

Development

A native Android app using Java for writing code.

Installing Procedure

-> Fork the repository. -> Clone the repo using the terminal command. Make sure you replace username with your GitHub username. "git clone https://github.com/username/BBCNewsApp.git"

Setting up the Android Project

1. Download the BBC News App project source. You can do this either by forking and cloning the repository (recommended if you plan on pushing changes) or by downloading it as a ZIP file and extracting it.

2. Open Android Studio, you will see a Welcome to Android window. Under Quick Start, select Import Project (Eclipse ADT, Gradle, etc.)

3. Navigate to the directory where you saved the susi_android project, select the root folder of the project (the folder named "BBC News App"), and hit OK. Android Studio should now begin building the project with Gradle.

4. Once this process is complete and Android Studio opens, check the Console for any build errors.

   Note: If you receive a Gradle sync error titled, "failed to find ...", you should click on the link below the error message (if available) that says Install missing platform(s) and sync project and allow Android studio to fetch you what is missing. Once all build errors have been resolved, you should be all set to build the app and test it.

5. To Build the app, go to Build>Make Project (or alternatively press the Make Project icon in the toolbar).

6. If the app was built successfully, you can test it by running it on either a real device or an emulated one by going to Run>Run 'app' or pressing the Run icon in the toolbar.

API Used

-> BBC News Api.

Recording At Runtime

-> The above attached video shows the working of the BBC News App.

Built With

1. Android Studio (version: 3.2.1)
2. Windows 10 Pro (version: 1803)

License

This project is licensed under the MIT License, see the LICENSE.md for more details.