1、在Git仓库分别创建2个私有库,一个索引库,一个是pod代码库
2、将远程索引库添加到本地
MacBook ~ % cd ~/.cocoapods/repos
MacBook repos % pod repo add ATSpecs https://github.com/xxxxx/ATSpecs.git //你创建的索引库地址
# 完成后再查看一下是不是已经创建成功
MacBook repos % ls
master ATSpecs
3、创建本地pod工程文件
MacBook ~ % cd Workspace/SDKs //cd到本地相应路径
MacBook SDKs % pod lib create ATFramework //创建本地pod工程名称
# 以下是创建本地pod库
Cloning `https://github.com/CocoaPods/pod-template.git` into `ATFramework`.
Configuring ATFramework template.
------------------------------
To get you started we need to ask a few questions, this should only take a minute.
If this is your first time we recommend running through with the guide:
- https://guides.cocoapods.org/making/using-pod-lib-create.html
( hold cmd and double click links to open in a browser. )
What platform do you want to use?? [ iOS / macOS ]
> iOS
What language do you want to use?? [ Swift / ObjC ]
> ObjC
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> None
Would you like to do view based testing? [ Yes / No ]
> No
What is your class prefix?
> AT
Running pod install on your new library.
Analyzing dependencies
Downloading dependencies
Installing ATFramework (0.1.0)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `ATFramework.xcworkspace` for this project from now on.
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.
Ace! you're ready to go!
We will start you off by opening your project in Xcode
open 'ATFramework/Example/ATFramework.xcworkspace'
To learn more about the template see `https://github.com/CocoaPods/pod-template.git`.
To learn more about creating a new pod, see `https://guides.cocoapods.org/making/making-a-cocoapod`.
# 创建完成后会自动打开demo工程
4、配置podspec文件
#
# Be sure to run `pod lib lint ATFramework.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 = 'ATFramework' // pod库名
s.version = '0.0.1' // 版本号
s.summary = 'A short description of ATFramework.' // 摘要
# 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
TODO: Add long description of the pod here.
DESC
s.static_framework = true
s.homepage = 'https://github.com/xxxxx/ATFramework'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'Atom' => 'xxxxx@gmail.com' }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.static_framework = true
s.source = { :git => 'https://github.com/xxxxx/ATFramework.git', :tag => s.version.to_s }
s.ios.frameworks = 'Foundation', 'UIKit'
s.vendored_frameworks = "#{s.name}/ios_frameworks/*.framework" //集成到ios_frameworks文件目录下的framework文件
# s.source_files = 'QPFramework/Classes/**/*' //集成到Class内的文件
# 上面根据实际项目需要集成对应的功能类API,framework或者Objective-C类文件
# s.resource_bundles = {
# 'QPFramework' => ['QPFramework/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
5、添加要封装的代码或framework
# 删除自带的ReplaceMe文件,根据实际集成添加需要的文件
# Example下执行pod install,编译没有报错后上传代码
MacBook SDKs % cd ATFramework/Example
MacBook Example % pod install
6、上传本地pod库代码到远端
MacBook ATFramework % git add .
MacBook ATFramework % git commit -m "修改podspec文件"
MacBook ATFramework % git remote add origin http://github.com/xxxxx/ATFramework.git
MacBook ATFramework % git push origin master -f
MacBook ATFramework % git tag 0.0.1 (注:这里的版本号必须和podspec里写的版本号一致)
MacBook ATFramework % git push --tags
# 一般公司内部是对master分支做过保护,不能直接提交到master分支,需要先在其他分支提交完成后再合入master,所以上面操作改为提交到相应分支,然后再合并到主master上,并在主master分支上打上Tag
7、验证podspec
# 验证podspec
MacBook SDKs % cd ATFramework
MacBook ATFramework % pod spec lint --verbose --allow-warnings
# 验证podspec需要注意的问题是要在你的本地pod库的根目录输入上面命令,而不是在你的本地索引库的位置。因为你的podspec文件是在本地pod库的根目录下
8、验证成功后上传本地索引库
# 在pod本地代码库根目录下执行下面命令
MacBook ATFramework % pod repo push ATSpecs ATFramework.podspec --allow-warnings
9、上传成功后引入私有库
# 在你的项目的Podfile文件中添加下面代码
source 'http://github.com/xxxx/ATspecs.git' // 索引库Git地址
pod 'ATFramework' // 引入pod
关于pod私有库遇到的一些问题
# 1、验证podspec报错
pod spec lint --verbose --allow-warnings
// 这时产生以下报错
-> QPFramework (0.0.1)
- WARN | summary: The summary is not meaningful.
# 下面这个报错是由于在对应的ios_frameworks文件夹未空导致,需要在此文件夹放入你集成的framework即可
- ERROR | [iOS] file patterns: The `vendored_frameworks` pattern did not match any file.
- NOTE | xcodebuild: note: Using new build system
- NOTE | xcodebuild: note: Building targets in parallel
- NOTE | xcodebuild: note: Using codesigning identity override: -
- NOTE | [iOS] xcodebuild: note: Planning build
- NOTE | [iOS] xcodebuild: note: Constructing build description
- NOTE | [iOS] xcodebuild: warning: The iOS Simulator deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 8.0, but the range of supported deployment target versions is 9.0 to 14.1.99. (in target 'App' from project 'App')
- NOTE | [iOS] xcodebuild: warning: Skipping code signing because the target does not have an Info.plist file and one is not being generated automatically. (in target 'App' from project 'App')
- NOTE | [iOS] xcodebuild: warning: The iOS Simulator deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 8.0, but the range of supported deployment target versions is 9.0 to 14.1.99. (in target 'QPFramework' from project 'Pods')
- NOTE | [iOS] xcodebuild: warning: The iOS Simulator deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 8.0, but the range of supported deployment target versions is 9.0 to 14.1.99. (in target 'Pods-App' from project 'Pods')
[!] QPFramework did not pass validation, due to 1 error.
You can use the `--no-clean` option to inspect any issue.
# 在验证podspec报错的问题,可以根据直接返回的结果来做分析,然后做相应的改动,我在实际验证时还出现了cpu架构报错的问题,arm64之类的,出现这类问题,需要在podspec添加下面配置:
s.pod_target_xcconfig = { 'VALID_ARCHS' => 'x86_64 armv7 arm64' }