iOS 创建Framework 项目及所遇到的坑

在开发中有时候会有一些功能是其他项目中也会用到的,所以为了便于维护和减少重复写代码,我们可以通过创建静态库的方式来管理代码,将生成的Framework 包直接拖入所需要的工程就可以调用相应方法。
首先是如何创建一个Framework项目,

1.在 Xcode 中,File -> New -> Project -> Framework & Library -> Cocoa Touch Framework 来创建项目。

Paste_Image.png

2.添加所需要的代码

Paste_Image.png

3.在 MintmedicalDiseaseGuidelinesKit.h 文件中添加公共代码的头文件:#import<MintmedicalDiseaseGuidelinesKit/MDGDiseaseGuidelMainViewController.h>

Paste_Image.png

4.开放公用代码的头文件。把需要曝光给外部的头文件放到 Targets -> Build Phases -> Headers -> Public 栏中。

Paste_Image.png

5.配置参数,这里制作的是静态库,需要将Build Settings ->Linking中的Mach-O Type设置为Static Library。

Paste_Image.png

6.打出通用包

和.a类似,生成的静态库需要进行合并才能适应不同的平台,为了方便,我们可以向Xcode添加脚本来解决这个繁琐的问题。
6.1新建target,选择other中的Aggregate,命名一般为framework名-Universal


Paste_Image.png

6.2我们在target的Build Phases中点击加号,添加一个Run Script


Paste_Image.png

6.3插入脚本
Paste_Image.png

对应的脚本内容:
#!/bin/sh

UNIVERSAL_OUTPUTFOLDER=${BUILD_DIR}/${CONFIGURATION}-universal

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

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

# 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 -output "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework/${PROJECT_NAME}"

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

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

6.4在 Targets -> MintmedicalDiseaseGuidelinesKit-Universal -> Target Dependencies 中添加 MintmedicalDiseaseGuidelinesKit 依赖项,这样使得在编译 MintmedicalDiseaseGuidelinesKit-Universal 的时候会先走正常流程编译 MintmedicalDiseaseGuidelinesKit.framework。


Paste_Image.png

6.5编译MintmedicalDiseaseGuidelinesKit-Universal生成通用framework包,拖入其他工程就可以使用。


Paste_Image.png

Paste_Image.png

7.遇到的坑!!!

7.1.因为Framework是要给其他工程用的,所以新建文件的时候一定要加前缀,不管是不是暴露给外部的,统统都加前缀,这个坑了我好久,开始只给新建的文件加了前缀,还有些文件是原来工程里的,直接拉过来了,想想不暴露出去不改名应该没事,结果最后打出来的包放到其他工程中(存在同名文件的工程),一直编译不通过,搞了好久才发现是这个问题。

7.2.关于Framework中用到的资源文件(图片等)
在Framework中所用到的图片不能直接打包进Framework中,而是要单独打包成bundle,然后跟最终打包好的Framework一起放入目标工程中即可。


Paste_Image.png

创建资源bundle的方法:
新建一个文件夹,把所需要的资源文件(这里是图片),放进去,然后直接修改它的名称和扩展名就可以了


Paste_Image.png

调用bundle中的图片方法:
写了个image的分类方法,调用起来方便一点
#import "UIImage+EX.h"

@implementation UIImage (EX)

+ (UIImage *)getImageInBundleWithName:(NSString *)name {
    NSBundle *libBundle = [NSBundle bundleWithPath:[[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"MDGImage.bundle"]];
    NSString *path = @"";
    if (libBundle) {
        
        path = [[libBundle resourcePath] stringByAppendingPathComponent:name];
        
        path = [path stringByAppendingString:@".png"];
    }
    return [UIImage imageWithContentsOfFile:path];
}
@end

调用方法:

[UIImage getImageInBundleWithName:@"backArrow"]

7.3 制作成动态库

错误描述:在使用静态库时,运行报错(Reason: Image Not Found)

具体原因:可能由于没有设置Mach-O Type,做的是动态库,在使用的时候需要额外加一个步骤,要把Framework同时添加到General --> Embedded Binaries中。

解决方案:将Mach-O Type设置为Static Library

参考:

http://www.hackmz.com/2016/05/25/iOS%E5%BC%80%E5%8F%91-%E9%9D%99%E6%80%81%E5%BA%93%E5%88%B6%E4%BD%9C-%E4%B8%89/

http://www.samirchen.com/create-a-framework/

http://www.hackmz.com/2016/05/26/Xcode%E4%B8%AD%E7%94%A8Workspace%E6%9D%A5%E7%AE%A1%E7%90%86%E5%A4%9A%E9%A1%B9%E7%9B%AE/

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

推荐阅读更多精彩内容