dylangore / mobile-app-dev-1-assignment2

Kotlin-based weather app for Android

Mobile App Development 1: Assignment 2

This is a Kotlin-based weather app for Android.

View Releases

Notable Features

• Display weather warnings from Met Éireann
• Display most recent conditions reported by Met Éireann's 25 weather observation stations
• Display a weather forecast for a specified location using data from the Meteorologisk institutt (met.no)
• Save and load a list of locations to/from a JSON file
• MapBox maps to view and choose locations (User location permission can be granted if desired)
• The option to add observation stations as saved locations or just view a weather forecast for that area
• Automated testing, linting and APK building using GitHub actions

Android / Material Design Notable Features

• Use of multiple Material design components / Material Design-themed standard components
  • MaterialTextView
  • Switch
  • ActionBar
  • SnackBar
  • SwipeRefreshLayout
  • FloatingActionButton
  • MaterialButton
• Use of Material Design icons
• Theme, fonts and colors are all based on the Material Design guilelines
• Dark mode is supported
• Launcher icon is adaptive and will work with any configured icon shape
• Background intents / services are used to request data from the various APIs

Development

In order to setup a development environment, you must add the following Gradle properties. These can be added to either the project gradle.properties file or the global gradle.properties file.

MAPBOX_DOWNLOADS_TOKEN=sk.xxxxxxxxxx
MAPBOX_ACCESS_TOKEN="pk.xxxxxxxxxx";

For more details on where to get the required tokens, see the MapBox Android Installation Guide.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Dylan Gore ⚠️ 💻 🚧 🤔 📆

This project follows the all-contributors specification. Contributions of any kind welcome!

Branches

• main - Main branch
• development - Development branch

Attribution

• Material Design Icons

References

• Android Developer Documentation
• Material Design Documentation
• MapBox Android SDK Documentation
• Migrating the deprecated Kotlin Android Extensions compiler plugin
• How to know when you’re using dark mode programmatically
• davidmoten/geo
• Pull to Refresh with RecyclerView in Android with Example
• Kotlin Android Broadcast Intents and Broadcast Receivers
• Android BroadcastReceiver Example Tutorial
• IntentService is deprecated, how do I replace it with JobIntentService?
• Setting Up the Search Interface
• Make Search Bar Filter Work Using Fragment & ListView In Android
• Retrofit
• Retrofit — Synchronous and Asynchronous Requests
• GitHub Actions

mobile-app-dev-1-assignment2's Issues

Update Observation Station map start point

The initial starting position of the map should be Ireland as that is where all of the observation stations are located.

Add myself as a contributor

@all-contributors please add @DylanGore for code, tests, maintenance, ideas, projectManagement

List of observation stations in reverse order

The list of observation stations is returned in reverse-alphabetical order by the API. This should be fixed.

Issues with network requests cause a crash

MainActivity is Re-created Unnecessarily