前言
也就是当做笔记了,记录下主要的流程已经一些注意事项。
创建项目以及配置信息
- 创建框架项目
打开终端,cd到你想要存储的目录下执行命令
// YourFrameworkName为你定义的名称
pod lib create YourFrameworkName
接着他会从git上克隆下来一份框架项目,中间他会问你五个问题,按照自己的需求回答。
执行完会自动打开这个框架项目。
- 配置信息
把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