开发过程
-
执行
pod lib create [ProjectName]创建项目。过程中需要回答几个问题，根据自己的需要设置设置就可以了。我的设置是：-
What platform do you want to use?? [ iOS / macOS ]
iOS
-
What language do you want to use?? [ Swift / ObjC ]
Swift
-
Would you like to include a demo application with your library? [ Yes / No ]
Yes
-
Which testing frameworks will you use? [ Quick / None ]
None
-
Would you like to do view based testing? [ Yes / No ]
No
紧接着会自动执行
pod install，我们只需要静静的等着完成就可以了。 -
-
项目结构。
pod install之后，Cocoapods会直接打开Xcode project。项目结构如下：- Podspec Metadata
- .podpsec - 项目相关的pod信息。包括了版本号、g�ithub主页、对其他项目的依赖、作者信息和指定资源文件
- README.md - 对当前项目的介绍和使用方法。也就是github中项目主页的介绍内容。
- LICENSE - 指定使用的开源协议
- Example for DemoProj - 对开源代码的使用实例。其他人从github下载了开源项目后可以通过这个来查看使用方法。如果在
Would you like to include a demo application with your library?中选择了No，这个项目就不会创建。因此强烈建议这个问题回答YES。对自己调试和别人使用都非常有利。 - Tests - 单元测试。
- Development Pods - 开源库代码就放在这里。
- Frameworks - 当前开源项目的依赖库
- Podspec Metadata
-
.podspec文件详解
- s.name - 名称，
pod search搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错 - s.version - 版本号，这个版本号要和tag版本一致，否则报错
- s.summary - 项目简介，
pod search的结果中会展示 - s.homepage - 项目主页地址，也就是github地址
- s.source -
git clone的项目地址。 - s.ios.deployment_target - 支持到的iOS版本
- s.source_files - 资源文件路径。请确保把项目相关的源文件放在这个文件夹下面，否则报错。
- s.dependency - 项目依赖的其他三方库。
- s.name - 名称，
在github上创建仓库
开发项目。。。
开发结束，把项目提交到github。
打tag并把tag提交。tag号要和.podspec中的s.server一致。
-
验证.podspec
-
pod lib lint本地验证 -
pod spec lint和github上的内容进行对比
-
把项目发布到Cocopods的master上。
pod trunk push [ProjectName].podspec。注意，这个过程较(chao ji)慢。
可能遇到的问题
-
pod lib lint通过，但是pod spec lint报错：use of unresolved identifier。遇到这个问题后，分为两步：-
pod spec lint --no-clean --verbose查看错误原因，这是会看到临时文件，到临时文件里查看会发现缺少文件 - 使用
pod cache clean - 重新执行一次
pod spec lint
-
- 项目提交后执行
pod search找不到的话，执行pod setup。 - 验证的时候出现
.swift-version错误。解决办法是在项目目录下创建一个执行echo "4.0" > .swift-version。注意，这里的4.0是我开发项目时使用的Swift版本。 - 注意权限控制和Swift与OC的混编问题
赠送一个提交开源库的shell脚本
# bin/sh
# 验证本地 pod lib lint
echo 'pod lib lint...\n'
pod lib lint
# 下拉git git pull
echo '\ngit pull...\n'
git pull
echo `git pull`
# 上传git git add git commit git push
echo "git add . \n"
git add .
echo "Enter a commit message: \c"
read commitMsg
echo "git commit -m $commitMsg"
git commit -m '$commitMsg'
# tag git tag git push --tags
echo "\ngit push ...\n"
git push
echo "\nEnter tag version: \c"
read tagVersion
git tag $tagVersion
echo "\n git push --tags ..."
git push --tags
# 远程验证 pod spec lint
echo "\npod spec lint ...\n"
pod spec lint
# 提交代码 pod trunk
echo "\npod trunk push ...\n"
pod trunk push [yourprojectname].podspec
首发在我的个人博客
欢迎关注微信公众号：iOS进阶指南
👍👍👍
