使用cocoapods打包私有framework及其引用方式(入
2021-04-01 本文已影响0人
wsspace
这是一个入门的,很基础的教程,老手就别看了,别浪费时间
故事背景:公司有套ios sdk的代码,是游戏投放用于登录和支付的,临时的学习了一swift,被我接手了,sdk是采用pod的方式导入的,若是pod导入网上的三方库很简单,如果是自己私有的framework要用pod的方式导入请看如下:
一、将sdk打包成framework
常规做法是用Xcode直接新建一个framework项目,采用pod的方式就不一样了。
- 新建源项目
- 新建一目录:如我创建的WinsonKit
- 在WinsonKit目录中创建文件夹WinsonSdk并在里面创建Assets文件夹用于存放图片资源及WinsonSdk文件夹用于存放framework的源代码,在WinsonKit文件夹中创建Xcode项目如项目名字为WinsonDemo,这个项目为调用WinsonSdk的代码。
- 创建podspec
- 命令行进入目录WinsonKit中并执行
pod spec create WinsonSdk
,此时会生成名为WinsonSdk.spec文件
根目录
- 命令行进入目录WinsonKit中并执行
- 编辑podspec
spec文件配置介绍
name:框架名
version:当前版本(注意,是当前版本,假如你后续更新了新版本,需要修改此处)
summary:简要描述,在pod search WinsonSdk的时候会显示该信息。
description:详细描述
homepage:页面链接
license:开源协议
author:作者
source:源码git地址
platform:支持最低ios版本
source_files:源文件(可以包含.h和.m)
public_header_files:头文件(.h文件)
resources:资源文件(配置的文件都会被放到mainBundle中)
resource_bundles:资源文件(配置的文件会放到你自己指定的bundle中)
frameworks:依赖的系统框架
vendored_frameworks:依赖的非系统框架
libraries:依赖的系统库
vendored_libraries:依赖的非系统的静态库
dependency:依赖的三方库
我的WinsonSdk.spec文件为:
Pod::Spec.new do |spec|
spec.name = "WinsonSdk"
spec.version = "0.0.2"
spec.summary = "A short description of WinsonSdk!!"
spec.description = <<-DESC
this is desc
DESC
spec.homepage = "http://xxx.com/WinsonSdk"
spec.license = "MIT"
spec.author = { "winson" => "winson@xxx.com" }
spec.source = { :git => "http://xxx.com/WinsonSdk.git", :tag => "#{spec.version}" }
# 代码源文件(重要)
spec.source_files = 'WinsonSdk/Classes/**/*'
# 图片资源配置(重要)
spec.resource = 'WinsonSdk/Assets/MiaoYouNativeBundle.bundle'
spec.ios.deployment_target = '10.0'
spec.swift_version = '5.0'
# framework需要依赖的第3方库
spec.dependency 'SVProgressHUD'
spec.dependency 'Alamofire'
spec.dependency 'SnapKit'
spec.dependency 'HandyJSON'
spec.dependency 'CryptoSwift'
spec.dependency 'PopupDialog'
spec.dependency 'IQKeyboardManager'
spec.dependency 'AsyncSwift'
spec.dependency 'MJRefresh'
spec.dependency 'SDWebImage'
end
- 初始化pod
- 命令行进入WinsonDemo目录并执行
pod init
, 此时会在WinsonDemo目录中生成Podfile
文件
- 命令行进入WinsonDemo目录并执行
- pod安装库
- 命令行进入Podfile所在目录,并执行
pod install
进行依赖库的安装,完成后会在WinsonDemo中生成.xcworkspace
文件
- 命令行进入Podfile所在目录,并执行
-
用Xcode进行代码
- 打开WinsonDemo目录中
WinsonDemo.xcworkspace
文件,然后在开始创建的WinsonSdk目录中编写代码
- 打开WinsonDemo目录中
-
目录结构
根目录
sdk源码目录,此目录将会被打包成framework
Assets中存放资源图片文件,可打包成bundle放入
Classes目录用于存放代码文件
demo项目,使用xcworkspace打开项目 -
打包出framework
- 打包成framework分debug和release版本,以及模拟器版本及真机版本,正式出包时采用release的真机版本,或者release的真机和模拟器合并版本(具体区别请百度)。
-
导出release版本,可在Xcode中的Product--Scheme--Edit Scheme...中进行配置
-
导出模拟器或真机版本,只需要运行选择真机或者模拟器就可以相对应打出
-
成功运行了demo后即可生成framework,在项目的Products目录可以找到对应的framework文件,在Finder找到并拷贝出来即可
-
合并framework
- 若是想要打出同时满足真机和模拟器运行的framework,可用
lipo
命令进行操作,lipo -create "xxx-iphone/xxx.framework/xxx" "xxx-emiu/xxx.framework/xxx" -output "输出文件路径"
- 若是想要打出同时满足真机和模拟器运行的framework,可用
二、使用pod调用framework
-
framework的调用与上面创建的项目基本一致
demo根目录
在此新建Frameworks目录,其它Assets和Classes目录为空
将上面打包生成的framework拷贝到此目录 -
修改podspec文件
Pod::Spec.new do |spec|
spec.name = "WinsonKit"
spec.version = "0.0.1"
spec.summary = "A short description of WinsonKit."
spec.description = <<-DESC
this is a kit demo
DESC
spec.homepage = "http://xx.com/WinsonKit"
spec.license = "MIT"
spec.author = { "winson" => "winson@xxx.com" }
spec.ios.deployment_target = "10.0"
spec.swift_version = '5.0'
spec.source = { :git => "http://xx.com/WinsonKit.git", :tag => "#{spec.version}" }
spec.source_files = "Classes", "WinsonKit/Classes/**/*"
spec.exclude_files = "WinsonKit/Classes/Exclude"
# !!!主要为修改这块,导入framework
spec.vendored_frameworks = "WinsonKit/Frameworks/*.framework"
spec.dependency 'SVProgressHUD'
spec.dependency 'SCLAlertView'
spec.dependency 'Alamofire'
spec.dependency 'SnapKit'
spec.dependency 'HandyJSON'
spec.dependency 'CryptoSwift'
spec.dependency 'PopupDialog'
spec.dependency 'IQKeyboardManager'
spec.dependency 'AsyncSwift'
spec.dependency 'MJRefresh'
spec.dependency 'SDWebImage'
end
- 命令行执行
pod install
,成功后,打开demo中的xcworkspace文件即可使用framework了