cocoapods 上传sdk

注意: 一下所有的操作都是建立在cd 到跟目录的情况,

cd 到自己的项目的根目录

0, 注册CocoaPods账户信息(这个过程可以跳过)

pod trunk register 邮箱地址 '用户名' --verbose
pod trunk me

26DF5FD0-7B01-4FEB-B85A-3A1762FF77F9.png

1, pod lib create创建一个pod项目(使用git创建项目这个就可以忽略)

pod lib create  IJSPhotoSDK(项目名称)

7E3AB481-D628-4068-9282-605B7A23FAFB.png

CB4B788F-639B-460E-A619-737EB3E64061.png

2, 为SDK建立一个podspec文件

pod spec create IJSPhotoSDK(写项目名称就可以)

3, 本地验证podspec的合法性

三者选一:
pod lib lint --verbose
pod lib lint --verbose --allow-warnings
 pod lib lint --verbose --use-libraries --allow-warnings(有警告,依赖静态framework情况下)

C338C8BF-CF9A-4B02-AC90-910537C7C257.png

4, 添加tags,必须保证 spec文件的版本和这个 tag统一,否则会找不到对应的版本文件

$ git add -A && git commit -m "Release 0.1.0"
$ git tag '0.1.0'
$ git push ——tags
删除tags:
git push origin --delete tag 0.0.1

注意这一步: 最好配合 git push 或者 sourcetree 将本地所有的代码全部提交到git

5, 验证线上的spec文件的合法性

三者选其一
pod spec lint --verbose
pod spec lint --verbose --use-libraries
pod spec lint --verbose --use-libraries --allow-warnings

B2700CA2-8944-4CB2-BBAB-15DF854BC499.png

6, 将项目提交到公共的远程仓库上

三者选其一:
pod trunk push
pod trunk push --user-libraries
pod trunk push --use-libraries --allow-warnings 

9C7F2F8A-FD76-4DCC-A2B7-3E7D2182FE1F.png

7, 成功之后执行更新pod操作

pod setup

8, 现在就可以正常搜索 自己的SDK了

pod search ijsp

974CE42A-1C56-4C20-A7C6-43052C528FD9.png

图片资源补充
问题: 项目依赖静态库

8341DA35-CB90-4691-8F82-62CF4CE8E9DC.png

处理方法:

8E3311B0-187B-4BBD-95CE-4E1EA56654A0.png

15F6D03D-5003-4764-ADEA-C6741DB14880.png

FC1FF1A8-DCC1-49FB-9817-68D6DBC9E575.png

59DB0BE4-564D-4612-A8AB-B8FE8519A551.png

9AF9325E-3AA1-4925-AE72-7B06223868D8.png

加载图片资源国际化资源建议使用如下方式

s.resource = "SDK/IJSPhotoSDK/Support/JSPhotoSDK.bundle"

其他还有两种方式

1,  spec.resources = ["Images/*.png", "Sounds/*"]  这些资源会在打包的时候直接拷贝的app的Bundle中，这样说不定会和其它资源产生命名冲突, 这种方法不可取
2, spec.resource_bundles = {
'MyLibrary' => ['Resources/*.png'],
'OtherResources' => ['OtherResources/*.png']
}
这种方式会在bundle下再一次打包成bundle ,所以在获取资源时需要额外处理
此方法本人未验证
但是遇见的错误说明方法不可取

spec文件参考

Pod::Spec.new do |s|

 
  s.name         = "IJSPhotoSDK"
  s.version      = "0.1.0"

  s.summary      = "IJSPhotoSDK from PhotoKit."
  s.license          = 'MIT'
  s.author           = { "wangjinshan" => "1096452045@qq.com" }
  s.homepage         = 'http://www.mob.com'
  s.platform         = :ios
  s.ios.deployment_target = "8.0"
  s.requires_arc = true
  s.description  = 'IJSPhotoSDK from PhotoKit ,you can select more image'
                
  s.source       = { :git => "https://github.com/wangjinshan/IJSPhotoSDK.git", :tag => "#{s.version}" ,:submodules => true}

  s.dependency 'IJSFoundation'
  s.dependency 'IJSUExtension'
  
  s.resource = "SDK/IJSPhotoSDK/Support/JSPhotoSDK.bundle"
  # ShareSDK提供的UI
  s.subspec 'IJSPhotoSDKFiles' do |sp|
    sp.source_files = 'SDK/IJSPhotoSDK/IJSPhotoSDKFiles/*.{h,m}'
  end
    
end

spec文件解析:

以下内容参考自别人文档: 主要目的是方便日后查阅

坑点: podsepc 文件 如果创建子文件路径注意:

1, 子文件爱你 不能相互依赖,如果相互依赖只能合并到一个文件下
2, subspec 文件 写 sp.dependces的时候 注意依赖的本地的文件不是物理路径而是指的是你自己创建好 subspec的实际问价层级,只有 source_file 文件才是写物理路径

必要属性
//
Pod::Spec.new do|s|
  //项目名
  s.name ='HycProject'
  //版本号
  s.version ='1.0.1'
  //listen文件的类型
  s.license = 'MIT'
  //简单描述
  s.summary = 'ATest in iOS.'
  //项目的getub地址，只支持HTTP和HTTPS地址，不支持ssh的地址
  s.homepage ='https://github.com/hyc603671932/HycProject'
  //作者和邮箱
  s.authors = {'HouKavin' => '603671932@qq.com' }
  //git仓库的https地址
  s.source = { :git=> 'https://github.com/hyc603671932/HycProject.git', :tag =>s.version}
  //是否要求arc（有部分非arc文件情况未考证）
  s.requires_arc = true
 //在这个属性中声明过的.h文件能够使用<>方法联想调用（这个是可选属性）
  s.public_header_files = 'UIKit/*.h'
  //表示源文件的路径，这个路径是相对podspec文件而言的。（这属性下面单独讨论）
  s.source_files ='AppInfo/*.*'
  //需要用到的frameworks，不需要加.frameworks后缀。（这个没有用到也可以不填）
  s.frameworks ='Foundation', 'CoreGraphics', 'UIKit'
end

可选属性

Pod::Spec.new do|s|
  ...
  ...
  ...
  //详细介绍
  s.description = "详细介绍"
  //支持的平台及版本
  s.platform     = :ios, '7.0' 
  //最低要求的系统版本
  s.ios.deployment_target= '7.0'
  //主页，需填写可访问地址
  s.homepage = "https://coding.net/u/wtlucky/p/podTestLibrary"
  //截图                      
  s.screenshots     = "www.example.com/screenshots_1"
  //多媒体介绍地址
  s.social_media_url = 'https://twitter.com/<twitter_username>'  
  //效果和s.public_header_files的相同，只需要配置一种
  s.ios.public_header_files = 'URS/URSAuth.h'
  //不常用，所有文件默认即为private只能用import"XXX"调用
  s.ios.private_header_files 
  #依赖关系，该项目所依赖的其他库
  s.dependency 'AFNetworking', '~> 2.3'
  //可拥有多个dependency依赖属性   
  s.dependency 'JSONKit', '~> 1.4' 

  //动态库所使用的资源文件存放位置，放在Resources文件夹中
  s.resource_bundles = {
    'Test5' => ['Test5/Assets/*.png']
  } 
  //资源文件（具体使用带考证）
  s.resources = 'src/SinaWeibo/SinaWeibo.bundle/**/*.png' 
  //建立名称为Info的子文件夹（虚拟路径）
  s.subspec 'Info' do |ss| 
  //应该和s.subspec作用相同（未考证）
  s.default_subspec
end

s.source_files

//下载AppInfo文件夹下的所有文件，子文件夹不识别
s.source_files ='AppInfo'
//下载AppInfo目录下所有格式文件
s.source_files ='AppInfo/*.*'
**/*表示Classes目录及其子目录下所有文件
s.source_files = 'AppInfo/**/*'


//下载HycProject文件夹下名称为AppManInfo和AppWomanInfo的共4项文件
s.source_files ='HycProject/App{Man,Woman}Info.{h,m}'
//目标路径下的文件不进行下载
s.ios.exclude_files = 'AppInfo/Info/json'

文件层次

Pod::Spec.new do|s|
  //第一层文件夹名称HycProject
  s.name ='HycProject'
  ...
  ...
  ...
  //第二层文件夹名称AppInfo（虚拟路径）
  s.subspec 'AppInfo' do |ss|
    //下载HycProject文件夹下AppInfo的.h和.m文件
    ss.source_files = 'HycProject/AppInfo.{h,m}'
    //允许使用import<AppInfo.h>
    ss.public_header_files = 'HycProject/AppInfo.h'
    //依赖的frameworks
    ss.ios.frameworks = 'MobileCoreServices', 'CoreGraphics'

    //第三层文件夹名称Info（虚拟路径）
    ss.subspec 'Info' do |sss| 
      //最低要求的系统版本7.0
      sss.ios.deployment_target = '7.0' 
      //只允许使用import"AppInfo.h"访问
      sss.ios.private_header_files = 'AppInfo/Info/**/*.h' 
      // 下载路径下的.h/.m/.c文件       
      sss.ios.source_files = 'AppInfo/Info/**/*.{h,m,c}'  
      //引用xml2库,但系统会找不到这个库的头文件，需与下方sss.xcconfig配合使用(这里省略lib)
      sss.libraries = "xml2" 
      //在pod target项的Header Search Path中配置:${SDK_DIR}/usr/include/libxml2
      sss.xcconfig = { 'HEADER_SEARCH_PATHS' => '${SDK_DIR}/usr/include/libxml2' }       
      //json目录下的文件不做下载
      sss.ios.exclude_files = 'AppInfo/Info/json' 
    end   
  end


end

链接：http://www.jianshu.com/p/9eea3e7cb3a1
來源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

后续步骤

//验证podspec文件是否可正常使用
命令行：pod lib lint
//上传podspec到trunk服务器中
命令行：pod trunk push HycProject.podspec
//上传需要一定时间，成功后更新本地pod依赖库
命令行：pod setup
//查看代码有没有通过审核版本是否更新
命令行：pod search HycProject
//下载线上git仓库（Podfile文件不在此讨论）
命令行：pod install

关于Podfile文件编辑时，第三方库版本号的各种写法

pod ‘AFNetworking’ //不显式指定依赖库版本，表示每次都获取最新版本
pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本
pod ‘AFNetworking’, ‘>2.0′ //使用高于2.0的版本
pod ‘AFNetworking’, ‘>=2.0′ //使用大于或等于2.0的版本
pod ‘AFNetworking’, ‘<2.0′ //使用小于2.0的版本
pod ‘AFNetworking’, ‘<=2.0′ //使用小于或等于2.0的版本
pod ‘AFNetworking’, ‘~>0.1.2′ //使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′ //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′ //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本
pod ‘AFNetworking’, :head //一样代表使用最新版本（这个我测试用不起来）