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閱讀 228,739評論 6 534
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,634評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,653評論 0 377
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,063評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,835評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,235評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,315評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,459評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,000評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,819評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,004評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,560評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,257評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,676評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,937評論 1 288
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,717評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,003評論 2 374