码云与github 操作步骤一致
一、远程索引库
什么是远程索引库?
每创建一个组件都会带有一个 xxx.podspec 的索引文件。专门用来存放这些索引文件的库就叫做索引库。我们需要将这些索引文件上传到远程索引库才能保证其他的同事能够拿来用。
创建远程索引库( 注:这里是在github上创建了一个public的organization名字叫FFComponent)笔者这里创建的public的,自己公司的项目创建private的私有索引库即可,私有索引的步骤和pubic的操作方式一样
远程索引库已经创建成功,可以看到远程索引库的地址
二、 本地索引库 (本地索引库就是用来存放本地索引文件的库)
1. 打开终端 pod repo 查看一下当前有哪些本地索引库(如果你之前没有创建过,应该只有一个master)
2. 通过pod repo add <本地索引库的名字> <远程索引库的地址> ,创建本地索引库并和远程索引库做关联(注:本地索引库的名字建议和远程索引库起的名字一样)
3. 通过下面的方式可以查看本地索引库的物理地址
三、远程代码库 (代码实际存放的远程仓库)
创建远程代码仓库(和创建远程索引库的方式一样),创建一个FFCategoryKit的远程代码库,用来存放FFCategory组件的代码。同样获取到FFCategoryKit组件的远程代码库地址。
四、本地代码库
本地创建后续要被共享的Lib工程
1.打开终端cd到你要创建的目录下(方便下我就放在桌面了)
2.然后输入 pod lib create (私有仓库的名字) 命令创建一个待上传的模版,如图
3.之后会有选项对私有的pod库进行一些选择
此处在桌面会生成一个文件夹,包括工程目录及文件介绍。ps:ReplaceMe.m文件为示例文件,可删除。你自己写的文件放在此处
配置 .podspec 后缀文件
s.name : 项目名
s.version : 版本号(需跟后面打 Tag 的值相等)
s.homepage : 项目主页(请注意,这里的地址跟git仓库地址有一定差别,请看清截图示例并区分)
s.license : 开源协议(这里我们选择 MIT )
s.source : Git 仓库地址(第二步所创建的仓库地址)
s.ios.deployment_target : 项目最低支持版本
s.source_files : 具体去那个目录下下载特定共享代码(注意:这里的地址与 .podspec 文件同级目录开始,,示例:PrivateLib/Classes/** /*表示如下目录下的所有文件
s.frameworks :项目所依赖的系统库(如果需要)
s.dependency :项目所依赖的第三方库(如果需要)
标记了红框的请务必记得修改,不然会出现各种奇葩的错误
验证 .podspec文件的格式的正确性
终端cd到该目录,输入
pod lib lint
将本地PrivateLib工程与远程私有 Git 仓库关联
git remote add origin 远程私有仓库地址
git pull origin master --allow-unrelated-histories
拉去数据的时候会出现冲突,我们把head里的删掉,保留远程的
(更新私有库时,从此步开始)
git add .
git commit -m "fix"
git push origin master
做完了这几步我们在码云中的私有项目可以看到如下图所示
然后本地和远程验证文件有效性
pod spec lint
此处会有报错,请不要慌张,那是因为我们没有tag
执行以下代码 添加 tag
git tag -a 0.1.0 -m '0.1.0标签'
git push –-tags
pod spec lint
好了此处一切ok。很关键
五、提交索引文件到远程索引库
pod repo push <本地索引库> <索引文件名> - -verbose - -allow-warnings 提交索引文件到远程索引库。
本地也可以查看已成功
9. 接下来回到FlowerField_Component工程修改podfile文件,把FFCategoryKit组件pod进来(注:需要在Podfile中指定组件远程索引库地址,如果不指定默认会从master的索引库查找就会报找不到组件)
Podfile文件修改如下 :
执行 pod install,按照上面同样的方式修改一下ReactiveCocoa和Result的UseLegacySwiftLanguage Version 成YES
同样在项目查看已经pod进来了。
私有库中添加资源(图片、音视频等)
方法共有三种:
第一种
spec.resources = ["Images/*.png","Sounds/*"]
但是这些资源会在打包的时候直接拷贝的app的Bundle中,这样说不定会和其它资源产生命名冲突
第二种
spec.resource ="Resources/MYLibrary.bundle"
把资源都放在bundle中,然后打包时候这个bundle会直接拷贝进app的mainBundle中。使用的时候在mainBundle中查找这个bundle然后再搜索具体资源
NSURL *bundleURL = [[NSBundle mainBundle] URLForResource:@"JZShare" withExtension:@"bundle"];
NSBundle *bundle = [NSBundle bundleWithURL:bundleURL];
UIImage *img = [UIImage imageNamed:icon inBundle:bundle compatibleWithTraitCollection:nil];
第三种
spec.resource_bundles = {'MyLibrary'=> ['Resources/*.png'],'OtherResources'=> ['OtherResources/*.png']}
这种方法利用 framework 的命名空间,有效防止了资源冲突。
使用方法是先拿到最外面的 bundle,然后再去找下面指定名字 的 bundle 对象,再搜索具体资源
NSBundle *bundle = [NSBundle bundleForClass:[MYSomeClass class]];
NSURL *bundleURL = [bundle URLForResource:@"MyLibrary" withExtension:@"bundle"];
NSBundle *resourceBundle = [NSBundle bundleWithURL: bundleURL];
UIImage *img = [UIImage imageNamed:icon inBundle:bundle compatibleWithTraitCollection:nil];