SwiftUI 向后移植

推出一系列 SwiftUI 向后移植功能，让您的 iOS 开发更加便捷。

许多向后移植支持 iOS 13+，但在 UIKit 的新功能在较新版本中引入时，这些向后移植也会遵循相同的适用性，以保持与 UIKit 的一致性。

在某些情况下，我还加入了一些额外的 API，为您的 SwiftUI 开发带来更多功能。

注意，所有向后移植都将与苹果官方 API 保持一致，任何额外功能将单独提供。

所有向后移植都有完整的文档，在大多数情况下使用苹果自己的文档以保持一致性。请参阅头文件文档或苹果原始文档以获取更多详细信息。

还有一个演示项目可供查看，其中展示了所有向后移植和附加功能的完整演示，包括参考代码以帮助您入门。

最后，我希望这个仓库也能成为一个很好的资源，展示如何通过最少的hack来有效地进行向后移植 👍

文档

完整的文档可以在这里找到。

赞助

构建这样有用的库需要花费我与家人相处的时间。我在业余时间构建这些工具，因为我认为回馈社区很重要。请考虑赞助我，这有助于我继续开发这些有用的库 😬

您也可以随时关注我并表示"感谢"。

使用方法

该库采用了由 Dave DeLong 设计的向后移植方法，使用单一类型来提高可发现性和可维护性，以便在未来移除向后移植实现，转而使用官方 API 时更加方便。

纯类型的向后移植可以在 Backport 命名空间下轻松发现。同样，修饰符可以在 .backport 命名空间下发现。

不幸的是，Environment 向后移植无法以这种方式访问，在这些情况下，苹果 API 值将以 backport 为前缀，以简化发现。

类型：

@Backport.AppStorage("filter-enabled")
private var filterEnabled: Bool = false

修饰符：

Button("Show Prompt") {
    showPrompt = true
}
.sheet(isPresented: $showPrompt) {
    Prompt()
        .backport.presentationDetents([.medium, .large])
}

环境：

@Environment(\.backportRefresh) private var refreshAction

向后移植

SwiftUI

• AsyncImage
• AppStorage
• background – ViewBuilder API
• DismissAction
• DynamicTypeSize – Label – LabeledContent
• NavigationDestination – 使用标准 NavigationView
• navigationTitle – 较新的 API
• overlay – ViewBuilder API
• onChange
• openURL
• ProgressView
• presentationDetents
• presentationDragIndicator
• quicklookPreview
• requestReview
• Refreshable – 包括下拉刷新
• ScaledMetric
• ShareLink
• StateObject
• scrollDisabled
• scrollDismissesKeyboard
• scrollIndicators
• Section(_ header:)
• task – async/await 修饰符

UIKit

• UIHostingConfiguration – 简化在 UICollectionViewCell 和 UITableViewCell 中嵌入 SwiftUI

附加功能

模态呈现

将此添加到您的呈现视图中，您可以使用提供的闭包在用户尝试交互式关闭时向其呈现 ActionSheet。您还可以使用它来完全禁用交互式关闭。

presentation(isModal: true) { /* attempt */ }

FittingGeometryReader

一个自定义的 GeometryReader 实现，可以正确地自动调整大小以适应其内容。这在许多需要 GeometryReader 但又不希望它隐式占用父视图边界的情况下非常有用。

FittingScrollView

一个自定义的 ScrollView，在内容不可滚动时尊重 Spacer。当您需要在滚动视图边缘放置视图，而内容小到不需要滚动时，这非常有用。另一个很好的用例是垂直居中的内容，一旦内容需要滚动，就会变成 top 对齐。

安装

您可以手动安装（通过复制 Sources 目录中的文件）或使用 Swift Package Manager（首选）

要使用 Swift Package Manager 安装，请将以下内容添加到 Package.swift 文件的 dependencies 部分：

.package(url: "https://github.com/shaps80/SwiftUIBackports.git", .upToNextMajor(from: "2.0.0"))