Liquid 2.3.4

您想将以下类似内容添加到您的 Podfile 中：

target 'MyApp' do
  pod 'Liquid', '~> 2.3'
end

然后在您的终端或从 CocoaPods.app 中运行 pod install 命令。

或者为了进行测试运行，运行以下命令：

pod try Liquid


依赖
SocketRocket	~> 0.5
方面	~> 1.4

Liquid 2.3.4

由
Liquid Data Intelligence S.A.
onliquid

快速开始 Liquid SDK for iOS & Apple Watch

本文档只是 Liquid SDK for iOS 的快速入门介绍。您可以在这里阅读完整的文档：https://www.onliquid.com/documentation/ios/。

要集成 Liquid 到您的应用程序中，只需遵循以下简单步骤。

在您的项目（iOS）中安装 Liquid

在您的系统中安装 CocoaPods
打开您的 Xcode 项目文件夹，并创建一个包含以下内容的名为 Podfile 的文件：
```
pod 'Liquid'
```
运行 pod install 并等待 CocoaPod 安装 Liquid SDK。从现在开始，您应该开始使用 .xcworkspace 文件，而不是使用 .xcodeproj 文件。

在您的项目（watchOS）中安装 Liquid

为了安装适用于 watchOS 项目的 Liquid，您需要在 Podfile 中为您的每个目标显式定义平台，如下所示

target 'Example' do
  platform :ios, '5.0'
  pod 'Liquid'
end

target 'ExampleApp WatchKit Extension' do
  platform :watchos, '2.0'
  pod 'Liquid'
end

target 'ExampleApp WatchKit App' do
  platform :watchos, '2.0'
  pod 'Liquid'
end

target 'Example TV App' do
  platform :tvos, '9.0'
  pod 'Liquid'
end

开始使用 Liquid

1. 初始化 Liquid 单例

在您的 AppDelegate.m 文件中，在 application:willFinishLaunchingWithOptions: 方法中初始化 Liquid

#import <Liquid/Liquid.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
# ifdef DEBUG
    [Liquid sharedInstanceWithToken:@"YOUR-DEVELOPMENT-APP-TOKEN" development:YES];
# else
    [Liquid sharedInstanceWithToken:@"YOUR-PRODUCTION-APP-TOKEN"];
# endif
    // The rest of your code goes here...
}

2. 识别用户（可选）

如果您所有的用户都是匿名的，您可以跳过此步骤。如果不是，您需要识别他们并定义他们的资料。通常这在与您的用户登录应用程序（或您执行自动登录）时间完成，如下面的示例所示

[[Liquid sharedInstance] identifyUserWithIdentifier:@"UNIQUE-ID-FOR-USER"
                                         attributes:@{ @"gender": @"female",@"name":@"Anna Lynch" }];

用户名 或 电子邮件 是应用程序使用的一些典型用户标识符。

3. 跟踪事件

您可以使用以下方法之一在您的应用程序中跟踪任何类型的事件：

[[Liquid sharedInstance] track:@"clickedProfilePage"];

或者

[[Liquid sharedInstance] track:@"boughtProduct" 
                    attributes:@{ @"productId": 123 }];

4. 配置推送通知和应用程序内消息

要通过Liquid公式为用户的设备发送推送通知或应用内消息，您只需配置这三种委派方法。

// AppDelegate.m

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [application registerForRemoteNotificationTypes:(UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound)];
    return YES;
}

- (void)application:(UIApplication *)app didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [[Liquid sharedInstance] setApplePushNotificationToken:deviceToken];
}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
    [[Liquid sharedInstance] handleRemoteNotification:userInfo forApplication:application];
}

5. 使用动态变量个性化应用程序

您只需将任何旧式的静态变量替换为Liquid动态方法，就可以将它转换为“Liquid”动态变量。您可以这样使用动态变量：

NSString *text = [[Liquid sharedInstance] stringForKey:@"welcomeText" 
                                              fallback:@"Welcome to our App"];

完整文档

我们建议您阅读完整的文档，请访问：https://www.onliquid.com/documentation/ios/。

作者

Liquid Data Intelligence, S.A.

许可证

Liquid遵循Apache许可证。更多详细信息，请参阅LICENSE文件。