集成 SDK

• 前置条件
• 集成方式
  • CocoaPods 集成 SDK
  • 手动集成 SDK

前置条件

• 环境要求
  • iOS >= 8.0
  • Xcode >= 10.0
• 组件依赖
  • Tars
  • TMFInstruction
  • TMFShark
  • TMFSSL
  • MQQComponents
  • MQQTcc
  • openssl
  • TMFXlog

集成方式

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

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

CocoaPods 集成 SDK

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

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

  其中：

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

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

  $ pod install
  

手动集成 SDK

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

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

  

  

• 把 TMFDistribution 依赖的所有组件添加到项目中，依赖的组件列表，请参见前置条件中的 组件依赖。

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

  系统库依赖

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

  

• Project 设置

  添加 TMFDistribution 之后，需要进行相关的 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__