1. BHAppDelegate
替代AppDelegate的类,响应UIApplicationDelegate的方法。
该类有以下作用:
- 调用
BHModuleManager
的- (void)triggerEvent:(NSInteger)eventType;
方法,用于向各个模块转发应用事件。 - 更新
BeeHive
的context
数据。
PS
该类代码是非常正宗的AppDelegate写法,具有非常大的参考意义。
2. Module注册
不管哪一种Module注册方法,最终都离不开BHModuleManager
的- (void)registerDynamicModule:(Class)moduleClass;
。
BHModuleManager
有两个重要的属性:
@property(nonatomic, strong) NSMutableArray<NSDictionary *> *BHModuleInfos;
该属性用于保存模块名称、模块等级、是否已实例化的信息。
@property(nonatomic, strong) NSMutableArray *BHModules;
该属性用于保存Module类的实例化对象。
3. Module转发应用事件
UIApplicationDelegate
、BHModuleEventType
、BHModuleProtocol
三者对应关系:
- Initializing the App
/// 响应事件:BHMSetupEvent,对应方法:- (void)modSetUp:(BHContext *)context;
/// 响应事件:BHMInitEvent,对应方法:- (void)modInit:(BHContext *)context;
/// 响应事件:BHMSplashEvent,对应方法:- (void)modSplash:(BHContext *)context;
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(nullable NSDictionary<UIApplicationLaunchOptionsKey, id> *)launchOptions;
- Responding to App Life-Cycle Events
/// 响应事件:BHMDidBecomeActiveEvent,对应方法:- (void)modDidBecomeActive:(BHContext *)context;
- (void)applicationDidBecomeActive:(UIApplication *)application;
/// 响应事件:BHMWillResignActiveEvent,对应方法:- (void)modWillResignActive:(BHContext *)context;
- (void)applicationWillResignActive:(UIApplication *)application;
/// 响应事件:BHMDidEnterBackgroundEvent,对应方法:- (void)modDidEnterBackground:(BHContext *)context;
- (void)applicationDidEnterBackground:(UIApplication *)application;
/// 响应事件:BHMWillEnterForegroundEvent,对应方法:- (void)modWillEnterForeground:(BHContext *)context;
- (void)applicationWillEnterForeground:(UIApplication *)application;
/// 响应事件:BHMWillTerminateEvent,对应方法:- (void)modWillTerminate:(BHContext *)context;
- (void)applicationWillTerminate:(UIApplication *)application;
- Responding to Environment Changes
/// 响应事件:BHMDidReceiveMemoryWarningEvent,对应方法:- (void)modDidReceiveMemoryWaring:(BHContext *)context;
- (void)applicationDidReceiveMemoryWarning:(UIApplication *)application;
- Handling Remote Notification Registration
/// 响应事件:BHMDidRegisterForRemoteNotificationsEvent,对应方法:- (void)modDidRegisterForRemoteNotifications:(BHContext *)context;
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken;
/// 响应事件:BHMDidFailToRegisterForRemoteNotificationsEvent,对应方法:- (void)modDidFailToRegisterForRemoteNotifications:(BHContext *)context;
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error;
/// 响应事件:BHMDidReceiveRemoteNotificationEvent,对应方法:- (void)modDidReceiveRemoteNotification:(BHContext *)context;
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
/// 响应事件:BHMDidReceiveRemoteNotificationEvent,对应方法:- (void)modDidReceiveRemoteNotification:(BHContext *)context;
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo;
/// 响应事件:BHMDidReceiveLocalNotificationEvent,对应方法:- (void)modDidReceiveLocalNotification:(BHContext *)context;
- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification;
- Continuing User Activity and Handling Quick Actions
/// 响应事件:BHMWillContinueUserActivityEvent,对应方法:- (void)modWillContinueUserActivity:(BHContext *)context;
- (BOOL)application:(UIApplication *)application willContinueUserActivityWithType:(NSString *)userActivityType;
/// 响应事件:BHMContinueUserActivityEvent,对应方法:- (void)modContinueUserActivity:(BHContext *)context;
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray<id<UIUserActivityRestoring>> * __nullable restorableObjects))restorationHandler;
/// 响应事件:BHMDidUpdateUserActivityEvent,对应方法:- (void)modDidUpdateContinueUserActivity:(BHContext *)context;
- (void)application:(UIApplication *)application didUpdateUserActivity:(NSUserActivity *)userActivity;
/// 响应事件:BHMDidFailToContinueUserActivityEvent,对应方法:- (void)modDidFailToContinueUserActivity:(BHContext *)context;
- (void)application:(UIApplication *)application didFailToContinueUserActivityWithType:(NSString *)userActivityType error:(NSError *)error;
/// 响应事件:BHMQuickActionEvent,对应方法:- (void)modQuickAction:(BHContext *)context;
- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void(^)(BOOL succeeded))completionHandler;
- Interacting With WatchKit
/// 响应事件:BHMHandleWatchKitExtensionRequestEvent,对应方法:- (void)modHandleWatchKitExtensionRequest:(BHContext *)context;
- (void)application:(UIApplication *)application handleWatchKitExtensionRequest:(nullable NSDictionary *)userInfo reply:(void(^)(NSDictionary * __nullable replyInfo))reply;
- Opening a URL-Specified Resource
/// 响应事件:BHMOpenURLEvent,对应方法:- (void)modOpenURL:(BHContext *)context;
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options;
/// 响应事件:BHMOpenURLEvent,对应方法:- (void)modOpenURL:(BHContext *)context;
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation;
- Receiving Notifications
/// 响应事件:BHMWillPresentNotificationEvent,对应方法:- (void)modWillPresentNotification:(BHContext *)context;
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler;
- Handling the Selection of Custom Actions
/// 响应事件:BHMDidReceiveNotificationResponseEvent,对应方法:- (void)modDidReceiveNotificationResponse:(BHContext *)context;
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler;
4. Service注册
Service的注册离不开BHServiceManager
的- (void)registerService:(Protocol *)service implClass:(Class)implClass;
方法。
BHServiceManager
有一个重要的属性:
@property (nonatomic, strong) NSMutableDictionary *allServicesDict;
该属性用于存放ServiceProtocol和Service类,并且以ServiceProtocol为键名,Service类为键值。
5. Service调用
Service的调用离不开BHServiceManager
的- (id)createService:(Protocol *)service withServiceName:(NSString *)serviceName shouldCache:(BOOL)shouldCache;
方法。
该方法以ServiceProtocol为键名,从allServicesDict
这个属性中搜索Service类。
Service类被找到时,该方法会根据ServiceProtocol的+ (BOOL)singleton;
的返回值,判断返回的Service对象是单例还是多例。如果是单例,调用Service类的+ (id)shareInstance;
方法;如果是多例,调用Service类的+ (instancetype)alloc;
和- (instancetype)init;
方法。