Home

Awesome

<p align="center"> <a href="https://github.com/WillieWangWei"><img src="https://img.shields.io/badge/language-swift-orange.svg"></a> <a href="https://github.com/WillieWangWei"><img src="https://img.shields.io/github/repo-size/WillieWangWei/SwiftUI-Tutorials.svg"></a> <a href="https://github.com/WillieWangWei/SwiftUI-Tutorials/blob/master/LICENSE"><img src="https://img.shields.io/github/license/WillieWangWei/SwiftUI-Tutorials.svg"></a> </p>

构建示例项目需要以下环境:

概述

对于初步学习和使用 SwiftUI 的开发者来说,官方教程无疑是最好的范例。它以构建一个 App 为脉络,串联出了 SwiftUI 重要的知识点,并主动抛出开发中一些常见的问题,然后用 SwiftUI 给出了解决方案。通过阅读此教程,你将逐步获得使用 SwiftUI 开发 App 的技能和思想。

此项目为 SwiftUI Tutorials 的翻译及代码示例,具体内容请翻阅:

🎉 SwiftUI 教程(中文)

项目中的代码为完成所有教程后的最终成品,你可以直接体验多种 SwiftUI 特性。另外,你也可以在每个教程章节中下载对应的起始和完成代码。

完成本教程,你将获得一个这样的 App 以及一套精彩的 SwiftUI 代码:

平台预览
iOS
watchOS
macOS

觉得不错?给个 Star 或 Follow 👌

更新日志

版本内容
v1.0.0完成初版
v1.0.1同步官方文档<br>增加成品预览
v1.0.2同步官方文档<br>优化翻译,修复翻译错误,让阅读更流畅<br>增加了代码高亮<br>标记出了代码修改范围,便于上下文对比
v1.0.3新增章节《创建 watchOS App》<br>修复代码bug<br>增加 watchOS App 成品预览<br>
v1.0.4同步官方文档
v1.0.5添加 Wiki 子模块
v1.0.6新增章节《创建 macOS App》

调整

图片

为了优化阅读体验,部分图片加上了 #000000 50% 10 Blur 的阴影。

视频

由于 GitHub Wiki 的限制,所有视频已转码成 GIF

代码

在实际编码中,由于本地环境和官方教程不一致,导致部分方法的声明和调用方式、代码风格等与官方教程有细微出入,例如:

官方教程:

.
.
.
struct MapView: UIViewRepresentable {
    func makeUIView(context: Context) -> MKMapView {
        MKMapView(frame: .zero)
    }
}
.
.
.

这里的 UIViewRepresentable 是一个协议,它的声明中包含一个 associatedtype :

/// The type of `UIView` to be presented.
associatedtype UIViewType : UIView

在开发中,给此 associatedtype 赋值后 Xcode 对方法的签名补全会有变化,最终写作:

.
.
.
struct MapView : UIViewRepresentable {
    
    typealias UIViewType = MKMapView
    
    func makeUIView(context: UIViewRepresentableContext<MapView>) -> MKMapView {
        return MKMapView(frame: .zero)
    }
}
.
.
.

如此修改不再一一列举,只需记得此类修改不会改变原教程的构建结果即可,不必过于纠结。

微信技术群

SwiftUI 代表未来构建 App 的方向,欢迎加群一起交流技术,解决问题。

加群现在需要申请了,可以先加我微信,备注 "SwiftUI",我会拉你进群。

Stargazers over time

Sparkline

Stargazers over time

License

This project is licensed under the MIT License - see the LICENSE.md file for details.