XWeather

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

iOS

Android

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.

HockeyApp

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

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
Android

License

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