DocumentKit Logo

Version Swift 6.0 Swift UI MIT License Twitter: @danielsaidi Mastodon: @danielsaidi@mastodon.social

关于 DocumentKit

DocumentKit 是一个 SwiftUI SDK,它为基于 DocumentGroup 的应用程序添加了更多功能。

基于 DocumentGroup 的应用程序在自定义方面受到相当大的限制。 DocumentKit 使您可以更轻松地向文档浏览器添加自定义项目、在启动时显示启动画面和引导屏幕等。

这使您可以为基于 DocumentGroup 的应用程序创建更好的用户体验。

‼️重要信息

iOS 18 完全更改了底层类型,从而改变了 DocumentGroup 的外观和行为。 您现在可以做比以前更多的事情,这使得此 SDK 的用处降低了。

虽然此版本修复了一些问题,例如使模态屏幕正常工作,但 UIDocumentBrowserViewController 自定义不再有效,因为 DocumentGroup 使用了一种新的底层类型。

由于您现在可以使用原生的 DocumentGroup 做更多的事情,因此此版本将保持原样,直到 iOS 19 发布,然后删除...除非有人提出在 iOS 18 中使用它的另一种方法。

安装

DocumentKit 可以使用 Swift Package Manager 安装

https://github.com/danielsaidi/DocumentKit.git

入门

DocumentKit 使用修饰符扩展了 DocumentGroup,使您可以添加自定义工具栏项目、自定义文档浏览器等。

@main
struct MyApp: App {

    var body: some Scene {
        DocumentGroup(newDocument: DemoDocument()) { file in
            ContentView(document: file.$document)
        }
        .additionalNavigationBarButtonItems(
            leading: [...],
            trailing: [...]
        )
        .allowsDocumentCreation(true)
        .allowsPickingMultipleItems(true)
        .showFileExtensions(true)
        .onboardingSheet {
            MyOnboardingScreen()
        }
        .splashSheet {
            MySplashScreen()
        }
    }
}

DocumentKit 还使用修饰符扩展了 DocumentGroup,使您可以在应用程序启动时显示引导模态框和启动画面,让您可以检查底层文档浏览器等。

请参阅在线入门指南以获取更多信息。

文档

在线文档包含更多信息、文章、代码示例等。

支持我的工作

您可以在 GitHub Sponsors 上赞助我,或者联系我以获得付费支持,以帮助支持我的开源项目

您的支持使我有可能投入更多精力到这些项目中,并使其达到最佳状态。

联系方式

如果您有任何问题或想以任何方式做出贡献,请随时与我联系

许可证

DocumentKit 在 MIT 许可证下可用。 有关更多信息,请参见LICENSE文件。