{"id":15032099,"url":"https://github.com/alibaba/beehive","last_synced_at":"2025-05-14T13:07:00.513Z","repository":{"id":49370436,"uuid":"64669556","full_name":"alibaba/BeeHive","owner":"alibaba","description":":honeybee: BeeHive is a solution for iOS Application module programs, it absorbed the Spring Framework API service concept to avoid coupling between modules.","archived":false,"fork":false,"pushed_at":"2020-09-25T03:29:09.000Z","size":441,"stargazers_count":4305,"open_issues_count":45,"forks_count":781,"subscribers_count":163,"default_branch":"master","last_synced_at":"2025-05-12T23:01:56.670Z","etag":null,"topics":["beehive","ios","lifecycle","lifecycle-events","modular","module","plugin","registered-services","service","service-discovery","service-registration"],"latest_commit_sha":null,"homepage":"https://github.com/alibaba/BeeHive/blob/master/README.md","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alibaba.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-01T13:33:11.000Z","updated_at":"2025-05-09T09:28:38.000Z","dependencies_parsed_at":"2022-08-20T18:50:32.141Z","dependency_job_id":null,"html_url":"https://github.com/alibaba/BeeHive","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2FBeeHive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2FBeeHive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2FBeeHive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2FBeeHive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alibaba","download_url":"https://codeload.github.com/alibaba/BeeHive/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149955,"owners_count":22022851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["beehive","ios","lifecycle","lifecycle-events","modular","module","plugin","registered-services","service","service-discovery","service-registration"],"created_at":"2024-09-24T20:17:20.301Z","updated_at":"2025-05-14T13:06:55.500Z","avatar_url":"https://github.com/alibaba.png","language":"Objective-C","readme":"# BeeHive\n\n[![Build Status](https://travis-ci.org/alibaba/BeeHive.svg?branch=master)](https://travis-ci.org/alibaba/BeeHive)\n[![Version](https://img.shields.io/cocoapods/v/BeeHive.svg?style=flat)](https://cocoapods.org/?q=name%3Abeehive)\n[![Platform](https://img.shields.io/cocoapods/p/BeeHive.svg?style=flat)](https://cocoapods.org/?q=name%3Abeehive)\n[![GitHub release](https://img.shields.io/github/release/alibaba/BeeHive.svg)](https://github.com/alibaba/BeeHive/releases)  \n[![Gitter](https://badges.gitter.im/alibaba/BeeHive.svg)](https://gitter.im/alibaba/BeeHive?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge)\n[![GitHub issues](https://img.shields.io/github/issues/alibaba/BeeHive.svg)](https://github.com/alibaba/BeeHive/issues)\n[![License](https://img.shields.io/badge/license-GPL%20v2-4EB1BA.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html)\n\n[:book: English Documentation](README.md) | :book: 中文文档\n\n\u003cimg src=\"http://gtms04.alicdn.com/tps/i4/TB1sc5IIFXXXXXOaXXXmZ78YFXX-1100-600.png_400x400.jpg\" vspace=\"10px\" align=\"right\" \u003e\n\n--------------------------\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n\n- [0. 概述](#0-%E6%A6%82%E8%BF%B0)\n    - [0.1 基本架构](#01-%E5%9F%BA%E6%9C%AC%E6%9E%B6%E6%9E%84)\n    - [0.2 实现特性](#02-%E5%AE%9E%E7%8E%B0%E7%89%B9%E6%80%A7)\n    - [0.3 设计原则](#03-%E8%AE%BE%E8%AE%A1%E5%8E%9F%E5%88%99)\n    - [0.4 项目名来源](#04-%E9%A1%B9%E7%9B%AE%E5%90%8D%E6%9D%A5%E6%BA%90)\n- [1 模块生命周期的事件](#1-%E6%A8%A1%E5%9D%97%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E7%9A%84%E4%BA%8B%E4%BB%B6)\n    - [1.1 系统事件](#11-%E7%B3%BB%E7%BB%9F%E4%BA%8B%E4%BB%B6)\n    - [1.2 通用事件](#12-%E9%80%9A%E7%94%A8%E4%BA%8B%E4%BB%B6)\n    - [1.3 业务自定义事件](#13-%E4%B8%9A%E5%8A%A1%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6)\n- [2. 模块注册](#2-%E6%A8%A1%E5%9D%97%E6%B3%A8%E5%86%8C)\n    - [2.1 静态注册](#21-%E9%9D%99%E6%80%81%E6%B3%A8%E5%86%8C)\n    - [2.2 动态注册](#22-%E5%8A%A8%E6%80%81%E6%B3%A8%E5%86%8C)\n    - [2.3 异步加载](#23-%E5%BC%82%E6%AD%A5%E5%8A%A0%E8%BD%BD)\n- [3. 编程开发](#3-%E7%BC%96%E7%A8%8B%E5%BC%80%E5%8F%91)\n    - [3.1 设置环境变量](#31-%E8%AE%BE%E7%BD%AE%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F)\n    - [3.2 模块初始化](#32-%E6%A8%A1%E5%9D%97%E5%88%9D%E5%A7%8B%E5%8C%96)\n    - [3.3 处理系统事件](#33-%E5%A4%84%E7%90%86%E7%B3%BB%E7%BB%9F%E4%BA%8B%E4%BB%B6)\n    - [3.4 模间调用](#34-%E6%A8%A1%E9%97%B4%E8%B0%83%E7%94%A8)\n        - [3.4.1 定义接口](#341-%E5%AE%9A%E4%B9%89%E6%8E%A5%E5%8F%A3)\n        - [3.4.2 注册`Service`](#342-%E6%B3%A8%E5%86%8Cservice)\n            - [`API`注册](#api%E6%B3%A8%E5%86%8C)\n            - [`BHService.plist`注册](#bhserviceplist%E6%B3%A8%E5%86%8C)\n        - [3.4.3 调用`Service`](#343-%E8%B0%83%E7%94%A8service)\n    - [3.5 单例与多例](#35-%E5%8D%95%E4%BE%8B%E4%B8%8E%E5%A4%9A%E4%BE%8B)\n    - [3.6 上下文环境Context](#36-%E4%B8%8A%E4%B8%8B%E6%96%87%E7%8E%AF%E5%A2%83context)\n- [4. 集成方式](#4-%E9%9B%86%E6%88%90%E6%96%B9%E5%BC%8F)\n    - [`cocoapods`](#cocoapods)\n- [5. 作者](#5-%E4%BD%9C%E8%80%85)\n- [6. 微信沟通群](#6-%E5%BE%AE%E4%BF%A1%E6%B2%9F%E9%80%9A%E7%BE%A4)\n- [7. 开源许可证](#7-%E5%BC%80%E6%BA%90%E8%AE%B8%E5%8F%AF%E8%AF%81)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n# 0. 概述\n\n`BeeHive`是用于`iOS`的`App`模块化编程的框架实现方案，吸收了`Spring`框架`Service`的理念来实现模块间的`API`耦合。\n\n## 0.1 基本架构\n\n![](http://gtms02.alicdn.com/tps/i2/TB1dhyFIFXXXXavaXXX7jjbSFXX-515-233.jpg_400x400.jpg)\n\n## 0.2 实现特性\n\n* 插件化的模块开发运行框架\n* 模块具体实现与接口调用分离\n* 模块生命周期管理，扩展了应用的系统事件\n\n## 0.3 设计原则\n\n因为基于`Spring`的`Service`理念，虽然可以使模块间的具体实现与接口解耦，但无法避免对接口类的依赖关系。\n\n为什么不使用`invoke`以及动态链接库技术实现对接口实现的解耦，类似`Apache`的`DSO`的方式？\n\n主要是考虑学习成本难度以及动态调用实现无法在编译检查阶段检测接口参数变更等问题，动态技术需要更高的编程门槛要求。\n\n## 0.4 项目名来源\n\n`BeeHive`灵感来源于蜂窝。蜂窝是世界上高度模块化的工程结构，六边形的设计能带来无限扩张的可能。所以我们用了`BeeHive`来做为这个项目的命名。\n\n# 1 模块生命周期的事件\n\n`BeeHive`会给每个模块提供生命周期事件，用于与`BeeHive`宿主环境进行必要信息交互，感知模块生命周期的变化。\n\n事件分为三种类型：\n\n* 系统事件\n* 通用事件\n* 业务自定义事件\n\n## 1.1 系统事件\n\n系统事件通常是`Application`生命周期事件，例如`DidBecomeActive`、`WillEnterBackground`等。\n\n系统事件基本工作流如下：\n\n![](https://img.alicdn.com/tps/TB1jHK2NFXXXXXKXVXXXXXXXXXX-1838-822.jpg)\n\n## 1.2 通用事件\n\n在系统事件的基础之上，扩展了应用的通用事件，例如`modSetup`、`modInit`等，可以用于编码实现各插件模块的设置与初始化。\n\n扩展的通用事件如下：\n\n![](https://img.alicdn.com/tps/TB12bOINFXXXXblapXXXXXXXXXX-1848-640.jpg)  \n\n## 1.3 业务自定义事件\n\n如果觉得系统事件、通用事件不足以满足需要，我们还将事件封装简化成`BHAppdelgate`，你可以通过继承 `BHAppdelegate`来扩展自己的事件。\n\n# 2. 模块注册\n\n模块注册的方式有静态注册与动态注册两种。\n\n## 2.1 静态注册\n\n通过在`BeeHive.plist`文件中注册符合`BHModuleProtocol`协议模块类:\n\n![](http://gtms01.alicdn.com/tps/i1/TB114eDIFXXXXcdaXXX6VsMLVXX-998-334.png_400x400.jpg)\n\n## 2.2 动态注册\n\n```objc\n@implementation HomeModule\n\nBH_EXPORT_MODULE()  // 声明该类为模块入口\n\n@end\n```\n\n在模块入口类实现中 使用`BH_EXPORT_MODULE()`宏声明该类为模块入口实现类。\n\n## 2.3 异步加载\n\n如果设置模块导出为`BH_EXPORT_MODULE(YES)`，则会在启动之后第一屏内容展现之前异步执行模块的初始化，可以优化启动时时间消耗。\n\n# 3. 编程开发\n\n`BHModuleProtocol`为各个模块提供了每个模块可以`Hook`的函数，用于实现插件逻辑以及代码实现。\n\n## 3.1 设置环境变量\n\n通过`context.env`可以判断我们的应用环境状态来决定我们如何配置我们的应用。\n\n```objc\n-(void)modSetup:(BHContext *)context\n{\n    switch (context.env) {\n        case BHEnvironmentDev:\n        //....初始化开发环境\n        break;\n        case BHEnvironmentProd:\n        //....初始化生产环境\n        default:\n        break;\n    }\n}\n```\n\n## 3.2 模块初始化\n\n如果模块有需要启动时初始化的逻辑，可以在`modInit`里编写，例如模块注册一个外部模块可以访问的`Service`接口\n\n```objc\n-(void)modInit:(BHContext *)context\n{\n    //注册模块的接口服务\n    [[BeeHive shareInstance] registerService:@protocol(UserTrackServiceProtocol) service:[BHUserTrackViewController class]];\n}\n\n```\n\n## 3.3 处理系统事件\n\n系统的事件会被传递给每个模块，让每个模块自己决定编写业务处理逻辑，比如`3D-Touch`功能\n\n```objc\n-(void)modQuickAction:(BHContext *)context\n{\n    [self process:context.shortcutItem handler:context.scompletionHandler];\n}\n```\n\n## 3.4 模间调用\n\n通过处理`Event`编写各个业务模块可以实现插件化编程，各业务模块之间没有任何依赖，`core`与`module`之间通过`event`交互，实现了插件隔离。但有时候我们需要模块间的相互调用某些功能来协同完成功能。\n\n通常会有三种形式的接口访问形式：\n\n1. 基于接口的实现`Service`访问方式（`Java spring`框架实现）\n1. 基于函数调用约定实现的`Export Method`(`PHP`的`extension`，`ReactNative`的扩展机制)\n1. 基于跨应用实现的`URL Route`模式(`iPhone` `App`之间的互访)\n\n我们目前实现了第一种方式，后续会逐步实现后两种方式。\n\n基于接口`Service`访问的优点是可以编译时检查发现接口的变更，从而及时修正接口问题。缺点是需要依赖接口定义的头文件，通过模块增加得越多，维护接口定义的也有一定工作量。\n\n### 3.4.1 定义接口\n\n以为`HomeServiceProtocol`为例。\n\n```\n@protocol HomeServiceProtocol \u003cNSObject, BHServiceProtocol\u003e\n\n- (void)registerViewController:(UIViewController *)vc title:(NSString *)title iconName:(NSString *)iconName;\n\n@end\n```\n\n### 3.4.2 注册`Service`\n\n有两种方式：\n\n#### `API`注册\n\n```objc\n[[BeeHive shareInstance] registerService:@protocol(HomeServiceProtocol) service:[BHViewController class]];\n```\n\n#### `BHService.plist`注册\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003c!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\"\u003e\n\u003cplist version=\"1.0\"\u003e\n    \u003cdict\u003e\n        \u003ckey\u003eHomeServiceProtocol\u003c/key\u003e\n        \u003cstring\u003eBHViewController\u003c/string\u003e\n    \u003c/dict\u003e\n\u003c/plist\u003e\n\n```\n\n### 3.4.3 调用`Service`\n\n```objc\n#import \"BHService.h\"\n\nid\u003c HomeServiceProtocol \u003e homeVc = [[BeeHive shareInstance] createService:@protocol(HomeServiceProtocol)];\n```\n\n## 3.5 单例与多例\n\n对于有些场景下，我们访问每个声明`Service`的对象，希望对象能保留一些状态，那我们需要声明这个`Service`对象是一个单例对象。\n\n我们只需要在`Service`对象中实现事件函数\n\n声明\n\n```objc\n-(BOOL) singleton\n{\n    return YES;\n}\n\n```\n\n通过`createService`获取的对象则为单例对象，如果实现上面函数返回的是`NO`，则`createService`返回的是多例。\n\n```objc\nid\u003c HomeServiceProtocol \u003e homeVc = [[BeeHive shareInstance] createService:@protocol(HomeServiceProtocol)];\n```\n\n## 3.6 上下文环境Context\n\n* 初始化设置应用的项目信息，并在各模块间共享整个应用程序的信息\n\n```objc\n- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions\n{\n    [BHContext shareInstance].env ＝ BHEnvironmentDev; //定义应用的运行开发环境\n    [BHContext shareInstance].application = application;\n    [BHContext shareInstance].launchOptions = launchOptions;\n    [BHContext shareInstance].moduleConfigName = @\"BeeHive.bundle/CustomModulePlist\";//可选，默认为BeeHive.bundle/BeeHive.plist\n    [BHContext shareInstance].serviceConfigName =  @\"BeeHive.bundle/CustomServicePlist\";//可选，默认为BeeHive.bundle/BHService.plist\n    [[BeeHive shareInstance] setContext:[BHContext shareInstance]];\n\n    [super application:application didFinishLaunchingWithOptions:launchOptions];\n\n    id\u003cHomeServiceProtocol\u003e homeVc = [[BeeHive shareInstance] createService:@protocol(HomeServiceProtocol)];\n\n    if ([homeVc isKindOfClass:[UIViewController class]]) {\n        UINavigationController *navCtrl = [[UINavigationController alloc] initWithRootViewController:(UIViewController*)homeVc];\n\n        self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];\n        self.window.rootViewController = navCtrl;\n        [self.window makeKeyAndVisible];\n    }\n\n    return YES;\n}\n```\n\n更多细节可以参考Example用例。\n\n# 4. 集成方式\n\n## `cocoapods`\n\n```sh\npod \"BeeHive\", '1.1.1'\n```\n\n# 5. 作者\n\n- [一渡](https://github.com/rexqin) shijie.qinsj\\\u003cat\u003ealibaba-inc\\\u003cdot\u003ecom\n- [达兹](https://github.com/SoXeon) dazi.dp\\\u003cat\u003ealibaba-inc\\\u003cdot\u003ecom\n\n# 6. 微信沟通群\n\n微信群已达人数上限，可以通过微信加：dolphinux ，然后邀请进入微信群。\n\n# 7. 开源许可证\n\nBeeHive is available under the GPL license. See the LICENSE file for more info.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fbeehive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falibaba%2Fbeehive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fbeehive/lists"}