Blondie 0.0.4

Blondie 0.0.4

×

由 Maxim Bilan 和 Maksims Gladkovs 维护。

Blondie 0.0.4

  • 由
  • Blondie 咨询公司

Blondie SDK

通过以下指南开始将 Blondie 集成到您的原生 iOS 应用程序中

安装

将 Blondie 安装到您的 iOS 应用程序中，以便直接从中执行自动化。Blondie SDK for iOS 库支持 iOS 8.x 及以上版本。

步骤 1 - 安装 Blondie SDK

在开始之前，您需要确保您有权访问 Blondie。您有三个选择

选项 1: CocoaPods（待定）

将 Blondie SDK 添加到您的 Podfile 并运行 pod install

target :YourTargetName do
  pod 'Blondie'
end

选项 2: Carthage（待定）

  1. 将 github "blondie-inc/blondie-sdk-ios" 添加到您的 Cartfile。
  2. 运行 carthage update。
  3. 前往您的Xcode项目的“通用”设置。将Blondie.framework从Carthage/Build/iOS拖动到“已嵌入的二进制文件”部分。

选项3：手动安装Blondie

下载iOS版本的Blondie SDK并解压缩。

前往您的Xcode项目的“通用”设置。将Blondie.framework拖动到“已嵌入的二进制文件”部分。确保已选中“如果需要则复制项目”，然后单击完成。

第3步 - 初始化Blondie

首先，您需要获取Blondie Flow ID和API密钥。要在Blondie Flow中找到这些，只需添加一个SDK触发即可。

然后通过导入库，在您的应用程序代理中添加以下内容来初始化Blondie SDK

Objective-C

@import Blondie;

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [Blondie setApiKey:@"<Your JWT API Key>"];
}

Swift

import Blondie 
  
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
     Blondie.setApiKey("<Your JWT API Key>")
}

配置

以下是配置iOS上Blondie的方法

选择一个环境

您可以选择要使用的Blondie Flow环境。在推出到生产环境之前，测试特定功能时非常方便。

默认情况下，我们选择production环境，但您可以通过调用其中之一来更改它

Objective-C

[Blondie useDevelopmentEnvironment];
[Blondie useTestEnvironment];
[Blondie useProductionEnvironment];

Swift

Blondie.useDevelopmentEnvironment()
Blondie.useTestEnvironment()
Blondie.useProductionEnvironment()

使用自定义Blondie Flow实例

为了将Blondie SDK与自定义Blondie Flow实例集成，您可以通过调用设置基本URL

Objective-C

[Blondie setBaseUrl:@"https://custom.flow.url"];

Swift

Blondie.setBaseUrl("https://custom.flow.url")

禁用离线模式

默认情况下，Blondie SDK既支持在线模式也支持离线模式。为了在没有网络连接的情况下工作，Blondie SDK会维护一个事件队列，以便在网络连接恢复时同步。

您可以通过调用以下方法来禁用此行为：

Objective-C

[Blondie disableOfflineMode];

Swift

Blondie.disableOfflineMode()

禁用自动重试

默认情况下，如果Blondie Flow请求过程中发生错误，Blondie SDK将执行自动重试，这样您就不必担心错过事件。

您可以通过调用以下方法来禁用此行为：

Objective-C

[Blondie disableAutoRetries];

Swift

Blondie.disableAutoRetries()

跟踪事件

您可以在Blondie中记录事件，记录用户在您的应用中的操作及其时间戳。例如，您可以记录用户提交到您的移动应用的数据及其提交时间。

Objective-C

[Blondie triggerEventWithName:@"Short Form Submitted" metaData: @{
  @"amount": @1234,
  @"customer": @{
    @"phone": @"+3712654321",
    @"email": @"[email protected]"
  }
}];

Swift

Blondie.triggerEvent(
  withName: "Short Form Submitted", 
  metaData: [
    "amount": 1234,
    "customer": [
      "phone": "+3712654321",
      "email": "[email protected]"
    ]
  ]
)