AnswerDash iOS SDK

本存储库包含了由AnswerDash发布的AnswerDash iOS SDK的二进制分发版本。

如果您对这个存储库中分发的任何产品有任何问题、评论或问题，请通过邮箱[email protected]联系团队。

要求

AnswerDashSDK是一个适用于iOS 8及以上版本的Objective-C和Swift项目的动态框架。

安装

可以通过导入框架或通过CocoaPods将AnswerDashSDK直接安装到您的应用程序中。以下提供了快速安装指南供参考。

CocoaPods安装

推荐使用CocoaPods进行安装。CocoaPods提供了一个简单、经过版本控制的依赖管理系统，它自动化了手动配置库和框架的繁琐和容易出错的部分。您可以通过以下步骤将AnswerDashSDK添加到您通过CocoaPods的项目中

$ sudo gem install cocoapods
$ pod setup

现在，在项目目录的根目录下运行以下命令：

$ pod init

这会创建一个Podfile文件，要集成AnswerDashSDK，请将pod AnswerDashSDK添加到文件中。现在它看起来应该是这样的：

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'AnswerDashSDK'
end

通过执行以下命令来完成安装：

$ pod install

这些说明将设置您的本地CocoaPods环境并将AnswerDashSDK导入到您的项目中。

手动框架安装

如果您希望通过二进制框架将AnswerDashSDK直接安装到您的应用程序中，请从这里下载最新的AnswerDashSDK.tgz，解压缩AnswerDashSDK.framework并将其按照以下步骤添加到您的应用程序中：

1. 将框架拖放到项目中，指示Xcode将其复制到目标组文件夹中。
2. 在您的项目设置中，确保将AnswerDashSDK.framework添加到“链接的框架和库”和“嵌入的二进制文件”中。

重要说明

Apple不会允许上传带有不需要的架构的应用程序。您将看到类似的错误：

- ERROR ITMS-90087: "Unsupported Architectures. The executable for YourCompany.app/Frameworks/AnswerDashSDK.framework contains unsupported architectures '[x86_64, i386]'."

要修复此问题，请在构建阶段**添加Run Script Phase**：

1. 前往目标设置中的“构建阶段”部分。
2. 点击左上角的+按钮，选择“新建运行脚本阶段”。
3. 在脚本文本输入框中粘贴以下代码片段：

bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/AnswerDashSDK.framework/strip-frameworks.sh"

更多信息，请参阅此文章。

用法

导入库

Swift

@import AnswerDashSDK

Objective-C

#import <AnswerDashSDK/AnswerDashSDK.h>

初始化

AnswerDashSDK应在应用程序启动时使用有效的站点ID进行初始化。将以下行添加到您的application:didFinishLaunchingWithOptions:委托方法中。

Swift

AnswerDash.initializeWithSiteID("YOUR-SITE-ID")

Objective-C

[AnswerDash initializeWithSiteID:@"YOUR-SITE-ID"];

设置应用状态

每当您的应用程序状态发生变化时，请调用以下方法来通知AnswerDashSDK。调用此方法将自动预载新问题和答案。

Swift

AnswerDash.appState = "NEW-APP-STATE"

Objective-C

[AnswerDash setAppState:@"NEW-APP-STATE"];

添加AnswerDash按钮

程序化,

Swift

let myAnswerDashButton = AnswerDashButton()
view.addSubview(myAnswerDashButton)
//Add layout constraints as required to position the button.

Objective-C

AnswerDashButton *myAnswerDashButton = [AnswerDashButton new];
[self.view addSubview:myAnswerDashButton];
//Add layout constraints as required to position the button.

使用Interface Builder，

将UIView添加到您的界面XIB/Storyboard中。将自定义类更改为AnswerDashButton，并添加所需的布局约束以定位按钮。请不要添加宽度和高度约束。

添加浮动AnswerDash按钮

如果您需要为您基于UITableView、UICollectionView或任何其他UIScrollView的控件添加默认浮动帮助按钮，请使用此便捷方法。AnswerDashSDK将正确定位按钮，并在滚动时使其粘性。

Swift

tableView.addAnswerDashButton()

Objective-C

[self.tableView addAnswerDashButton];

如果需要，您可以调用removeAnswerDashButton方法来移除按钮。例如

Swift

deinit {
    tableView.removeAnswerDashButton()
}

Objective-C

- (void)dealloc {
    [self.tableView removeAnswerDashButton];
}

样式

您可以使用以下属性自定义默认AnswerDash按钮的外观。

myAnswerDashButton.borderColor
myAnswerDashButton.fillColor
myAnswerDashButton.iconColor

使用自己的按钮实现

如果您想使用自己的按钮或其他交互方式触发AnswerDash弹出窗口，请直接调用以下方法来显示和隐藏弹出窗口。

Swift

AnswerDashSDK.show() //Opens the AnswerDash popup
AnswerDashSDK.hide() //Close the AnswerDash popup

Objective-C

[AnswerDashSDK show]; //Opens the AnswerDash popup
[AnswerDashSDK hide]; //Close the AnswerDash popup

联系方式

您可以通过发送电子邮件至[email protected]任何时候联系AnswerDash团队。

许可证

AnswerDashSDK遵循AnswerDash SDK许可证。