iOS8 Day-by-Day 项目解析：WatchKit 开发入门指南-CSDN博客

iOS8 Day-by-Day 项目解析：WatchKit 开发入门指南

前言

随着 Apple Watch 的发布，WatchKit 作为 iOS 8.2 SDK 的一部分为开发者打开了全新的可穿戴设备开发领域。本文将基于 ScottLogic/iOS8-day-by-day 项目中的 WatchKit 示例，深入浅出地讲解 WatchKit 的核心概念和开发要点，帮助开发者快速掌握 Apple Watch 应用开发。

WatchKit 开发基础

1. WatchKit 应用架构

WatchKit 应用采用独特的架构设计：

Watch App：仅包含静态资源（图片、Storyboard），运行在 Apple Watch 上
Watch Extension：包含业务逻辑代码，运行在配对的 iPhone 上

这种设计意味着：

所有代码执行都在 iPhone 上完成
UI 更新通过蓝牙传输到手表
开发者无法直接访问手表传感器

2. 三种交互模式

WatchKit 提供了三种不同的交互方式：

主应用：完整交互式应用
Glance（速览）：只读信息展示界面
通知：支持静态和动态两种展示形式

开发环境搭建

创建 WatchKit 项目

在现有 iOS 项目中添加新 Target
选择 "Apple Watch" → "Watch App"
可选择同时创建 Glance 和 Notification 目标

项目创建后会生成：

Watch App Target（包含 Storyboard 和资源）
Watch Extension Target（包含业务逻辑代码）

Watch App 开发详解

界面设计要点

WatchKit 的界面设计与传统 iOS 开发有显著差异：

布局系统：
- 使用 Group 容器组织界面元素
- 不支持 Auto Layout
- 提供 38mm/42mm 屏幕尺寸适配选项
控件限制：
- 仅支持有限的 UI 组件
- 动画仅能通过序列帧实现
- 表格采用逐个添加单元格的方式
导航方式：
- 页面式导航（Page-based）
- 层级式导航（Hierarchical）
- 两种方式不能混用

代码交互实现

WatchKit 控制器（WKInterfaceController）生命周期：

class InterfaceController: WKInterfaceController {
    // 初始化
    override init() { ... }
    
    // 准备界面
    override func awakeWithContext(context: AnyObject?) { ... }
    
    // 即将显示
    override func willActivate() { ... }
    
    // 即将消失
    override func willDeactivate() { ... }
}

UI 控件交互特点：

所有控件属性都是只写的（write-only）
更新操作会被批量处理
每个按钮需要独立的 IBAction 方法

示例代码：

@IBOutlet weak var quoteLabel: WKInterfaceLabel!
@IBOutlet weak var timer: WKInterfaceTimer!

@IBAction func handleButtonPressed() {
    quoteLabel.setText("新内容")
    timer.setDate(Date(timeIntervalSinceNow: 10))
    timer.start()
}

Glance 开发指南

设计原则

Glance 是只读的信息展示界面：

用户无法交互
点击会打开主应用
设计应简洁明了

实现步骤

在 Storyboard 中设计 Glance 界面
创建对应的 WKInterfaceController 子类
在 awakeWithContext 方法中准备数据

示例代码：

class GlanceController: WKInterfaceController {
    @IBOutlet weak var infoLabel: WKInterfaceLabel!
    
    override func awakeWithContext(context: AnyObject?) {
        infoLabel.setText("重要信息")
    }
}

测试技巧

需要创建独立 Scheme 来测试 Glance：

复制 Watch App Scheme
修改可执行文件为 Glance 目标
运行测试

通知功能开发

通知类型

短通知：仅显示应用图标和标题
长通知：
- 静态版本：预定义布局
- 动态版本：可自定义界面

实现方法

动态通知控制器需要继承 WKUserNotificationInterfaceController：

class NotificationController: WKUserNotificationInterfaceController {
    override func didReceiveRemoteNotification(
        _ remoteNotification: [AnyHashable : Any],
        withCompletion completionHandler: @escaping (WKUserNotificationInterfaceType) -> Void
    ) {
        // 处理远程通知
        completionHandler(.custom)
    }
}

测试配置

创建专门的通知测试 Scheme
准备测试用的 payload JSON 文件
配置 Scheme 使用该测试文件

示例 payload 文件：

{
    "aps": {
        "alert": "通知内容",
        "title": "通知标题",
        "category": "通知类别"
    },
    "WatchKit Simulator Actions": [
        {
            "title": "操作按钮",
            "identifier": "actionButton"
        }
    ]
}