Giter VIP home page Giter VIP logo

xweather's Introduction

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.

xweather's People

Contributors

colbylwilliams avatar naterickard avatar

Watchers

James Cloos avatar Wilfrido Reyes avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.