GMObjC 项目常见问题解决方案

GMObjC 项目常见问题解决方案

GMObjC SM2/SM3/SM4/ECDH crypto library based on OpenSSL. 项目地址: https://gitcode.com/gh_mirrors/gm/GMObjC

项目基础介绍

GMObjC 是一个基于 OpenSSL 的国密算法库，支持 SM2、SM3、SM4 和 ECDH 加密算法。该项目主要用于 iOS 平台，使用 Objective-C 语言进行开发。通过 GMObjC，开发者可以在 iOS 应用中方便地集成国密算法，实现数据的安全加密和解密。

新手使用注意事项及解决方案

1. OpenSSL 版本冲突问题

问题描述：
在使用 GMObjC 时，可能会遇到 OpenSSL 版本冲突的问题，尤其是在项目中已经集成了其他依赖 OpenSSL 的第三方库（如百度地图 SDK）时。

解决步骤：

1. 升级第三方库：
   尝试升级项目中依赖 OpenSSL 的第三方库，使其支持 OpenSSL 1.1.1 或更高版本。GMObjC 直接共享这个 OpenSSL 库，无需单独为 GMObjC 添加 OpenSSL 依赖库。

2. 编译 GMObjC 为动态库：
   如果升级第三方库不可行，可以考虑将 GMObjC 编译为动态库。使用 Carthage 工具可以自动将 GMObjC 编译为动态库。具体操作如下：

   • 安装 Carthage：brew update && brew install carthage
   • 创建 Cartfile 文件并添加 GMObjC：touch Cartfile && echo 'github "muzipiao/GMObjC"' >> Cartfile
   • 执行编译命令：carthage update --use-xcframeworks
   • 编译成功后，在 Carthage/Build/iOS/ 目录下找到 GMObjC.xcframework，将其拖入项目中。

2. 数据分组长度和密钥长度问题

问题描述：
在使用 SM4 算法时，数据分组长度必须为 128 比特（即 16 字节），密钥长度也必须为 128 比特（即 16 字节）。如果数据或密钥长度不符合要求，会导致加密或解密失败。

解决步骤：

1. 检查数据长度：
   确保待加密的数据长度为 16 字节的整数倍。如果数据长度不符合要求，可以通过填充字节的方式使其满足要求。

2. 检查密钥长度：
   确保密钥长度为 16 字节。如果密钥长度不符合要求，可以通过截取或填充字节的方式使其满足要求。

3. 导入项目时的路径问题

问题描述：
在将 GMObjC 导入项目时，可能会遇到路径错误或找不到头文件的问题。

解决步骤：

1. 使用 CocoaPods 集成：
   推荐使用 CocoaPods 集成 GMObjC，这是最简单和最方便的方式。编辑 Podfile 文件，添加 pod 'GMObjC'，然后执行 pod install。

2. 手动导入项目：
   如果选择手动导入项目，确保将 GMObjC 文件夹拖入项目时，选择“Copy items if needed”选项，并确保在项目设置中正确配置了头文件搜索路径。

3. 检查导入路径：
   在导入项目后，检查项目设置中的“Header Search Paths”和“Framework Search Paths”，确保路径设置正确，能够找到 GMObjC 和 OpenSSL 的相关文件。

通过以上步骤，新手在使用 GMObjC 项目时可以有效避免常见问题，顺利集成和使用国密算法。

GMObjC SM2/SM3/SM4/ECDH crypto library based on OpenSSL. 项目地址: https://gitcode.com/gh_mirrors/gm/GMObjC