SDK开发系列.md

一、Framework与.a基础

此处等下一期



二、工程嵌套联调静态库

1、新建一个主工程


2、新建一个Library工程


3、将静态库工程拖到主工程文件夹下

如果你要拖到其他目录,就要改Library Search Paths

4、将Library工程下.a文件拖入主工程的Link Binary With Libraries

image.png

如果有必要(运行时崩溃),将静态库需要加入 Embedded Binaries 中


image.png

5. 主工程添加对子工程的依赖,避免每次修改都要手动编译子工程

如下图给主工程添加对子工程的依赖,这样每次编译主工程的时候也会编译子工程。


image.png




三、在静态库中使用图片以及 xib 等资源文件

1、添加 Bundle Target

image.png

因为iOS框架中没有bundle,要选中OS X框架找到bundle,如下图


image.png

2、将资源文件加入 bundle 中

将工程中的资源文件都加入到刚刚建的bundle中,如xib、图片。点+号或直接拖都行。


image.png

3、iOS Deployment Target改为你支持的最低版本

image.png

4、设置base SDK 为latest iOS

image.png

5、编译 Bundle

image.png

6、主工程添加对子工程的依赖,避免每次修改都要手动编译子工程

image.png

7、加载 Bundle 里的资源文件

7.1、加载图片

使用运行时替换 [UIImage imageNamed:]方法,减少修改代码的工作量。
相关代码在以下几个类中

image.png

// 在AppDelegate中执行以下代码即可swizzle 所有 [UIImage imageNamed:]

#import "UIImage+Swizzle.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [UIImage kk_autoLoadImageInBundle];
    return YES;
}

  • UIImage+Swizzle.m
//  
// 修改所有的 [UIImage imageNamed:]的实现,改为先从同一项目中的 .bundle 文件中加载,没有再使用系统默认实现加载
+ (void)kk_autoLoadImageInBundle {
    SEL original = @selector(imageNamed:);
    SEL new = @selector(hook_kk_imageWithName:);
    [self kk_swizzleClassMethod:original with:new];
}

// 1. 从 .bundle 中加载图片
// 2. 按照默认的方法加载图片
+ (instancetype)hook_kk_imageWithName:(NSString *)imageName {
    UIImage *image = [NSBundle kk_imageInBundle:kk_BundleName imageName:imageName];
    if (!image) {
        image = [self hook_kk_imageWithName:imageName];
    }
    
    return image;
}
  • NSObject+Swizzle.m
#import "NSObject+Swizzle.h"
#import <objc/objc.h>
#import <objc/runtime.h>

@implementation NSObject (Swizzle)

+ (BOOL)kk_swizzleInstanceMethod:(SEL)originalSel with:(SEL)newSel {
    Class class = object_getClass(self);
    Method originalMethod = class_getInstanceMethod(class, originalSel);
    Method newMethod = class_getInstanceMethod(class, newSel);

    if (!originalMethod || !newMethod) return NO;
    method_exchangeImplementations(originalMethod, newMethod);
    
    return YES;
}

+ (BOOL)kk_swizzleClassMethod:(SEL)originalSel with:(SEL)newSel {
    Class class = object_getClass(self);
    Method originalMethod = class_getClassMethod(class, originalSel);
    Method newMethod = class_getClassMethod(class, newSel);
    
    if (!originalMethod || !newMethod) return NO;
    method_exchangeImplementations(originalMethod, newMethod);
    
    return YES;
}

@end

7.2、加载 xib

7.2.1 加载xib对应的UIViewController

需要重写xib对应控制器的 init 方法,否则可能出现找不到xib文件导致crash
参考bundle打包xib文件


- (instancetype)init {

    NSBundle *bundle = [NSBundle kk_bundleWithName:kBundleTargetName];

    self = [super initWithNibName:@"CalculatePriceViewController" bundle:bundle];

    return self;

}

代码参见:github](https://github.com/action456789/SKS_Collection/blob/master/SKS_Collection/Classes/Category/Framework开发/NSBundle%2BResource.h))

7.2.1 加载xib对应的UIVIew

需要重写xib对应View的 init 方法,,否则可能出现找不到xib文件导致crash

@implementation OfflineView

//重写要加载的view的init方法
- (instancetype)init {
    if (self = [super init]) {
        NSBundle *bundle = [NSBundle kk_bundleWithName:kk_BundleName];
        self = [[bundle loadNibNamed:@"OfflineView" owner:self options:nil] lastObject];
    }
    return self;
}

@end

7.3、加载 Localizable.strings

第一步:在Bundle中新建国际化文件

image.png

第二步:添加语言,并将之前的国际化文件中的代码复制过来

image.png

第三步:

使用 NSBundle+Resource 如下方法

+ (NSString *)mj_localizedStringForKey:(NSString *)key;
+ (NSString *)mj_localizedStringForKey:(NSString *)key value:(NSString *)value;

然后使用如下宏定义

// 加载 Bundle 中的国际化语句
#undef NSLocalizedString
#define NSLocalizedString(key, comment) \
[NSBundle mj_localizedStringForKey:(key)]

然后就可以自动的加载Bundle中的字符串了




四、将整个App打包为Framework

需要注意的地方

  1. 整个项目都要解除 AppDelegate 的依赖,AppDelegate不能打入Framework中
  2. 图片和xib文件需要按照 三 中的处理
  3. 可以使用 runtime 动态加载图片和xib文件,减少工作量
  4. 注意点:bundle中的国际化文件需要重新新建,添加语言,然后将之前App中的内容复制过来,直接拖进去是无效的
image.png

实际操作中存在的问题

  1. 图片同时存在@2x和@3x后缀导致加载的图片为nil的问题
    解决办法为只要@2x的图片




五、使用 appledoc 生成文档

官网

  • 安装
    brew install appledoc
  • 查看版本
    appledoc --version
  • 查看帮助
    appledoc --help
  • 生成文档
appledoc --output ./doc --project-name "D103Framework"  --project-company "RICISUNG" --company-id "RICISUNG" .  

”.“ 和前面的符号一定要加 空格 否则就会报错。


image.png

参考

iOS 工程套子工程,主工程和framework工程或.a library静态库工程联调](http://www.cnblogs.com/zhanglinfeng/p/5494762.html))

iOS framework静态库中使用xib和图片资源详解

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