iOS组件化（一）—Cocopods创建私有库

一、创建一个文件夹

代码语言：txt复制

mkdir Module

二、下载工程脚手架

代码语言：txt复制

pod lib create AaronSwift

AaronSwift是你要创建的组件工程的名称。安装过程中会提示你输入要下载工程的配置（如下：），依次输入：iOS、Swift、Yes、Quick、Yes，其中第二步如果想创建OC库，请输入ObjC。（各版本可能有不同，请根据提示输入）

代码语言：txt复制

Cloning `https://github.com/CocoaPods/pod-template.git` into `AaronSwift`.



Configuring AaronSwift 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 ]



 > Swift



Would you like to include a demo application with your library? [ Yes / No ]



 > Yes



Which testing frameworks will you use? [ Quick / None ]



 > Quick



Would you like to do view based testing? [ Yes / No ]



 > Yes



Running pod install on your new library.



Analyzing dependencies



Downloading dependencies



Installing AaronSwift (0.1.0)



Installing FBSnapshotTestCase (2.1.4)



Installing Nimble (7.3.4)



Installing Nimble-Snapshots (6.3.0)



Installing Quick (1.2.0)



Generating Pods project



Integrating client project



[!] Please close any current Xcode sessions and use `AaronSwift.xcworkspace` for this project from now on.



Pod installation complete! There are 5 dependencies from the Podfile and 5 total pods installed.



[!] Automatically assigning platform `iOS` with version `9.3` on target `AaronSwift_Example` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.



 Ace! you're ready to go!



 We will start you off by opening your project in Xcode



 open 'AaronSwift/Example/AaronSwift.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`.

三、创建Git Hub远程仓库

如果是公司的项目，需要运维同事搭建一个Git Lab仓库并创建项目。这里用Git Hub代替。在Git Hub上创建一个AaronSwift的项目。地址：https://github.com/AaronYin0514/AaronSwift

四、代码提交到远程仓库

进入工程目录

代码语言：txt复制

cd AaronSwift/



git init



git add .



git commit -m "first commit"



git remote add origin https://github.com/AaronYin0514/AaronSwift.git



git push -u origin maste

五、编写代码

现在我们可以为私有库添加代码，位置是跟目录下的AaronSwift/Classes，我们的代码必须加到这个目录下。创建库时自动生成了ReplaceMe.swift文件，我们添加一些测试代码：

代码语言：txt复制

import Foundation



public struct RepleaceMeTest {



 public func test() {



 print("Test!")



 }



}

六、提交代码

通过Source Tree管理代码，commit代码变动：

七、添加Tag

每一个版本我们需要添加一个Tag，如下图

八、检测配置文件是否填写正确

代码语言：txt复制

pod spec lint --allow-warnings

其中--allow-warnings参数代表忽略警告，如果你的代码在编译时有警告，如果不加这个参数就会报错。结果如下：

代码语言：txt复制

 -> AaronSwift (0.1.0)



 - WARN | [iOS] swift: The validator used Swift `4.0` by default because no Swift version was specified. To specify a Swift version during validation, add the `swift_versions` attribute in your podspec. Note that usage of a `.swift-version` file is now deprecated.



 - NOTE | xcodebuild: note: Using new build system



 - NOTE | [iOS] xcodebuild: note: Planning build



 - NOTE | [iOS] xcodebuild: note: Constructing build description



 - 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: note: Execution policy exception registration failed and was skipped: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" (in target 'AaronSwift' from project 'Pods')



 - NOTE | [iOS] xcodebuild: note: Execution policy exception registration failed and was skipped: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" (in target 'Pods-App' from project 'Pods')



 - NOTE | [iOS] xcodebuild: note: Execution policy exception registration failed and was skipped: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" (in target 'App' from project 'App')



Analyzed 1 podspec.



AaronSwift.podspec passed validation.

九、配置文件说明

刚才说的检测配置文件是否配置正确，是哪个文件呢？就是工程跟目录下的后缀为podspec的文件，在我的例子中就是AaronSwift.podspec文件。

打开这个文件，里面是工程的配置。我们在用pod命令安装库时，就是找到这个文件，获取地址下载库，并根据配置下载好依赖库和其它工程的配置。

代码语言：txt复制

Pod::Spec.new do |s|



 s.name  = 'AaronSwift'



 s.version = '0.1.0'



 s.summary = 'Aaron私有Swift公共组件库AaronSwift.'



# 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.homepage  = 'https://github.com/AaronYin0514/AaronSwift'



 # s.screenshots  = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'



 s.license = { :type => 'MIT', :file => 'LICENSE' }



 s.author  = { 'AaronYin0514' => '562540603@qq.com' }



 s.source  = { :git => 'https://github.com/AaronYin0514/AaronSwift.git', :tag => s.version.to_s }



 # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'



 s.ios.deployment_target = '8.0'



 s.source_files = 'AaronSwift/Classes/**/*'



 # s.resource_bundles = {



 #  'AaronSwift' => ['AaronSwift/Assets/*.png']



 # }



 # s.public_header_files = 'Pod/Classes/**/*.h'



 # s.frameworks = 'UIKit', 'MapKit'



 # s.dependency 'AFNetworking', '~> 2.3'



end

* s.name ：pod search 搜索的关键词,注意这里一定要和.podspec的名称一样

* s.version ：版本号，这个版本号必须与对应的Tag一致。上面例子中我们设置的为0.1.0

* s.summary : 简介，这个简介你需要修改一下，对项目的简短介绍，不修改的话会有警告。

* s.homepage : 项目主页地址，这个地址需要是https地址

* s.license : 许可证

* s.author : 作者

* s.social_media_url : 社交网址

* s.source : 项目的地址

* s.source_files : 需要包含的源文件，“*” 表示匹配所有文件，“**” 表示匹配所有子目录。

* s.resources: 资源文件

* s.requires_arc : 是否支持ARC

* s.dependency ：依赖库

* s.ios.deployment_target = '8.0' : 支持的pod最低版本

十、发布版本

代码语言：txt复制

pod repo add AaronSwift https://github.com/AaronYin0514/AaronSwift.git



pod repo push AaronSwift AaronSwift.podspec --allow-warnings

执行这两步操作，操作过程如下

代码语言：txt复制

yinzhongzhengdeMacBook-Pro:AaronSwift yinzhongzheng$ pod repo add AaronSwift https://github.com/AaronYin0514/AaronSwift.git



Cloning spec repo `AaronSwift` from `https://github.com/AaronYin0514/AaronSwift.git`



yinzhongzhengdeMacBook-Pro:AaronSwift yinzhongzheng$ pod repo push AaronSwift AaronSwift.podspec --allow-warnings



Validating spec



 -> AaronSwift (0.1.0)



 - WARN | [iOS] swift: The validator used Swift `4.0` by default because no Swift version was specified. To specify a Swift version during validation, add the `swift_versions` attribute in your podspec. Note that usage of a `.swift-version` file is now deprecated.



 - NOTE | xcodebuild: note: Using new build system



 - NOTE | [iOS] xcodebuild: note: Planning build



 - NOTE | [iOS] xcodebuild: note: Constructing build description



 - 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: note: Execution policy exception registration failed and was skipped: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" (in target 'AaronSwift' from project 'Pods')



 - NOTE | [iOS] xcodebuild: note: Execution policy exception registration failed and was skipped: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" (in target 'Pods-App' from project 'Pods')



 - NOTE | [iOS] xcodebuild: note: Execution policy exception registration failed and was skipped: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" (in target 'App' from project 'App')



Updating the `AaronSwift' repo



Adding the spec to the `AaronSwift' repo



 - [Update] AaronSwift (0.1.0)



Pushing the `AaronSwift' repo

十一、解释pod repo add 库名称库地址

这一个操作是将原创仓库添加到本地，执行下面命令：

代码语言：txt复制

cd ~/.cocoapods/repos/



open .

就能看到Cocopods的所有本地仓库列表了，例子的库是AaronSwift。我们也可以浏览一下其它的目录，就能找到很多后缀为podspec的文件。

pod install命令就是根据要安装的库的名字在这些目录中遍历，找到对应的配置文件后，解析里面的地址和配置进行下载。

Pod update命令是从远程库，把这些配置文件下载到本地的这个目录中，再install。

十二、解释pod repo push 库名库配置文件(后缀为podspec) --allow-warnings

这个命令就是发布版本的命令，将版本push到远程，我们在~/.cocoapods/repos/AaronSwift/AaronSwift/目录中，可以找到对应版本号的目录，目录里面就是配置文件（后缀为podspec）。

pod install时指定版本或最新版本时，就是根据版本号找到对应的配置文件的。

十三、pod udpate

进入Example，这个目录中是我们测试代码的工程，pod update后，就安装了我们发布的版本，到此，整个过程就完成了。

代码语言：txt复制

yinzhongzhengdeMacBook-Pro:AaronSwift yinzhongzheng$ cd Example/



yinzhongzhengdeMacBook-Pro:Example yinzhongzheng$ ls



AaronSwift  Podfile  Tests



AaronSwift.xcodeproj  Podfile.lock



AaronSwift.xcworkspace  Pods



yinzhongzhengdeMacBook-Pro:Example yinzhongzheng$ pod update



Update all pods



Updating local specs repositories



^C[!] Cancelled



yinzhongzhengdeMacBook-Pro:Example yinzhongzheng$ pod update --no-repo-update



Update all pods



Analyzing dependencies



Downloading dependencies



Installing AaronSwift 0.1.0



Generating Pods project



Integrating client project



Pod installation complete! There are 5 dependencies from the Podfile and 5 total pods installed.



[!] Automatically assigning platform `iOS` with version `9.3` on target `AaronSwift_Example` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.

swift ios git

0 人点赞