简易博客系统，含客户端和服务器端，采用各种编程语言实现. .zip

# SDWebImageSwiftUI [](https://travis-ci.org/SDWebImage/SDWebImageSwiftUI) [](https://cocoapods.org/pods/SDWebImageSwiftUI) [](https://cocoapods.org/pods/SDWebImageSwiftUI) [](https://cocoapods.org/pods/SDWebImageSwiftUI) [](https://github.com/Carthage/Carthage) [](https://swift.org/package-manager/) [](https://codecov.io/gh/SDWebImage/SDWebImageSwiftUI) ## What's for SDWebImageSwiftUI is a SwiftUI image loading framework, which based on [SDWebImage](https://github.com/SDWebImage/SDWebImage). It brings all your favorite features from SDWebImage, like async image loading, memory/disk caching, animated image playback and performances. The framework provide the different View structs, which API match the SwiftUI framework guideline. If you're familiar with `Image`, you'll find it easy to use `WebImage` and `AnimatedImage`. ## Features Since SDWebImageSwiftUI is built on top of SDWebImage, it provide both the out-of-box features as well as advanced powerful features you may want in real world Apps. Check our [Wiki](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage) when you need: - [x] Animated Image full-stack solution, with balance of CPU && RAM - [x] Progressive image loading, with animation support - [x] Reusable download, never request single URL twice - [x] URL Request / Response Modifier, provide custom HTTP Header - [x] Image Transformer, apply corner radius or CIFilter - [x] Multiple caches system, query from different source - [x] Multiple loaders system, load from different resource You can also get all benefits from the existing community around with SDWebImage. You can have massive image format support (GIF/APNG/WebP/HEIF/AVIF/SVG/PDF) via [Coder Plugins](https://github.com/SDWebImage/SDWebImage/wiki/Coder-Plugin-List), PhotoKit support via [SDWebImagePhotosPlugin](https://github.com/SDWebImage/SDWebImagePhotosPlugin), Firebase integration via [FirebaseUI](https://github.com/firebase/FirebaseUI-iOS), etc. Besides all these features, we do optimization for SwiftUI, like Binding, View Modifier, using the same design pattern to become a good SwiftUI citizen. ## Version This framework is under heavily development, it's recommended to use [the latest release](https://github.com/SDWebImage/SDWebImageSwiftUI/releases) as much as possible (including SDWebImage dependency). This framework follows [Semantic Versioning](https://semver.org/). Each source-break API changes will bump to a major version. ## Changelog This project use [keep a changelog](https://keepachangelog.com/en/1.0.0/) format to record the changes. Check the [CHANGELOG.md](https://github.com/SDWebImage/SDWebImageSwiftUI/blob/master/CHANGELOG.md) about the changes between versions. The changes will also be updated in Release page. ## Contribution All issue reports, feature requests, contributions, and GitHub stars are welcomed. Hope for active feedback and promotion if you find this framework useful. ## Requirements + Xcode 12+ + iOS 13+ + macOS 10.15+ + tvOS 13+ + watchOS 6+ + Swift 5.2+ ## SwiftUI 2.0 Compatibility iOS 14(macOS 11) introduce the SwiftUI 2.0, which keep the most API compatible, but changes many internal behaviors, which breaks the SDWebImageSwiftUI's function. From v2.0.0, we adopt SwiftUI 2.0 and iOS 14(macOS 11)'s behavior. You can use `WebImage` and `AnimatedImage` inside the new `LazyVStack`. ```swift var body: some View { ScrollView { LazyVStack { ForEach(urls, id: \.self) { url in AnimatedImage(url: url) } } } } ``` Note: However, many differences behavior between iOS 13/14's is hard to fixup. Due to maintain issue, in the future release, we will drop the iOS 13 supports and always match SwiftUI 2.0's behavior. ## Installation #### Swift Package Manager SDWebImageSwiftUI is available through [Swift Package Manager](https://swift.org/package-manager/). + For App integration For App integration, you should using Xcode 12 or higher, to add this package to your App target. To do this, check [Adding Package Dependencies to Your App](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app?language=objc) about the step by step tutorial using Xcode. + For downstream framework For downstream framework author, you should create a `Package.swift` file into your git repo, then add the following line to mark your framework dependent our SDWebImageSwiftUI. ```swift let package = Package( dependencies: [ .package(url: "https://github.com/SDWebImage/SDWebImageSwiftUI.git", from: "2.0.0") ], ) ``` #### CocoaPods SDWebImageSwiftUI is available through [CocoaPods](https://cocoapods.org). To install it, simply add the following line to your Podfile: ```ruby pod 'SDWebImageSwiftUI' ``` #### Carthage SDWebImageSwiftUI is available through [Carthage](https://github.com/Carthage/Carthage). ``` github "SDWebImage/SDWebImageSwiftUI" ``` ## Usage ### Using `WebImage` to load network image - [x] Supports placeholder and detail options control for image loading as SDWebImage - [x] Supports progressive image loading (like baseline) - [x] Supports success/failure/progress changes event for custom handling - [x] Supports indicator with activity/progress indicator and customization - [x] Supports built-in animation and transition, powered by SwiftUI - [x] Supports animated image as well! ```swift var body: some View { WebImage(url: URL(string: "https://nokiatech.github.io/heif/content/images/ski_jump_1440x960.heic")) // Supports options and context, like `.delayPlaceholder` to show placeholder only when error .onSuccess { image, data, cacheType in // Success // Note: Data exist only when queried from disk cache or network. Use `.queryMemoryData` if you really need data } .resizable() // Resizable like SwiftUI.Image, you must use this modifier or the view will use the image bitmap size .placeholder(Image(systemName: "photo")) // Placeholder Image // Supports ViewBuilder as well .placeholder { Rectangle().foregroundColor(.gray) } .indicator(.activity) // Activity Indicator .transition(.fade(duration: 0.5)) // Fade Transition with duration .scaledToFit() .frame(width: 300, height: 300, alignment: .center) } ``` Note: This `WebImage` using `Image` for internal implementation, which is the best compatible for SwiftUI layout and animation system. But unlike SwiftUI's `Image` which does not support animated image or vector image, `WebImage` supports animated image as well (by defaults from v2.0.0). However, The `WebImage` animation provide simple common use case, so it's still recommend to use `AnimatedImage` for advanced controls like progressive animation rendering, or vector image rendering. ```swift @State var isAnimating: Bool = true var body: some View { WebImage(url: URL(string: "https://raw.githubusercontent.com/liyong03/YLGIFImage/master/YLGIFImageDemo/YLGIFImageDemo/joy.gif"), isAnimating: $isAnimating)) // Animation Control, supports dynamic changes // The initial value of binding should be true .customLoopCount(1) // Custom loop count .playbackRate(2.0) // Playback speed rate .playbackMode(.bounce) // Playback normally to the end, then reversely back to the start // `WebImage` supports advanced control just like `AnimatedImage`, but without the progressive animation support } ``` No