Lime Connect SDK for iOS

要连接您在 Lime Connect 中创建的内容到您的移动应用，您需要遵循一些简单的步骤。本手册描述了 SDK 集成的几种情景。高级 SDK 选项请参阅我们的 API 参考。

安装

Lime Connect SDK 通过CocoaPods提供，CocoaPods 是 Objective-C 的依赖管理器，可自动并简化在项目中使用第三方库如 Lime Connect SDK 的过程。

要安装 iOS 的 Lime Connect SDK，只需将以下行添加到您的 Podfile 中

platform :ios, "7.0"
pod 'LimeConnectSDK'

或者，您可以手动下载我们的 SDK 软件包（来自 Pod 文件夹的类和资源）并使用拖放将其添加到您的 iOS 项目中。

为了让 Lime Connect SDK 工作正常，您需要更改您的 Info.plist 文件以声明所需的位置服务，即 CoreLocation（iBeacon 支持是 CoreLocation 的一部分）。添加 NSLocationAlwaysUsageDescription 键（String）。此键的值应是一个文本，解释在您的应用中使用 iBeacons 的目的。用户根据此文本决定是否授予应用程序权限。

説明文本示例

"为了在您进入我们商店后自动向您展示折扣券，我们需要能够确定您的位置，即使您不积极使用您的应用程序。"

基本的 SDK 集成

Lime Connect SDK 最简单的使用案例是基于自动的近距消息和数据分析。在此情况下，SDK 自动执行以下步骤

• 下载 SDK 配置。
• 监视 Lime Connect 中定义的区域。
• 如果找到区域，请求关联的内容规则。
• 下载内容规则，并显示与之相连的通知（仅在应用后台显示）。
• 如果用户打开通知，渲染与规则关联的内容。
• 自动将所有分析事件发送到 Lime Connect。

以下代码用于此基本的 Lime Connect SDK 集成

- (BOOL)application:(UIApplication *)app didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Connect to your CMS data using the APP_KEY
    [[LimeConnect sharedInstance] startFetchingContextForApplicationKey:@"app_8cb31c49a46df1fea116a3e07f0b6a84"];

    // Handle notifications when your app is NOT running on background
    UILocalNotification *notif = [launchOptions objectForKey:UIApplicationLaunchOptionsLocalNotificationKey];
    [[LimeConnect sharedInstance] handleAppLaunch:notif];
    return YES;
}

- (void)application:(UIApplication *)app didReceiveLocalNotification:(UILocalNotification *)notif {
    // Handle notifications when your app is running on background
    [[LimeConnect sharedInstance] handleAppLaunch:notif];
}

您的应用现在可以根据您创建的内容规则从 Lime Connect 收到通知，并在您的应用中显示内容。

API 参考

我们移动SDK的高级功能，例如在应用程序中手动内容渲染、iBeacon距离测量、通知节流或其他功能，已经在我们的API参考中进行了解释。

http://assets.lime-company.eu/docs/ios/html/Classes/LimeConnect.html

作者

Lime - 高科技解决方案有限公司

• 网站：http://www.lime-company.eu/
• Twitter：https://twitter.com/lime_company
• E-mail：[email protected]

许可协议

Lime Connect SDK for iOS 可在GPLv3许可协议下使用。更多信息请参阅LICENSE文件。