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 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' }