关注 @ServiceStack 或加入 Google+ 社区 以获取更新,或前往 StackOverflow 或 客户论坛 以获得支持。
ServiceStack.Swift
查看 Swift 添加 ServiceStack 参考以了解 ServiceStack Swift 支持概述。
ServiceStack 的 添加 ServiceStack 参考 功能让 iOS/macOS 开发者能够轻松地使用 x
dotnet 命令行工具为您的 ServiceStack 服务生成原生类型的 Swift API。
ServiceStack 简单命令行工具
x dotnet tool 提供了一个简单的命令行 UX,可以轻松添加和更新 Swift ServiceStack 参考。
准备工作:安装 .NET Core。
$ dotnet tool install --global x
这将使 x
dotnet 工具可用在你的 $PATH
中,现在可以从 Xcode 项目文件夹的 终端窗口 中使用它。
要使用最新的 JsonServiceClient
,您需要使用您喜欢的包管理器添加对 ServiceStack Swift 库的引用
Xcode
从 Xcode 12 开始,Swift 包管理器已内置到 Xcode 中。
转到 文件 > Swift 包 > 添加包依赖项。
添加 ServiceStack.Swift GitHub 仓库的引用
https://github.com/ServiceStack/ServiceStack.Swift
添加依赖项后,ServiceStack.Swift 和其 PromiseKit 依赖项也将添加到您的项目中
SwiftPM
dependencies: [
.package(name: "ServiceStack", url: "https://github.com/ServiceStack/ServiceStack.Swift.git",
Version(5,0,0)..<Version(6,0,0)),
],
CocoaPods
在您的 Podfile 中
use_frameworks!
# Pods for Project
pod "ServiceStack", '~> 5.0'
Carthage
github "ServiceStack/ServiceStack.Swift" ~> 5.0
v5.0.0 版本发布
ServiceStack.Swift 的最新 v5 支持已重写为使用 Swift 5,并且使用 ServiceStack 从 v5.10.5+ 可用的 Swift 的新 Codable
生成的 DTO。
上一个版本
要使用由早期 ServiceStack 版本生成的 DTO 的 JsonServiceStack
,您需要引用较旧的 1.x 客户端版本
dependencies: [
.package(name: "ServiceStack", url: "https://github.com/ServiceStack/ServiceStack.Swift.git",
Version(1,0,0)..<Version(2,0,0)),
],
添加新的 ServiceStack 引用
要添加新的 ServiceStack 引用,请使用含有远程 ServiceStack 实例基础 URL 的 x swift
命令
x swift {BaseUrl}
x swift {BaseUrl} {FileName}
如果未提供文件名,它会首先使用 dtos.swift
或如果存在,则从远程URL的主机名推断文件名,例如:
x swift https://techstacks.io
下载 techstacks.io 的类型化 Swift DTOs 并将其保存到 dtos.swift
。
或者,您也可以使用不同的文件名进行保存:
x swift https://techstacks.io TechStacks
这会将 DTOs 保存到 TechStacks.dtos.swift
。
x swift
还会下载 ServiceStack 的 Swift 客户端 并将其保存到 JsonServiceClient.swift
,它与服务器 DTOs 一起包含在 Swift 中消费类型化 Web 服务所需的全部依赖项。
更新现有 ServiceStack 引用
要更新所有 Swift 服务器 DTOs,只需不带任何参数调用 x swift
。
x swift
这将会遍历并更新所有您的 *.dtos.swift
服务引用。
要更新特定的 ServiceStack 引用,请使用文件名调用 x swift
。
x swift {FileName.dtos.swift}
例如,您可以用以下方法更新由前一条命令添加的服务器 DTOs:
x swift TechStacks.dtos.swift
这还将包括任何手动添加的 自定义选项。
可选的 DTO 自定义
有关其他可用自定义的信息,请参阅 Swift 添加 ServiceStack 引用文档。
使用 ServiceStack.Swift 的 Swift 应用
AutoQuery Viewer
AutoQuery Viewer 是一个本地的 iPad 应用,提供了一个自动用户界面,用于在 iPad 上浏览、检查和查询任何公开可访问的 ServiceStack AutoQuery 服务。
TechStacks iOS 应用
TechStacks 本地 iOS 应用为浏览iPhone和iPad设备上的https://techstacks.io内容提供了流畅且响应灵敏的体验。它利用了ServiceStack对Swift和XCode的新支持以及易用性和实用性,从而快速构建丰富的iOS应用服务。《AppStore上免费下载!》立即免费在AppStore下载!
特色功能
TechStacks Cocoa OSX 桌面应用
TechStacks OSX 桌面应用围绕2个AutoQuery服务构建,展示了AutoQuery服务提供的免费查询功能以及与ServiceStack对Swift和XCode的新支持调用服务的简便性。