HelpCrunch SDK
一个智能客户沟通平台,融合了完美的实时聊天、邮件自动化和超级直观的帮助台。
内容
需求
- iOS 13+
- Xcode 12.0+
- ObjC / Swift 4.0+
安装
CocoaPods
CocoaPods 是一个用于 Swift 和 Objective-C Cocoa 项目的依赖管理器。它包含超过 43,000 个库,并被应用于超过 3000 万个应用程序。CocoaPods 可以帮助您优雅地扩展您的项目。
CocoaPods 使用 Ruby 构建,并且可以使用 OS X 上默认的 Ruby 版本进行安装。我们建议您使用默认的 Ruby 版本。
使用默认的 Ruby 版本安装可能需要在安装 gem 时使用 sudo
。详细安装说明请参阅 指南。
$ sudo gem install cocoapods
此外,还有用于 CocoaPods 的 Mac 应用。但目前的版本仅支持主要发布。
Podfile
要使用 CocoaPods 将 HelpCrunch 集成到您的 Xcode 项目中,请在您的 Podfile
文件中指定(位于您的 Xcode 项目目录中的文本文件)
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
use_frameworks!
target 'ProjectTargetName' do
pod 'HelpCrunchSDK', '~> 4.0'
end
提示:CocoaPods 提供了一个
pod init
命令,用于创建带有智能默认值的 Podfile。您应该使用它。
现在您可以为项目安装依赖项
$ pod install
在构建项目时,请始终打开 Xcode 工作区而不是项目文件
$ open App.xcworkspace
现在您可以导入依赖项,例如:
ObjC
@import HelpCrunchSDK;
Swift
import HelpCrunchSDK
Carthage
Carthage 是另一种将框架添加到您的 Cocoa 应用程序的方法。
Carthage 构建您的依赖项并提供二进制框架,但您可以完全控制项目结构和设置。Carthage 不会自动修改您的项目文件或构建设置。
如果您尚未安装它,请查阅 快速入门指南
Cartfile
在 .xcodeproj 或 .xcworkspace 所在目录中创建一个 Cartfile。
打开 Cartfile 并添加 github "helpcrunch/helpcrunchsdk-ios" ~> 4.0
运行
$ carthage update --platform ios --use-xcframeworks
打开 常规
设置。将构建好的 HelpcrunchSDK.xcframework
二进制文件从 Carthage/Build/iOS
拖到 嵌入的二进制文件
部分。不要忘记选择 如需则复制项
Swift Package Manager
SPM 是向项目中添加库的现代方式。它内置在 Xcode 中,因此您不需要安装其他工具。您可以在 Xcode 中将 HelpCrunchSDK
添加为 Swift Package
仓库。您可以通过以下操作完成此操作:
文件 -> Swift Packages -> 添加包依赖...
或
项目 -> 您的项目名称 -> Swift Packages -> +.
然后添加此 URL: https://github.com/helpcrunch/helpcrunchsdk-ios
然后只需遵循屏幕上的说明。
手动安装
您需要完成几个额外步骤
下载 HelpcrunchSDK.xcframework 并将其复制到 嵌入的二进制文件
部分。不要忘记选择 如需则复制项
.
更新 Info.plist
为了发送文件和照片,您的 Info.plist
中需要包含 NSCameraUsageDescription
、NSPhotoLibraryAddUsageDescription
和 NSPhotoLibraryUsageDescription
条目。
这些条目由 Apple 要求。当用户尝试使用相机或打开或保存图像到照片库时,才会提示用户选择相机/照片库权限,使用您提供的文本。
NSCameraUsageDescription
- 当用户尝试使用相机时
NSPhotoLibraryUsageDescription
- 当用户尝试打开照片库时
NSPhotoLibraryAddUsageDescription
- 当用户尝试将图像保存到照片库时
文档
文档在 此处 可用。您还可以检查 Swift 和 ObjC 应用示例 在此
许可证
本项目根据Apache License 2.0许可——详细信息请参阅LICENSE文件