Skip to content

指南 ​

每一篇讲怎么做成一件事,按步骤走一遍。某个属性、方法的细节看 API 文档。

开始 ​

页面说明
建一个自己的 App从零建一个用 Nacre 的 iOS App:四个文件,装几个包,跑两条命令,模拟器上就能看到。
配置 App:名字、语言、权限文案App 的名字、包名、支持哪些语言、向用户申请权限时显示的那句话、哪些链接能打开它,都写在项目根目录的 nacre.config.json 里。

App 和页面 ​

页面说明
建窗口和处理场景这一篇讲 App 的界面从哪里开始:等系统交来场景(UIWindowScene),在场景上建窗口(UIWindow),以及场景被系统销毁、又重新接入时界面怎么办。
处理 App 的生命周期这一篇讲 App 从启动到进后台、回前台、内存不足这一路上,代码写在哪里:建界面、保存数据、释放缓存、让屏幕常亮、在 App 的各部分之间传消息。
统一处理错误这一篇讲怎么在一个地方接住 App 里所有没被捕获的异常和没被处理的 Promise 拒绝。
处理打开 App 的链接这一篇讲用户在别的 App 或网页里点了一条指向本 App 的链接时,怎么接到这条链接并跳到对应的页面。
做一个页面这一篇讲怎么用 UIViewController 做一屏内容:往页面上放东西、设标题、在页面出现和消失时做事、把另一个页面嵌进来。
在页面之间跳转这一篇讲怎么用导航控制器 UINavigationController 做「列表 → 详情 → 再下一层」这种一层层进入、再一层层返回的界面:推入、返回、知道现在在哪一页、页面离开时清理、按路径跳转。
弹出一个模态页这一篇讲怎么把一个页面模态呈现出来、怎么关掉它、怎么知道用户把它拖走了。
做一组底部标签这一篇讲怎么用标签控制器 UITabBarController 做「首页、行情、我的」这种屏幕底部有一排标签的主界面:设标签的样子、加角标、切换、在每个标签里放导航栈。
在导航条上放按钮和标题这一篇讲怎么设置导航条上的东西:正中的标题、右侧和左侧的按钮、返回按钮。
弹出提示框和菜单这一篇讲怎么用系统弹窗 UIAlertController 和它的按钮 UIAlertAction 提示用户、让用户确认、在几个操作里选一个、输入一段文字。
分享内容这一篇讲怎么用系统的分享面板 UIActivityViewController 把文字、链接、图片交给别的 App 或系统动作,以及怎么知道用户分享了没有。

视图和布局 ​

页面说明
在屏幕上摆放视图这一篇讲怎么用 UIView 在屏幕上放出东西:创建视图、给位置和大小、设外观、加到视图树上,以及调整叠放顺序、隐藏、移除、圆角、裁剪、变换、响应点按。
用约束排版这一篇讲怎么用约束(Auto Layout)摆放视图:固定宽高、居中、贴边、避开刘海、上下排列、等宽、比例、最小最大尺寸、展开收起、占位、跟随键盘,以及约束写错时怎么查。
把视图排成一行或一列这一篇讲怎么用 UIStackView 把一组视图排成一行或一列:等宽平分、让一项占满剩余空间、对齐、隐藏、插入和移除、内边距、底色和圆角、嵌套成多行。
做一个能滚动的页面这一篇讲怎么用 UIScrollView 做一个能滚动的页面:搭骨架、查滚不动的原因、读滚动位置、用代码滚动、横向滚动、轮播、键盘。
做一个列表这一篇讲怎么用 UICollectionView 做一个列表:给数据、增删改行、分区、点选、滚到某一项、加载更多、在单元格里放自己的视图。
做模糊和玻璃效果这一篇讲怎么用 UIVisualEffectView 做半透明的模糊面板、让面板上的文字更鲜明、用 iOS 26 的玻璃,以及看不出效果时查哪里。
显示加载和进度这一篇讲怎么告诉用户「有一件事正在进行」:不知道要多久时用转圈 UIActivityIndicatorView,知道完成了多少时用进度条 UIProgressView。
做一个工具条这一篇讲怎么用 UIToolbar 做一排按钮:放到页面底部、排按钮、增减按钮、放到键盘上方。

文字、图片、颜色 ​

页面说明
显示文字这一篇讲怎么用 UILabel 显示文字:标题、多行说明、放不下时截断或缩小、量出文字需要多大、阴影。
设置字体这一篇讲怎么用 UIFont 给文字设字体:字号、粗细、斜体、等宽、跟随用户的文字大小设置、用指定名字的字体。
显示带样式的文字这一篇讲怎么用富文本在一段文字里混用几种字体和颜色,加下划线、删除线、阴影,调行距和对齐,插入图片,量出尺寸,以及富文本在标签、输入框、按钮上怎么读写。
显示图片这一篇讲怎么用 UIImage 和 UIImageView 显示图片:打包在 App 里的图、系统图标、网络图片、本地文件里的图、动图,以及图片怎么摆、怎么上色、怎么拉伸。
设置颜色这一篇讲怎么给视图、文字、图层设颜色:固定色、半透明、跟随浅色和深色模式的颜色、Asset Catalog 里的颜色,以及读出、比较、去掉颜色。
适配深色模式这一篇讲怎么让界面跟着浅色和深色模式变:什么时候只用颜色就够了、怎么判断当前外观、怎么在 App 里做主题开关、怎么让图层上的颜色和字号跟着变。

控件、输入和手势 ​

页面说明
做一个按钮这一篇讲怎么用 UIButton 做出常见的按钮:创建、响应点击、改外观、禁用、加图标。
处理控件的触摸这一篇讲怎么用 UIControl 的控件事件响应触摸:响应点击、按下时改外观、区分松手的位置、禁用、在代码里模拟点击,以及自己做一块可点击的区域。
做开关、滑块和步进器这一篇讲怎么用三种取值的控件让用户选一个值:UISwitch(开关,两个取值)、UISlider(滑块,在一段连续的范围里取值)、UIStepper(步进器,一档一档地加减)。
做分段选择和页码这一篇讲两种控件的常见用法:UISegmentedControl(分段选择,在几个并列的选项之间切换)和 UIPageControl(页码,一排表示「一共几页、现在第几页」的小圆点)。
让用户选日期和时间这一篇讲怎么用 UIDatePicker 让用户选一个日期、一个时间或者一段时长:选样式、限定范围、选时长、用代码改日期。
做一个输入框这一篇讲怎么用 UITextField 做单行输入:读出内容、响应输入、弹出和收起键盘、不被键盘挡住、限制输入、做一个登录表单。
做一个多行输入框这一篇讲怎么用 UITextView 做多行输入:读写内容、显示占位文字、跟着内容长高、只读展示、收起键盘、避开键盘。
做一个搜索框这一篇讲怎么用 UISearchBar 做搜索:放到页面上、边输入边筛选、提交搜索、取消按钮、范围按钮、设置键盘。
响应手势这一篇讲怎么用手势识别器让普通视图响应点按、长按、拖动、捏合、旋转和轻扫,以及识别器和按钮、和别的识别器、和滚动视图放在一起时谁生效。
让读屏念对你的界面这一篇讲怎么用 UIView 上的无障碍属性让读屏把界面念对:什么时候把视图设成读屏元素、名字和提示和值各放什么、特征怎么选、把自己做的控件合成一个元素、让读屏只在弹层里转。

图层和动画 ​

页面说明
用图层画圆角、阴影、渐变和形状这一篇讲怎么用图层给视图加圆角、边框、阴影,怎么用 CAGradientLayer 画渐变、用 CAShapeLayer 画折线、扇形、进度环和虚线,以及子图层的大小怎么跟上视图、颜色怎么跟上深浅色。
画一条路径这一篇讲怎么用 UIBezierPath 描出形状,再交给 CAShapeLayer 画到屏幕上:矩形、圆角、圆弧、折线、曲线、扇形,以及判断一个点落在不在形状里。
让视图动起来这一篇讲怎么用 UIView.animateWithDuration() 让视图的属性带动画地变化:淡入淡出、移动、缩放、改约束、弹簧效果,以及动画结束后接着做下一件事。
做动画这一篇讲怎么让图层的属性在一段时间里连续变化:淡入淡出、移动、闪烁、沿路径移动、弹簧回弹,以及怎么关掉系统自动加的过渡。
每一帧执行一次代码这一篇讲怎么用 CADisplayLink 在屏幕每刷新一帧时执行一次代码,用代码逐帧更新界面:开始、停止、按经过的时间算位置、控制帧率。

网络和网页 ​

页面说明
从网络取数据这一篇讲怎么用 fetch() 发 HTTP 请求:取回 JSON、发送数据、上传和下载文件、处理失败、取消和超时。
边下载边读响应这一篇讲怎么用 Response 的 body 在内容还没下载完时一块一块地读:处理大文件、显示下载进度、读服务器持续推送的文本。
拼接和解析网址这一篇讲怎么用 URL 拼出和拆开地址,用 URLSearchParams 改查询参数,用 Headers 准备请求头。
用 WebSocket 收发消息这一篇讲怎么用 WebSocket 和服务器保持一条长连接:连接、收发文本和二进制、收发 JSON、关闭,以及断开后自动重连、定时检查连接。
显示网页这一篇讲怎么用 WebView 在 App 里显示网页:加载地址和本地文件、处理加载失败、后退前进、限制网页能去的地址、提前加载、销毁和崩溃之后恢复。
让网页和 App 互发消息这一篇讲网页怎么调用 App 的功能、怎么向 App 要一个结果,App 怎么通知网页。
管理网页的登录状态这一篇讲 App 怎么管 WebView 里网页的登录状态:在打开网页之前写好登录 cookie、读网页自己登录之后得到的 cookie、退出登录时清数据、多个账号分开存。

数据和工具 ​

页面说明
保存用户设置这一篇讲怎么用 application.storage 保存用户设置和少量状态:登记默认值、存对象和时间、监听变化。
读写文件这一篇讲怎么用 application.fileSystem 保存和读取文件:选目录、存 JSON、缓存下载的内容、处理出错。
保存登录令牌这一篇讲怎么用 application.keychain 保存登录令牌、密码和密钥:选哪种存储、选哪个访问级别、启动时取出、退出登录时删除。
延迟和重复执行代码这一篇讲怎么用定时器延迟执行代码、重复执行代码、在 async 函数里等一段时间、等一个条件成立。
量一段代码花了多久这一篇讲怎么用 performance.now() 量一段代码、一次请求、一个定时器实际花了多久,以及什么时候该用 Date.now()。
生成随机数和唯一编号这一篇讲怎么用 crypto 生成令牌、唯一编号、一个范围内的随机整数,以及什么时候用 Math.random() 就够了。
在文字和字节之间转换这一篇讲怎么用 TextEncoder 和 TextDecoder 在字符串和 UTF-8 字节之间转换,怎么用 btoa() 和 atob() 编码 Base64,怎么用 structuredClone() 深拷贝一个值。
按地区显示数字和金额这一篇讲怎么用 Intl.NumberFormat 按用户的地区显示数字、金额、百分比和大数。
按地区显示日期和时间这一篇讲怎么用 Intl.DateTimeFormat 和 Date 的 toLocale*String() 按用户的地区和时区显示时间,以及只显示时间、显示星期几、写一段时间。

系统能力 ​

页面说明
读设备和系统的信息这一篇讲怎么用 UIDevice 判断系统版本、给这台设备一个标识。
复制和粘贴文字这一篇讲怎么用 UIPasteboard 做「复制」和「粘贴」:把文字放进系统剪贴板,读出用户复制的文字,以及怎样读才不惊扰用户。
让手机震一下这一篇讲怎么用触感反馈配合界面变化让手机短促地震一下:按钮按下、选中项变了、操作成功或失败。
用面容 ID 确认身份这一篇讲怎么用 LAContext 让系统确认现在拿着手机的人是机主:付款前确认、打开 App 时解锁、显示敏感信息前确认。
取用户的位置这一篇讲怎么用 CLLocationManager 拿到用户的位置:申请授权、取一次位置、跟着用户移动持续接收、挑出可用的位置、处理出错。
发本地通知这一篇讲怎么让 App 发通知:问用户同不同意、约定什么时候送达、App 开着时也显示横幅、用户点了通知之后打开对应的页面、撤销和清理。
远程推送这一篇讲怎么让 App 收到服务器发来的推送:装包、写 entitlement、用开了推送能力的描述文件签名、拿到设备令牌交给服务器、处理能看见的推送和静默推送。
拍一张照片这一篇讲怎么用 UIImagePickerController 弹出系统的拍照界面、拿到用户拍的照片。
从相册选图、把图存进相册这一篇讲怎么让用户从相册里选图、把选中的图取出来显示,以及把一张图存进相册。
让用户选联系人这一篇讲怎么用 CNContactPickerViewController 让用户从通讯录里选一个联系人、一个电话、一个邮箱或者几个人,以及怎么把拿到的 CNContact 显示出来。
申请跟踪授权这一篇讲怎么用 ATTrackingManager 在合适的时机向用户申请跟踪授权,以及怎么用 ASIdentifierManager 取广告标识。

原生模块 ​

页面说明
从 JS 调原生模块这一篇讲 JS 这一侧怎么用原生模块:确认模块在不在、调方法、处理原生报的错、传二进制、听事件、给模块包一层函数。
写自己的原生模块App 里有些能力只能用原生代码做:公司自己写的原生库,或者只提供 iOS SDK 的第三方服务(风控、崩溃收集、支付)。

← 返回文档首页