添加统一SDK

添加统一SDK

iOS的统一SDK支持四种集成方法:

• Swift Package Manager

• CocoaPods

• 迦太基

• 用Xcode手动操作

使用SPM添加SDK

Swift Package Manager是一个用于管理Swift代码分发的工具。它与Swift构建系统集成，以自动化下载、编译和链接依赖项的过程。

将Zendesk 亚博SDK作为依赖项添加到项目:

1. 检索所需产品SDK包的URL。例子:https://github.com/亚博zendesk/answer_bot_sdk_iosAnswerBot,https://github.com/亚博zendesk/chat_sdk_ios用于聊天，或https://github.com/亚博zendesk/support_sdk_ios寻求支持。

2. 遵循苹果公司的文档关于如何将包添加到项目。

3. 将步骤1中的URL粘贴到选择存储库包搜索栏。

4. 使用基于版本的Package Requirements，设置为SDK的最新版本。

使用CocoaPods添加SDK

CocoaPods是一个依赖管理器，允许您将第三方框架和库添加到项目中。有关安装说明，请参见安装CocoaPods．

如果还没有完成，为你的项目创建一个Podfile，如下所示:

1. 在Terminal中，导航到项目的顶级文件夹(带有xcodeproj文件)。

2. 用下面的命令创建一个Podfile:$ pod init

3. 用下面的命令在Xcode中打开文件:打开一个Xcode Podfile

内容应该如下:

             

              
｀｀｀ruby以“我的样本应用”为目标use_frameworks !#如果你使用的是Objective-C，删除这一行结束｀｀｀
             

1. 添加以下选项之一圆荚体命令做你的Podfile块，取决于你的Zendesk配置。亚博

                  
   
                   
   以“我的样本应用”为目标.．.统一SDK是每个产品SDK的子依赖项# pods('亚博 ZendeskAnswerBotSDK '， ' ZendeskChatSDK '和' ZendeskSupportSDK ')。pod '亚博ZendeskAnswerBotSDK' # AnswerBot-only在统一SDK上pod '亚博ZendeskChatSDK' #只在统一SDK上聊天pod '亚博ZendeskSupportSDK' #只支持统一SDK结束
                  

2. 保存Podfile。

3. 在Terminal中执行如下命令:

                  
   
                   
   圆荚体安装
                  

   请注意:如果您使用CocoaPods安装了以前版本的SDK，请运行豆荚更新首先更新系统上的SDK pod。

因为你的项目现在包含一个由CocoaPods管理的依赖项，你必须在Xcode中双击.xcworkspace文件,而不是.xcodeproj．

有关更多信息，请参见使用CocoaPods在cocoapods.org上。

添加带有Carthage的SDK

Carthage是iOS应用程序的另一个常见的第三方依赖管理器。有关安装和使用说明，请参见安装迦太基在Github上的迦太基自述手册。

1. 在你的Cartfile，添加以下行来导入必要的框架，以集成Support、Chat和AnswerBot依赖项:

                  
   
                   
   #回答机器人Github "亚博zendesk/answer_bot_sdk_ios" ~> 3.0.0#聊天Github "亚博zendesk/chat_sdk_ios" ~> 3.0.0#支持Github "亚博zendesk/support_sdk_ios" ~> 6.0.0
                  

   请注意:如果您只想要一个产品SDK，只需从此列表中删除其他产品SDK。

2. 保存Cartfile。

3. 执行如下命令:

                  
   
                   
   Carthage更新——使用xcframeworks
                  

4. 将以下框架拖到框架和库应用程序目标的general Settings选项卡下的。确保嵌入下拉了嵌入和签名为每个框架选择。

   • 亚博ZendeskCoreSDK.xcframework
   • SupportProvidersSDK.xcframework
   • SupportSDK.xcframework
   • CommonUISDK.xcframework
   • AnswerBotSDK.xcframework
   • AnswerBotProvidersSDK.xcframework
   • ChatSDK.xcframework
   • ChatProvidersSDK.xcframework
   • MessagingSDK.xcframework
   • MessagingAPI.xcframework
   • SDKConfigurations.xcframework

请注意:你的应用程序构建目标必须指向它FRAMEWORK_SEARCH_PATHS在Carthage/Build/iOS文件夹中设置。

手动添加SDK

为了在你的应用中使用统一SDK，你必须在Xcode中手动添加以下SDK到你的项目中。

请注意:对于人工集成，集成商可以选择使用苹果的新框架格式XCFrameworks或者旧的胖框架格式。

1. 下载以下ZIP文件:

• https://github.com/亚博zendesk/core_sdk_ios/releases/download/3.0.0/ZendeskCoreSDK.xcframework.zip
• https://github.com/亚博zendesk/answer_bot_sdk_ios/releases/download/3.0.0/AnswerBotSDK.xcframework.zip
• https://github.com/亚博zendesk/answer_bot_providers_sdk_ios/releases/download/3.0.0/AnswerBotProvidersSDK.xcframework.zip
• https://github.com/亚博zendesk/support_sdk_ios/releases/download/6.0.0/SupportSDK.xcframework.zip
• https://github.com/亚博zendesk/support_providers_sdk_ios/releases/download/6.0.0/SupportProvidersSDK.xcframework.zip
• https://github.com/亚博zendesk/chat_sdk_ios/releases/download/3.0.0/ChatSDK.xcframework.zip
• https://github.com/亚博zendesk/chat_providers_sdk_ios/releases/download/3.0.0/ChatProvidersSDK.xcframework.zip
• https://github.com/亚博zendesk/messaging_sdk_ios/releases/download/4.0.0/MessagingSDK.xcframework.zip
• https://github.com/亚博zendesk/messagingapi_sdk_ios/releases/download/4.0.0/MessagingAPI.xcframework.zip
• https://github.com/亚博zendesk/commonui_sdk_ios/releases/download/7.0.0/CommonUISDK.xcframework.zip
• https://github.com/亚博zendesk/sdkconfigurations_sdk_ios/releases/download/2.0.0/SDKConfigurations.xcframework.zip

你也可以批量下载ZIP文件复制上面的列表，粘贴到一个文本文件，并运行以下命令:

             

              
｀｀｀Wget -i _the_file_you_created_的名称｀｀｀**请注意**：你可以安装｀wget｀工具与家酿使用｀Brew install wget｀．
             

1. 在Xcode中，在project navigator中选择你的项目:

   

2. 在Finder中，导航到提取SDK的位置。

3. 将下面的XCFrameworks拖到框架和库应用程序目标的general Settings选项卡下的。确保嵌入下拉了嵌入和签名为每个框架选择。

   • 亚博ZendeskCoreSDK.xcframework
   • SupportProvidersSDK.xcframework
   • SupportSDK.xcframework
   • CommonUISDK.xcframework
   • AnswerBotSDK.xcframework
   • AnswerBotProvidersSDK.xcframework
   • ChatSDK.xcframework
   • ChatProvidersSDK.xcframework
   • MessagingSDK.xcframework
   • MessagingAPI.xcframework
   • SDKConfigurations.xcframework

4. 设置添加文件选项如下:

   • 目的地——选择如有需要，复制项目
   • 添加文件夹——选择创建组

请注意:如果你在构建项目时出现链接错误，你可能需要添加以下一个或两个苹果核心框架到你的项目中:MobileCoreServices.framework而且Security.framework．它们并不总是自动添加。

添加iCloud权限

若要允许用户附加文件以支持来自其iCloud帐户的请求，您必须启用iCloud文档在你的应用中功能．

更新Info.plist中的用法描述

Support SDK使用iOS中的相机和照片库，允许最终用户向门票添加图像附件。

如果你的应用程序还没有请求这些功能的权限，更新你的Info.plist的使用说明的文件NSPhotoLibraryUsageDescription而且NSCameraUsageDescription．

了解更多关于Apple中的Cocoa key开发人员文档．