制作自己的CocoaPods公开库（涉及modulemap）

创建GIT仓库

图1

Repository name 仓库名称
Description 描述
Public / Private 公开仓库或者私人仓库
Initialize this repository with a README 创建一个README文件
Add .gitignore 需要忽略的文件类型
Add a license 添加一个许可证，如果项目需要上传到cocoapods，最好选择一个。

将仓库克隆到本地指定目录，该目录下将自动创建HCKit-Swift文件夹，并且包含LICENSE和README.md文件。

cd /Users/chenhc/Documents/Swift
git clone https://github.com/chyo/HCKit-Swift.git

创建一个项目，并将项目根目录中的文件移动到HCKit-Swift目录中

图2

创建Pods依赖文件

cd HCKit-Swift
pod spec create HCKit-Swift

HCKit-Swift根目录中将出现HCKit-Swift.podspec文件，将文件的内容修改为自己所需的


Pod::Spec.new do |s|

# 项目名
  s.name         = "HCKit-Swift"
# 版本号
  s.version      = "0.0.1"
# 摘要
  s.summary      = "一个简单的Swift库"
# 描述
  s.description  = <<-DESC
                    一个森罗万象的Swift库
                   DESC
# 主页
  s.homepage     = "https://github.com/chyo/HCKit-Swift"
# 证书
  s.license      = "MIT"
# 作者
  s.author             = { "ChenHongchao" => "xmchc@hotmail.com" }
# 平台
  s.platform     = :ios, "8.0"
# Swift版本
  s.swift_version = "4.0"
# 来源
  s.source       = { :git => "https://github.com/chyo/HCKit-Swift.git", :tag => "#{s.version}" }
# 源代码
  s.source_files  = "Classes/*.swift"
# 资源文件
  # s.resources = "Resources/*.png"
# 依赖系统库
  # s.framework  = "SomeFramework"
  # s.frameworks = "SomeFramework", "AnotherFramework"
  # s.library   = "iconv"
  # s.libraries = "iconv", "xml2"
# ARC
  s.requires_arc = true
# XC配置
  # s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
# 依赖库
  # s.dependency "JSONKit", "~> 1.4"

end

创建项目

创建一个项目，在项目中创建一个实体文件夹Classes（非group），并在其中新建一个Swift类。

image.png

关闭项目，将项目根目录中的文件全部移动到HCKit-Swift中。

image.png

项目中的实体文件夹名称Classes和刚才所创建的HCKit-Swift.podspec文件中的s.source_files需保持一致，并且如果此文件夹包含多级目录，层级关系也要保持一致。假设Classes文件夹中有二级目录，那么s.source_files就应该改为：

s.source_files = "Classes/**/*.swift"

同步GIT仓库

// 版本标签，要与HCKit-Swift.podspec文件保持一致
git tag 0.0.1
// 上传标签
git push --tags
// 添加文件
git add .
// 提交
git commit -m '初次提交'
// 上传，默认合并到master主干
git push
// 校验pod文件
pod spec lint HCKit-Swift.podspec

根据校验的结果修改产生的错误，WARN类型的警告可以选择性处理，其他常见的一些错误：

Could not find remote branch 0.0.1 to clone.
// 无法找到版本号为0.0.1的分支/主干，执行 git push --tags 即可

The `source_files` pattern did not match any file.
The `resources` pattern did not match any file.
The `preserve_paths` pattern did not match any file.
module_map: Unable to find the specified module map file.
// 这几种错误的处理方式都是一样的，主要是podspec中配置的路径与实际路径不一致所导致的，
// 如果确认路径无误，那么需要重新设定.podspec文件中的s.version，
// 重新执行上述“同步GIT仓库”的操作，tag需要与s.version保持一致。

The validator used Swift 3.2 by default because no Swift version was specified. To specify a Swift version during validation, add the `swift_version` attribute in your podspec. Note that usage of the `--swift-version` parameter or a `.swift-version` file is now deprecated.
// 这个主要是因为Swift版本引起的，需指定代码运行的Swift版本
// 打开.podspec文件，添加 s.swift-version = '4.0.0'

如果通过校验，则会提示

 -> HCKit-Swift (0.0.1)

Analyzed 1 podspec.

HCKit-Swift.podspec passed validation.

执行lint操作后根据cocoapods的安装目录，可以在本地文件夹中找到代码库

~/Library/Caches/CocoaPods/Pods/External

其他的一些操作（非必须）

// 删除版本标签
git tag -d 0.0.1
// 拉取代码
git pull

发布到Cocoapods

注册trunk，注册成功会在邮箱中收到一个验证地址，验证成功后就可以查看自己的个人信息。

pod trunk register 电子邮件 '用户名' --verbose
// 邮箱验证后，执行
pod trunk me

最后直行push操作将库上传到pods中，注意库的名称不能与其他人重复，否则会提示 xxx库的作者是xxxx。

pod trunk push

// 上传结果，这个过程需要一段时间
// [!] Found podspec `HCKit-Swift.podspec`
// Updating spec repo `master`
// Validating podspec
//  -> HCKit-Swift (0.0.3)
// Updating spec repo `master`
// --------------------------------------------------------------------------------
// 🎉  Congrats
// 
// 🚀  HCKit-Swift (0.0.3) successfully published
// 📅  May 21st, 20:53
// 🌎  https://cocoapods.org/pods/HCKit-Swift
// 👍  Tell your friends!
// --------------------------------------------------------------------------------

此后每次版本变更需要执行以下几个步骤：

1. 变更.podspec文件的s.version
2. 同步GIT仓库，tag与s.version保持一致
3. trunk push

trunk成功后如果搜索不到自己的库，可以重新同步下pods代码

pod setup

如果setup之后依然搜索不到，那么需要重新建立检索文件

// 进入 /Users/用户名/Library/Caches/CocoaPods 文件夹删除search_index.json
// 执行
pod search HCKit-Swift

image.png

删除发布到cocoapods的框架

pod trunk delete 框架名称 版本号

CommonCrypto

在Swift中使用CommonCrypto库一般有两种方式，一种是建立桥接文件，一种是使用modulemap。我用的是modulemap的方式，模拟器和真机编译一切都正常，但是校验podsepc的时候提示了失败。

// 没配置相关信息的时候提示
no such module 'CommonCrypto'
// 配置了s.module_map、s.preserve_path、s.xcconfig的时候提示
HCKit-Swift/Classes/Extension/String+HCExtension.swift:10:8: error: could not build Objective-C module 'CCommonCrypto'

在stackflow上看了好多方法都不管用，最后终于找到了方案，记住，podspec中的 s.module_map = "xxxx" 这个是无效的，无效的！
在根目录创建文件夹Module，在文件夹中创建空文件(Other/empty)，命名为module.modulemap，编辑文件：

module CommonCrypto [system] {
    header "/usr/include/CommonCrypto/CommonCrypto.h"
    export *
}

在项目的Build Settings中找到Import Paths，设置其值为$(PROJECT_DIR)/Module，编译，这时候就可以正常引用了 import CommonCrypto。
打开.podspec文件，修改source_files、preserve_path、xcconfig：

// modulemap要配置在source_files中，配置在module_map中不起作用
s.source_files  = "Classes/**/*.swift", "Module/*.modulemap"
s.preserve_path = "Module/module.modulemap"
s.xcconfig = { "SWIFT_INCLUDE_PATHS" => "$(PODS_ROOT)/HCKit-Swift/Module"}

接下来就是打版本标签，提交，校验即可。