iOS - 制作CocoaPods依赖未发布framework库

CocoaPods.jpg

背景

公司准备对项目进行模块化, 要使用pod形式. 咱们做过.framework和.a形式的sdk. 这pod只是应用.制作还真不了解, 咱也不敢说,咱也不敢问. 没办法, 找资料呗. 度娘的强大实在让人头大. 千篇一律的复制. demo的需求可以满足.但开发中碰到的有太多太多情况了. 自己做的pod工程是私有的. 整理了一些自己遇到的问题. 希望能给其他朋友一些帮助.

正文

1. 打开终端, cd <文件目录地址> (任意文件夹地址), 本人习惯Desktop位置

cd Desktop

2. 开始创建pod工程

pod lib create Demo_podProject

4. 紧接着会有一下信息

What platform do you want to use?? [ iOS / macOS ]
// 这里输入你使用的平台
 > iOS

What language do you want to use?? [ Swift / ObjC ]
//这里输入你使用的语言
 > ObjC

Would you like to include a demo application with your library? [ Yes / No ]
//这里输入你是否需要生成一个 demo 应用
//这里最好 Yes 这样你可以查看你创建的库是否可以使用
 > YES

Which testing frameworks will you use? [ Specta / Kiwi / None ]
// 这里输入你需要用到的测试框架,随意选
 > None

Would you like to do view based testing? [ Yes / No ]
//是否做基于视图的测试 Yes/No 都可以
 > No

What is your class prefix?
//输入前缀
 > JR

回车后, demo会自动打开. 下面是我生成的项目结构

结构.png

5. podspec文件, 工程的配置信息文件, 非常重要
   下面图片为demo初始样子

podspec.png

• s.name = 'Demo_podProject' # 工程的名字
• s.version = '0.1.0' # 版本号
• s.summary = 'A short description of Demo_podProject. #对你写的库进行简要的概述一下
• s.description = <<-DESC
  TODO: Add long description of the pod here.
  DESC # 对写的库进行具体的使用方法说明及其他描述 (没觉得太多意义)
• s.homepage = 'https://github.com/[email protected]/Demo_podProject #git库的地址首页,可以在开源中国创建你的库,不需要使用什么初始化方法,不要勾选 readme
• s.screenshots = 'www.example.com/screenshots_1 # 屏幕快照的地址,例如演示的 gif 文件 (一样觉得没有太多意义)
• s.license = { :type => 'MIT', :file => 'LICENSE' } #许可证，type-类型；file-文件，这里不需要改变,使用默认,文件指向的文件名与工程中文件名要一致。
• s.author = { 'xxx' => '[email protected]' } # 作者信息: 账户名，账户邮箱地址
s.source = { :git => 'https://github.com/[email protected]/Demo_podProject.git', :tag => s.version.to_s } # 输入邮箱如果你在开源中国申请的 git 账号,那么把你在开源中国创建的项目的 https 网址输入到这里,
• s.ios.deployment_target = '8.0' #iOS 支持的最低级别,这里最低8.0
• s.source_files = 'Demo_podProject/Classes/**/*' #你库文件存放的目录位置,这里通过文件 项目名.xcodeworkspace 打开 xcode,如今打了 pods -> Development Pods -> 工程名 -> 工程名 -> Classes 在 Classes 这个文件夹下我们存放我们创建的类文件(.h,.m文件)
• s.dependency 'AFNetworking', '~> 2.3' # 如果你的公共库需要依赖其他库,那么打开这里的注释,例如AFNetworking，如果有多个，则依次往后排

重点

当我们使用到自己写的静态库或bundle资源文件时如何解决呢

framework

• 在工程目录结构中创建framework文件夹;路径结构 Desktop->Demo_podProject->Demo_podProject->Framework
• 将自定义framework放入该文件夹下
• podspec文件中配置信息, 如下:

• s.vendored_frameworks = 'xxxxx/Framework/*.framework' #vendored_frameworks是所依赖自定义库, Demo_podProject/Framework查找的路径

Xcode12版本以上编译的framework需要注意

在podspec文件中需添加

• s.pod_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
• s.user_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
  两句话

如果没有上述配置pod repo push会报错

ld: building for iOS Simulator, but linking in dylib built for iOS, file ' XXX ' for architecture arm64
clang: error: linker command failed with exit code 1

bundle

• 在工程目录结构中创建resource文件夹;路径结构 Desktop->Demo_podProject->Demo_podProject->resource
• 将bundle文件放入该文件夹下
• podspec文件中配置信息

• s.resources = 'xxxxx/resource/*.bundle'

然后执行pod install, 会发工程中创建Frameworks与Resources两个虚拟文件夹,并且库和资源文件包在各自文件下.

案例.png

路径描述中的 * & ** 说明

• *匹配所有文件
• v*匹配所有 以v开头的文件
• *.framework匹配所有后缀为framework文件 可以任意修改.看所需要后缀的文件
• **递归匹配所有子文件夹

CocoaPods中bundle文件使用

正常工程中使用bundle文件使用方式,[[[NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:@"name" ofType:@"bundle"]] resourcePath] stringByAppendingPathComponent:@"filename"];但在pod中使用样方式返回的是nil.虽说都是用的bundleWithPath.然而之前的是mainBundle.指的是工程路径下的.CocoaPods路径不算.
解决方案

/**
 获取文件所在name，默认情况下podName和bundlename相同，传一个即可
 
 @param bundleName bundle名字，就是在resource_bundles里面的名字
 @param podName pod的名字
 @return bundle
 */
+ (NSBundle *)bundleWithBundleName:(NSString *)bundleName podName:(NSString *)podName {
    if (bundleName == nil && podName == nil) {
        @throw @"bundleName和podName不能同时为空";
    } else if (bundleName == nil ) {
        bundleName = podName;
    } else if (podName == nil) {
        podName = bundleName;
    }
    
    if ([bundleName containsString:@".bundle"]) {
        bundleName = [bundleName componentsSeparatedByString:@".bundle"].firstObject;
    }
    //没使用framwork的情况下
    NSURL *associateBundleURL = [[NSBundle mainBundle] URLForResource:bundleName withExtension:@"bundle"];
    //使用framework形式
    if (!associateBundleURL) {
        associateBundleURL = [[NSBundle mainBundle] URLForResource:@"Frameworks" withExtension:nil];
        associateBundleURL = [associateBundleURL URLByAppendingPathComponent:podName];
        associateBundleURL = [associateBundleURL URLByAppendingPathExtension:@"framework"];
        NSBundle *associateBunle = [NSBundle bundleWithURL:associateBundleURL];
        associateBundleURL = [associateBunle URLForResource:bundleName withExtension:@"bundle"];
    }
    
    NSAssert(associateBundleURL, @"取不到关联bundle");
    //生产环境直接返回空
    return associateBundleURL?[NSBundle bundleWithURL:associateBundleURL]:nil;
}