CocoaPods 打包以及创建私有仓库
2019-06-28 本文已影响0人
石显军
前言
也就是当做笔记了，记录下主要的流程已经一些注意事项。
创建项目以及配置信息
- 创建框架项目
打开终端，cd到你想要存储的目录下执行命令
// YourFrameworkName为你定义的名称
pod lib create YourFrameworkName
接着他会从git上克隆下来一份框架项目，中间他会问你五个问题，按照自己的需求回答。
image.png
执行完会自动打开这个框架项目。
- 配置信息
把framework需要的类文件放到SJPodDemo/Classes目录下，记得删除ReplaceMe.m文件
把framework需要的资源文件放到SJPodDemo/Assets目录下
项目中有个.podspec的文件，它就是配置文件了。主要用到的参数我都做了注释，也可以查看官方文档地址
Pod::Spec.new do |s|
#pod库 名称
s.name = 'SJPodDemo'
#pod库 版本
s.version = '0.1.0'
#pod库 简介
s.summary = 'A short description of SJPodDemo.'
# 详细介绍
# 此描述用于生成标签并改进搜索结果。
# *想一想：它做了什么？ 你为什么写它？ 重点是什么？
# *尽量保持简短，活泼，重点突出。
# *在下面的DESC分隔符之间写下描述。
# *最后，不要担心缩进，CocoaPods剥吧！
# 公开的pod库并且想被人发现的话可以优化一下，如果是私有库的话，这玩意写不写都行吧
s.description = <<-DESC
TODO: Add long description of the pod here.
DESC
# 项目的主页
s.homepage = 'https://github.com/ShiXianjun-2016/SJPodDemo'
# 截图
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
# 执照
s.license = { :type => 'MIT', :file => 'LICENSE' }
# 作者信息
s.author = { 'ShiXianjun-2016' => '1092207960@qq.com' }
# git：项目所在路径，这个比较重要。在打包或者拉取pod的时候，都是根据这个路径拉取的
# 如果你只是想打个framework可以填本地路径就行 '/Users/shixianjun/Desktop/PodDemo'
# 如果你想作为pod来用的话，就需要给项目创建个一直能访问的远程仓库了，这个项目默认是没有关联远程仓库的
# tag：对应git中的tag
s.source = { :git => 'https://github.com/ShiXianjun-2016/SJPodDemo.git', :tag => s.version.to_s }
# 社交媒体网址
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
# 版本支持
s.ios.deployment_target = '9.0'
# framework 中包含的文件
s.source_files = 'SJPodDemo/Classes/**/*'
# framework 中包含的资源文件
s.resource_bundles = {
'SJPodDemo' => ['SJPodDemo/Assets/*.png']
}
# framework 中公开出来的文件
s.public_header_files = 'Pod/Classes/**/*.h'
# 依赖的frameworks
s.frameworks = 'UIKit', 'MapKit'
# 依赖的其他pod
s.dependency 'AFNetworking', '~> 2.3'
# ----------------------- 上面这些都是系统默认生成的 下面还有一些会用到的 -----------------------
# pch中需要全局使用的类
s.prefix_header_contents = '#import "SJHeader.h"','#import "SJHttpEngine.h"'
# xib和storyboard 都属于资源文件
s.resource = 'SJPodDemo/Classes/Cells/*.xib'
# 后面需要了再补充吧
# ...
打包framework、上传至公共Spec、上传至私有Spec
- 先运行一下，查看是否有问题
-
cd到
Example文件夹下，执行pod install，项目会安装我们配置的文件。
重新打开项目，引用framework的文件，写一个小demo测试一下。运行并查看运行效果，和预期一致说明没问题了，如果有错误检查配置是否正确、依赖的文件是否都复制到了Classes和Assets中。自己慢慢排查吧 -
提交源码并且打上tag，注意这里的tag要和配置文件中
s.source的tag一致
git add *
git commit -a -m 'v0.1.0'
git tag -a 0.1.0 -m 'v0.1.0'
如果你的s.source 的 git是远程仓库的话，需要把代码和tagpush到远程。框架项目默认是没有关联远程仓库的。新建一个空的远程仓库，然后关联一下
// 关联远程仓库
git remote add origin ssh://shixianjun@192.168.1.251:29418/~shixianjun/tttttttt.git
git push -u origin master
// 推送代码和tag
git push
git push --tags
- 验证类库
cd 到项目根目录下
pod lib lint SJPodDemo.podspec --only-errors --verbose
- 打包framework
使用cocoapods的cocoapods-packager工具进行打包
// 安装cocoapods-packager插件 已经安装可以忽略
sudo gem install cocoapods-packager
// 打包静态.a库
pod package BZLib.podspec --library --force
// 打包静态framework库
pod package BZLib.podspec --force
- 上传至公共podSpec
这里会使用到cocoapod的trunk工具，计算机初次使用的话需要注册一个账号
pod trunk register your@163.com 'shixianjun' --description='description'
你会收到一个验证的邮件，验证完就注册完成了
部署库
pod trunk push SJPodDemo.podspec
- 上传至私有podSpec
// 首先你要创建一个git仓库来管理你的私有pod。
pod repo add SJPodSpec http://shixianjun@192.168.1.251:82/r/~shixianjun/SJPodSpec.git
// 上传至你的私有podspec
pod repo push SJPodSpec SJPodDemo.podspec
使用私有pod
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
// 私有podspec 地址
source 'http://shixianjun@192.168.1.251:82/r/~shixianjun/SJPodSpec.git'
// 官方的podspec 地址
source 'https://github.com/CocoaPods/Specs.git'
target 'PodDemo' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
pod 'SJPodDemo', '~> 0.1.0'
target 'PodDemoTests' do
inherit! :search_paths
# Pods for testing
end
target 'PodDemoUITests' do
inherit! :search_paths
# Pods for testing
end
end
