iOS-使用CocoaPods创建私有仓库（一）

iOS-创建私有仓库步骤

一、创建本地pod私有库

cd到你想创建pod库工程的路径，并执行pod库的创建。命令如下：

mizhifadeMacBook-Pro:~ mizhifa$ cd /Users/mizhifa/Desktop/组件库 
mizhifadeMacBook-Pro:组件库 mizhifa$ pod lib create MZFTestModule

回车，回答以下问题：

# 选择使用平台
What platform do you want to use?? [ iOS / macOS ]
 > iOS

# 选择编程语言
What language do you want to use?? [ Swift / ObjC ]
 > ObjC

# 是否创建一个demo工程，为了方便测试，选择Yes
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 ]
 > Yes

#demo工程的class前缀
What is your class prefix?
 > MZF

回车，本地pod私有库创建工程成功。

二、安装CocoaPods项目

1.找到刚才创建的MZFTestModule文件夹，点击入去，里面的目录如下：

MZFTestModule
├── Example                             #demo DemoAPP
│   ├── MZFTestModule
│   ├── MZFTestModule.xcodeproj
│   ├── MZFTestModule.xcworkspace
│   ├── Podfile                         #demo APP 的依赖描述文件
│   ├── Podfile.lock
│   ├── Pods                            #demo APP 的依赖文件
│   └── Tests
├── LICENSE                             #开源协议 默认MIT
├── MZFTestModule                       #组件的目录
│   ├── Assets                          #资源文件 
│   └── Classes                         #类文件
├── MZFTestModule.podspec               #第三步要创建的podspec文件
└── README.md                           #markdown格式的README

2.cd到Example文件夹下，安装CocoaPods项目：

mizhifadeMacBook-Pro:组件库 mizhifa$ cd /Users/mizhifa/Desktop/组件库/MZFTestModule/Example 
mizhifadeMacBook-Pro:Example mizhifa$ pod install --no-repo-update

进去Example文件夹点击.xcworkspace的文件打开项目，运行下是否成功。

三、编辑私有库

1.添加代码文件和资源文件（复制粘贴）

Classes.png

把需要添加的文件放到Classes文件夹下，
把资源文件（图片，字体文件等）放到Assets文件夹下

2.编辑 .podspec配置文件
打开.podspec文件填写相关配置选项

.podspec文件.png

  Pod::Spec.new do |s|
  # 名称
  s.name             = 'MZFTestModule' 
  #版本号
  s.version          = '0.1.0'     
  #简短介绍
  s.summary          = '简介'   
  #详细介绍
  s.description      = <<-DESC
                       MZFTestModule description
                       DESC
  #主页,这里要填写可以访问到的地址，不然验证不通过
  s.homepage         = 'https://www.baidu.com'   
  #截图
  # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2" 
  #开源协议
  s.license          = 'MIT' 
  #作者信息
  s.author           = { 'dingyuping' => '[email protected]' }  
  #项目地址，不支持ssh的地址，验证不通过，只支持HTTP和HTTPS，最好使用HTTPS,这里用的码云（免费的）
  s.source           = { :git => 'https://gitee.com/xingxingstyle/MZFTestModule.git',  :tag => s.version.to_s  }   
  #多媒体介绍地址
  # s.social_media_url = 'https://twitter.com/'                       
  #支持的平台及版本
  s.ios.deployment_target     = '8.0'     
  #是否使用ARC，如果指定具体文件，则具体的文件使用ARC
  #s.requires_arc = true                   
  #代码源文件地址，**/*表示Classes目录及其子目录下所有文件，如果有多个目录下则用逗号分开，如果需要在项目中分组显示，这里也要做相应的设置
  s.source_files = 'podTestLibrary/Classes/**/*'     
  #资源文件地址
  s.resource_bundles = {
      'MZFTestModule' => ['MZFTestModule/Assets/*.png']
   } 
  #公开头文件地
  #s.public_header_files = 'MZFTestModule/Classes/**/*.h'  

  #  buildsetting相关设置, 这里讲bitcode设置为NO, C++ Standard Library设置为libstdc++
  #s.xcconfig = {
  #  'ENABLE_BITCODE' => 'NO',
  #  'CLANG_CXX_LIBRARY' => 'libstdc++'
  #  }

  #该pod依赖的系统framework，多个用逗号隔开
  #s.frameworks = 'UIKit','CoreGraphics'

  #该pod依赖的系统library，多个用逗号隔开
  #s.libraries  = 'iconv','sqlite3','stdc++','z'

  #第三方.a文件
  #s.vendored_libraries = 'MZFTestModule/Classes/ThirdParty/*.a'

  #第三方frameworks文件
  #s.vendored_frameworks = 'MZFTestModule/Classes/ThirdParty/*.framework'

  #依赖关系，该项目所依赖的其他库，如果有多个需要填写多个s.dependency
  #s.dependency 'AFNetworking', '~> 2.3'   
  end

3.配置完成后，再次cd到Example文件夹下，更新pod：

mizhifadeMacBook-Pro:Example mizhifa$ pod update --no-repo-update

更新完成后打开项目看能能否正常运行，并验证导入的文件是否能调用

四、提交到私有仓库

1.验证pod配置文件
为了保证项目正确性，pod文件配置没问题，在提交之前，我们需要验证一下：

# cd到项目目录
mizhifadeMacBook-Pro:Example mizhifa$ cd /Users/mizhifa/Desktop/组件库/MZFTestModule 
# pod lib lint 为验证本地仓库
# pod spec lint 为验证远程仓库
# 如过有警告存在，会验证不通过，需要加 --allow-warnings 忽略警告
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ pod lib lint --allow-warnings

2.提交代码到私有仓库
cd到该项目文件下执行git的相关命令：

# 添加远程地址,即上面创建码云项目的地址
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git remote add origin https://gitee.com/xingxingstyle/MZFTestModule.git
# 添加文件
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git add .
# 提交本地，并写描述
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git commit -a -m '提交代码'
# git pull origin maste会失败 ,提示：fatal: refusing to merge unrelated histories
# 原因是远程仓库origin上的分支master和本地分支master被Git认为是不同的仓库，所以不能直接合并，需要添加 --allow-unrelated-histories
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git pull origin master --allow-unrelated-histories
# 推送到远程仓库的master分支上
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git push origin master

完成后，去私有库查看，就可以看到项目已经在私有仓库里了。

五、添加tag

终端执行以下命令：

# 新增tag
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git tag -a '版本号' -m '描述'
# push到远程tag分支
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ git push --tags

完成后就可以看到私有仓库已经有一个tag存在了。

六、创建Spec索引库

索引库地址创建和私有库创建一样，这里也是用的码云。

在终端执行命令：

# 添加本地索引库
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ pod repo add MZFTestModule https://gitee.com/xingxingstyle/MZFSpecs.git
# MZFTestModule是刚才上面添加的管理库名字 
# MZFTestModule.podspec是MZFTestModule项目里面后缀为podspec的文件名
# push的时候会先验证，同样要忽略警告，添加--allow-warnings
mizhifadeMacBook-Pro:MZFTestModule mizhifa$ pod repo push MZFTestModule MZFTestModule.podspec --allow-warnings

发布成功后，我们就可以在索引库中看到MZFTestModule的索引文件了。
到这里我们的私有库已经发布完成了。

七、在项目中使用私有库

新建项目一个项目，创建Podfile文件并安装
Podfile文件代码如下：

# pod 默认是从公有源查找的，需要添加私有库源和共有库源
# 只添加私有库源默认会只从私有库查找，所以需要同时添加公有库源
source 'https://gitee.com/xingxingstyle/MZFSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '9.0'
inhibit_all_warnings!
use_frameworks!

target 'podDemo' do
  pod 'MZFTestModule'
end

终端执行以下命令：

mizhifadeMacBook-Pro:~ mizhifa$ cd /Users/mizhifa/Desktop/podDemo
mizhifadeMacBook-Pro:podDemo mizhifa$ pod install --no-repo-update 

成功如下图：

pod install.png

在项目中导入私有库头文件，验证能否调用。
到这里私有库的使用已经完成了！！！

私有库的更新，子库的创建待后续更新