cmtrounce / SwURL

Lightweight and customisable async image loading in SwiftUI. Supports on-disk storage, placeholders and more!

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SwURL

Build Status License: MIT contributions welcome

Asyncrounously download and display images in Swift UI. Supports progress indicators, placeholders and image transitions.

SwURLImage

Asyncrounously download and display images declaratively. Supports progress indicators, placeholders and image transitions. Flexible caching options.

Flexible caching and image fetching done in background. Currently tested with basic List as seen in Example

"But, AsyncImage"

It's great that Apple now has official support for async images, however:

Unlike AsyncImage, SwURLImage:

  • Is supported from iOS 13
  • Supports caching (in memory, on disk, and custom)
  • Supports progress indicators (including download fraction) and custom transitions
  • Has in depth, customisable logging

Getting Started

Get it

SwURL is available only through Swift Package Manager

  • Open Xcode
  • Go to File > Swift Packages > Add Package Dependency...
  • Paste this Github Repo URL ( https://github.com/cmtrounce/SwURL ) into the search bar.
  • Select the SwURL repo from the search results.
  • Choose the branch/version you want to clone. The most recent release is the most stable but you can choose branches master and develop for the most up to date changes.
  • Confirm and enjoy!

Read the Documentation

Get started by reading the documentation in your browser here.

The documentation includes usage examples and makes the code easier to explore.

There is also an example project in this repo that you can give a try.

Contact

Join the SwURL Gitter community at https://gitter.im/SwURL-package/community and message me directly. Recommended for quicker response time.

You can also follow/message me on Twitter at https://twitter.com/cmtrounce

About

Lightweight and customisable async image loading in SwiftUI. Supports on-disk storage, placeholders and more!

License:MIT License


Languages

Language:Swift 100.0%