PBGMService 开源项目安装与使用教程

PBGMService 开源项目安装与使用教程

PBGMService 国密算法 sm2/sm3/sm4 Objc封装！作者观点：重点不是算法而是密钥安全性！ 项目地址: https://gitcode.com/gh_mirrors/pb/PBGMService

1. 项目目录结构及介绍

项目PBGMService是一个基于Objective-C的封装，专注于实现国家商用密码算法(SM2/SM3/SM4)。以下是对主要目录结构的概述：

• PBGMService: 核心功能所在，包括对SM2加密解密、SM3哈希计算、以及SM4加密解密的实现。
  • PBGMService.m/h: 实现各类国密算法的具体逻辑。
• PBGMServiceTests: 单元测试相关，用于验证算法的正确性。
• PBGMServiceUITests: 若有，则可能包含UI相关的自动化测试代码。
• PBSMx: 框架目录，包含预编译的静态库文件，供项目直接链接使用。
  • 这里可能包含不同架构的支持文件如i386、x86_64、armv7、arm64。
• Pods: 若项目使用CocoaPods管理依赖，这个目录存放所有第三方库，例如OpenSSL，它是SM2算法实现所必需的。
• LICENSE: 许可证文件，表明项目遵循MIT协议。
• Podfile 和 Podfile.lock: 若适用，定义了项目的CocoaPods依赖及其版本锁定。
• README.md: 项目的主要说明文件，包含了快速入门指南、算法简介和关键点说明。

2. 项目的启动文件介绍

虽然本项目重点在于库的集成而非一个完整的应用，但要开始使用，关键是将PBGMService框架导入您的项目，并通过以下步骤进行初始化：

1. 将PBGMService中的框架文件添加到项目中。这通常涉及到将PBSMx/framework/PBSMx.framework拖拽至Xcode中的“Targets” -> “General” -> “Frameworks, Libraries, and Embedded Content”。

2. 使用CocoaPods集成OpenSSL，编辑或创建Podfile并加入行：pod 'OpenSSL', '~> 1.0.210'，然后执行pod install来下载和集成依赖。

3. 在需要使用国密算法的地方，引入PBGMService头文件，例如：#import "PBGMService.h"。

3. 项目的配置文件介绍

• Podfile: 不算是传统意义上的配置文件，但对于使用CocoaPods管理项目的开发者来说至关重要，它定义了项目的外部依赖及其版本。
• Info.plist: 虽然在基本的项目启动中不需要特别调整，但如果项目要求特定权限或者需要自定义App信息时，这是进行这些配置的地方。

对于国密算法的具体配置并非通过独立的配置文件完成，而是通过代码中调用API时指定参数来实现，比如选择使用哪种模式的加密，或是设置密钥等。

记得在集成过程中，确保已正确处理了其他链接标志(Other Linker Flags)，特别是在使用C++库时，添加"-lstdc++"，确保编译顺利进行。

以上就是PBGMService项目的基本介绍、启动和配置指南。按照上述步骤操作后，您就可以开始在iOS应用中利用该库进行安全的数据加密、签名验证等功能了。

PBGMService 国密算法 sm2/sm3/sm4 Objc封装！作者观点：重点不是算法而是密钥安全性！ 项目地址: https://gitcode.com/gh_mirrors/pb/PBGMService