iOS制作pod私有库

1、在Git仓库分别创建2个私有库，一个索引库，一个是pod代码库

1.png

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' }