创建私有库的一些小技巧

2019-10-02

简介

创建private pods流程

使用说明

环境要求

需要安装Cocapods
Git仓库要求:
- 需要对应的repo的master读写权限。

创建步骤

将管理podspec文件的repo放入到本地的cocoapods repo文件夹中

$ pod repo add REPO_NAME SOURCE_URL	
	REPO_NAME: oa-ibg-tech-podspecs
	SOURCE_URL: git@git.code.oa.com:IBG-TECH/PodSpecs.git
直接复制以下代码运行即可:
$ pod repo add oa-ibg-tech-podspecs git@git.code.oa.com:IBG-TECH/PodSpecs.git

添加完之后如果成功 repo会存入以下文件夹

1	~/.cocoapods/repos/REPO_NAME

注意事项：

REPO_NAME 为本地的repo名称

可以先到目录~/.cocoapods/repos/确认repo是否已经添加到本地

SOURCE_URL 服务端的repo URL （ssh https任选）

为目标工程branch添加tag 在本地的git 目录下打开terminal

注意事项：

该目录为组件工程的目录不是pods add的目录

tag必须添加否者无法找到对应的工程branch

1 2	$ git tag TAG_VERSION $ git push --tag

创建Podspec文件 Podspec Basic Reference

Pod::Spec.new do |s|
s.name         = "DebugOptions"
s.version      = "0.0.1"
s.summary      = "小组件"
	
s.description  = <<-DESC
一个便捷的小组件。
DESC
	
s.homepage     = "http://github.com/DebugOptions"
	
s.license      = {
	:type => 'Copyright',
	:text => <<-LICENSE
		© 1998-2019 Company. All rights reserved.
	LICENSE
}
	
s.author             = { "holaween" => "lianghwen@live.cn" }
s.social_media_url   = "http://twitter.com/haowenliang"
	
s.platform     = :ios, "9.0"
s.source       = { :git => "http://github.com/DebugOptions.git", :tag => "#{s.version}" }
	
s.source_files  = "Classes", "DebugOptions/**/*.{h,m,mm}"
s.public_header_files = "DebugOptions/**/*.h"
	
s.requires_arc = true
	
end

以上为Podspec模版如果用pod spec create生成需要手动修改以上内容

注意事项：
tag为刚才git中标记的branch tag

tag命名规范参考

对于包涵图片，本地化strings文件的pod，将该类资源文件做成bundle

本地化strings文件必须在bundle里面才能起作用
调用方法
1
2
3
NSString *path = [[NSBundle mainBundle] pathForResource:@"Bundle_Name" ofType:@"bundle"];
NSBundle *bundle = [NSBundle bundleWithPath:path];
[bundle localizedStringForKey:@"String_Key" value:@"default value" table:@"Table_Name"];

上传PodSpec文件

pod repo push REPO_NAME .podspec文件目录

该步骤会检测对应的pod目录是否validate 验证通过后会将PodSpec文件上传到同名的文件夹中结构如下:

├── PodSpecs
    └── [SPEC_NAME]
        └── [VERSION]
            └── [SPEC_NAME].podspec

关于如何规避validate过程产生的问题，见 Podspec Basic Reference/格式检查（非常重要）

项目导入pod

# Uncomment this line to define a global platform for your project
platform :ios, '9.0'
	
source '官方podspec文件的URL'
source 'podspec文件的SOURCE_URL'

target 'PROJECT_NAME' do

	pod 'SPEC_NAME', '~> VERSION'

end

注意：source的url应为https

误操作的移除／修改

上传之前应当检查确保无误如果不是必要状况不要轻易删除

1
2
3

pod trunk delete PODNAME VERSION
	
pod trunk deprecate PODNAME