使用cocoapods打包私有framework及其引用方式(入门)

这是一个入门的,很基础的教程,老手就别看了,别浪费时间
故事背景:公司有套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文件
      根目录
  • 编辑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" => "[email protected]" }
  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文件
  • pod安装库
    • 命令行进入Podfile所在目录,并执行pod install进行依赖库的安装,完成后会在WinsonDemo中生成.xcworkspace文件
  • 用Xcode进行代码

    • 打开WinsonDemo目录中WinsonDemo.xcworkspace文件,然后在开始创建的WinsonSdk目录中编写代码
  • 目录结构


    根目录

    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 "输出文件路径"

二、使用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" => "[email protected]" }
  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了

你可能感兴趣的:(使用cocoapods打包私有framework及其引用方式(入门))