知晓云是个好用、顺手的开发工具。它免去了小程序开发中服务器搭建、域名备案、数据接口实现等繁琐流程。让您专注于业务逻辑的实现,使用知晓云开发 APP
应用,门槛更低,效率更高。
SwiftUI
是苹果最新推出 UI
开发工具,其具有以下特点:采用声明式语法,易于阅读、代码更少;跨所有苹果平台,共用一套 API;自动支持动态类型、暗黑模式、本地化等。采用 SwiftUI
将大大提高 UI
界面开发效率。
使用知晓云和 SwiftUI
,能够帮助您更快速创建一款 iOS
应用。
新手入门章节将会带领大家如何从零开始将知晓云接入 SwiftUI
应用中。
在本章节中,你将会学到以下内容:
-
知晓云账号注册,创建数据表
-
了解知晓云
MinCloud iOS SDK
的使用 -
使用
SwiftUI
创建一个接入MinCloud
的iOS
应用
前往知晓云注册知晓云账号。
成功注册后,页面将跳转至控制台,需要用户进一步完成邮箱激活验证和企业信息设置等步骤。
完成以上步骤,即可进入知晓云控制台 dashboard
页。
danger 如果注册或邮件激活失败,请开发者根据失败提示进行后续操作。如果开发者认为是服务提供方方面导致的失败,请邮件联系
[email protected]
,我们会第一时间处理您的邮件。
BookShelf
是一个简单的书架应用,以列表形式展示了存储在知晓云数据表中所有的书籍信息,点击每个书籍项,将跳转到书籍详情页。
我们以 BookShelf
为例,讲解如何在 iOS
中接入知晓云 SDK
。示例代码可以在这里下载,建议下载代码,一步一步跟着做。
我们根据自身应用的业务逻辑,确定所需的数据表,确定好后即可在知晓云后台 >> 数据管理模块开始数据表的创建工作。
在书架应用中,我们将创建一张名为 bookshelf
的数据表。打开数据管理模块
添加一个名为 bookName
的数据列
以同样的方式创建以下列:
列名 | 类型 | 说明 |
---|---|---|
bookName | string | 书名 |
bookPrice | number | 价格 |
bookAuthor | string | 作者 |
bookContent | string | 内容 |
coverUrl | string | 封面链接 |
通过 Cocoapods
,完成安装 MinCloud
,在 BookShelf
工程目录下,新建 Podfile
文件,并输入以下内容:
platform :ios, '9.0'
use_frameworks!
target 'MinCloud' do
pod 'MinCloud', :git => 'https://github.com/ifanrx/hydrogen-ios-sdk.git'
end
在终端进入项目根目录,并执行以下命令,完成安装:
pod install
在应用启动时,需要注册知晓云 clientId
,即在 AppDelegate.swift
文件中,导入 MinCloud
,并找到 application:didFinishLaunchingWithOptions
方法,插入下面代码: 示例代码
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
BaaS.register(clientID: "[[client_id]]") // 应用名称: [[app_name]]
return true
}
将 clientID
替换成你的应用 ID
,clientID
可在 dashboard [设置-应用页](https://cloud.minapp.com/dashboard/#/app/[[app_id | addSlashPostfixIfNotEmpty]]settings/info/)中获取)。
通过上面的步骤完成了数据表的创建和 MinCloud
安装和初始化,接下来就可以通过 MinCloud
的 API
操作知晓云数据表了。
Book
类,表示书籍信息,和数据表 bookshelf
的记录信息对应。Book
的属性如下:
struct Book: Identifiable {
let id: String
var name: String
var author: String
var price: Float
var content: String
var coverUrl: String
}
- 创建
Table
对象
Table
对应于知晓云的数据表,操作该对象即相当于操作知晓云对应的数据表。打开 BookStore.swift
文件,导入 MinCloud
。为 BookStore
类增加一个属性:bookshelfTable。bookshelfTable
是一个 Table
对象,关联数据表 bookshelf
。
let bookshelfTable = Table(name: "bookshelf")
- 获取数据表
bookshelf
的书籍信息
接下来我们可以通过 bookshelfTable
来操作数据表。实现 BookStore
类的方法 fetch()
,该方法从知晓云数据表 bookshelf
请求书籍信息,并保存到 books
中。具体实现如下:
func fetch() {
// 从 bookshelf 表获取书籍列表
bookshelfTable.find { (recordList, error) in
var books: [Book] = []
recordList?.records?.forEach({ (record) in
let id = record.Id!
let name = record.get("bookName") as! String
let author = record.get("bookAuthor") as! String
let price = record.get("bookPrice") as! Float
let content = record.get("bookContent") as! String
let coverUrl = record.get("coverUrl") as! String
let book = Book(id: id, name: name, author: author, price: price, content: content, coverUrl: coverUrl)
books.append(book)
})
DispatchQueue.main.async {
self.books = books
}
}
}
其中,BookStore
是一个可观察对象 ObservableObject
。BookList
为书籍列表界面,为了显示书籍信息,在该类创建一个 BookStore
实例,命名为 store
,并声明 store
为 @ObservedObject
观察对象,这就完成了数据和界面的绑定,即每当 store.books
有变化时,系统会自动根据 store.books
新的数据来更新 BookList
。无需手动去更新相关的界面。更多关于 SwiftUI
的使用,请查阅 SwiftUI
至此, 接入 MinCloud
的 SwiftUI
应用,已经完成了,完整的代码可以从这里下载。
通过这个简单的上手 demo
,我们已经学会了知晓云注册、iOS
应用接入 MinCloud
。希望进一步了解 MinCloud iOS SDK
,可以点击这里。