美文网首页iOS面试题组件化iOS项目
iOS 制作自己的Framework(引入第三方库)

iOS 制作自己的Framework(引入第三方库)

作者: 百里玄卿 | 来源:发表于2018-04-02 11:35 被阅读1461次

    一、创建工程并新建Framework Target

    1. 新建一个工程,Target选择Cocoa Touch Framework。


      新建Framework Target
    2. 添加接口
      在刚刚创建的Framework里面添加一些接口。


      ZMSDKInterface.h
      ZMSDKInterface.m
    1. 设置
      对Target进行一些设置。
      3.1 选择Framework Target,在Build Settings里面搜索Mach -O type,改为Static Library
      3.2 选择Framework Target,在Build Settings里面搜索Link With Standard Libraries,改为No
      3.3 选择Framework Target,在Build Phases的Headers里面将需要暴露出来的头文件设置好。public是可以被引用的,用户可以看到的,例如用户在使用的时候import "xxxxxx.h"projectprivate是不暴露出来的。
      设置头文件
      Framework设置完成,进行下一步。

    二、创建测试工程
    Framework制作好了,我们需要一个Target测试一下吧。那么直接在刚刚创建的这个工程里面,新建一个Single View APP的Target就好了。


    目录结构

    三、引入第三方库
    如果我们在制作Framework的时候,需要用到第三方库怎么办呢?网上有轮子,而且有专人维护,总比我们自己造的强。但是如果公司有条件的话,最好是不引入第三方库。
    我们在引入第三方库的时候,使用cocoapods进行管理,假设我们的SDK需要AFNetworking这个库,按下面操作引入。

    1. podfile文件的写法
    platform:ios,'8.0'
    #project中不要有commomPods的target
    abstract_target 'commonPods' do
    #这里写共用的第三方库
    pod 'AFNetworking'
        target 'ZMSDKDemo' do
            #这里写SDK需要使用的第三方库
        end
        target 'ZMSDKTest' do
             #这里写测试工程里面需要使用的第三方库
        end
    end
    
    1. 这么写的原因
      因为我们在Framework里面需要使用第三方库,在测试工程里面也需要使用第三方库,所以我们要同时引入。

    四、创建Framework打包脚本

    1. 在这个工程里面新建一个target,选择Cross-platform选项卡中的Aggregate。


      创建打包脚本
    2. 选择这个target,然后点击左上角+,新建一个Run Script。脚本如下(来源于网上,实测可用):
    #!/bin/sh
    #要build的target名
    TARGET_NAME=${PROJECT_NAME}
    if [[ $1 ]]
    then
    TARGET_NAME=$1
    fi
    UNIVERSAL_OUTPUT_FOLDER="${SRCROOT}/${PROJECT_NAME}/"
    
    #创建输出目录,并删除之前的framework文件
    mkdir -p "${UNIVERSAL_OUTPUT_FOLDER}"
    rm -rf "${UNIVERSAL_OUTPUT_FOLDER}/${TARGET_NAME}.framework"
    
    #分别编译模拟器和真机的Framework
    xcodebuild -target "${TARGET_NAME}" ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphoneos BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" clean build
    xcodebuild -target "${TARGET_NAME}" ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphonesimulator BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" clean build
    
    #拷贝framework到univer目录
    cp -R "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${TARGET_NAME}.framework" "${UNIVERSAL_OUTPUT_FOLDER}"
    
    #合并framework,输出最终的framework到build目录
    lipo -create -output "${UNIVERSAL_OUTPUT_FOLDER}/${TARGET_NAME}.framework/${TARGET_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${TARGET_NAME}.framework/${TARGET_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${TARGET_NAME}.framework/${TARGET_NAME}"
    
    #删除编译之后生成的无关的配置文件
    dir_path="${UNIVERSAL_OUTPUT_FOLDER}/${TARGET_NAME}.framework/"
    for file in ls $dir_path
    do
    if [[ ${file} =~ ".xcconfig" ]]
    then
    rm -f "${dir_path}/${file}"
    fi
    done
    #判断build文件夹是否存在,存在则删除
    if [ -d "${SRCROOT}/build" ]
    then
    rm -rf "${SRCROOT}/build"
    fi
    rm -rf "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator" "${BUILD_DIR}/${CONFIGURATION}-iphoneos"
    #打开合并后的文件夹
    open "${UNIVERSAL_OUTPUT_FOLDER}"
    

    五、运行

    1. 选择Framework这个target,然后分别在simulator和general device上面运行一次。
    2. 选择测试target,在General选项卡中的Embeded Binaries里面添加自己的Framework。


      添加自己的Framework
    3. 运行测试target
      在需要使用Framework的地方引入头文件。


      使用Framework
      结果

    六、导出Framework给他人使用

    1. 选择脚本target,运行一次。此时会打开一个finder窗口,里面有你打包好的Framework啦,你就可以给其他人使用了。
    2. 我们再新建一个工程,选择Single View APP,导入我们刚刚制作好的Framework,同时我们的SDK需要AFNetworking这个第三方库的,所以我们也同样需要把AFNetworking导入到我们的工程里面来,如果使用pod管理的话,像平常那样写podfile就可以了,不需要像上面那样写了。然后测试一下看是否正常就可以了。

    本文完结。喜欢点个喜欢吧~~

    相关文章

      网友评论

      • Jabir_Zhang:如果用到的第三方库在测试项目中不需要用到,所以不需要导入到工程的话,那怎么处理呢
      • b6a42eecbbfb:按这样的步骤sdk 依赖了个YYModel库,然后我建了oc的demo工程,然后把sdk扔进去pod,运行,没问题,但是如果建的是swift跑起来会报错.
        objc[1734]: Class PodsDummy_YYModel is implemented in both /private/var/containers/Bundle/Application/1587C210-6642-49D1-9A7D-71513746DB19/SMKZLZFDemo.app/Frameworks/SMKZLZFSDK.framework/SMKZLZFSDK (0x103f749d0) and /var/containers/Bundle/Application/1587C210-6642-49D1-9A7D-71513746DB19/SMKZLZFDemo.app/SMKZLZFDemo (0x1033dbf40). One of the two will be used. Which one is undefined.
        请问有遇到这样的问题么,怎么解决呢?
        zyc_在路上:大牛,你好,我有个问题向你请教一下:按你的方式打成的framework包,framework和项目中用到了同样的三方(例如:SDWebImage,AFNetworking),这样项目在编译的时候就会报错,你是怎样解决的 ?
        b6a42eecbbfb:@百里玄卿 恩sdk和demo的Podfile都加use_frameworks!就好了
        百里玄卿:@yy天空之上 我没有试过swift的

      本文标题:iOS 制作自己的Framework(引入第三方库)

      本文链接:https://www.haomeiwen.com/subject/jfjthftx.html