Git 私有库的创建

最近在学习组件化。
组件化有一个方案是利用cocoapods进行管理组件。
这就涉及到了specs私有库的创建、维护和使用。


1. 开启显示隐藏文件

为了方便查看某些文件是否完成
//打开隐藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool true
//关闭隐藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool false


2. 创建远程组件索引库

该库包含了所有组件的索引以及版本信息。
命名最好以Specs结尾,我采用了coding的免费私有库。


image.png

3. 创建本地组件索引库

终端输入:pod repo add REPO_NAME SOURCE_URL

REPO_NAME:仓库名字,最好和远程索引仓库保持一致,
SOURCE_URL:为仓库地址。
回车后,Finder利用~/.cocoapods/repo查看,可以看到系统已经为我们创建好了文件夹和基本配置。


4. 创建 lib

4.1创建远程代码库

image.png

4.2 本地创建项目,将库文件引入工程, 关联远端的库.

终端输入:pod lib create REPO_NAME

image.png

4.3 将库文件引入工程,

完成后,将你的代码库代替Classes里的ReplaceMe.m

终端进入Example文件夹
pod install
可以看到项目中已经导入添加在Classes里的代码

4.4 将本地 lib 关联到远端库

git add .

git commit -m "first commit"

git remote add origin SOURCE_URL

git tag '0.0.1'

git push --tags

git push -f origin master

5. 配置 podspec 文件

5.1 修改.podspec文件
#
# Be sure to run `pod lib lint basedModule.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see https://guides.cocoapods.org/syntax/podspec.html
#

Pod::Spec.new do |s|
  s.name             = '组件名字'
  s.version          = '组件版本'
  s.summary          = '组件描述'

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
组件详细描述
                       DESC

  s.homepage         = '组件代码主页'
  # s.screenshots     = '组件代码库地址'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { '作者' => '作者地址' }
  s.source           = { :git => '组件代码库地址', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '最低版本'

  s.source_files = '组件名字/Classes/**/*'
  
  # s.resource_bundles = {
  #   '组件名字' => ['组件名字/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end
5.2 检测spec是否可用

pod lib lint --allow-warnings
pod spec lint --allow-warnings

--allow-warnings :忽略所有警告,并通过校验。
--no-clean :检查任何问题。
--verbose :查看详细的验证过程来帮助定位错误
--use-libraries :通过含有.a静态库的验证

5.3 提交 podspec 至私有 Spec 仓库

在 podspec 文件目录执行
pod repo push REPO_NAME MODULE_NAME.podspec --allow-warnings


6.更新 Pod

如果在开发过程中发现某基础组件存在 bug 需要更新 Pod,具体操作步骤如下:

修改 podspec 文件中的 s.version;
修复 bug 并对项目打 tag,tag 名称和 s.version 一直并 push 到远程仓库。
验证 podspec 文件的有效性;
推送 podspec 文件到远程仓库;
执行 pod search RRCache 验证结果;

创建时会遇到的一些问题

  1. 查找有无ERROR,有的话,修复相应的BUG
  2. 没有ERROR,但是有很多WARN,很多WARN无法
    解决的,加上--allow-warnings可以解决
  3. 如果有静态库或者是framework,加上--use-libraries
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容