集成 Linkus macOS SDK

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

使用要求及前提条件

使用要求

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

  • macOS 版本:10.13 及以上
  • Xcode 版本:14.3 及以上
前提条件
启用 Linkus SDK

Demo & 源码

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

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

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

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

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

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

步骤二、初始化 Linkus macOS SDK

  1. 在 macOS 工程项目内,打开 PrefixHeader.pch 文件并引入头文件。
    #import <linkus_sdk_MacOS/linkus_sdk.h>
  2. 参考 Demo 源码,初始化 Linkus SDK。

后续步骤

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

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