{"id":13996,"date":"2014-09-08T15:27:15","date_gmt":"2014-09-08T19:27:15","guid":{"rendered":"http:\/\/blog.xamarin.com\/?p=13996"},"modified":"2014-09-08T15:27:15","modified_gmt":"2014-09-08T19:27:15","slug":"evolve-countdown-ios-8-today-widget","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/evolve-countdown-ios-8-today-widget\/","title":{"rendered":"Evolve Countdown iOS 8 Today Widget"},"content":{"rendered":"

\t\t\t\tCount down how many days until Evolve<\/a> from the iOS 8 notification screen using a Today Widget<\/em>:<\/p>\n

\"today<\/p>\n

iOS 8 introduces a variety of extensibility features called extensions<\/em>. Extensions allow applications to offer user experiences throughout the system in ways that were not available previously to third party developers.<\/p>\n

With app extensions, applications can now offer features\u00a0such as custom keyboards, content sharing, and photo editing to name just a few of the new ways to provide system-wide functionality.<\/p>\n

Today Widgets<\/h2>\n

One type of extension is called a Today Widget<\/em>, which is an extension that lives on the notification screen along with the widgets provided by Apple. This is a great place for an application to offer updated data for people to consume at a glance without having to open the application. Scenarios involving\u00a0sports scores, package trackers and news headlines make for good Today Widget<\/em> use cases.<\/p>\n

Evolve Countdown Widget<\/h2>\n

Let\u2019s take a look at a Today Widget<\/em> that displays the number of days until Xamarin Evolve 2014<\/a>.<\/p>\n

Widgets are created using\u00a0an Extension Project template under the Unified API project templates, as extensions are required to support both 64 and 32 bit architectures.<\/p>\n

\"extension<\/p>\n

You don\u2019t create a stand-alone extension, rather it must be created and referenced from a container application. In this case, I created a small app that displays the Evolve website in a WKWebView and then added the extension project as a reference.<\/p>\n

\"container<\/a><\/p>\n

There are a few configurations that need to be set in the Info.plist for the extension:<\/p>\n

\"extension<\/p>\n

In this case, I included a button in the extension that, when tapped, will launch the app so the app registers a custom url scheme as well:<\/p>\n

\"custom<\/p>\n

To create the extension, I designed the UI in a storyboard with a UIImage, UILabel and UIButton respectively. Note, since the unified API is required, use Xcode to wire up controls to code (code generation support for the Xamarin designer will come in a future release).<\/p>\n

The notification center determines the frame for the extension. The best way to control the layout of controls is using auto-layout, which is what I used here.<\/p>\n

Adding the Extension\u2019s Code<\/h2>\n

A today widget is just a view controller. Therefore, the code is implemented much like other view controllers, as shown below:<\/p>\n

\npublic override void ViewDidLoad ()\n{\n  base.ViewDidLoad ();\n\n  PreferredContentSize = new CGSize (PreferredContentSize.Width, 55f);\n  var evolveStartDate = new DateTime (2014, 10, 6);\n  var numDays = (evolveStartDate - DateTime.Now).Days;\n\n  WidgetTitle.Text = String.Format ("{0} days until Evolve", numDays);\n  WidgetButton.SetTitle ("Tap here to register", UIControlState.Normal);\n  WidgetButton.TouchUpInside += (sender, e) => UIApplication.SharedApplication.OpenUrl (new NSUrl ("evolveCountdown:\/\/"));\n}\n<\/pre>\n
When the application is deployed, the user will have the option to include the widget in the notification screen:<\/p>\n
\"include<\/p>\n
After adding the widget, tapping the butting results in the app opening, thanks to the custom url scheme it registered:<\/p>\n
\"container<\/p>\n
Extensions like Today Widgets<\/em>\u00a0allow applications to deliver experiences that\u00a0only for Apple could provide in the past, so it\u2019s great to see this added flexibility come to iOS.<\/p>\n
Join me at Evolve to discuss this and many other exciting new iOS 8 features!<\/p>\n
The code from this post is available here<\/a>.<\/p>\n
Discuss this blog post in the Xamarin Forums<\/em><\/a>\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"
Count down how many days until Evolve from the iOS 8 notification screen using a Today Widget: iOS 8 introduces a variety of extensibility features called extensions. Extensions allow applications to offer user experiences throughout the system in ways that were not available previously to third party developers. With app extensions, applications can now offer […]<\/p>\n","protected":false},"author":546,"featured_media":39167,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[2],"tags":[6,13,4],"class_list":["post-13996","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-developers","tag-ios","tag-xamarin-evolve","tag-xamarin-platform"],"acf":[],"blog_post_summary":"
Count down how many days until Evolve from the iOS 8 notification screen using a Today Widget: iOS 8 introduces a variety of extensibility features called extensions. Extensions allow applications to offer user experiences throughout the system in ways that were not available previously to third party developers. With app extensions, applications can now offer […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/13996","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/users\/546"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/comments?post=13996"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/13996\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media\/39167"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media?parent=13996"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/categories?post=13996"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/tags?post=13996"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}