Workshop

Introduction to Widgets

Report a Bug · Ask a Question

Table of Contents

• About
• Getting Started
  • Installation
  • How to
• Issues and Discussions
• Support
• Authors & contributors
• License

---

About

The well-known and amazing iOS Home Screen experience remained almost unchanged from the first version of iOS until the Worldwide Developer Conference 2020, when Apple, with the announcement of iOS 14, revolutionised and enhanced it introducing Widgets.

Widgets are the best way to bring your Apps’ most useful information directly to the Home Screen or Today’s View on the iOS and iPadOS and also on macOS Notification Center.

Along with Widgets, Apple introduced also a new framework to implement them: WidgetKit. Thanks to WidgetKit and SwiftUI, developers can easily build Widgets and make them available across iOS, iPadOS, and macOS to provide a new dynamic and personalised experience for the Users and to make your app stand out and get noticed.

Getting Started

Installation

1. Clone the repo

   git clone https://github.com/developer-academy-unina/Workshop-Introduction-to-Widgets

2. Open the .xcodeproj file

How to

This Workshop will make you understand WidgetKit features and functionality, you will discover how to create a Widget project, configure the Widget and its provider, and start exploring timeline concepts by creating a real Widget from start to finish during the activity. The Moon App is an assets tracker app that will be used as starting point to create the Widget during the activity.

Issues and Discussions

You've found a bug in the source code, a mistake in the documentation or maybe you'd like a new feature? Take a look at GitHub Discussions to see if it's already being discussed. You can help us by submitting an issue on GitHub. Before you create an issue, make sure to search the issue archive -- your issue may have already been addressed!

Please try to create bug reports that are:

• Reproducible. Include steps to reproduce the problem.
• Specific. Include as much detail as possible: which version, what environment, etc.
• Unique. Do not duplicate existing opened issues.
• Scoped to a Single Bug. One bug per report.

Support

Reach out to the maintainer at one of the following places:

• GitHub Discussions
• GitHub issues
• Contact a Mentor for any other help

Authors & contributors

The original setup of this repository is by Pasquale Vittoriosi.

For a full list of all authors and contributors, see the contributors page.

License

This project is licensed under the MIT License.

See LICENSE for more information.