ServiceStack 5.0.11

ServiceStack 5.0.11

ServiceStack 维护。



  • ServiceStack, Inc.

关注 @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 服务

AutoQuery Viewer on AppStore

TechStacks iOS 应用

TechStacks 本地 iOS 应用为浏览iPhone和iPad设备上的https://techstacks.io内容提供了流畅且响应灵敏的体验。它利用了ServiceStack对Swift和XCode的新支持以及易用性和实用性,从而快速构建丰富的iOS应用服务。《AppStore上免费下载!》立即免费在AppStore下载!

TechStacks on AppStore

特色功能

TechStacks Cocoa OSX 桌面应用

TechStacks OSX 桌面应用围绕2个AutoQuery服务构建,展示了AutoQuery服务提供的免费查询功能以及与ServiceStack对Swift和XCode的新支持调用服务的简便性。

TechStack Desktop Search Fields