一、主要流程
- 1、创建并设置一个本地私有的Spec Repo,绑定远程Spec仓库
- 2、创建一个本地Pod库MGAPIClient,绑定远程Pod库
- 3、修改podspec文件,并验证可用性
- 4、podspec验证通过后,本地测试使用MGAPIClient.podspec文件
- 5、向远程私有的Spec Repo中提交podspec
- 6、完毕,使用制作成功的私有库MGAPIClient了。
二、傻瓜式教学
1、创建一个本地私有的Spec Repo:MGSpec
,绑定托管到远程仓库
- 1、使用bitbucket托管服务,创建远程
MGSpec
仓库
- 2、创建本地私有Spec Repo,绑定托管到远程
MGSpec
仓库
1. 打开命令行终端,输入如下命令:
pod repo add MGSpec https://jennyCjp@bitbucket.org/jennyCjp/mgspecs.git
2. ~/.cocoapods/repos目录下就可以看到 MGSpec
2、创建远程仓库MGAPIClient
,创建本地Pod的项目工程库,如:MGAPIClient
,利用命令行将本地项目托管到远程仓库MGAPIClient
-
使用bitbucket托管服务,创建远程Pod私有仓库
-
-
创建Pod的项目工程库
-
- 添加自定义类APIClient,放入MGAPIClient/MGAPIClient/Classes/
import UIKit
public class APIClient: NSObject {
public class func requestAPI(){
print("APIClient requestAPI 网络请求 !")
}
}
# 1. 终端进入MGAPIClient根目录下的Example目录中
cd /Users/asahanayuujuu/MGAPIClient/Example
# 2. 执行pod update 后查看项目
pod update
- 添加提交, 并打tag0.1.0后 ,推送到刚才创建的远程MGAPIClient仓库
# 终端进入MGAPIClient根目录下
cd /Users/asahanayuujuu/MGAPIClient
# 添加,提交本地仓库,并推送到远程仓库MGAPIClient
git add .
git commit -s -m "初始化MGAPIClient库"
git remote add origin git@bitbucket.org:jennyCjp/mgapiclient.git
git push -u origin master
# podspec文件中获取Git版本控制的项目需要tag号,要打tag
git tag -m '初始化 release' 0.1.0
git push --tags #推送tag到远程仓库
-
查看远程MGAPIClient源码,已经将本地仓库,推送到远程
-
3、修改本地pod库MGAPIClient中的podspec文件,并验证可用性,验证通过后,将本地Pod库推送到远程
-
1、配置podspec文件
Pod::Spec.new do |s| s.name = 'MGAPIClient' s.version = '0.1.0' #版本号 要与刚才提交到远程仓库MGAPIClient打的tag标识一致。 s.summary = 'MGAPIClient 封装了一个网络框架,便于以后快速集成开发.' s.description = <<-DESC MGAPIClient 是 测试Pod的一个Demo,封装了一个网络框架,便于以后快速集成开发。 DESC # 主页,填写可以访问到的地址,否则验证不通过 s.homepage = 'https://jennyCjp@bitbucket.org/jennyCjp' # s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2' # 开源协议 s.license = { :type => 'MIT', :file => 'LICENSE' } s.author = { 'jennyCheng' => '2271648527@qq.com' } # Pod库远程地址,不支持ssh,请使用Https s.source = { :git => 'https://jennyCjp@bitbucket.org/jennyCjp/mgapiclient.git', :tag => s.version.to_s } # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>' # 持的平台及版本 s.ios.deployment_target = '8.0' # 源代码文件地址,**/*表示Classes目录及其子目录下所有文件 # 如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置 s.source_files = 'MGAPIClient/Classes/**/*' # 资源文件地址 # s.resource_bundles = { # 'MGAPIClient' => ['MGAPIClient/Assets/*.png'] # } #公开头文件地址 # s.public_header_files = 'Pod/Classes/**/*.h' #所需的framework,多个用逗号隔开 # s.frameworks = 'UIKit', 'MapKit' #依赖库,该项目所依赖的其他库,如果有多个需要填写多个s.dependency # s.dependency 'AFNetworking', '~> 2.3' end
- 验证
# 进入本地MGAPIClient根目录
cd /Users/asahanayuujuu/MGAPIClient
# 验证,
pod lib lint
# 如下则验证通过后,podspec就是一个符合CocoaPods规则的配置文件了。
-> MGAPIClient (0.1.0)
MGAPIClient passed validation.
# 推送到远程MGAPIClient仓库
可能警告错误:
1、 验证podspec文件时
-> MGAPIClient (0.1.0)
- WARN | [iOS] swift_version: The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:
`echo "2.3" > .swift-version`
- 解决方式:
终端执行 echo 3.0 > .swift-version
后执行验证 pod lib lint
4、podspec验证通过后,本地测试MGAPIClient项目中的MGAPIClient.podspec使用
- 修改MGAPIClient中的Podfile文件
Podfile原文件
use_frameworks!
target 'MGAPIClient_Tests' do
pod 'MGAPIClient', :path => '../'
end
修改成
use_frameworks!
target 'MGAPIClient_Tests' do
# pod 'MGAPIClient', :path => '../'
pod 'MGAPIClient', :podspec => '../MGAPIClient.podspec'
end
- 更新pod库
# 进入本地MGAPIClient根目录Example文件
cd /Users/asahanayuujuu/MGAPIClient/Example
# 执行更新
pod update
在之前pod update前与后,文件对比
5、向远程私有的Spec Repo中提交podspec
- 1、提交推送本地
MGAPIClient
库修改,到远程MGAPIClient
仓库
# 进入本地MGAPIClient根目录
cd /Users/asahanayuujuu/MGAPIClient
git add .
git commit -s -m "podspec文件测试修改"
git push origin master #提交到远程仓库
- 2、推送MGAPIClient.podspec到私有远程spec仓库
# 进入本地MGAPIClient根目录
cd /Users/asahanayuujuu/MGAPIClient
# podspec文件推送到私有远程spec仓库
# 注意:MGSpec:之前本地创建的spec名字, MGAPIClient.podspec: 创建本地pod项目中的podspec名字。
pod repo push MGSpec MGAPIClient.podspec
- 成功推送
Validating spec
-> MGAPIClient (0.1.0)
Updating the `MGSpec' repo
Already up-to-date.
Adding the spec to the `MGSpec' repo
- [Add] MGAPIClient (0.1.0)
Pushing the `MGSpec' repo
-
对比之下推送podspec文件到远程spec仓库的前与后:
-
-
查看远程Spec仓库,查看推送podspec文件后。
-
6、完毕,使用制作成功的私有库MGAPIClient
- 1、新建iOS项目tesstPod,创建profile文件,添加MGAPIClient仓库
# 私有Spec Repo
source 'https://git.coding.net/kensla/DDSpecs.git'
pod 'MyLib', '~> 0.1.0'