Skip to content

A weather app for iOS and Android built with Xamarin

License

Notifications You must be signed in to change notification settings

malirezai/XWeather

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XWeather

XWeather is a weather app for iOS and Android built with Xamarin.

iOS

ios-daily ios-hourly ios-details ios-locations ios-search

Android

android-daily android-hourly android-details android-locations android-search

Xamarin Test Cloud

Each time a code change is commit to this repo, the app is built with Visual Studio Team Services and deployed to be test on a plethora of apps in Xamarin Test Cloud. You can view results for both iOS and Android.

Screenshots

Screenshots

HockeyApp

XWeather uses HockeyApp to deploy pre-release versions to beta testers and record crash reports in production app.

Screenshots

Getting Started

You'll need to obtain a few API Keys and add them to a PrivateKeys.cs file in order to build and run app locally. You'll find instructions for obtaining and adding each key below.

PrivateKeys.cs

First, move (or copy) the template private keys file extras/PrivateKeys.cs into the constants directory XWeather/XWeather/Constants.

Weather Underground

XWeather gets weather data from Weather Underground's API. There are static data files included in the iOS and Android app bundle that will allow you to build and run the app with "test data". However, in order to get live weather data, add additional locations, etc., you'll need to create an Weather Underground account and obtain an API key. The free "Developer" tier is sufficient to run the app.

  • Sign up for new a Weather Underground account (or login to an existing one)
  • Purchase an new API Key. Make sure to select ANVIL PLAN, as the app uses several pieces of data in that plat.
  • In PrivateKeys.cs set the value of WuApiKey to your Weather Underground API Key.

Google Maps API key (Android)

To use location services in the Android version of XWeather, you'll need to obtain a Google Maps API key.

  • Follow the step-by-step guide to obtain a Google Maps API key.
  • In PrivateKeys.cs set the value of GoogleMapsApiKey to your Weather Underground API Key.

HockeyApp (optional)

HockeyApp is a platform to collect live crash reports, get feedback from your users, distribute your betas, recruit new testers, and analyze your test coverage.

Setting up HockeyApp is completely optional. You can set it up by following the steps listed below. However, if you'd rather skip this step for now, simply leave the values of HockeyApiKey_iOS and HockeyApiKey_Droid as empty strings.

  • Sign up for new a HockeyApp account (or login to an existing one)
  • Follow the How to create a new app tutorial to create an iOS and Android app.
  • In PrivateKeys.cs set the value of HockeyApiKey_iOS and HockeyApiKey_Droid to your new HockeyApp iOS and Android API keys respectively.

About

Created by Colby Williams. Thanks to @charlieyllobre for the awesome (free) weather icons.

Build Status

Project CI (master) Nightly (master) Weekly (master)
iOS iOS CI iOS Nightly iOS Weekly
Android Android CI Android Nightly Android Weekly

License

Licensed under the MIT License (MIT). See LICENSE for details.

About

A weather app for iOS and Android built with Xamarin

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 95.1%
  • Shell 4.9%