README_CN.md

SplashScreenKit

SwiftUI 全新启动页 (Splash Screen)

Region	Languages
Global	English
Asia	廣東話 繁體中文 简体中文 日本語 한국어 Indo हिन्दी
Europe	Français Deutsch Español Русский Polski Türkçe
ME & Africa	العربية Kiswahili

版本

2.2.3 (稳定版本)
针对高性能交互进行了优化，确保零卡顿体验。

• 无缝无限轮播： 全新的虚拟索引逻辑，防止“卡片飞走”并确保流畅的无限旋转。
• 性能优化： 采用 Metal 加速渲染 (drawingGroup) 以及通过 RunLoop 进行高效的每帧更新。
• 动量滚动： 丝滑般流畅、基于速度的交互手势，具备原生减速感。
• AsyncImage 支持： 经过预验证的 URL 处理，实现无延迟的远程图片加载。
• 两种显示模式： 可在动态的 .carousel 和优雅的 .static 布局之间选择。
• 高级文字效果： 利用 SwiftUI 6.0 功能实现美观的文字渲染和过渡效果。

环境 / 测试平台

• 📲 需要 iOS 18.0+
• Swift 6.0
• Xcode 16.0+

如何使用

将包添加到您的项目中： https://github.com/1998code/19-Splash-Screen-for-SwiftUI

轮播模式 (默认)

经典的图片旋转交互体验。

SplashScreen(
    images: [
        Photo("ImageName1"),
        Photo("https://example.com/image.jpg") // 支持远程 URL！
    ],
    title: "欢迎使用",
    product: "Apple TV",
    caption: "浏览所有电影、电视节目等。",
    cta: "立即观看"
) {
    print("按钮被点击")
}

静态模式 (全新)

简洁、可滚动的布局，非常适合产品介绍。

SplashScreen(
    mode: .static,
    images: [Photo("https://url.to/header_image.jpg")],
    title: "创作者工作室",
    product: "免费试用 3 个月创作者工作室。",
    caption: "通过功能强大的应用将您的愿景变为现实。",
    features: [
        SplashFeature(title: "功能 1", icon: "video"),
        SplashFeature(title: "功能 2", icon: "waveform")
    ],
    footer: "适用条款与条件。",
    cta: "接受优惠",
    secondaryCta: "查看所有计划",
    secondaryAction: {
        print("次要按钮被点击")
    }
) {
    print("主要按钮被点击")
}

已知问题

• 仅支持 iOS 18+，利用了最新的 SwiftUI TextRenderer 和视觉效果 API。
• 尺寸调整：轮播模式针对 Pro/Pro Max 进行了优化。静态模式包含 ScrollView 以处理较小的设备和不同的内容长度。

版权

App Store 屏幕截图 © 2025 Apple Inc.

参考

Creating visual effects with SwiftUI - Apple Developer

X 上的相关贴文

https://x.com/1998design/status/2019418746553790664
https://x.com/1998design/status/1888641485303878110
https://x.com/1998design/status/1888945523845140677

组合推荐

配合 SwiftNEWKit 同时使用，效果翻倍！

许可证

MIT

赞助