Jetstream-iOS 开源项目教程-优快云博客

Jetstream-iOS 开源项目教程

jetstream-ios项目地址:https://gitcode.com/gh_mirrors/jet/jetstream-ios

项目介绍

Jetstream for iOS 是一个用 Swift 编写的优雅 MVC 模型框架。它支持 Jetstream Sync 协议，用于同步本地和远程模型。默认情况下，它包含一个 Websocket 传输适配器，并支持添加自定义传输适配器。

主要特性

变更观察
即发即忘观察
同步协议，用于快速创建多用户应用程序
模块化架构
全面的单元测试覆盖
与 Objective-C 兼容

系统要求

iOS 7.0+ / Mac OS X 10.9+
Xcode 7.0
Swift 2.0

项目快速启动

安装

将 Jetstream 作为子模块添加到项目中：

git submodule add https://github.com/uber/jetstream-ios.git

打开 Jetstream 文件夹，将 Jetstream.xcodeproj 拖到应用程序导航器中。
在 Xcode 中选择你的项目，导航到“General”标签，点击“Embedded Binaries”部分的“+”图标，选择 Jetstream 框架。

快速开始

Jetstream 有两个基本概念：所有模型对象都继承自 ModelObject 超类，其中一个 ModelObject 实例将是模型的根。

// 示例代码
import Jetstream

class MyModel: ModelObject {
    // 定义你的模型属性
}

let rootModel = MyModel()

应用案例和最佳实践

实时协议

Jetstream 使用基于 JSON 的消息来创建会话、获取范围和同步变更。如果你想构建自己的客户端或服务器，请参考协议文档。

示例应用

假设我们有一个画布应用，用户可以在画布上添加和删除形状。我们的 ViewController 监听形状集合的变更，每当添加一个形状时，创建一个 ShapeView 实例并将其添加为子视图，并将 Shape 模型传递给它。

class CanvasViewController: UIViewController {
    var shapesCollection: Collection<Shape>

    override func viewDidLoad() {
        super.viewDidLoad()
        shapesCollection.addObserver(self)
    }

    func collectionDidChange(_ collection: Collection<Shape>) {
        for shape in collection.addedItems {
            let shapeView = ShapeView(shape: shape)
            view.addSubview(shapeView)
        }
    }
}