集成 Linkus iOS SDK

要集成 Linkus iOS SDK,你需要将 Linkus iOS SDK 导入到 iOS 项目中并对其进行初始化。

使用要求及前提条件

使用要求

确保你的开发环境满足以下要求:

  • iOS 版本:11 及以上
  • Xcode 版本:14.3 及以上
前提条件
启用 Linkus SDK 并绑定 APNs 证书

Demo & 源码

在正式集成之前,我们推荐你体验 Linkus iOS SDK 的 Demo 并查阅项目源码,以了解 Linkus iOS SDK 的整体运行框架及流程。

更多信息,前往 Linkus iOS SDK 的 GitHub 仓库

步骤一、导入 Linkus SDK 至 iOS 工程

选择以下任意一种方法导入 Linkus SDK:
使用 CocoaPods 自动集成 Linkus iOS SDK
注: 使用此方法集成 Linkus iOS SDK 前,确保你已安装 CocoaPods。更多信息,请参见 CocoaPods 入门指南
  1. 打开 iOS 工程项目的 Podfile 文件,添加以下代码并保存:
    注: 若无 Podfile 文件,可从终端进入项目根目录,并运行 pod init 命令生成该文件夹。
    pod 'linkus-sdk'
  2. 在终端内,运行以下命令安装 Linkus iOS SDK。
    pod install

    安装完成后,终端会显示 Pod installation complete!,且项目文件夹下会生成一个后缀为 .xcworkspace 的文件。

  3. 使用 Xcode 打开后缀为 .xcworkspace 的文件。
手动集成 Linkus iOS SDK
  1. 前往 Linkus SDK 的 GitHub 仓库,下载 Linkus iOS SDK 项目文件。
  2. 在 Xcode 中,将 linkus_sdk_iOS.framework 文件拖入对应的 Target 下,并在弹窗中勾选 Copy items if needed
  3. 在工程项目中,前往 Build Phases > Link Binary With Libraries,并添加以下依赖库:
    libz.dylib
    libc++.dylib
    libxml2.dylib
    libresolvdylib

步骤二、初始化 Linkus iOS SDK

  1. 在 iOS 工程项目内,打开 PrefixHeader.pch 文件并引入头文件。
    #import <linkus_sdk_iOS/linkus_sdk.h>
  2. 在工程项目 AppDelegate.mapplication:didFinishLaunchingWithOptions: 方法中,使用以下代码初始化 Linkus iOS SDK。
    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        [[YLSSDK sharedYLSSDK] initApp];
        return YES;
    }

后续步骤

向 PBX 服务器请求 SDK 登录签名,用于用户鉴权及登录 Linkus iOS SDK。

更多信息,参见 获取 Linkus iOS SDK 登录签名