iOS 私有库创建遇到的问题和podspec文件的编写

关于私有库的搭建可查看

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 lintpod 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 

你可以只做framework的组件(如buglyshareSDK等),但是使用者只能根据你的文档接入。你也可以在framework的基础上加上代码部分(如JpushTalkingData等),方便使用者理解。

类似的第三方库你可以多看看,合理规划好自己的组件开发方案,下面开始配置.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' }

你可能感兴趣的:(iOS 私有库创建遇到的问题和podspec文件的编写)