cocoapods 的使用
前提在已经安装好 cocoapods 的情况下
使用cocoapods
1、使用 Xcode 创建一个名为: myCocoapods 的项目
2、创建 .gitignore 文件 touch .gitignore
,配置好我们平常需要忽略的相关文件,打开 Pods/ 可以参考github官方之gitignore
3、cd 到刚才的项目
4、pod init
如果是升级 Xcode8 后,可能执行
pod init
后没有任何反应或者其他错误
查找资料得:
执行sudo gem install -n /usr/local/bin cocoapods --pre
后可正常使用
参考自
5、pod update
6、在 Podfile 中添加相应的第三方
最简单的版本选择:
参考
# 取最新版本
pod 'MJRefresh',
# 取3.1.12
pod 'MJRefresh', ‘3.1.12'
# [3.1.12 ...]
pod 'MJRefresh', ‘>=3.1.12'
# (3.1.12 ...]
pod 'MJRefresh', ‘>3.1.12'
# [0.0.0 3.1.12]
pod 'MJRefresh', ‘<=3.1.12'
# [0.0.0 3.1.12)
pod 'MJRefresh', ‘<3.1.12'
# [3.1.12 3.2.0)
pod 'MJRefresh', ‘~>3.1.12'
7、 在 pod update
或者 pod update --verbose --no-repo-update
8、把项目 push 到仓库
9、项目的初始化基本OK,另一个开发到来以后直接去 git 仓库 clone 项目下来
10、然后 pod update
或者 pod update --verbose --no-repo-update
一下即可正常使用了
11、项目结构如下:
让自己的代码使用 cocoapods 管理
1、在github创建项目
2、初始化好项目
3、clone 项目下来
4、到项目root目录下, 创建 spec 文件
cd 项目
pod spec create 名称
5、编辑 spec 文件 (MJRefresh的spec文件是这样写的,里面具体的含义以后补充,或者 自行Google)
Pod::Spec.new do |s|
s.name = 'MJRefresh'
s.version = '3.1.12'
s.summary = 'An easy way to use pull-to-refresh'
s.homepage = 'https://github.com/CoderMJLee/MJRefresh'
s.license = 'MIT'
s.authors = {'MJ Lee' => '199109106@qq.com'}
s.platform = :ios, '6.0'
s.source = {:git => 'https://github.com/CoderMJLee/MJRefresh.git', :tag => s.version}
s.source_files = 'MJRefresh/**/*.{h,m}'
s.resource = 'MJRefresh/MJRefresh.bundle'
s.requires_arc = true
end
6、新建 tag
且提交项目
git add .
git commit -m '0.01'
git tag 0.0.1
git push --tags
git push origin master
7、验证一下 podspec 文件
pod lib lint
8、如果是第一次提交需验证一下,不是第一次可以不用此步
pod trunk register 邮箱地址 '名称' --description=‘其他描述’
此时需要登录邮箱验证一下身份,看提示即可
9、提交给 cocoapods 管理
pod trunk push IHExtension.podspec --allow-warnings
10、如果成功,可能需要等几分钟才可以 search 到你的 lib, 可去cocoapods查看
11、提交好了以后如果还是无法搜索到自己的项目,可以使用以下方法
删除搜索目录
rm ~/Library/Caches/CocoaPods/search_index.json
pod search
或者
pod repo update
12、可以正常使用了
pod search XXX
13、如果想多人维护一个库(需先让指定的邮箱注册)
pod trunk add-owner name xxx@163.com
14、查看自己的信息
pod trunk me
公司公共模块使用 cocoapods 管理
pod 配置文件放到 cocoapods官网
1、如果公司的项目较多,那么许多公共模块,一些工具类如果使用 pod 管理起来就更加方便了。
2、一个方法的只需要把上面配置文件;
s.homepage
s.source
指向自己的内网就👌,虽然把 pod 的配置文件push 到了cocoapods 官网,但是别人其实无法查看其中的任何内容。
使用和配置都比较简单,但是外面的人会搜到你的模块,只是无法下载
全部私有化
待研究下
完全私有化
利用 appledoc 生成 API 文档
克隆项目
git clone https://github.com/tomaz/appledoc.git
到目录下
cd appledoc
安装
sudo sh install-appledoc.sh
查看版本情况
appledoc --version
生成文档
appledoc --no-create-docset --output 生成的文档保存的路径 --project-name "你的项目名称" --company-id "com.idhong" --project-company "公司名称" 需要生成文档的项目