電子發(fā)燒友網(wǎng)>電子資料下載>電子資料>TinyPart由objective-C編寫的iOS模塊化框架

TinyPart由objective-C編寫的iOS模塊化框架

2512970 2022-06-23 | zip | 0.84 MB | 次下載 | 免費(fèi)

普通下載普通下載

資料介紹

授權(quán)協(xié)議 MIT

開發(fā)語(yǔ)言 Objec tive-C

操作系統(tǒng) OS X

軟件類型開源軟件

所屬分類手機(jī)/移動(dòng)開發(fā)、 iPhone/iPad開發(fā)工具

軟件簡(jiǎn)介

TinyPart 是一個(gè)由 Objective-C 編寫的面向協(xié)議的 iOS 模塊化框架，同時(shí)它還支持 URL 路由和模塊間通信機(jī)制。

安裝

cocoapods

pod 'TinyPart'

特點(diǎn)

面向協(xié)議。TinyPart中模塊和服務(wù)都是面向協(xié)議的。服務(wù)面向協(xié)議的好處在于對(duì)于接口維護(hù)比較友好，任何接口的變動(dòng)在編譯時(shí)都是可見的，但是大型項(xiàng)目有可能會(huì)面臨大量需要維護(hù)的協(xié)議，這也是不可忽視的缺點(diǎn)。
動(dòng)態(tài)化。TinyPart中模塊和服務(wù)的注冊(cè)都是在運(yùn)行時(shí)完成的，可以根據(jù)具體需要調(diào)整模塊的注冊(cè)和啟動(dòng)時(shí)間，異步啟動(dòng)模塊對(duì)于優(yōu)化APP首屏加載時(shí)間會(huì)有幫助。
路由服務(wù)。我們知道面向協(xié)議的服務(wù)雖然對(duì)于接口維護(hù)比較方便，但是模塊間相互調(diào)用各自服務(wù)，是需要知道對(duì)方協(xié)議的，這樣最后可能會(huì)導(dǎo)致所有的協(xié)議需要暴露給所有的模塊。比如現(xiàn)在有10個(gè)模塊每個(gè)模塊有1個(gè)服務(wù)協(xié)議，在上述情況下每個(gè)模塊需要知道另外9個(gè)模塊的協(xié)議，這相當(dāng)于每個(gè)協(xié)議都被@import了9次，所有協(xié)議總共將會(huì)被@import 9*10=90次，這對(duì)于想做完全代碼隔離的模塊化來(lái)說(shuō)是個(gè)噩夢(mèng)。通過(guò)路由服務(wù)則很好地平衡了模塊間調(diào)用和依賴問(wèn)題，順便也解決了跨APP跳轉(zhuǎn)的問(wèn)題。
URL路由。在路由基礎(chǔ)上，只需要再增加簡(jiǎn)單的1到2行代碼就可以實(shí)現(xiàn)通過(guò)APPScheme的URL路由機(jī)制。
多級(jí)模塊有向通信。一般來(lái)說(shuō)，完全去耦合的模塊間通信方案大概是兩種：URL和通知NSNotification。URL解決了模塊間服務(wù)相互調(diào)用的問(wèn)題，但是如果想要通過(guò)URL實(shí)現(xiàn)一個(gè)觀察者模式則會(huì)變得非常復(fù)雜。這時(shí)候大家可能會(huì)偏向于選擇通知，但是由于通知是全局性的，這樣會(huì)導(dǎo)致任何一條通知可能會(huì)被APP內(nèi)任何一個(gè)模塊所使用，久而久之這些通知會(huì)變得難以維護(hù)。所謂多級(jí)模塊有向通信，則是在NSNotification基礎(chǔ)上對(duì)通知的傳播方向進(jìn)行了限制，底層模塊對(duì)上層模塊的通知稱為廣播Broadcast，上層模塊對(duì)底層模塊或者同層模塊的通知稱為上報(bào)Report。這樣做有兩個(gè)好處：一方面更利于通知的維護(hù)，另一方面可以幫助我們劃分模塊層級(jí)，如果我們發(fā)現(xiàn)有一個(gè)模塊需要向多個(gè)同級(jí)模塊進(jìn)行Report那么這個(gè)模塊很有可能應(yīng)該被劃分到更底層的模塊。

架構(gòu)說(shuō)明

用法

初始化

繼承 TPAppDelegate，初始化TPContext

#import "TinyPart.h"

@interface AppDelegate : TPAppDelegate
@property (strong, nonatomic) UIWindow *window;
@end

@implementation AppDelegate
@synthesize window;

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [TPMediator sharedInstance].deleagate = self;

    [TPContext sharedContext].launchOptions = launchOptions;
    [TPContext sharedContext].application = application;
    context.configPlistFileName = @"TinyPart.bundle/TinyPart.plist";
    context.modulePlistFileName = @"TinyPart.bundle/TinyPart.plist";
    context.servicePlistFileName = @"TinyPart.bundle/TinyPart.plist";
    context.routerPlistFileName = @"TinyPart.bundle/TinyPart.plist";
    [TinyPart sharedInstance].context = [TPContext sharedContext];
    
    return [super application:application didFinishLaunchingWithOptions:launchOptions];
}
@end

新建 plist 文件 'TinyPart.bundle/TinyPart.plist'

模塊Module

定義并注冊(cè)一個(gè)模塊

#import "TinyPart.h"

@interface TestModule : NSObject 
@end

@implementation TestModule
TP_MODULE_AUTO_REGISTER // 自動(dòng)注冊(cè)模塊，動(dòng)態(tài)注冊(cè)模塊

TP_MODULE_ASYNC         // 異步啟動(dòng)模塊，優(yōu)化開屏性能

TP_MODULE_PRIORITY(1)   // 模塊啟動(dòng)優(yōu)先級(jí)，優(yōu)先級(jí)高的先啟動(dòng)

TP_MODULE_LEVEL(TPModuleLevelBasic)     // 模塊級(jí)別：基礎(chǔ)模塊

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

- (void)moduleDidLoad:(TPContext *)context {
    switch (context.env) {
        case TPRunningEnviromentTypeDebug: {
            NSLog(@"%@", @"TestModule1 moduleDidLoad: debug");
            break;
        }
        case TPRunningEnviromentTypeRelease: {
            NSLog(@"%@", @"TestModule1 moduleDidLoad: release");
            break;
        }
    }
}
@end

如果沒有使用TP_MODULE_AUTO_REGISTER?自動(dòng)注冊(cè)宏的話，還需要將TestModule1加到TinyPart.plist配置文件中。

服務(wù)Service用法

定義并注冊(cè)一個(gè)服務(wù)Service。Service可自定義單例模式或多例模式。

#import "TPServiceProtocol.h"

@protocol TestModuleService1 
- (void)function1;
@end

@interface TestModuleService1Imp : NSObject 
@end

@implementation TestModuleService1Imp
TPSERVICE_AUTO_REGISTER(TestModuleService1) // 自動(dòng)注冊(cè)服務(wù)

- (void)function1 {
    NSLog(@"%@", @"TestModuleService1 function1");
}
@end

如果沒有使用TPSERVICE_AUTO_REGISTER?自動(dòng)注冊(cè)宏的話，還需要將TestModuleService1加到TinyPart.plist配置文件中。

訪問(wèn)服務(wù)Sevice

id service1 = [[TPServiceManager sharedInstance] serviceWithName:@"TestModuleService1"];
    [service1 function1];

路由Router用法

定義并注冊(cè)一個(gè)路由Router

#import "TPRouter.h"

@interface TestRouter : TPRouter
@end
#import "TinyPart.h"

@implementation TestRouter
TPROUTER_AUTO_REGISTER  // 自動(dòng)注冊(cè)路由

// APP身份驗(yàn)證，需要實(shí)現(xiàn)TPMediatorDelegate中的身份驗(yàn)證回調(diào)
TPRouter_AUTH_REQUIRE(@"action1", @"action2")

TPROUTER_METHOD_EXPORT(action1, {
    NSLog(@"TestRouter action1 params=%@", params);
    return nil;
});

TPROUTER_METHOD_EXPORT(action2, {
    NSLog(@"TestRouter action2 params=%@", params);
    return nil;
});
@end

如果沒有使用TPROUTER_AUTO_REGISTER自動(dòng)注冊(cè)宏的話，還需要將TestModuleService1加到TinyPart.plist配置文件中。

使用路由Router

[[TPMediator sharedInstance] performAction:@"action1" router:@"Test" params:@{}];

URL路由

新建TinyPart.bundle/TinyPart.plist，并注冊(cè)一條URL Scheme





	APPURLSchemes
	
		tinypart

定義一條URL路由規(guī)則。在已有的TestRouter基礎(chǔ)上，我們只需要新建一個(gè)TPMediator+Test的擴(kuò)展。

@implementation TPMediator (Test)
+ (void)load {
    // 聲明TestRouter對(duì)應(yīng)的Host
    TPURLHostForRouter(@"com.tinypart.test", TestRouter) // tinypart://com.tinypart.test
    
    // 聲明TestRouter中action1對(duì)應(yīng)的Path
    TPURLPathForActionForRouter(@"/action1", action1, TestRouter);  // tinypart://com.tinypart.test/action1
}
@end

使用URL路由

NSURL *url = [NSURL URLWithString:@"tinypart://com.tinypart.test/action1?id=1&name=tinypart"];
[[TPMediator sharedInstance] openURL:url];

有向通信

發(fā)送。這里注意前面提到的，底層模塊對(duì)上層模塊的通知稱為廣播Broadcast，上層模塊對(duì)底層模塊或者同層模塊的通知稱為上報(bào)Report。模塊級(jí)別分為Basic、Middle、Topout三個(gè)級(jí)別。

TPNotificationCenter *center2 = [TestModule2 tp_notificationCenter];

[center2 reportNotification:^(TPNotificationMaker *make) {
    make.name(@"report_notification_from_TestModule2");
} targetModule:@"TestModule1"];
    
[center2 broadcastNotification:^(TPNotificationMaker *make) {
	make.name(@"broadcast_notification_from_TestModule2").userInfo(@{@"key":@"value"}).object(self);
}];

接收

TPNotificationCenter *center1 = [TestModule1 tp_notificationCenter];
// Observer銷毀后自動(dòng)釋放
[center1 addObserver:self selector:@selector(testNotification:) name:@"report_notification_from_TestModule2" object:nil];