制作cocoapods私有仓库(一)依赖库制作

前言
制作cocoapods私有仓库 首先是依赖库的制作,然后才是cocoapods私有仓库的制作

依赖库的制作的制作核心则是.podspec 的制作 。cocoapods私有仓库是负责管理这些.podspec 的仓库

下面以TestDemo2为例,记录依赖库的制作。

1.git仓库建立

cocoapods 是托管在github上的,这里我们使用国内的git仓库码云作为托管仓库平台


制作cocoapods私有仓库(一)依赖库制作_第1张图片
图例1.png

图中8个地方:
1.项目名称,也就是依赖库的名称,必填项
2.搜索路径,也就是cocoapods搜索依赖库的地址
3.项目介绍
4.项目开发语言,cocoapod对针对依赖库做检测,这个作为依据
5.git 忽略文件
6.开源许可证 ,这里使用MIT,为啥要选不懂,欢迎科普
7.依赖库类型,是否公开,我们选择不公开,github私有仓库是收费的,这里就是为啥选择码云作为仓库。
8.Readme,项目说明文档,建议勾选创建。

制作cocoapods私有仓库(一)依赖库制作_第2张图片
图例2.png

2.clone到本地

clone仓库到本地,完成项目文件的添加

git clone https://git.oschina.net/ZOKAI/TestDemo2.git

如下,表明仓库已完成clone

Cloning into 'TestDemo2'...
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 0), reused 0 (delta 0)
Unpacking objects: 100% (5/5), done.

本地目录


图例3.png

添加过项目文件的本地目录

git add -A && git commit -m 'add project file'
git push origin master
制作cocoapods私有仓库(一)依赖库制作_第3张图片
图例4.png

3 .podspec 文件

依赖库的核心就是.podspec 文件的创建
有两种方式创建podspec文件:
1.从其他地方复制过来,然后修改
2.使用命令行
我们这里使用命令行创建

 pod spec create TestDemo2

里面有很多的内容,但是大多数都是我们不需要的,所以我们只需要根据项目的情况保留关键的内容
podspec 文件配置



Pod::Spec.new do |s|


  s.name         = "TestDemo2" #specc文件的名称
  s.version      = "1.0.0" #对应的版本
  s.summary      = "简短介绍 TestDemo2." #简短介绍
  s.description  = <<-DESC 
  测试用例,这里是详细介绍,可以不写,但是
                   DESC

  s.homepage     = "https://git.oschina.net/ZOKAI/TestDemo2.git" #注意
  # s.screenshots  = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"

  s.license      = "MIT" #开源协议
  # s.license      = { :type => "MIT", :file => "FILE_LICENSE" }

  s.author             = { "ZOKAI" => "[email protected]" } #作者,邮箱
  # Or just: s.author    = "ZOKAI"
  # s.authors            = { "ZOKAI" => "[email protected]" }
  # s.social_media_url   = "http://twitter.com/ZOKAI"

  # s.platform     = :ios
  s.platform     = :ios, "8.0" #平台,版本

  #  When using multiple platforms
  # s.ios.deployment_target = "5.0"
  # s.osx.deployment_target = "10.7"
  # s.watchos.deployment_target = "2.0"
  # s.tvos.deployment_target = "9.0"

  s.source       = { :git => "https://git.oschina.net/ZOKAI/TestDemo2.git", :tag => "#{s.version}" }#对应的资源文件的地址,注意后边的tag ,其实就是他的版本,pods是以git为基础管理的。
## 这里不支持ssh的地址,只支持HTTP和HTTPS,最好使用HTTPS
## 正常情况下我们会使用稳定的tag版本来访问,如果是在开发测试的时候,不需要发布release版本,直接指向git地址使用
  s.source_files  = "TestDemo2/TestDemo2/Class/**/*.{h,m}" #编译源文件
  s.exclude_files = "Classes/Exclude" #排除文件

  s.requires_arc = true #是否是arc模式 
  s.frameworks = "UIKit", "Foundation"#使用的framworks 这里可以是系统的framework 也可以是部分第三方中包含的frameworks ,多个以","隔开

  s.dependency "SVProgressHUD", "~> 2.1.2"#使用了cocopoads第三方依赖库 ,多个以","隔开
  s.module_name = 'TestDemo2' #模块名称


  # s.public_header_files = "Classes/**/*.h" #公开的头文件

  # s.resource  = "icon.png"
  # s.resources = "Resources/*.png"

  # s.preserve_paths = "FilesToSave", "MoreFilesToSave"

  # s.framework  = "SomeFramework"

  # s.library   = "iconv"
  # s.libraries = "iconv", "xml2"


  # s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }

end

s.module_name = 'TestDemo2' #模块名称 这个需要特别留意,这个是最终使用pod 'xxx' 的名称

图例5是依赖库工程的组织目录


制作cocoapods私有仓库(一)依赖库制作_第4张图片
图例5.png

图例6是最终制作完毕的私有仓库在使用的时候的组织目录,对比可见目录结构已经打乱


制作cocoapods私有仓库(一)依赖库制作_第5张图片
图例6.png

图例7 是AFNetworking在使用的时候的组织目录,对比发现仍然保持有目录结构
制作cocoapods私有仓库(一)依赖库制作_第6张图片
图例7.png

如果需要保持组织结构 ,如AFNetworking 的组织目录 则需要在.podspec 配置。参考AFNetworking.podspec

Pod::Spec.new do |s|
 s.name     = 'AFNetworking'#sepc文件的名字
 s.version  = '2.5.4'#对应的版本
 s.license  = 'MIT'#开源协议
 s.summary  = 'A delightful iOS and OS X networking framework.'#简单的介绍
 s.homepage = 'https://github.com/AFNetworking/AFNetworking'#主页
 s.social_media_url = 'https://twitter.com/AFNetworking'#作者的twitter 
 s.authors  = { 'Mattt Thompson' => '[email protected]' }#作者 和他的邮箱
 s.source   = { :git => 'https://github.com/AFNetworking/AFNetworking.git', :tag => s.version, :submodules => true }#对应的资源文件的地址,注意后边的tag ,其实就是他的版本,pods是以git为基础管理的。版本就是tag值了
 s.requires_arc = true#是否是arc模式 

 s.ios.deployment_target = '6.0'#iOS对应的版本
 s.osx.deployment_target = '10.8'#OX S 对应的版本

 s.public_header_files = 'AFNetworking/*.h'#公共的头文件地址
 s.source_files = 'AFNetworking/AFNetworking.h'#文件地址,pod会以这个地址下载需要的文件构建pods

 s.subspec 'Serialization' do |ss|#对应的一些子工程
   ss.source_files = 'AFNetworking/AFURL{Request,Response}Serialization.{h,m}'
   ss.ios.frameworks = 'MobileCoreServices', 'CoreGraphics'
   ss.osx.frameworks = 'CoreServices'
 end

 s.subspec 'Security' do |ss|
   ss.source_files = 'AFNetworking/AFSecurityPolicy.{h,m}'
   ss.frameworks = 'Security'
 end

 s.subspec 'Reachability' do |ss|
   ss.source_files = 'AFNetworking/AFNetworkReachabilityManager.{h,m}'
   ss.frameworks = 'SystemConfiguration'
 end

 s.subspec 'NSURLConnection' do |ss|
   ss.dependency 'AFNetworking/Serialization'
   ss.dependency 'AFNetworking/Reachability'
   ss.dependency 'AFNetworking/Security'

   ss.source_files = 'AFNetworking/AFURLConnectionOperation.{h,m}', 'AFNetworking/AFHTTPRequestOperation.{h,m}', 'AFNetworking/AFHTTPRequestOperationManager.{h,m}'
 end

 s.subspec 'NSURLSession' do |ss|
   ss.dependency 'AFNetworking/Serialization'
   ss.dependency 'AFNetworking/Reachability'
   ss.dependency 'AFNetworking/Security'

   ss.source_files = 'AFNetworking/AFURLSessionManager.{h,m}', 'AFNetworking/AFHTTPSessionManager.{h,m}'
 end

 s.subspec 'UIKit' do |ss|
   ss.ios.deployment_target = '6.0'

   ss.dependency 'AFNetworking/NSURLConnection'
   ss.dependency 'AFNetworking/NSURLSession'

   ss.ios.public_header_files = 'UIKit+AFNetworking/*.h'
   ss.ios.source_files = 'UIKit+AFNetworking'
   ss.osx.source_files = ''
 end
end

AFNetworking是通过subspec 来保持子目录结构的,如果有需求的可以在这里特殊配置。

4.检测podspec文件

podspec文件默认有error 和warning 都不会检测通过 --allow-warnings 参数会运行warnings 可以加上 --verbose 参数查看debug信息

pod lib lint --allow-warnings

检测成功,即表明依赖库制作完毕

 -> TestDemo2 (1.0.0)
TestDemo2 passed validation.

这里介绍一个情况
如图例8 ,使用RongCloudIM的时候发现,里面有.a 静态库和.framework

制作cocoapods私有仓库(一)依赖库制作_第7张图片
图例8.png

依旧使用

pod lib lint TestDemo2.podspec --allow-warnings --verbose

检测,会出现如下错误

- ERROR | [iOS] unknown: Encountered an unknown error (The 'Pods-App' target has transitive dependencies that include static binaries: 
(/private/var/folders/2c/78rv4swj57n7pvzdy7jk3w0w0000gn/T/CocoaPods/Lint/Pods/RongCloudIM/RongCloudIM/RongIMKit.framework, 
/private/var/folders/2c/78rv4swj57n7pvzdy7jk3w0w0000gn/T/CocoaPods/Lint/Pods/RongCloudIM/RongCloudIM/libopencore-amrnb.a,
 and /private/var/folders/2c/78rv4swj57n7pvzdy7jk3w0w0000gn/T/CocoaPods/Lint/Pods/RongCloudIM/RongCloudIM/RongIMLib.framework)

原因就是依赖库(s.dependency)包含了.a静态库造成的,解决方法是,添加 --use-libraries 来让检测通过

pod lib lint TestDemo2.podspec --allow-warnings --verbose --use-libraries

这样在以后使用私有仓库的时候。podfile 需要做如下修改

pre_install do |installer|
def installer.verify_no_static_framework_transitive_dependencies; end
end

下一篇
制作cocoapods私有仓库(二)cococapods私有仓库制作

参考:
折腾cocoaPods, 创建自己的依赖库
'The 'Pods' target has transitive dependencies that include static binaries' when installing 'xxxx'

你可能感兴趣的:(制作cocoapods私有仓库(一)依赖库制作)