使您的 iPad App 更上一层楼

使您的 iPad App 更上一层楼

制作更加优秀的 iPad App：了解如何采用极佳的场景，确保不间断的重点交互。通过键盘快捷键和键盘快捷键界面帮助人们保持投入和快速操作。探索最新指针增强功能如何帮助您的 App 提高工作效率。

资源
相关视频

WWDC21
WWDC20
WWDC19
- 在多窗口情境下设定内容
- iPad 上多窗口功能简介
下载

♪低音音乐播放♪ ♪ 克里斯多尼根：嗨我是克里斯我是UIKit的工程师之后我的同事阿南特和穆罕默德也会加入我们 iPad是许多人的主要设备因为它有强大能力和功能本视频中你会学到一些令人兴奋的新功能你应该用这些新功能让你的iPad应用程序更上一层楼首先我会介绍多任务和场景的最新改进然后阿南特会逐步讲解键盘快捷键的强大改变最后穆罕默德会介绍系统指针的最新改进我们开始介绍多任务吧 iPadOS 13引进了能够运行多个应用程序UI实例的功能 iPadOS 15中我们进一步改善这个体验引进了场景演示的新API 以及增强了状态还原这些增强是基于既有的UI场景基础结构如果你还没采用UI场景请看《在iPad上引入多个窗口》我们先简短介绍关键概念一个场景代表应用程序UI的单一实例一个场景的组件结构由场景配置定义它至少会定义场景的角色和委托类你也可以提供一个名称情节提要和场景子类场景配置可在Info.plist声明或是在运行时用UISceneConfiguration对象创建一个场景的内容由一个NSUserActivity表示这些活动用于请求场景还有用于状态还原一个场景由一个场景委托管理场景委托负责设置UI 响应生命周期事件以及存储和还原状态最后一个场景由一个场景会话跟踪场景本身在背景时可以被系统断开连接或重新连接场景会话会跟踪场景无论它的连接状态如何并在不同次启动之间持续会话可以视为系统应用程序切换器中的表示切换器中的每个项目都和一个场景会话相应向系统请求一个场景时你可以提供一个选项对象以自定义请求 iPadOS 15有一个新的选项子类是特别为窗口场景推出的使用这个子类让你能指定一种演示样式窗口场景演示样式会影响相较于工作区中的其他场景场景演示的方式有三个可能值显著标准和自动这是使用显著演示样式的场景它在目前的工作区以模式窗口演示背后的其他场景变暗因为它是模式窗口它应该提供“取消”、“关闭” 或“完成”按钮这个新样式可以想成新场景的暂存区它跟其他场景一样可以用新的多任务控制改变位置也可以移到应用程序架上晚点再用考虑这个样式是否适合某个场景时有一些要记得的准则首先显著场景应该本身就有用途它不应该被用来为别的场景提供选项或工具它应该提供“完成”或“关闭”按钮而且应该专门用于应用程序中的特定内容像是一个文档或文件这个专用内容范围必须在场景的激活条件中定义要了解更多关于激活条件请看《使用多个窗口定位内容》这个例子显示Safari如何开启一个使用标准样式的新场景它们并排演示让人跟两者都能交互而且两个都提供主场景的完整功能你也可以指定样式为自动这个值告诉系统它应该基于它被请求的方式选择最佳样式 iPadOS 15不仅提供用样式自定义演示的方式它也让人能更轻易在新场景中打开内容在Mac上很常会在上下文菜单中看到“以新窗口开启”项目你应该将这个大家熟悉的体验引进你的iPad应用程序方式是用 UIWindowScene.ActivationAction 这是新的UIAction子类用来请求可以用在菜单按钮和栏按钮项目的场景要将这个功能添加到你的应用程序先初始化一个 UIWindowScene.ActivationAction 它会被当项目被选择时执行的闭包初始化闭包应该返回一个激活配置里面有新场景内容的用户活动最后将操作放进菜单就完成了在iPad和Mac Catalyst上菜单会显示“以新窗口开启”项目被选定后会演示一个新场景在iPhone上这个项目会自动隐藏因为iPhone不支持多场景如果你宁愿在它的位置显示另一个项目你可以提供备用操作我们更新先前的例子来提供备用操作要做到这件事先创建备用操作当多窗口不可用它会显示新操作的标题和图像然后更新场景激活操作的初始值设定项方式是将新操作输入为备用提供一个备用操作后 iPad和Mac Catalyst上的菜单还是会显示“以新窗口开启”项目但在iPhone上则看到“显示细节”项目这一切不需要在你的代码中放入任何条件就能做到添加这些菜单项目能让人用明确又熟悉的方式在新场景中打开内容但这不是唯一方式 iPad是触控优先的设备能轻易用一个手势打开场景在笔记应用程序中双指放在单元格上分开双指能在新场景中打开笔记场景会交互式动画从单元格到最终位置在应用程序中提供这个功能的方式有两种如果你使用集合视图有个新的委托方法至于其他视图请用UIWindowScene ActivationInteraction 这两个方式都只是为了演示显著样式的场景要在你的集合视图支持这个手势执行新委托方法名称为 sceneActivationConfiguration ForItemAt indexPath 这很类似稍早提过的上下文菜单例子创建新场景内容的用户活动然后用那个活动返回激活配置你可能不想让每个单元格都支持开启新场景为了从一开始就阻止手势返回nil就好要在其他视图上支持手势创建一个UIWindowScene .ActivationInteraction 创建它的闭包接受两个参数交互本身还有交互在视图的坐标空间中的点这些可以用来为视图的不同区域创建特定用户活动闭包应该返回一个激活配置和用户活动交互也采取一个错误处理程序虽然在不支持多场景的平台上交互会被禁用但可能还是会因为配置问题产生错误或是因缺少系统资源产生错误你应该已经注意到所有这些演示窗口场景的方式使用同样的激活配置对象它的唯一需求是一个用户活动但它也包含场景请求选项和一个目标预览如果没有提供这些系统会尽量为你创建不过你可以明确提供它们以让体验更细致作为例子这些集合视图单元格有缩略图标题和描述当用户在单元格上分开双指会出现一个场景它主要显示缩略图内容的较大版本注意这个新场景是整体从单元格过渡而来如果它只从缩略图过渡看起来会比较好要达到这个效果跟之前一样创建激活配置然后检查单元格是否为缩略图单元格如果是用单元格的缩略图视图创建一个目标预览并在配置上设置通过在激活配置上提供自定义预览过渡会细致很多我们来看细节现在与其从单元格本身过渡它会从缩略图过渡让单元格其余部分留在原处激活配置让你能请求你的应用程序的任何一个场景不过你可能单纯只想显示一个文件不想自己构建一个场景 iPadOS 15让你能轻松做到这点 UIWindowScene .ActivationConfiguration 有个特别子类叫做QLPreviewScene ActivationConfiguration 返回一个预览场景配置会请求一个系统管理的预览场景不需要担心场景委托或回调但你的应用程序必须在Info.plist中声明支持多窗口提供优美并方便的方式让人能在新场景中打开内容很重要但同等重要的是存储和还原场景的状态让人之后能够流畅返回场景当一个场景移动到背景系统会向场景的委托要求一个NSUserActivity 以表示它的状态这个活动可以是根视图控制器的活动如果它支持“连续互通” 或是当下创建一个这里一个用户活动被创建将文本字段的内容存储在活动的用户信息字典要提供最佳体验场景状态应该不仅是内容而已你也应该存储视觉和交互状态像是滚动位置光标位置和第一响应者状态与其将每个都独立存储 UITextField和UITextView现在有一个interactionState属性这个属性提供包含所有交互状态的单一对象对象中并没有内容本身它是让你存储用户活动的额外信息我已通过存储文本字段的交互状态更新先前的例子现在通过存储内容以及交互状态用户活动包含足够信息能够准确地还原在iPadOS 14上要还原状态可能有点困难如果你试图在场景连接时还原状态你会发现情节提要和视图没有完整加载如果你晚点再还原在场景过渡到前景时再还原你必须跟踪那是不是第一次 iPadOS 15解决了这个问题它推出了新的委托方法专门用于还原状态它在场景连接并且情节提要已经加载后调用不过是在第一次过渡到前景之前调用无论你的应用程序是否使用情节提要你应该用这个新回调来还原状态从存储在先前例子中的活动还原状态要从系统调用场景还原交互状态开始接着还原文本字段的内容最后还原它的交互状态关键是让内容在交互状态之前还原最后同步还原状态可能很复杂你可能需要访问数据库或加载文件而不想要在那个期间出现空的UI 考虑到这点 iPadOS 15让你的应用程序能请求一个短期扩展在这个扩展期间启动图像会保持可见同时让主要RunLoop还是能执行一旦你的内容加载完毕应用程序应该发出信号完成还原这个扩展很短不应用于可能长时间运行的任务例如网络访问如果你的应用程序未能发出完成信号或是花太多时间它会被系统关闭要使用扩展状态还原先向场景请求一个扩展然后开始你的异步工作一旦内容加载完毕将它还原并叫场景完成还原场景接着会显示刚还原的UI 在应用程序中支持多任务能让它脱颖而出但是要成为真正更上一层楼的 iPad应用程序还有更多要做的现在交给阿南特阿南特贾恩：谢谢克里斯我是阿南特我是UIKit工程师大家很喜欢iPad够轻能够拿在手上但同时还是能够随时连接实体键盘大家预期你的应用程序能提供极佳的键盘支持跟上他们的步调 iPadOS 15推出了几个新功能让你的应用程序的键盘快捷键更上一层楼 iPadOS 15拥有用来发现键盘快捷键的全新界面它将每个命令组织成熟悉的类别让你的应用程序的 iPad和Mac Catalyst版本越来越一致菜单提供方便的搜索功能可以在系统的任何地方叫出你甚至可以点击快捷键来触发它如果你需要复习如何用UIKeyCommand 支持键盘快捷键包含命令如何调度到响应链请看《在你的应用程序中支持硬件键盘》在Mac Catalyst上每个应用程序都有一个全局菜单叫做主菜单显示于屏幕顶端的菜单栏主菜单由几个类别子菜单组成像是“文件”和“编辑” 这些类别菜单则包含更多子菜单里面含有应用程序的所有命令 iPadOS 15上我们将主菜单系统带到iPad应用程序新快捷键界面会在按住Command键不放时出现它会显示这个菜单和Mac上相比主菜单系统在iPad上表示的形式不太一样 Mac显示每个类别里面的完整子菜单层次结构而iPad则会将那些层次结构扁平化禁用和无法执行的命令在Mac上以显示为灰色表示而在iPad上则会被隐藏此外 iPad快捷键菜单设计来协助用户发现应用程序中的键盘快捷键它不会显示无键命令但是Mac菜单栏会默认情况下主菜单包含所有系统类别菜单像是“文件”和“编辑” 这包含所有系统命令像是“撤销”和“重做” “粘贴”和“匹配样式”等 iPadOS 15添加“打印”命令到系统命令应用程序可以取得打印命令方式是添加UIApplication SupportsPrintCommand键到Info.plist 因为现在iPadOS 15上的 iPad应用程序支持主菜单系统他们可以用UIMenuBuilder API 进行自定义就和Mac Catalyst应用程序一样事实上如果你的应用程序已经有 Mac Catalyst版本你已经完成了大部分的工作应用程序应该用生成器将所有支持的键命令添加到主菜单这和之前应用程序声明键盘快捷键的方式不同通过替代UIResponder上的 keyCommands属性或通过在视图控制器上调用 addKeyCommand(_:) 用这个方式定义的命令还是可以用但它们会出现在新界面中另外的未分类部分应用程序应该移除这种键命令声明改而将它们添加到主菜单要自定义主菜单在你的AppDelegate中替代buildMenu(withbuilder:) UIKit会在应用程序启动时调用这个方法并传递一个UIMenuBuilder对象应用程序应该检查生成器是否正在修改主菜单系统如果是它可以用生成器自定义假设一个应用程序想要在文件菜单中放入一些用于选项卡的键命令应用程序只需用UIMenu API 创建子菜单并添加想要的键命令作为那个菜单的子项然后应用程序对生成器对象调用insertChild方法将子菜单插入文件菜单要引用主菜单系统中的既有元素像是此例中的文件菜单应用程序应该指定元素的标识符内置的系统菜单标识符在UIMenu.Identifier定义为常量应用程序也可以轻松创建自己的菜单类别这里应用程序创建一个“书签”菜单跟之前一样是用UIMenu API做到然后应用程序用生成器将那个菜单插入根菜单在这个例子中是在系统视图菜单之后就这样！生成器可以用来插入更多东西到书签菜单中就像文件菜单一样只要输入新菜单的标识符那会由UIKit自动生成我一直提到标识符 UIMenuBuilder会强制每个主菜单系统中的元素都有唯一标识符包含个别命令假设一个应用程序插入键命令以显示内容可能是清单或是网格形式两个命令是用同样的操作 changeViewMode(_:) 主菜单系统中命令通过它们的操作隐式识别所以这两个命令共用相同的标识符 UIMenuBuilder不会让这两个命令都插入除非它们有不同的标识符区分这些命令的方式之一是给它们不同的propertyList值但更好的方式是给每个命令一个唯一操作形容它的具体用途生成器也强制主菜单中的键盘快捷键组合必须是唯一假设应用程序插入 “获取信息”键命令按键是Command-I 因为文本样式菜单中的系统斜体快捷键拥有同样的快捷键这次插入也会失败跟之前一样有两个解决方案应用程序可以将获取信息快捷键改成不要和既有快捷键抵触例如Control-Command-I 或者若不需要文本样式命令应用程序可以叫生成器移除它如果插入包含一个复制那UIMenuBuilder会使插入失败并在控制台记录错误显示复制的键命令或是共享的标识符如果你发现你的插入没有出现可能是在某处有复制所以请在控制台找像这样的纪录在buildMenu(with builder:)调用结束后应用程序的主菜单出现在 Mac菜单栏和iPad快捷键覆盖中不过有一个问题应用程序添加了一个有命令的子菜单以用名称或日期分类书签但因为iPad快捷键覆盖不会显示子菜单层次结构不确定这些快捷键在iPadOS上会是怎样对于这种情况对键命令设置一个更具描述性的更容易发现的标题若两者都提供 iPadOS首选可发现性标题而非常规标题我之前提过单个响应者应该避免声明键盘快捷键而该在主菜单系统中声明不过响应者还是应该实现主菜单命令的操作方法当键命令被触发 UIKit自动将操作调度给响应者 UIKit通过遍历应用程序的响应链做到这点一旦它找到可以执行操作的响应者它会调用该响应者的操作方法如果响应链中没有东西可以执行操作那键命令就不可执行如果你不熟悉UIResponder概念《在你的应用程序中支持硬件键盘》很好地介绍了它的运作机制《出色的Mac Catalyst 应用程序的特性》也介绍了更多细节当UIKit在响应链中执行响应者搜索它调用两种好用的UIResponder方法应用程序可以在响应者中替代这些方法以改善它们的键命令第一个方法是canPerformAction (_:withSender:) UIKit用它来检查响应者是否可以执行某个操作默认情况下如果响应者实现那个操作方法这会返回true 否则它会返回false 响应者可以替代它以添加自定义逻辑例如网页浏览器可以告诉UIKit 若没有开着的选项卡则closeTab命令不可执行既然UIKit无法为那个操作找到目标响应者该命令则不可执行不会在快捷键界面中显示注意这个方法的替代必须为未处理的案例调用super 另一个好用的方法是 validate(_ command:) 当UIKit找到键命令的目标响应者它会在响应者上调用这个方法并传递命令的副本响应者可以替代 validate(_ command:) 为应用程序的当前状态更新命令的外观这里应用程序更新 toggleBookmark(_:)命令的标题基于当前页面是否加入书签这个方法中设置的标题会在快捷键界面出现时反映 iPadOS 15中 UIKit推出了响应链的重大变更当应用程序用聚焦系统采用键盘导航那响应者遍历会从聚焦项目开始而不是从第一响应者开始这个改变和键命令十分搭配例如Photos让用户能只用键盘使用照片库当用户聚焦在在格子中的某个单元格他们可以点击空格键查看那张照片他们甚至可以按Command-C复制照片贴到另一个应用程序中每个单元格实现不同的键命令操作而因为响应者遍历始于聚焦项目键命令会锁定单元格简单来说聚焦系统让键命令和响应链更上一层楼善加利用它以在你的应用程序中支持强大的上下文快捷键要了解更多请看《聚焦iPad键盘导航》最后 iPadOS 15和macOS 12 推出了键盘快捷键本地化当你用这些SDK建构你的应用程序系统会自动本地化快捷键修改器和每个键盘布局的输入例如Command-反斜杠快捷键虽然这个快捷键在美国键盘上可用它不可能在日本键盘上执行因为日式键盘的布局没有反斜杠键所以系统会为日式键盘重新映射快捷键这代表应用程序不应该本地化快捷键修改器或输入而是应该让系统处理应用程序也可以选择禁用自动本地化可以是在应用程序范围或是在个别快捷键中禁用当系统将快捷键本地化它也会为右到左布局进行镜像处理例如一个快捷键若用Command-左括号往回导航它会被翻转成Command-右括号如果快捷键不应该被镜像处理将命令的 allowsAutomaticMirroring属性设置为false 以禁用镜像但不完全禁用自动本地化 iPadOS 15对于键盘快捷键来说是重大发表除了我们今天谈到的一切外还有一大堆其他增强现在你采用了所有新的多任务功能也打造了很好的键盘支持现在穆罕默德会给你一些建议让你的iPad应用程序能登峰造极穆罕默德吉斯阿威：谢谢阿南特嗨我是穆罕默德我们来聊聊 iPadOS 15为系统指针带来的改进 iPadOS 13.4引进了自适应系统指针连接起iPad基于触控的UI 和精准的鼠标或触控板如果你不熟悉指针交互花点时间熟悉它观看这些之前的视频《为iPadOS指针构建》讲解指针交互API 《iPadOS指针的设计》深入介绍背后的设计哲学并讨论在应用程序采用它的最佳实践 iPadOS 15带来一些熟悉的Mac用户交互并且是以符合iPad的设计语言的方式引进它也引进一些新概念能增强可用性和清晰度第一个添加的是波段选择新的指针特定多选体验用过Mac的人应该都很熟悉 iPadOS 15中当你在集合视图中点击并拖动指针会伸展成一个长方形集合视图会选择长方形包含的项目当然这能自然地移植到 Mac Catalyst应用程序上类似的Mac UI 这个交互内置于非列表UICollectionView 若UICollectionView 通过shouldBeginMultiple SelectionInteraction API 支持一指和两指多选手势则它会自动在iPadOS 15中获得这个行为对于UICollectionView以外的东西新的 UIBandSelectionInteraction API 让你能轻松在应用程序采用这个体验既然选择逻辑完全由你决定你能够支持自定义选择行为并让你的UI针对改变的选择做出任何反应首先用一个选择处理程序将交互实例化选择处理程序在指针移动交互状态改变时调用一旦创建后将交互添加到你的视图就像你会为任何其他UI交互做的一样在处理程序中你可以实现你的自定义选择逻辑方式是响应交互状态和selectionRect中的变化这里有个简单的实现将选择设置为指针移动时交互的selectionRect里面的项目然后它会在主要鼠标按钮放开交互结束时完成选择会话除了基本选择 UICollectionView的内置波段选择支持一些常见键盘快捷键且为开箱即用例如开始拖动时按住Shift不放会导致项目被添加到现有的选择中而不是取代当前选定的项目按住Command不放会切换选择长方形中的项目的选择状态这个可以在自定义UI中使用交互的 initialModifierFlags属性实现它提供开始拖动时按住不放的键既然它是所有按下修改器的集合你可以响应任意的键组合以支持专属你的应用程序的自定义或更高阶的行为系统指针第二个添加的是附加附件的能力附件能沟通额外信息并提供上下文线索方式是将辅助形状和主要指针结合举例来说在左边的例子里两个箭头表示这个视图可以横向拖动在右边的例子里加号提供一些额外上下文给这个“加入购物车”按钮在附件和使用自定义指针形状之间有几个关键差异附件在视觉上是分开的是辅助主要指针用这个特性在下列这点很明显它们可以用不同的外观呈现并和主指针分开设置动画它们是独立的单位可以被组合起来并放置在指针周围以传达不同的概念既然它们是独立的它们可以和任何指针样式结合这里有个演示示范同一组附件也就是两个表示可拖动的箭头可以和不同的指针样式组合在左边它们用提升效果组合指针会和视图合并并将它提升在中间它们用突出显示效果指针会变成圆角的长方形并跑到视图下面在右边它们用新的 UIPointerStyle.system() API 和默认系统指针一起出现所以我们能够提供额外上下文同时保持使用最适合情况的效果不用牺牲指针的活泼同时还能维持它和应用程序UI的深厚关系就跟它设置指针样式之间的动画一样系统会自动设置附件出现和消失的动画它也会流畅地设置不同附件形状和位置之间的动画在某个效果动作时过渡附件可能很有意义这种过渡可以用来沟通底下UI状态或行为的改变在左边的例子从加号变成禁止符号可能表示先前可以进行的操作现在不再允许指针附件由一个UIPointerShape 和一个 UIPointerAccessory.Position构成后者将想要的位置描述为指针中点的偏移和距离顶端的角度为了便利 UIKit提供一些预定义值给指针周围的位置如果预定义位置不太符合你的需求你可以将它们当作起点并自定义单个属性这个例子一开始用topRight位置并自定义偏移你也可以用完全自定义的位置像这个例子它用自定义偏移和角度创建一个位置要设置我们在这一部分一开始看到的例子我们用视图创建一个UITargetedPreview 并用它创建一个有提升效果的 UIPointerStyle 然后我们将样式的新附件属性设置成包含两个箭头附件的数组 UIKit提供预先准备好的箭头附件所以我们可以用那个创建两个就好位置在效果的左边和右边所以现在当指针悬停在这个视图上两个箭头会随着视图提升时往外移动暗示它可以拖动如果你尝试过实现这种交互有指针效果的视图可拖动的这种你应该会注意到这种事当指针到达指针区域的边缘它会从提升视图脱离效果会结束通常我们想要这样因为它能避免指针在到处移动时黏在视图上不过在这种情境中理想体验是让指针效果维持稳定锁定视图在它被拖动时跟着它走为了让这种交互更好地呈现 iPadOS 15在UIPointerRegion上引进了latchingAxes的概念当一个区域锁定一个特定轴按下主要鼠标按钮时它的指针效果会随着轴跟踪指针横向锁定区域让你能在 X轴上随意拖动同时在Y轴上橡皮筋式滚屏回弹纵向的锁定区域让你能在Y轴上自由拖动而锁定两轴的区域让你能在两轴都自由拖动这些新工具可以用来构建非常强大的新体验这里它们被结合在文稿编辑应用程序中像是Pages或Keynote 这个图像可以用波段选择选定选择这个图像让拖动指标出现当指针悬停在指标上方附件会出现暗示如果被拖动的话图像会如何调整大小最后锁定让指针效果和附件能够跟踪锁定轴的调整大小手势这些只是一些 iPadOS 15为iPad引进的增强在适用的地方善加利用它们让你的应用程序能发挥最大效用采用显著场景让人能获得你的应用程序内容的聚焦、不间断的视图用新的键盘快捷键菜单让他们能快速完成复杂任务并用新指针功能提升他们的生产力谢谢收看 ♪

4:56 - Build an "Open in New Window" action

let <#newSceneAction#> = UIWindowScene.ActivationAction({ _ in

    // Create the user activity that represents the new scene content.
    let userActivity = NSUserActivity(activityType: <#User Activity Type#>)

    // Return the activation configuration.
    return UIWindowScene.ActivationConfiguration(userActivity: userActivity)

})

5:43 - Use an alternate action with UIWindowScene.ActivationAction

// Create an action to use when multiple scenes are not available.
let alternateAction = UIAction(title: <#Alternate Action Title#>,
                               image: <#Alternate Action Image#>,
                             handler: { _ in
    <#Perform Alternate Action#>
})

// Create the scene activation action with the alternate.
let newSceneAction = UIWindowScene.ActivationAction(alternate: alternateAction) { _ in

    // Create the user activity that represents the new scene content.
    let userActivity = NSUserActivity(activityType: <#Scene Activity Type#>)

    // Return the activation configuration.
    return UIWindowScene.ActivationConfiguration(userActivity: userActivity)
}

6:58 - Present a scene from a collection view with a gesture

func collectionView(_ collectionView: UICollectionView,
                    sceneActivationConfigurationForItemAt indexPath: IndexPath,
                    point: CGPoint) -> UIWindowScene.ActivationConfiguration? {

    // Get the item's user activity.
    guard let itemActivity = <#User Activity#> else {
        // Return nil if item can’t be opened in a dedicated scene.
        return nil
    }

    // Return the activation configuration.
    return UIWindowScene.ActivationConfiguration(userActivity: itemActivity)
}

7:28 - Present a scene from a custom view with a gesture

// Create an activation interaction.
let newSceneInteraction = UIWindowScene.ActivationInteraction { interaction, point in
    // Get the activity for specific point in view.
    guard let userActivity = <#User Activity#> else { return nil }

    // Return an activation configuration.
    return UIWindowScene.ActivationConfiguration(userActivity: userActivity)

} errorHandler: { error in
    // Present the content in another manner.
    <#Present Content#>
}

// Add interaction to the view.
<#View#>.addInteraction(newSceneInteraction)

8:53 - Customize scene transition preview

// Create the activation configuration.
let itemActivity = NSUserActivity(activityType: <#User Activity Type#>)
let configuration = UIWindowScene.ActivationConfiguration(userActivity: itemActivity)

// If the cell has a subview to use as the preview, create the custom preview.
if let cell = collectionView.cellForItem(at: indexPath) as? <#Expected Cell Class#> {
    configuration.preview = UITargetedPreview(view: cell.<#Subview For Preview#>)
}

// Return the activation configuration.
return configuration

10:18 - Save scene state

func stateRestorationActivity(for scene: UIScene) -> NSUserActivity? {
    guard let viewController = self.window?.rootViewController as? <#Expected View Controller Class#> else {
        return nil
    }

    let stateActivity = NSUserActivity(activityType: <#State Restoration Activity Type#>)

    stateActivity.addUserInfoEntries(from: [
        // Save content of a text field.
        <#Content Key#>: viewController.<#Text Field#>.text
    ])

    return stateActivity
}

11:16 - Save scene state with interaction state

func stateRestorationActivity(for scene: UIScene) -> NSUserActivity? {
    guard let viewController = self.window?.rootViewController as? <#Expected View Controller Class#> else {
        return nil
    }

    let stateActivity = NSUserActivity(activityType: <#State Restoration Activity Type#>)

    stateActivity.addUserInfoEntries(from: [
        // Save content of a text field.
        <#Content Key#>: viewController.<#Text Field#>.text,

        // Save interaction state of a text field.
        <#Interaction State Key#>: viewController.<#Text Field#>.interactionState
    ])

    return stateActivity
}

12:13 - Restore scene state

func scene(_ scene: UIScene, restoreInteractionState stateRestorationActivity: NSUserActivity) {
    guard let viewController = window?.rootViewController as? <#Expected View Controller Class#>,
          let userInfo = stateRestorationActivity.userInfo
    else { return }

    if let content = userInfo[<#Content Key#>] as? String {
        // Restore the content first.
        viewController.<#Text Field#>.text = content

        // Then, restore the text field’s interaction state.
        if let interactionState = userInfo[<#Interaction State Key#>] {
            viewController.<#Text Field#>.interactionState = interactionState
        }
    }
}

13:15 - Restore scene state asynchronously

func scene(_ scene: UIScene, restoreInteractionState stateRestorationActivity: NSUserActivity) {
    guard let viewController = window?.rootViewController as? <#Expected View Controller Class#> else { return }

    // Request an extension.
    scene.extendStateRestoration()

    // Fetch content asynchronously.
    <#self.someAsyncFunction#> { result in
        <#Restore Content#>

        // Signal that state has been restored.
        scene.completeStateRestoration()
    }
}

17:15 - Modify the main menu

override func buildMenu(with builder: UIMenuBuilder) {
    super.buildMenu(with: builder)
    
    // Ensure the builder is modifying the main menu.
    guard builder.system == .main else { return }
    
    // Use the builder to modify the main menu...
}

17:37 - Add key commands to the main menu

// Create a menu with key commands.
let tabMenu = UIMenu(options: .displayInline, children: [
    UIKeyCommand(title: NSLocalizedString("New Tab", ...),
                 action: #selector(BrowserViewController.newTab(_:)),
                 input: "t",
                 modifierFlags: .command),
    UIKeyCommand(...)
])

// Insert tabMenu into the File menu.
builder.insertChild(tabMenu, atStartOfMenu: .file)

18:19 - Add a custom menu category

// Create a "Bookmarks" menu.
let bookmarksMenu = UIMenu(title: NSLocalizedString("Bookmarks", ...),
                           children: [...])

// Insert the Bookmarks menu into the root menu, after View.
builder.insertSibling(bookmarksMenu, afterMenu: .view)

// Insert another menu into the Bookmarks menu.
let sortBookmarksMenu = UIMenu(...)
builder.insertChild(sortBookmarksMenu, atEndOfMenu: bookmarksMenu.identifier)

22:38 - Customizing key command performability

override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {
    if action == #selector(closeTab(_:)) {
        return !openTabs.isEmpty
    } else {
        return super.canPerformAction(action, withSender: sender)
    }
}

23:26 - Customizing key command appearance

override func validate(_ command: UICommand) {
    if command.action == #selector(toggleBookmark(_:)) {
        if currentTab.isInBookmarks {
            command.title = NSLocalizedString("Add to Bookmarks", ...)
        } else {
            command.title = NSLocalizedString("Remove from Bookmarks", ...)
        }
    } else {
        return super.validate(command)
    }
}

28:47 - Supporting multi-selection using UIBandSelectionInteraction

// Support multi-selection using UIBandSelectionInteraction.

let selectionInteraction = UIBandSelectionInteraction { [weak self] interaction in
    guard let strongSelf = self else { return }
            
    // Handle selection by responding to interaction state.
    if interaction.state == .selecting {
        strongSelf.selectItemsInRect(interaction.selectionRect)
    } 
    else if interaction.state == .ended {
        strongSelf.finalizeSelection()
    }
}

view.addInteraction(selectionInteraction)

33:01 - Customizing a predefined pointer accessory position

var position = UIPointerAccessory.Position.topRight
position.offset = 40.0

33:14 - Creating a custom pointer accessory position

let position = UIPointerAccessory.Position(offset: 23.0, angle: .pi * 1.25)

33:27 - Pointer Accessories

// Attach two arrow accessories to a lift pointer effect.

func pointerInteraction(_ interaction: UIPointerInteraction, styleFor region: UIPointerRegion) -> UIPointerStyle?
{
    let preview = UITargetedPreview(view: self)
    let style = UIPointerStyle(effect: .lift(preview))

    if #available(iOS 15.0, *) {
        style.accessories = [
            .arrow(.left),
            .arrow(.right)
        ]
    }

    return style
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

资源

相关视频

WWDC21

WWDC20

WWDC19