集成 SDK

• 前置条件
• 集成方式
  • CocoaPods 集成 SDK（离线 Pod）
  • 手动集成 SDK

前置条件

• 环境要求

  • iOS >= 8.0
  • Xcode >= 10.0

• 组件依赖

  • TMFInstruction
  • TMFShark
  • Tars
  • openssl
  • MQQTcc
  • MQQComponents
  • TMFSSL

集成方式

MQQCodeDetector 的集成方式有以下 2 种，可选择其一进行集成：

• CocoaPods 集成 SDK（离线 Pod）
• 手动集成 SDK

CocoaPods 集成 SDK（离线 Pod）

• 在您项目中的 Podfile 文件里添加如下内容：

  target 'YourTarget' do
  
    # 依赖组件
    pod 'TMFInstruction',       :path => './Frameworks/TMFInstruction'
    pod 'TMFShark',             :path => './Frameworks/TMFShark'
    pod 'Tars',                 :path => './Frameworks/Tars'
    pod 'openssl',              :path => './Frameworks/openssl'
    pod 'MQQTcc',               :path => './Frameworks/MQQTcc'
    pod 'MQQComponents',        :path => './Frameworks/MQQComponents'
    pod 'TMFSSL',               :path => './Frameworks/TMFSSL'
  
    # TMFDataPush
    pod 'TMFDataPush',          :path => './Frameworks/TMFDataPush
  
  end
  

  其中：

  • YourTarget 为您的项目需要引入 TMFDataPush` 的 target 的名字。
  • :path => 指向的路径，为当前组件的 .podspec 文件所在目录与 Podfile 文件的相对路径。 例如，上面示例中的 './Frameworks/TMFDataPush' 为 TMFDataPush.podspec 文件所在目录的相对路径。

• Terminal cd 到 Podfile 文件所在目录，并执行 pod install 进行组件安装。

  $ pod install
  

手动集成 SDK

• 把 TMFDataPush 组件的目录添加到您项目的 Xcode Project 中的合适位置，并选择合适的 target。 您可以把组件的目录从 Finder 直接拖动到 Xcode Project 中，以进行快捷添加。

  注意：手动集成 SDK 不要引入 LICENSE 与 podspec 等无关文件到项目中。

  

  

• 把 TMFDataPush 依赖的所有组件添加到您的项目中。 依赖的组件列表见 前置条件 - 组件依赖。

• 添加 TMFDataPush 依赖的系统库。 在 Xcode 中打开您的 project 设置页，选中相关的 target，单击 General，在“Linked Frameworks and Libraries”中进行添加。

  系统库依赖

  • Foundation.framework
  • UIKit.framework
  • Security.framework
  • CoreTelephony.framework
  • SystemConfiguration.framework
  • CoreFoundation.framework
  • libsqlite3.0.tdb
  • libc++.tdb
  • libc.tbd
  • libz.1.2.5.tbd

  

• Project 设置

  添加 TMFDataPush 之后，需要进行相关的 Project 设置。
  在 Xcode 中打开您的 Project 设置页，选中相关的 target，进行以下设置：

  • 选择 Build Settings > Linking > Other Linker Flags，增加：
    • -ObjC
  • 选择 Build Settings > Apple Clang - Custom Compiler Flags > Other C Flags，增加：
    • -fshort-wchar
    • -D__FIXWCHART__
  • 选择 Build Settings > Apple Clang - Custom Compiler Flags > Other C++ Flags，增加：
    • -fshort-wchar
    • -D__FIXWCHART__