• 所需设置
• 安装
  • CocoaPods
  • Carthage
  • 手动
• 完整SDK文档

所需设置

要使用HandpointSDK，您需要先设置一些内容

在您的Info.plist中设置外部配件协议

添加/修改属性"支持的外部配件协议"，并添加com.datecs.pinpad

在您的info.plist的"源代码"视图中，它应该看起来像这样

<key>UISupportedExternalAccessoryProtocols</key>
<array>
    <string>com.datecs.pinpad</string>
</array>

重要

Handpoint蓝牙读卡器是Apple MFi计划的一部分。为了发布支持MFi计划配件的应用程序，您必须在Apple处申请。请填写MFi表格，我们将帮助您完成此过程。

设置外部配件通信后台模式

在Xcode项目中，从“能力”标签页“后台模式”部分启用对外部配件通信的支持。

您还可以通过在您的app的Info.plist文件中包含具有external-accessory值的UIBackgroundModes密钥来启用此支持

<key>UIBackgroundModes</key>
<array>
    <string>external-accessory</string>
</array>

安装

CocoaPods

CocoaPods 是 Cocoa 项目的依赖管理器。您可以使用以下命令安装它：

$ gem install cocoapods

如果您还没有 Podfile

$ pod init

要使用 CocoaPods 将 HandpointSDK 集成到您的 Xcode 项目中，请在您的 Podfile 中指定它

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target 'your_target' do
    pod 'HandpointSDK', '~> 3.3.1'
end

然后，运行以下命令

$ pod install

Carthage

Carthage 是一个去中心化的依赖管理器，它会构建您的依赖项并为您提供二进制框架。

您可以使用以下命令通过 Homebrew 安装 Carthage：

$ brew update
$ brew install carthage

要使用 Carthage 将 HandpointSDK 集成到您的 Xcode 项目中，请在您的 Cartfile 中指定它

github "handpoint/HandpointSDK-iOS"

运行 carthage update 命令以构建框架，并将构建的 HandpointSDK.framework 拖到您的 Xcode 项目中。

手动

如果您愿意手动处理依赖，有三种方法将 HandpointSDK 包含到项目中

预构建静态库

从 Handpoint 开发者门户 下载最新的预构建静态库，并参照那里的说明进行安装。

自己构建项目

从主分支下载最新版本

$ git clone https://github.com/handpoint/HandpointSDK-iOS.git

还可以将其作为git 子模块添加。

$ git submodule add https://github.com/handpoint/HandpointSDK-iOS.git

框架

动态框架项目名为 HandpointSDK.xcodeproj，位于repo的根目录下。

静态库

静态库项目名为 headstart.xcodeproj，位于 Library 文件夹下。

强烈建议您不要自己构建此项目。

此项目包含许多目标，您需要构建聚合目标 device-simulator Release

此目标在 headstart.xcodeproj 文件相同的目录下生成一个 .zip 文件，包含库和模拟器库。

完整SDK文档

完整的SDK文档可以在 Handpoint的开发者门户 中找到。

内部文档

发布方法