see 07/23 log

Blankj · Blankj · commit 7f247e7ec66c · 2019-07-23T09:04:35.000+08:00
diff --git a/buildSrc/src/main/groovy/Config.groovy b/buildSrc/src/main/groovy/Config.groovy
@@ -25,7 +25,7 @@ class Config {
     // appConfig &#37197;&#32622;&#30340;&#26159;&#21487;&#20197;&#36305; app &#30340;&#27169;&#22359;&#65292;git &#25552;&#20132;&#21153;&#24517;&#21482;&#21253;&#21547; launcher
     static appConfig = ['launcher']
     // pkgConfig &#37197;&#32622;&#30340;&#26159;&#35201;&#20381;&#36182;&#30340;&#21151;&#33021;&#21253;&#65292;&#20026;&#31354;&#21017;&#20381;&#36182;&#20840;&#37096;&#65292;git &#25552;&#20132;&#21153;&#24517;&#20026;&#31354;
-    static pkgConfig = ['utilcode']
+    static pkgConfig = []
 
     static depConfig = [
             plugin           : [
diff --git a/feature/utilcode/pkg/src/main/java/com/blankj/utilcode/pkg/feature/language/LanguageActivity.kt b/feature/utilcode/pkg/src/main/java/com/blankj/utilcode/pkg/feature/language/LanguageActivity.kt
@@ -54,7 +54,7 @@ class LanguageActivity : CommonTitleActivity() {
         when (view.id) {
             R.id.languageApp -> ToastUtils.showLong(R.string.language)
             R.id.languageActivity -> ToastUtils.showLong(getString(R.string.language))
-            R.id.applySimpleChineseLanguage -> LanguageUtils.applyLanguage(Locale.SIMPLIFIED_CHINESE, "com.blankj.launcher.pkg.MainActivity")
+            R.id.applySimpleChineseLanguage -> LanguageUtils.applyLanguage(Locale.SIMPLIFIED_CHINESE, "com.blankj.main.pkg.MainActivity")
             R.id.applyAmericanLanguage -> LanguageUtils.applyLanguage(Locale.US, "")
             R.id.applySystemLanguage -> LanguageUtils.applySystemLanguage("")
         }
diff --git a/plugin/api-gradle-plugin/README.md b/plugin/api-gradle-plugin/README.md
@@ -176,7 +176,7 @@ MainResult result = ApiUtils.getApi(MainApi.class)
 &#35201;&#24819;&#24037;&#20855;&#29992;&#24471;&#33298;&#26381;&#65292;&#35268;&#33539;&#32943;&#23450;&#35201;&#36981;&#23432;&#30340;&#65292;&#25152;&#35859;&#26080;&#35268;&#30697;&#19981;&#25104;&#26041;&#22278;&#65292;&#19981;&#28982;&#20116;&#33457;&#20843;&#38376;&#30340;&#38382;&#39064;&#32943;&#23450;&#19968;&#22534;&#22534;&#65292;&#36825;&#37324;&#25512;&#33616;&#22914;&#19979;&#35268;&#33539;&#65306;
 
 * `impl` &#21644; `api` &#24212;&#35813;&#37117;&#26159; `public` &#30340;&#65292;&#32780;&#19988; `impl` &#20013;&#24212;&#35813;&#21482;&#23384;&#22312;&#19968;&#20010;&#26080;&#21442;&#30340; `public` &#26500;&#36896;&#20989;&#25968;&#65288;&#40664;&#35748;&#19981;&#20889;&#21363;&#21487;&#65289;&#12290;
-* `api` &#20013;&#20462;&#25913;&#25509;&#21475;&#19981;&#35201;&#22312;&#32769;&#30340;&#25509;&#21475;&#19978;&#21160;&#25163;&#33050;&#65292;&#26356;&#19981;&#35201;&#21024;&#38500;&#32769;&#30340;&#25509;&#21475;&#65292;&#32780;&#24212;&#35813;&#24314;&#31435;&#26032;&#30340;&#25509;&#21475;&#21518;&#65292;&#36890;&#30693;&#19994;&#21153;&#26041;&#26469;&#35843;&#29992;&#26032;&#30340;&#25509;&#21475;&#65292;&#36824;&#26159;&#19978;&#38754;&#30340;&#36339;&#36716; `main` &#30340;&#20363;&#23376;&#65292;&#30001;&#20110;&#25105;&#20204;&#21069;&#26399;&#25509;&#21475;&#35774;&#35745;&#26377;&#38382;&#39064;&#65292;&#38656;&#35201;&#26032;&#22686;&#19968;&#20010; `UserInfo` &#30340;&#21442;&#25968;&#65292;&#20855;&#20307;&#22914;&#19979;&#25152;&#31034;&#65306;
+* `api` &#20013;&#25509;&#21475;&#30340;&#20462;&#25913;&#25105;&#20204;&#36981;&#24490;&#31867;&#20284;&#20110;&#23448;&#26041; Android SDK &#30340;&#21319;&#32423;&#65292;&#22823;&#37096;&#20998;&#24773;&#20917;&#26159;&#26032;&#25509;&#21475;&#30340;&#20986;&#29616;&#38656;&#35201;&#20860;&#23481;&#32769;&#25509;&#21475;&#65292;&#22914;&#26524;&#32769;&#25509;&#21475;&#24182;&#19981;&#24433;&#21709;&#21151;&#33021;&#30340;&#27491;&#24120;&#20351;&#29992;&#65292;&#20063;&#23601;&#26080;&#38656;&#36890;&#30693;&#19994;&#21153;&#26041;&#26356;&#26032;&#20026;&#26032;&#25509;&#21475;&#65292;&#26032;&#30340;&#25509;&#21475;&#19968;&#33324;&#37117;&#26159;&#26032;&#30340;&#19994;&#21153;&#26041;&#26469;&#35843;&#29992;&#65307;&#38500;&#38750;&#32769;&#30340;&#25509;&#21475;&#23384;&#26377;&#38382;&#39064;&#25110;&#28431;&#27934;&#65292;&#25105;&#20204;&#26126;&#30830;&#38656;&#35201;&#21024;&#38500;&#23427;&#65292;&#37027;&#22312;&#21024;&#38500;&#23427;&#30340;&#21516;&#26102;&#65292;&#25105;&#20204;&#36824;&#38656;&#35201;&#25226;&#19994;&#21153;&#20013;&#35843;&#29992;&#32769;&#25509;&#21475;&#30340;&#22320;&#26041;&#32479;&#19968;&#26367;&#25442;&#20026;&#26032;&#30340;&#25509;&#21475;&#65292;&#31867;&#20284;&#20110;&#25105;&#20204;&#21319;&#32423; Android SDK &#30340;&#26102;&#20505;&#65292;&#26576;&#20123; `api` &#26126;&#30830;&#34987;&#23448;&#26041;&#21024;&#38500;&#20102;&#65292;&#37027;&#25105;&#20204;&#23601;&#38656;&#35201;&#24378;&#34892;&#26367;&#25442;&#20026;&#26032;&#30340;&#25509;&#21475;&#12290;&#36824;&#26159;&#19978;&#38754;&#30340;&#36339;&#36716; `main` &#30340;&#20363;&#23376;&#65292;&#30001;&#20110;&#26032;&#30340;&#19994;&#21153;&#22312;&#36339;&#36716;&#30340;&#26102;&#20505;&#38656;&#26032;&#22686;&#19968;&#20010; `UserInfo` &#30340;&#21442;&#25968;&#65292;&#20855;&#20307;&#22914;&#19979;&#25152;&#31034;&#65306;
 ```java
 // old
 public abstract class MainApi extends ApiUtils.BaseApi {
@@ -185,7 +185,6 @@ public abstract class MainApi extends ApiUtils.BaseApi {
 
 // good
 public abstract class MainApi extends ApiUtils.BaseApi {
-    @Deprecated
     public abstract MainResult startMainActivity(Context context, MainParam param);
 
     public abstract MainResult startMainActivity(Context context, MainParam param, UserInfo info);
diff --git a/plugin/bus-gradle-plugin/README.md b/plugin/bus-gradle-plugin/README.md
@@ -1,10 +1,10 @@
-## &#27604; EventBus &#26356;&#39640;&#25928;&#30340;&#20107;&#20214;&#24635;&#32447;&#65288;BusUtils&#65289;
+# &#27604; EventBus &#26356;&#39640;&#25928;&#30340;&#20107;&#20214;&#24635;&#32447;&#65288;BusUtils&#65289;
 
 ## &#32972;&#26223;
 
 &#35774;&#35745;&#36825;&#20010; `BusUtils` &#20854;&#23454;&#26159;&#22312;&#20570; [ApiUtils](https://github.com/Blankj/AndroidUtilCode/tree/master/plugin/api-gradle-plugin) &#26102;&#39034;&#25163;&#20570;&#30340;&#65292;&#22240;&#20026;&#20004;&#32773;&#23454;&#29616;&#26041;&#24335;&#22522;&#26412;&#19968;&#33268;&#65292;&#35774;&#35745;&#21069;&#25105;&#20063;&#27809;&#24819;&#30528;&#35201;&#21644; greenrobot &#30340; `EventBus` &#19968;&#36739;&#39640;&#20302;&#65292;&#20294;&#35774;&#35745;&#23436;&#24635;&#38656;&#35201;&#19968;&#20010;&#23545;&#27604;&#65292;&#25152;&#20197;&#23601;&#25343;&#19994;&#30028;&#26368;&#20248;&#31168;&#30340;&#20107;&#20214;&#24635;&#32447; `EventBus` &#27604;&#36739;&#19968;&#19979;&#21543;&#65292;&#28982;&#21518;&#23601;&#21457;&#29616;&#25105;&#36825;&#21306;&#21306; 300 &#34892;&#19981;&#21040;&#30340; `BusUtils` &#24615;&#33021;&#27604; `EventBus` &#35201;&#39640;&#20986;&#22909;&#22810;&#65292;&#24403;&#28982;&#65292;&#36825;&#19968;&#20999;&#30340;&#21069;&#25552;&#37117;&#26159;&#22312; `BusUtils` &#26159;&#20999;&#23454;&#21487;&#29992;&#24182;&#19988;&#26377;&#25928;&#30340;&#65292;&#23427;&#20063;&#26159;&#19968;&#27454;&#32447;&#31243;&#23433;&#20840;&#30340;&#20107;&#20214;&#24635;&#32447;&#65292;&#36825;&#20123;&#25105;&#37117;&#22312;&#21333;&#27979;&#20013;&#26377;&#20570;&#36807;&#23454;&#38469;&#27979;&#35797;&#30340;&#65292;&#19981;&#21561;&#19981;&#25794;&#65292;&#21518;&#38754;&#25105;&#20204;&#25343;&#25968;&#25454;&#35828;&#35805;&#65292;&#26377;&#23567;&#20249;&#20276;&#19981;&#30456;&#20449;&#30340;&#35805;&#20063;&#21487;&#20197;&#36890;&#36807;&#19979;&#36733;&#25105;&#30340;&#28304;&#30721;&#26469;&#27604;&#36739;&#21363;&#21487;&#65292;&#21333;&#27979;&#22320;&#22336;&#65306;[BusUtilsVsEventBusTest](https://github.com/Blankj/AndroidUtilCode/blob/master/lib/utilcode/src/test/java/com/blankj/utilcode/util/BusUtilsVsEventBusTest.java)&#65292;Android &#27979;&#35797;&#22320;&#22336;&#65306;[BusCompareActivity](https://github.com/Blankj/AndroidUtilCode/blob/master/feature/utilcode/pkg/src/main/java/com/blankj/utilcode/pkg/feature/bus/BusCompareActivity.kt)&#65292;`BusUtils` &#22312; **[AucFrame](https://github.com/Blankj/AucFrameTemplate)** &#20013;&#30340;&#20316;&#29992;&#23601;&#26159;&#27169;&#22359;&#20869;&#20256;&#20540;&#65292;&#20854;&#25198;&#28436;&#30340;&#35282;&#33394;&#22914;&#19979;&#25152;&#31034;&#65306;
 
-![BusUtilsPlayer](https://raw.githubusercontent.com/Blankj/AndroidUtilCode/master/art/communication.png)
+![BusUtilsRole](https://raw.githubusercontent.com/Blankj/AndroidUtilCode/master/art/communication.png)
 
 &#19979;&#38754;&#20171;&#32461;&#20854;&#20351;&#29992;&#65306;
 
@@ -314,7 +314,7 @@ private void comparePostTemplate(String name, int subscribeNum, int postTimes) {
 }
 ```
 
-### &#21521; 100 &#20010;&#35746;&#38405;&#32773;&#21457;&#36865; * 10000 &#27425;&#65292;&#20849;&#25191;&#34892; 10 &#27425;&#21462;&#24179;&#22343;&#20540;
+### &#21521; 100 &#20010;&#35746;&#38405;&#32773;&#21457;&#36865; * 100000 &#27425;&#65292;&#20849;&#25191;&#34892; 10 &#27425;&#21462;&#24179;&#22343;&#20540;
 
 ```java
 /**
@@ -390,7 +390,7 @@ public void compareUnregister10000Times() {
 
 &#20026;&#20102;&#26041;&#20415;&#35266;&#23519;&#65292;&#25105;&#20204;&#29983;&#25104;&#19968;&#20221;&#22270;&#34920;&#26469;&#27604;&#36739;&#20004;&#32773;&#20043;&#38388;&#30340;&#24615;&#33021;&#65306;
 
-![BusUtilsVsEventBusChart](https://github.com/Blankj/AndroidUtilCode/blob/master/art/busutil_vs_eventbus.png)
+![BusUtilsVsEventBusChart](https://raw.githubusercontent.com/Blankj/AndroidUtilCode/master/art/busutil_vs_eventbus.png)
 
 &#22270;&#34920;&#20013;&#20998;&#21035;&#23545;&#22235;&#20010;&#20989;&#25968;&#22312; MacOS &#21644; OnePlus6 &#20013;&#30340;&#34920;&#29616;&#36827;&#34892;&#32479;&#35745;&#65292;&#27599;&#20010;&#20989;&#25968;&#20013;&#20174;&#24038;&#21521;&#21491;&#20998;&#21035;&#26159; &#12300;MacOS &#30340; BusUtils&#12301;&#12289;&#12300;MacOS &#30340; EventBus&#12301;&#12289;&#12300;OnePlus6 &#30340; BusUtils&#12301;&#12289;&#12300;OnePlus6 &#30340; EventBus&#12301;&#65292;&#21487;&#20197;&#21457;&#29616;&#65292;BusUtils &#22312;&#27880;&#20876;&#21644;&#27880;&#38144;&#19978;&#22522;&#26412;&#27604; `EventBus` &#35201;&#24555;&#19978;&#22909;&#20960;&#20493;&#65292;BusUtils &#22312;&#21521;&#23569;&#37327;&#35746;&#38405;&#32773;&#21457;&#36865;&#22810;&#27425;&#20107;&#20214;&#27604; `EventBus` &#20063;&#24555;&#19978;&#22909;&#22810;&#65292;&#22312;&#21521;&#22810;&#20010;&#35746;&#38405;&#32773;&#21457;&#36865;&#22810;&#27425;&#20107;&#20214;&#20063;&#27604; `EventBus` &#24555;&#19978;&#20123;&#35768;&#12290;
 

Original file line number	Diff line number	Diff line change
`@@ -54,7 +54,7 @@ class LanguageActivity : CommonTitleActivity() {`
`54`	`54`	`when (view.id) {`
`55`	`55`	`R.id.languageApp -> ToastUtils.showLong(R.string.language)`
`56`	`56`	`R.id.languageActivity -> ToastUtils.showLong(getString(R.string.language))`
`57`		`- R.id.applySimpleChineseLanguage -> LanguageUtils.applyLanguage(Locale.SIMPLIFIED_CHINESE, "com.blankj.launcher.pkg.MainActivity")`
	`57`	`+ R.id.applySimpleChineseLanguage -> LanguageUtils.applyLanguage(Locale.SIMPLIFIED_CHINESE, "com.blankj.main.pkg.MainActivity")`
`58`	`58`	`R.id.applyAmericanLanguage -> LanguageUtils.applyLanguage(Locale.US, "")`
`59`	`59`	`R.id.applySystemLanguage -> LanguageUtils.applySystemLanguage("")`
`60`	`60`	`}`
-Original file line number
+Diff line change
 要想工具用得舒服，规范肯定要遵守的，所谓无规矩不成方圆，不然五花八门的问题肯定一堆堆，这里推荐如下规范：
 * `impl` 和 `api` 应该都是 `public` 的，而且 `impl` 中应该只存在一个无参的 `public` 构造函数（默认不写即可）。
 -* `api` 中修改接口不要在老的接口上动手脚，更不要删除老的接口，而应该建立新的接口后，通知业务方来调用新的接口，还是上面的跳转 `main` 的例子，由于我们前期接口设计有问题，需要新增一个 `UserInfo` 的参数，具体如下所示：
 +* `api` 中接口的修改我们遵循类似于官方 Android SDK 的升级，大部分情况是新接口的出现需要兼容老接口，如果老接口并不影响功能的正常使用，也就无需通知业务方更新为新接口，新的接口一般都是新的业务方来调用；除非老的接口存有问题或漏洞，我们明确需要删除它，那在删除它的同时，我们还需要把业务中调用老接口的地方统一替换为新的接口，类似于我们升级 Android SDK 的时候，某些 `api` 明确被官方删除了，那我们就需要强行替换为新的接口。还是上面的跳转 `main` 的例子，由于新的业务在跳转的时候需新增一个 `UserInfo` 的参数，具体如下所示：
 ```java
 // old
 public abstract class MainApi extends ApiUtils.BaseApi {
 // good
 public abstract class MainApi extends ApiUtils.BaseApi {
 -    @Deprecated
     public abstract MainResult startMainActivity(Context context, MainParam param);
     public abstract MainResult startMainActivity(Context context, MainParam param, UserInfo info);
-Original file line number
+Diff line change
@@ @@ -1,10 +1,10 @@ @@
 -## 比 EventBus 更高效的事件总线（BusUtils）
 +# 比 EventBus 更高效的事件总线（BusUtils）
 ## 背景
 设计这个 `BusUtils` 其实是在做 [ApiUtils](https://github.com/Blankj/AndroidUtilCode/tree/master/plugin/api-gradle-plugin) 时顺手做的，因为两者实现方式基本一致，设计前我也没想着要和 greenrobot 的 `EventBus` 一较高低，但设计完总需要一个对比，所以就拿业界最优秀的事件总线 `EventBus` 比较一下吧，然后就发现我这区区 300 行不到的 `BusUtils` 性能比 `EventBus` 要高出好多，当然，这一切的前提都是在 `BusUtils` 是切实可用并且有效的，它也是一款线程安全的事件总线，这些我都在单测中有做过实际测试的，不吹不擂，后面我们拿数据说话，有小伙伴不相信的话也可以通过下载我的源码来比较即可，单测地址：[BusUtilsVsEventBusTest](https://github.com/Blankj/AndroidUtilCode/blob/master/lib/utilcode/src/test/java/com/blankj/utilcode/util/BusUtilsVsEventBusTest.java)，Android 测试地址：[BusCompareActivity](https://github.com/Blankj/AndroidUtilCode/blob/master/feature/utilcode/pkg/src/main/java/com/blankj/utilcode/pkg/feature/bus/BusCompareActivity.kt)，`BusUtils` 在 **[AucFrame](https://github.com/Blankj/AucFrameTemplate)** 中的作用就是模块内传值，其扮演的角色如下所示：
 -![BusUtilsPlayer](https://raw.githubusercontent.com/Blankj/AndroidUtilCode/master/art/communication.png)
 +![BusUtilsRole](https://raw.githubusercontent.com/Blankj/AndroidUtilCode/master/art/communication.png)
 下面介绍其使用：
+}
 ```
 -### 向 100 个订阅者发送 * 10000 次，共执行 10 次取平均值
 +### 向 100 个订阅者发送 * 100000 次，共执行 10 次取平均值
 ```java
 /**
 为了方便观察，我们生成一份图表来比较两者之间的性能：
 -![BusUtilsVsEventBusChart](https://github.com/Blankj/AndroidUtilCode/blob/master/art/busutil_vs_eventbus.png)
 +![BusUtilsVsEventBusChart](https://raw.githubusercontent.com/Blankj/AndroidUtilCode/master/art/busutil_vs_eventbus.png)
 图表中分别对四个函数在 MacOS 和 OnePlus6 中的表现进行统计，每个函数中从左向右分别是 「MacOS 的 BusUtils」、「MacOS 的 EventBus」、「OnePlus6 的 BusUtils」、「OnePlus6 的 EventBus」，可以发现，BusUtils 在注册和注销上基本比 `EventBus` 要快上好几倍，BusUtils 在向少量订阅者发送多次事件比 `EventBus` 也快上好多，在向多个订阅者发送多次事件也比 `EventBus` 快上些许。