组件化之路---Swift如何创建Framework(1)

动态库与静态库

什么是静态库

静态库(Static Library),可以将它理解为一个二进制文件,通过公共的 .h 文件,可以获取到 .a 中暴露的方法或者属性等。在最后编译 APP 的时候.a 将被链接到最终的可执行文件中,由于不能控制加载的方式和时机,所以称为静态库

什么是动态库

动态库(Dynamic Framework), 在 iOS 系统的框架是以 .framework 结尾的,就是动态框架。Framework 其实是一个 bundle,也可以理解为是一个特殊的文件夹。系统的 framework 是存在于系统内部,而不会打包进 APP 中,这可以保证 app 启动速度。相比静态库,使用起来很方便。

静态库和动态库的区别

静态库和动态库区别主要体现在编译和运行时期,在编译APP的时候静态库的.a文件就会被链接到可执行文件当中去,从一定程度上来讲静态库也会增加包的大小;
动态库在编译时并不会编译到可执行文件当中,而是在程序运行的过程当中使用到了动态库才会进行载入

创建并配置Framework

创建Framework
创建Framework.png
配置Framework
  • 动态&静态库选择


    库类型.png
  • 支持的版本


    设置支持.png
  • 创建bundle文件


    资源文件.png
构建API
  • 示例API构建

JJXConst.swift文件

import Foundation

public let JJX_SDK_Version = "0.3.1";

JJXSDKInfo.swift文件

import Foundation


public class JJXSDKInfo: NSObject {
    public func fetchSDKVersion() -> String {
        return JJX_SDK_Version
    }
}

JJXSDKManager.swift文件

import UIKit

public class JJXSDKManager: NSObject {
    
    public static let sharedInstance = JJXSDKManager()
    //版本信息
    public let sdkInfo: JJXSDKInfo

    //MARK: private
    private override init() {
        sdkInfo = JJXSDKInfo.init()
    }
}

  • 暴露swift文件
    为何此处会选择暴露swift文件?
    如果我们仅仅是将API编写完成,然后编译成Framework,将其拖入到其他工程当中进行使用,是可以选择不在此处暴露swift文件的。后续在使用Cocoapods将Framework进行发布的时候发现如果不将swift文件进行暴露,库就无法正常的进行使用。(目前其中的原因还不太了解,后续再继续查找相关的资料进行补充,此处如果理解不正确还请大家指教!!!)


    swift文件.png

如何对Framework提供的API进行测试

测试Framework的方法
  • 方法一:编译出Framework,拖入其他测试工程中进行API的测试
  • 方法二:创建依赖的测试工程,进行API的测试

两种方法都是可以对API进行测试的,此处是不推荐使用方法一,如果编译成Framework拖入其他工程进行测试,那么在测试的过程中如果发现API有问题,并不能够很好的对问题进行定位,所以更加推荐方法二,使用依赖工程的方式,可以很方便的在API中打断点进行问题定位,也更利于对库进行代码上的修改

创建依赖测试工程

使用Xcode新建一个工程,随便起一个名字,比如JJXSDKExample

将Framework工程嵌入到测试工程中
  • 将SDK项目工程拖入到测试工程目录中,如图所示


    目录移动.png
  • 在测试工程中导入SDK项目工程,如图所示


    SDK工程导入.png
编译运行测试
  • 编译SDK
    在编写测试工程代码时,需要先对 JJXSDKDemo进行编译,才会在上图中生成对应的JJXSDKDemo.framework文件,右击"JJXSDKDemo.framework",选择"show in finder" 可以查看到编译生成的Framework具体地址。如果修改了SDK工程的代码,需要对SDK进行重新的编译

  • 测试SDK API

import UIKit
import JJXSDKDemo

class ViewController: UIViewController {
    
    var sdk : JJXSDKManager?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        sdk = JJXSDKManager.sharedInstance
        print(sdk?.sdkInfo.fetchSDKVersion() ?? "---")
    }
}

到此,关于动态库的创建以及测试就完成了。在最后,我们需要掌握如何对动态库CPU的架构进行合并,让库既能够在模拟器上使用,同时也可以在真机上使用

如何编译出真机和模拟器都支持的CPU架构

模拟器

i386:适合在32位上的模拟器使用
x86_64:适合在64位上的模拟器进行使用

真机

arm7:适合于支持ios7上的设备使用
arm7s:适用于iphon5 和iphone 5c使用
arm64:在64位处理器上使用

CPU架构合并
  • 新建Target : File --- New --- Target


    菜单.png
  • 选择Aggregate


    Aggregate.png
  • 创建script


    script.png
  • 编写脚本文件

以范例中的脚本内容为例,具体PROJECT_NAME的值根据自己的需求进行命名

#!/bin/sh

# make configuration name
# CONFIGURATION_NAME = "ReleaseJJXSDKDemo"

#universal output folder
UNIVERSAL_OUTPUTFOLDER=${BUILD_DIR}/${CONFIGURATION}-universal

# make frame name
PROJECT_NAME = "JJXSDKDemo"

# Step 1. Build Device and Simulator versions
xcodebuild \
    -target "${PROJECT_NAME}" \
    ONLY_ACTIVE_ARCH=NO \
    -configuration ${CONFIGURATION} \
    -sdk iphoneos \
    -arch arm64 \
    BUILD_DIR="${BUILD_DIR}" \
    BUILD_ROOT="${BUILD_ROOT}" \
    clean build
xcodebuild \
    -target "${PROJECT_NAME}" \
    -configuration ${CONFIGURATION} \
    -sdk iphonesimulator \
    -arch x86_64 \
    ONLY_ACTIVE_ARCH=NO \
    BUILD_DIR="${BUILD_DIR}" \
    BUILD_ROOT="${BUILD_ROOT}" \
    clean build

# make sure the output directory exists
rm -rf "${UNIVERSAL_OUTPUTFOLDER}"
mkdir -p "${UNIVERSAL_OUTPUTFOLDER}"

# Step 2. Copy the framework structure (from iphoneos build) to the universal folder
 cp -R "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework" "${UNIVERSAL_OUTPUTFOLDER}/"

# Step 3. Copy Swift modules from iphonesimulator build (if it exists) to the copied framework directory
SIMULATOR_SWIFT_MODULES_DIR="${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/Modules/${PROJECT_NAME}.swiftmodule/."
if [ -d "${SIMULATOR_SWIFT_MODULES_DIR}" ]; then
cp -R "${SIMULATOR_SWIFT_MODULES_DIR}" "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/Modules/${PROJECT_NAME}.swiftmodule"
fi

# Step 4. Create universal binary file using lipo and place the combined executable in the copied framework directory
lipo -create "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework/${PROJECT_NAME}" -output "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/${PROJECT_NAME}" 

# Step 5. Convenience step to copy the framework to the project's directory
rm -rf "${PROJECT_DIR}/${PROJECT_NAME}.framework"
cp -R "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework" "${PROJECT_DIR}"

# Step 6. Convenience step to open the project's directory in Finder
open "${PROJECT_DIR}"


  • 修改为Release版本


    Edit Scheme.png
debug修改为release.png

最后,运行UniversalSDKDemo,便可编译出同时具有模拟器和真机架构的Framework

写在最后:组件化之路---通过cocoapods进行动态库的发布及维护

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,544评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,430评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,764评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,193评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,216评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,182评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,063评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,917评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,329评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,543评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,722评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,425评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,019评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,671评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,825评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,729评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,614评论 2 353

推荐阅读更多精彩内容