关于私有库的搭建可查看
1.pod lib create失败
提示:
Failed to connect to raw.githubusercontent.com port 443: Connect
可查看解决
2.pod repo push失败
删除本地仓库,重新添加接口,执行:
pod repo remove mySpecs
pod repo add mySpecs https://github.com/*****/MySpecs
3.bitcode支持
配置.podspec
文件:
s.xcconfig = {'ENABLE_BITCODE' => 'NO'}
这个主要是引入组件库内包含了不支持bitcode的二进制文件
4.依赖系统类库,如tdb、dylib
依赖frameworks,配置.podspec
文件:
s.frameworks = 'AVFoundation', 'SystemConfiguration'
依赖libc++.dylib等文件,这里需要去掉头尾的lib、dylib等,配置.podspec
文件:
s.libraries = 'c++','z'
5.依赖第三方库
配置.podspec
文件:
s.dependency 'ZFPlayer/AVPlayer'
依赖的第三方库用到了静态库,还需要添加:
s.static_framework = true
6.依赖自己的私有库
配置.podspec
文件:
// 例
s.dependency 'ZFPlayer'
这里需要注意一下,在进行私有库验证pod lib lint
、pod spec lint
时,还需要加上source
,多个用逗号分隔,其中必须要包含github的source:
pod lib lint --allow-warnings --sources='https://github.com/*****/MySpecs,https://github.com/CocoaPods/Specs.git'
pod spec lint --allow-warnings --sources='https://github.com/*****/MySpecs,https://github.com/CocoaPods/Specs.git'
在执行pod repo push
的时候,也需要加上对应的source。如果执行上述命令还是失败,还需要加入一下参数,不用全部加入,混合使用即可,直到执行成功:
--no-clean
--allow-warnings
--use-libraries
--verbose
--skip-import-validation
如:
pod lib lint --no-clean --verbose --allow-warnings --sources='https://github.com/*****/MySpecs,https://github.com/CocoaPods/Specs.git'
pod spec lint --no-clean --verbose --allow-warnings --sources='https://github.com/*****/MySpecs,https://github.com/CocoaPods/Specs.git'
7.i386报错提示
配置.podspec
文件:
s.pod_target_xcconfig = { 'VALID_ARCHS' => 'arm64 armv7 x86_64' }
其中x86_64即i386,是用于模拟器的芯片指令集架构文件
8.按条件文件路径引入
类似shareSDK的`pod 'mob_sharesdk/ShareSDKPlatforms/WeChat',实现类似精简版、完整版的SDK
如图在Classes
下分不同的文件夹:
之后配置.podspec
文件,子模块也可以设置不同的依赖,如:
s.default_subspec = 'ImageView'
# 基础功能配置
s.subspec 'ImageView' do |imageView|
imageView.source_files = 'MyImageView/Classes/ImageView/**/*'
imageView.public_header_files = 'MyImageView/Classes/ImageView/**/*.h'
imageView.frameworks = 'AVFoundation'
end
# 附加功能配置
s.subspec 'GifImageView' do |gifImageView|
gifImageView.source_files = 'MyImageView/Classes/GifImageView/**/*.{h,m}'
gifImageView.public_header_files = 'MyImageView/Classes/GifImageView/**/*.h'
gifImageView.dependency 'MyImageView/ImageView'
gifImageView.resource_bundles = {
'MyImageView' => ['MyImageView/Assets/*']
}
end
9.添加图片资源
这里只包括添加图片的其中一种方式,就是将编辑完成的图片资源放入Assets
文件加下,之后配置.podspec
文件:
s.resource_bundles = {
'MyImageView' => ['MyImageView/Assets/*']
}
这里图片的获取也不能用常规的[UIImage imageNamed:@""]
方式了,而是要换成:
- (UIImage *)getImageWithName:(NSString *)nameString{
NSURL *associateBundleURL = [[NSBundle mainBundle] URLForResource:@"Frameworks" withExtension:nil];
associateBundleURL = [associateBundleURL URLByAppendingPathComponent:@"MyImageView"];
associateBundleURL = [associateBundleURL URLByAppendingPathExtension:@"framework"];
NSBundle *associateBunle = [NSBundle bundleWithURL:associateBundleURL];
associateBundleURL = [associateBunle URLForResource:@"MyImageView" withExtension:@"bundle"];
NSBundle *bundle = [NSBundle bundleWithURL:associateBundleURL];
/// 这里去区分下用哪种像素的图片
NSInteger scale = [[UIScreen mainScreen] scale];
NSString *imgName = [NSString stringWithFormat:@"%@@%zdx.png", nameString,scale];
UIImage *image = [UIImage imageWithContentsOfFile:[bundle pathForResource:imgName ofType:nil]];
return image;
}
这里需要注意一下,此方法最好不要用在category
中,如果使用到了,请将其中的方法名根据不同的组件做区分,否则会存在图片无法显示之类的问题
10.将组件打包成framework
这里拿opencv的framework做一下演示,将打包好的framework拖入组件工程,如图:
文件命名建议和framework的命名一致,方便阅读,使用的时候如下:
// 前半部分framework名称,后半部分为framework内部的某个.h文件,可以将头文件都放在Opencv.h下
#import <opencv2/Opencv.h>
你可以只做framework的组件(如bugly
、shareSDK
等),但是使用者只能根据你的文档接入。你也可以在framework的基础上加上代码部分(如Jpush
、TalkingData
等),方便使用者理解。
类似的第三方库你可以多看看,合理规划好自己的组件开发方案,下面开始配置.podspec
文件:
# 自己的framework,这里需要注意下路径是否正确
s.ios.vendored_frameworks = 'OpenCV/opencv2.framework'
10.在Other Linker Flags添加配置项
s.xcconfig = { "OTHER_LDFLAGS" => "-ObjC"}
11.设置Allow Non-modular includes in Framework Modules为YES
s.user_target_xcconfig = { 'CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES' => 'YES' }