指南
每一篇讲怎么做成一件事,按步骤走一遍。某个属性、方法的细节看 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 的第三方服务(风控、崩溃收集、支付)。 |
← 返回文档首页