用法:
Podfile 中添加
source 'https://github.com/CocoaPods/Specs.git' # 官方库
source 'https://github.com/QinKingHan/BX_Podspec_Repo.git' # 私有库
pod 'TiKuBaseModulesRepo', '~> 0.3.0'
最后 pod install
截图:私有库创建
1: 创建两个repo 一个放项目 一个放spec
'分别初始化git' cd TiKuBaseModulesRepo/SL_Specs_Repo echo "# InitPodFrameWork" >> README.md git init git add README.md git commit -m "first commit" git remote add origin git@github.com:JeeneDo/InitPodFrameWork.git git push -u origin master
2: 关联私有源到远端
pod repo add BX_Podspec_Repo https://github.com/JeeneDo/BX_Podspec_Repo.git 此时如果成功的话进入到 ~/.cocoapods/repos 目录下,就可以看到SL_Spec_Repo这个目录了。至此第一步创建私有Spec Repo完成。 这个是私有库的 文件夹 集合,里面放的是你建的各个私有库
3: 在TiKuBaseModuleRepo中初始化, 会生成一个podspec 文件
pod lib create TiKuBasdeModulesRepo pod lib create BaseClassModulesRepo
4: 编辑/校验podspec
pod lib lint --allow-warnings --use-libraries //验证 pod 和 podspec代码是否编译通过 --use-libraries // 第三方lib 要加上 // podspec soure:-> http://172.16.117.224/zhangxinxin02/TiKuBaseModulesRepo.git
5: 将配置完代码仓库 和 podspec 将代码同步Git
git add . git commit -m '编辑.podspec and Example and Pod Class' git remote add origin ssh://git@172.16.117.224:39876/zhangxinxin02/TiKuBaseModulesRepo.git git pull origin master --allow-unrelated-histories git push origin master git tag -m "first release" 0.1.0 <tag 一定要和Spec文件一样,每次改动都要 pod lib lint 进行校验 同时tag加1> git push --tags
6: 把Spec 推送到远端的私有源仓库
pod repo push BX_Podspec_Repo TiKuBaseModulesRepo.podspec --allow-warnings --use-libraries --verbose 执行成功后 pod search TiKuBaseModulesRepo 如果发现搜索不到刚才的组件 rm ~/Library/Caches/CocoaPods/search_index.json '同时也会推送到 spec 的repo'
以上流程要分清 spec 和 repo. 同时注意名字不要混
7: 使用
source 'https://github.com/CocoaPods/Specs.git' # 官方库 source 'https://github.com/JeeneDo/BX_Podspec_Repo.git' # 私有库 platform :ios, '7.0'
8: 日常更新维护
1: 代码更新: 1.1: 修改Sepc 并 pod lib lint --allow-warnings --use-libraries // 确认 //引入第三私有 pod lib lint --allow-warnings --use-libraries --sources='https://github.com/JeeneDo/BX_Podspec_Repo.git,https://github.com/CocoaPods/Specs.git' //OC Swift 混编去掉--use-libraries 但这样会引起其他问题 pod lib lint --verbose --allow-warnings --swift-version=4.0 --sources='https://github.com/JeeneDo/BX_Podspec_Repo.git,https://github.com/CocoaPods/Specs.git' //d.同时依赖了第三方静态库和第三方非静态私有库 pod lib lint XGCommonView.podspec --sources='http://git.ops.com/XGN-IOS/xgn.git,https://github.com/CocoaPods/Specs.git' --use-libraries --allow-warnings --no-clean //依赖了第三方非静态私有库 pod lib lint XGCommonView.podspec --sources='http://git.ops.com/XGN-IOS/xgn.git,https://github.com/CocoaPods/Specs.git' --allow-warnings --no-clean //b.依赖了第三方静态库 pod lib lint XGCommonView.podspec --use-libraries --allow-warnings --no-clean 打开你的xx.podspec文件,将原本的版本号改为0.2.0,与刚刚的tag保持一致。 (如果代码确定没有问题的话,就不需要pod lib lint,直接执行第4步) 1.2 git add . git commit -m '更新描述' 2: 代码库版本更新 git tag -a '新版本号' -m '注释' git push --tags 3: 私有库更新索引库 pod repo push 索引库名称 xxx.podspec --allow-warnings pod repo push BX_Podspec_Repo TiKuBaseModulesRepo.podspec --allow-warnings --use-libraries --verbose pod repo push BX_Podspec_Repo BaseClassModulesRepo.podspec --allow-warnings --use-libraries --verbose 4: 别的电脑可以用pod repo update命令来使用仓库 (也可以用pod repo update 仓库名来更新指定仓库)
-
遇到的问题
-
找不到 libxml2.dylib
-
注意这个import <libxml/tree.h> 只能在项目中编程,直接拖到Pod中编译会报错。真坑
-
在 .xcconfig 设置环境 虽然编译通过了,但是pod lib lint 失败。
-
原因是.xcconfig 是不会push到远端的。解决方法在Podspec 中添加
s.xcconfig = { 'HEADER_SEARCH_PATHS' => "$(SDKROOT)/usr/include/libxml2" }
- Podspec 的配置
# ――― 代码文件 ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # # 代码文件匹配,**指匹配任意文件夹,*.{h,m}指匹配任意.h和.m文件 s.source_files = "Classes", "Classes/**/*.{h,m}" s.exclude_files = "Classes/Exclude" # SDK需要暴露的.h文件,默认暴露所有 # s.public_header_files = "Classes/**/*.h" # ――― 资源路径 ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # #s.source = { :git => 'http://172.16.117.224/zhangxinxin02/TiKuBaseModulesRepo.git', :tag => s.version.to_s } # 指定资源,比如xib,图片等资源都是 # s.resource_bundles = { 'XXXKit' => ['XXXKit/Classes/**/*.{storyboard,xib,cer,json,plist}','XXXKit/Assets/*.{bundle,xcassets,imageset,png}'] } # s.resource_bundles = { 'LazyTableViewModel' => ['Assets/*.png'] } # ――― 系统库依赖以及静态库―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # s.framework = "UIKit" # s.frameworks = "UIKit", "AnotherFramework" # s.library = "iconv" # s.libraries = "iconv", "xml2" , 'c++' < 用于.mm 文件> # ――― 其他三方库依赖 ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # # Pod 引入的 # 比如你的SDK依赖AFNetworking,注意这里和podfile中的语法不同在于,这里无法指定其他依赖的具体路径 # 比如这种写法就不支持 s.dependency 'XMPPFramework', :git => "https://github.com/robbiehanson/XMPPFramework.git", :branch => 'master' # s.dependency "AFNetworking", "~> 3.0" # 手动引入的第三方framework # s.vendored_frameworks = 'vendors/IJKMediaFramework.framework' # s.vendored_libraries = 'ProtocolBuffNetWorking/StaticLib/*.a' # swift 要指定版本 s.swift_version = '5.1' s.pod_target_xcconfig = { 'SWIFT_VERSION' => '5.1' } # ――― Xcode配置相关 ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # s.xcconfig = { 'HEADER_SEARCH_PATHS' => "$(SDKROOT)/usr/include/libxml2" } # spec.user_target_xcconfig = { # 'CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES' => 'YES' } # s.pod_target_xcconfig = { 'ENABLE_BITCODE' => 'NO' }
-
-
-
-
文件结构问题处理
- TiKuBaseModulesRepo/Classes 放实体文件,在 Example 引用这些文件进行编译(在pod也可以但是Example 可以建几个文件夹进行分类。便于理解)
- 上面两种创建方式不同 Target 也不同。避免踩坑 还是在Pod建立吧
- TiKuBaseModulesRepo/Classes 放实体文件,在 Example 引用这些文件进行编译(在pod也可以但是Example 可以建几个文件夹进行分类。便于理解)
-
fatal: 远程分支 0.1.8 在上游 origin 未发现
- 这个一般就是tag 打错了。重新打一个就行
不能在项目·中直接改动POD 改动后调试有异常。无法正确调试
-
本地私有库 ** (一般用到打包私有静态库**)
-
podFile 改为
pod 'TiKuBaseModulesRepo', :path => File.expand_path("../..", Dir.pwd)+'/TiKuGit/TiKuBaseModulesRepo' pod 'BaseClassModulesRepo', :path => File.expand_path("../..", Dir.pwd)+'/TiKuGit/BKX_BaseClassModule'
将处理好的文件夹放到和项目同一个目录下
基本完成了,这时引入文件会报错。在 Build Setting — Header Search Paths 中将Development Pods下面的文件家拖入即可
-
pod package POPModulesRepo.podspec --force --no-mangle --exclude-deps --spec-sources=https://github.com/JeeneDo/InitPodFrameWork.git,https://github.com/CocoaPods/Specs.git pod package YYKitModulesRepo.podspec --force --no-mangle --exclude-deps --spec-sources=https://github.com/JeeneDo/YYKitModulesRepo.git,https://github.com/CocoaPods/Specs.git '遇到的问题 '打包出来的framework 引入后报错找不到' 解决: 将framwork 目录结构和正常的弄成 一样。特别是'modules.modulemap 里面的东西 才是主要 这里加入引入的头文件 '引入问题 'swift - 单个文件 引入 import YYKitModulesRepo, - '全局'引入在 XXX-Bridging-Header.h 加入#import <AfnAndSDWebRepo/AfnAndSDWebImageHeader.h> OC中 - #import <YYKitModulesRepo/YYModel.h> '最好自己创建一个 头文件来引入各个类', 这样打成framework后只用在modules.modulemap 添加引入就可以了 'duplicate symbol _OBJC_CLASS_$_PodsDummy_Pods_packager' Fixed by appending --no-mangle --exclude-deps
- 测试步骤
修改引入afn 代码 查看编译时间 记录下来,并记录当前包大小
将afn 封入自己创建的私有pod库中,并进行打包成动态库
删除项目中afn代码,引入afn-framework。
重复第一步,并比较编译时间和包大小
- 测试步骤
-