ios从开发Framework到提交Cocoapods
最近因为公司项目需求,需要提供静态库给其他公司使用;这个项目做完了发现遇到很多坑,因为网上太多这样的教程,本文只是在此梳理一下整个开发流程。
一、静态库的简单介绍
ios静态库分为 .a和.framework;同样有静态库就有动态库,动态库在ios中是 .dylib和.framework;系统提供的.framework都是动态库,我们自己写的.framework都是静态库(我们提供动态库是不能通过审核的)。为什么我在项目中选择framework开发,主要因为.a文件必须手动提供对应的.h文件,而framework包括了.h文件和.a文件。
二、Framework的开发
1.创建一个project选择framework
创建Framework2.创建名为:DFFramework的工程
DFFramework项目3.本文主要意图在意整个流程,所以功能随意一点,创建一个简单的加法运算类DFAdditionOperation,实现一个additionOneNum的类方法,另:静态库中也可以使用cocoapods管理自己用到的第三方库,当然第三方库在最后生成的文件中不会包含其中,所以当别人用到你的库的时候,也必须要加载你所使用的第三方库来支持你的库。
功能4.在DFFramework中导入需要暴露给用户的头文件:
导入头文件5.修改为静态库
静态库6.把我们需要暴露给用户的头文件移动到public中
暴露头文件7.到目前为止基本的创建framework工作已经完成,那么如何提供给其他人用呢?目前为止我们可以通过选择虚拟器或者真机生成framework,这种方式生成的framework是分开使用对应的虚拟器和真机。这种方式很复杂,下面我们用脚本来生成虚拟器和真机通用的framework。另:用到aggregate,关于aggregate具体介绍可以Google学习。
8.创建Aggregate名为:DFAggregate
file->new->target->进入下图页面
创建Aggregate9.在DFAggregate下添加DFFramework.framework
添加.framework10.创建可执行的脚本文件
创建脚本文件11.填入脚本
# Sets the target folders and the final framework product.
# 如果工程名称和Framework的Target名称不一样的话,要自定义FMKNAME
# 例如: FMK_NAME = "MyFramework"
FMK_NAME=${PROJECT_NAME}
# Install dir will be the final output to the framework.
# The following line create it in the root folder of the current project.
INSTALL_DIR=${SRCROOT}/Products/${FMK_NAME}.framework
# Working dir will be deleted after the framework creation.
WRK_DIR=build
DEVICE_DIR=${WRK_DIR}/Release-iphoneos/${FMK_NAME}.framework
SIMULATOR_DIR=${WRK_DIR}/Release-iphonesimulator/${FMK_NAME}.framework
# -configuration ${CONFIGURATION}
# Clean and Building both architectures.
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphoneos clean build
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphonesimulator clean build
# Cleaning the oldest.
if [ -d "${INSTALL_DIR}" ]
then
rm -rf "${INSTALL_DIR}"
fi
mkdir -p "${INSTALL_DIR}"
cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"
# Uses the Lipo Tool to merge both binary files (i386 + armv6/armv7) into one Universal final product.
lipo -create "${DEVICE_DIR}/${FMK_NAME}" "${SIMULATOR_DIR}/${FMK_NAME}" -output "${INSTALL_DIR}/${FMK_NAME}"
rm -r "${WRK_DIR}"
open "${INSTALL_DIR}"
脚本文件12.大功告成,编译DFAggregate自动弹出.framework文件
生成的framework三、将Framework提交Cocoapods
cocoapods默认只能基于git的代码管理,所以以下操作基于mac环境安装了cocoapods、并且熟悉git操作,本文是在github和cocoa pods联合使用,当然也可以用其他git平台或者自己搭建的git平台。
1.安装cocoapods的打包插件
sudo gem install cocoapods-packager
2.创建git代码管理仓库
本文基于github开源平台作为代码管理。在新建仓库时候按照以下配置创建
github仓库3.将上面生成的Framework整个push到github服务器上面去
push该.framework4.给稳定的代码打上版本tag,一般以版本号作为tag名字
git tag -a
5.将tag推送到git服务器
git push --tags
6.注册trunk
//注册邮箱和用户名:pod trunk register XXX@XXX.com '名字' --verbose
//查看注册信息:pod trunk me
成功后显示信息7.配置自己的podspec文件
这一步是至关重要的一步,也是坑最多的一步,发现网上有很多关于pod源码的文章,很少有framework的文章,如果和我一样遇到很多坑的同学,能自己慢慢的去填坑,本文也只是记录成功上传的流程。大家可以在网上找找.podspec文件自己改改,自己写反而容易出错。
Pod::Spec.new do |s|
s.name = 'DFFramework'
s.version = "1.0.1"
s.summary = 'DFFramework is test.'
s.license = 'MIT'
s.author = { "注册的名字" => "注册的邮件" }
s.homepage = 'https://github.com/xxx/DFFramework'
s.source = { :git => "https://github.com/xxx/DFFramework.git", :tag => s.version}
s.platform = :ios
s.ios.deployment_target = "7.0"
s.frameworks = 'Foundation'
s.vendored_frameworks = 'DFFramework.framework'
s.requires_arc = true
end
上面就是.podspec的配置,其他字段没什么可说的了,网上一大把介绍,这里主要介绍与网上不同的地方是:s.vendored_frameworks = 'DFFramework.framework' 因为我们要提交到cocoa pods的是.framework静态库,所以这个字段必不可少,如果用到了第三方可以比如:AFNetworking,就要在s.dependency 'AFNetworking', '~> 2.6.1'
8.验证podspec文件
编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,需要修改错误,知道验证通过podspec文件才可用,以下命令验证:
pod lib lint
9.提交cocoa pods
pod trunk push DFFramework.podspec