Stitch
该 SDK 旨在为想要集成聊天、语音和视频的开发者提供现成的解决方案。
👇
开始使用来看看 iOS 快速入门!
安装
CocoaPods
Cocoa 项目的依赖管理器。您可以使用以下命令安装它:
$ gem install cocoapods
使用 CocoaPods 在项目中集成 Stitch,在 Podfile
中指定 SDK
source 'https://github.com/Nexmo/stitch-ios-sdk.git'
source 'https://github.com/CocoaPods/Specs.git'
target '<YOUR_TARGET_NAME>' do
pod 'Stitch'
end
然后,运行以下命令:
$ pod install --repo-update
Carthage
将这些添加到 Cartfile
github "Nexmo/stitch-ios-sdk" ~> CURRENT_VERSION
$ carthage update --platform iOS
SDK 设置
在项目导航器中,点击您目标的 "Info.plist"。
- 添加新行,并设置行类型为名为
Nexmo
的字典。 - 在
Nexmo
字典内部添加名为ConversationApplicationID
的新行,并将其设置为字符串类型。 - 添加从 CLI 界面获取到的您的应用程序 ID。
开发环境测试的先决条件
配置环境,执行以下命令
$ sudo gem install bundler
$ bundle install
pod repo add Nexmo https://github.com/Nexmo/PodSpec.git
pod setup && pod install
注意:仅在未安装 Homebrew 的情况下
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew bundle
要使用与开发端点关联的项目
- 转到目标方案选择框,并点击管理方案
- 复制
Demo
(请确保未选择共享),并将其命名为Demo-local
- 在 "运行" 选项卡下,为
socket_url
、ips_url
、rest_url
和acme_url
添加以下环境变量端点。
部署
Fastlane:自动对我们 iOS 演示应用的beta版本部署和发布。
$ fastlane test
运行所有测试
$ fastlane code_coverage
显示测试代码覆盖率
$ fastlane beta
向 Apple TestFlight 提交新的 Beta 构建
$ fastlane doc
更新 SDK 文档
$ fastlane ios deploy
将 SDK 打包为框架
测试
所有测试代码均用 Swift 编写,网络请求不应达到网络,始终使用 JSON stubs 文件来拦截请求。我们使用第三方工具通过 Apple XCTest 测试框架。
- Nimble:以BDD风格的框架表示Swift或Objective-C表达式的预期结果
- Quick:Swift和Objective-C的行为驱动开发(BDD)框架。灵感来源于RSpec,Specta和Ginkgo。
- MockingJay:在Swift中轻松模拟HTTP请求
端到端(E2E)和自洽测试
这类类设计为灰色测试箱。在每种目标中,您可以通过添加 socket_url
、rest_url
、acme_url
和 ips_url
来自定义基本URL。
代码风格与约定
许可协议
版权(c)2018 Nexmo,Inc。保留所有权利。仅根据Stitch SDK许可协议(“许可”)授权
通过下载或使用我们的软件或服务,您承认您已阅读、理解并同意受Stitch SDK许可协议和隐私政策的约束。
您不得使用、行使其对或利用此SDK、或任何修改或衍生作品,除非根据许可
作者
- Jodi Humphreys
- Shams Ahmed, [email protected]
- Ivan Ivanov, [email protected]
- James Green, [email protected]
- Paul Calver
- Ashley Arthur, [email protected]
- Eric Giannini, [email protected]
- Chris Guzman, [email protected]
- Tom Morris, [email protected]
- Gady Rozin, [email protected]
- 陈乐夫,[email protected]