Swift Package Index 标志。Swift Package Index

追踪 Swift 6 严格并发检查的数据竞争安全性的采用情况。有多少包为 Swift 6 做好准备

版本化 DocC 文档


更新: 此博文中的信息已被我们的官方文档取代。请参考该文档,而不是这篇博文。

两个月前,我们推出了自动生成、自动托管和自动更新 DocC 文档,今天我们再次带来更多以文档为中心的新闻!

对于包作者来说,选择加入此功能非常简单,只需快速修改包的 .spi.yml 文件,告诉我们用于文档生成过程的目标/平台即可。剩下的事情都由我们处理,并且每个选择加入的包都会自动显示“Documentation(文档)”链接。

我们很高兴地说,此功能非常成功,现在已有超过一百个包选择在我们这里托管文档。这太棒了!

今天,对于这 103 位包作者,我们有一些好消息要宣布。你们做出了正确的选择,因为你们现在也自动获得了版本化文档!

我们最初为包的默认分支生成文档。这是我们构建该功能的最简单方法,也是一个良好的开端,但版本化文档才是我们的目标。

当您使用一个包时,通常会使用最新的标记版本,因此我们应该默认显示从该版本生成的文档。从今天开始,情况就是这样了。

Package documentation showing a tagged release in the breadcrumb bar at the top of the page.

我们将继续为默认分支生成文档,并且随着包的演变,我们将为每个主要版本保留存档文档。将鼠标悬停在版本上即可切换到不同版本或默认分支的文档

Package documentation showing a drop-down menu with both the latest tagged release and the default branch version.

我们还移动了为一个包生成多个文档存档的包的选择器

Package documentation showing a drop-down menu with multiple documentation archives generated from one package.

为什么不使用其中一个已记录的包来查看此功能呢?按字母顺序,您可以从 AdvancedListAgoraUIKit_iOSAnimationPlannerAnyAsyncSequenceAnyLintAnyMeasureapnswiftAppFoundationAppStorageBoutiqueBuildkitebytesCalendarKitCameraControlARViewCertificateSigningRequestCombineCoreBluetoothcomposable-effect-identifierComputeConcurrencyPlusCryptoSwiftCurrencyConverterCustomRepeatDateDesignReviewerDflatEffectsLibraryEpoxyFileSystemEventPublisherFocusEntityGatheredKitGeoJSONKitgis-toolsHandySwiftHandyUIKitKeyboardShortcutsKeyboardToolbarKingfisherLeftPadLindenmayerLocationFormatterLottieMediaMeshGeneratorMicroyaMonthYearWheelPickermqtt-nioMuJoComvt-toolsNetworkReachabilityOperationPlusParseSwiftPianoRollPioneerpostgres-nioPrettyPrettyLogreactiveswift-composable-architectureRevenueCatRunestoneSagaScaledFontSceneKitDebugToolsScript.swiftsecp256k1SemanticVersionSemanticVersioningKitServerSGPKitSmoothGradientSpanGridSquirrel3SteamStoreFlowableStreamChatStreamChatSwiftUIStreamChatVaporStytchswift-bundlerswift-case-pathsswift-composable-architectureswift-confidentialswift-markdownswift-multipart-formdataswift-parsingswift-url-routingswift-xml-parserSwiftDocCSwiftInspectorSwiftPlantUMLSwiftProtobufswiftui-cached-async-imageSwiftUIChartsSwiftUnitsSwiftVizScaleSwiftyProvisioningProfileTGCardViewControllerUnsplashFrameworkUpdetoURLCompatibilityKitvapor-routingWeakReferenceXCSnippetsYamsYMatterType! 哎唷! 😅

我们希望大家喜欢这个功能,如果您想为您的包生成文档,请参考启动博文中的说明


关于此博客

Swift Package Index 是 Swift 包的搜索引擎和元数据索引。我们的主要目标是帮助您更好地决定应用程序和项目中包含的依赖项。如果您是新来的用户,最好的入门方式是搜索包