iOS 洪荒之力-SDK开发(三)

上一章节中,我们对SDK工程进行了一些配置,很多朋友已经开始着手进行开发了,同时也提出了一些问题并给出了纠正,非常感谢各位支持。本章中,我们将对资源文件以及三方库做一些配置,以便能更好的利用到我们的项目当中。开始之前,确保你已经打开了我们之前创建好的Workspace。

Bundle

在SDK开发中,有时候我们需要用到图片、xib等等一些资源文件,这时候需要通过bundle来进行管理。选中MySDK工程,然后File->New->Target,当然你也可以直接点击TARGETS底下的“+”来创建


3-1.png

找到macOS下的Bundle,新建并命名为MySDKResources。接下来切换到Bundle工程的Build Settings选项,这里我们需要修改几项配置。首先选择Base SDK,按下Delete键将其修改为iOS


3-2.0aafdbe6ec5a406eaa1434fcad35b00c.png

然后配置编译后的输出路径Per-configuration Build Products Path,这里仍然设置在build目录
3-3.f0fd5bdf546b49089eb06aaf11267ede.png

去掉Info.plist文件并删除配置,因为编译后plist文件同样会打包进bundle文件内


3-4.cb1a1d4f47514b47a1a39f1ba63543d4.png

修改Product Name
3-5.3129b005c6634c16a144900d53c76a37.png

将COMBINE_HIDPI_IMAGES设置为NO,默认配置下会被转为.tiff格式
3-6.ed24079ab62142569dbd9c70b99d5ae4.png

将Versioning System设置为None,默认Xcode会通过agvtool生成对应的版本信息,并打包进bundle文件中,这会导致后续在SDK跟随使用的App提交到AppStore的时候报错。
3-7.d58cae65ee4c410d8ac644f6f144bf39.png

好了,这时候我们选择MySDKResources来进行编译
3-8.ad30853b80924002842e3f139134f3b1.png

编译成功后,去到你的build目录中查看


3-9.84fc9fdbe6a24cfc8a84b8423b28d38a.png

bundle文件顺利生成了,接下来我们还需要做一些配置以便能够在开发当中更好的使用bundle文件。在MySDK的Build Phases中将MySDKResources加入Target Dependencies
3-10.537c4a0def984a1dbedbb4b99c0e0dda.png

接下来我们加入图片进行测试
3-11.6c10cd20871e402e965a2603a959ee79.png

编译,到build目录中查看bundle文件(右键显示包内容),这时候我们的test.png已经顺利打包进了bundle文件中,是时候来使用它了。在SDK工程中创建View来加载图片,这里创建MySDKView类来测试
MySDKView.m
#import "MySDKView.h"

@interface MySDKView()
@property (strong, nonatomic) UIImageView *imageView;
@end

@implementation MySDKView

- (instancetype)initWithFrame:(CGRect)frame
{
    self = [super initWithFrame:frame];
    if (self) {
        self.imageView = [[UIImageView alloc] initWithFrame:self.bounds];
        self.imageView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
        self.imageView.image = [UIImage imageNamed:@"MySDK.bundle/test.png"];
        [self addSubview:self.imageView];
    }
    return self;
}

@end

别忘了把MySDKView加入Public Header和MySDK.h中


3-12.b3da41f6b15740c692e812e74b53e83b.png
3-13.d133affb405d4f888a33d33b78a55a87.png

这时候在MySDKTests工程中创建View并显示

MySDKView *sdkView = [[MySDKView alloc] initWithFrame:CGRectMake(20, 20, 100, 100)];
[self.view addSubview:sdkView];

运行测试工程进行测试,这时候图片并没有显示出来,需要把build目录中的bundle文件导入到测试工程中,注意不要选择copy确保编译同步最新


3-14.d3392f9e81e74e6b9e65873fdf596cc8.png

3-15.4273e4a81f634a739cb20b7f89ff8f6b.png

OK,再次运行测试,图片正常展示了。到此Bundle已经完成了对bundle文件的配置。

使用第三方库

开发过程中,必然会想到去使用一些优秀的开源库,比如AFNetworking、SDWebImage等等,毕竟自己去开发一套代价会更大。那么问题来了,当你在把这些库加入到你的工程中后,打包发布给其它项目使用,而其它项目也使用了相同的库,那么就会编译出错,也就是"duplicate symbols”错误。要解决这个问题,方法有很多,但我选择给所有库加上前缀,这需要做一些配置。虽然这样会增加包的大小,也会延长编译时间,但给开发带来的便利以及稳定性来说不失为一个好的选择。
首先在我们的SDK目录中新建vendor文件夹


3-16.811d82cf0f7941b5b4c5b08cb7c4ba2b.png

然后将我们需要用到的三方库加入进来,我们以AFNetworking为例


3-17.93f396a8d1764700bce8a02f54e8393a.png

这里是通过手动下载源码的方式导入,当然如果你用Git可以用Submodule更新,或者新建一个空的工程用CocoaPods导入都会更加方便。回到我们的SDK工程,创建静态库Target并命名为MySDKVendor
3-18.45031e4f83d34a1f88b3adc5bcaa4e78.png

3-19.666e65a09c054150a975309fd142c1b3.png

接下来把Vendor中的AFNetworking加入进来,注意不要Copy,这里需要同时加入到MySDK和MySDKVendor中,这里我只是将Vender作为一个辅助Target,是为了生成后面需要用到的宏定义文件。


3-20.b402ae140f2b48238478b18b548ea2e1.png

3-20.87cca807b3b7427eb0fd5cb63fb13500.png

在scripts目录中创建脚本generate_namespace_header.sh

# This script is a modified version of this: https://github.com/jverkoey/nimbus/blob/master/scripts/generate_namespace_header

header=../vendor/MySDK+Namespace.h
prefix="MySDK"

echo "Generating $header from $CODESIGNING_FOLDER_PATH..."

echo "// Namespaced Header
#ifndef __NS_SYMBOL
// We need to have multiple levels of macros here so that __NAMESPACE_PREFIX_ is
// properly replaced by the time we concatenate the namespace prefix.
#define __NS_REWRITE(ns, symbol) ns ## _ ## symbol
#define __NS_BRIDGE(ns, symbol) __NS_REWRITE(ns, symbol)
#define __NS_SYMBOL(symbol) __NS_BRIDGE($prefix, symbol)
#endif
" > $header

# The following one-liner is a bit of a pain in the ass.
# Breakdown:
#
# nm $CODESIGNING_FOLDER_PATH -j
# Dump all of the symbols from the compiled library. This will include all UIKit
# and Foundation symbols as well.
#
# | grep "^_OBJC_CLASS_$_"
# Filter out the interfaces.
#
# | grep -v "\$_NS"
# Remove all Foundation classes.
#
# | grep -v "\$_UI"
# Remove all UIKit classes.
#
# | sed -e 's/_OBJC_CLASS_\$_\(.*\)/#ifndef \1\'$'\n''#define \1 __NS_SYMBOL(\1)\'$'\n''#endif/g'
# I use the syntax outlined here:
# http://stackoverflow.com/questions/6761796/bash-perl-or-sed-insert-on-new-line-after-found-phrase
# to create newlines so that we can write the following on separate lines:
#
#  #ifndef ...
#  #define ...
#  #endif
#

echo "// Classes" >> $header

nm $CODESIGNING_FOLDER_PATH -j | sort | uniq | grep "^_OBJC_CLASS_\$_" | grep -v "\$_AGSGT" | grep -v "\$_MK" | grep -v "\$_CL" | grep -v "\$_NS" | grep -v "\$_UI" | sed -e 's/_OBJC_CLASS_\$_\(.*\)/#ifndef \1\'$'\n''#define \1 __NS_SYMBOL(\1)\'$'\n''#endif\'$'\n''/g' >> $header

echo "// Functions" >> $header

nm $CODESIGNING_FOLDER_PATH | sort | uniq | grep " T " | cut -d' ' -f3 | grep -v "\$_NS" | grep -v "\$_UI" | grep -v "llvm" | sed -e 's/_\(.*\)/#ifndef \1\'$'\n''#define \1 __NS_SYMBOL(\1)\'$'\n''#endif\'$'\n''/g' >> $header

echo "// Externs" >> $header

nm $CODESIGNING_FOLDER_PATH | sort | uniq | grep " D " | cut -d' ' -f3 | grep -v "\$_NS" | grep -v "\$_UI" | grep -v "llvm" | sed -e 's/_\(.*\)/#ifndef \1\'$'\n''#define \1 __NS_SYMBOL(\1)\'$'\n''#endif\'$'\n''/g' >> $header

nm $CODESIGNING_FOLDER_PATH | sort | uniq | grep " S " | cut -d' ' -f3 | grep -v "\$_NS" | grep -v ".eh" | grep -v "llvm" | grep -v "\$_UI" | grep -v "OBJC_" | sed -e 's/_\(.*\)/#ifndef \1\'$'\n''#define \1 __NS_SYMBOL(\1)\'$'\n''#endif\'$'\n''/g' >> $header

脚本来自nimbus,主要是生成一个头文件,通过宏定义替换的方式来实现对类名、方法、外部定义等等的修改,从而能够顺利的使用各种三方库。当然有可能你需要对改脚本做一些改变,有些库比较特殊,这取决于你的工程。是时候把脚本配置到Vendor中了


3-21.0fdd60d7d4a34afcb021e3c232d3f181.png

选择MySDKVendor进行编译,注意一定是选择模拟器编译,真机是不能正常生成的。可能真机并没有把符号表暴漏出来。


3-23.7043fe2c64ac47499d2f14a3a27e85c2.png

这时候可以在vendor文件夹中看到生成了MySDK+Namespace.h文件
3-24.a855d962042d46a5a200ab0dce16963c.png

把该文件加入进MySDK工程


3-25.4294f76da1bf483aa042ed4a3d19df1c.png

在你所有需要使用三方库的地方都需要import该文件,为了方便,这里我们创建pch文件
3-26.17a748799df64c4e88ab5d292758e300.png

然后在MySDK-Project.xcconfig中配置
GCC_PREFIX_HEADER = MySDK/MySDK-Prefix.pch
GCC_PRECOMPILE_PREFIX_HEADER = YES

最后写上测试代码

#import "MySDKTest.h"
#import "AFNetworking.h"

@implementation MySDKTest

+ (void)printTest {
    NSLog(@"MySDK Test");
    
    NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
    AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];
    
    NSURL *URL = [NSURL URLWithString:@"https://www.baidu.com"];
    NSURLRequest *request = [NSURLRequest requestWithURL:URL];
    
    NSURLSessionDataTask *dataTask = [manager dataTaskWithRequest:request completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
        if (error) {
            NSLog(@"Error: %@", error);
        } else {
            NSLog(@"%@ %@", response, responseObject);
        }
    }];
    [dataTask resume];
}

@end

编译运行,这时候Namespace文件也许会报错


3-27.042a42d9d5d54de0b2197781e69bda05.png

稍作修改


3-28.499926ceeed54f3ca7046521033b4fad.png

再次运行测试工程,将输出正确结果。到此完成了第三方库的导入。下一章继续讨论发布以及相关文档的输出。

有很多问题没有及时回复,欢迎加群讨论557165621

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

推荐阅读更多精彩内容