优化框架的代码写法

优化框架的使用的文档
移动 ResultException 类
移动 TokenException 类
新增 LifecycleAppFragment 类
修改 LifecycleService 类的回调时机
修正 Get 请求不能存在多个同名参数的问题
修复 USE_CACHE_AFTER_FAILURE 没有重新写入缓存的 Bug

Author: getActivity

.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: https://raw.githubusercontent.com/getActivity/Donate/master/picture/pay_ali.png

.github/ISSUE_TEMPLATE/issue_template_bug.md

@@ -0,0 +1,41 @@
+---
+name: 提交 Bug
+about: 请告诉我框架存在的问题，我会协助你解决此问题！
+labels: bug
+assignees: getActivity
+
+---
+
+## 问题描述
+
+* 框架版本：XXX
+
+* 问题描述：XXX
+
+* 复现步骤：XXX
+
+* 是否必现：填是/否
+
+* 手机信息：例如某米 9 / Android 10
+
+## 请回答
+
+* 是部分机型还是所有机型都会出现：部分/全部（例如：某为，某 Android 版本会出现）
+
+* 框架最新的版本是否存在这个问题：是/否（如果用的是旧版本的话，建议升级看问题是否还存在）
+
+* 是否已经查阅框架文档还未能解决的：是/否（文档会提供最常见的问题解答，可以看看是否有自己想要的）
+
+* issue 是否有人曾提过类似的问题：是/否（看看曾经有人提过类似的问题，先参考一下别人是怎么解决的）
+
+* 是否可以通过 Demo 来复现该问题：是/否（排查一下是不是自己的项目代码写得有问题导致的）
+
+* 使用原生 API 是否会出现该问题：是/否（排查一下是不是框架的代码写法存在问题导致的）
+
+## 其他
+
+* 提供报错堆栈（如果有报错的话必填）
+
+* 提供截图或视频（根据需要提供，此项不强制）
+
+* 提供解决方案（如果已经解决了的话，此项不强制）

.github/ISSUE_TEMPLATE/issue_template_suggest.md

@@ -0,0 +1,13 @@
+---
+name: 提交建议
+about: 请告诉我框架的不足之处，让我做得更好！
+labels: bug
+assignees: getActivity
+
+---
+
+## 建议收集
+
+* 你觉得框架有什么不足之处？（必答项，你可以描述框架有什么令你不满意的地方）
+
+* 你觉得该怎么去完善会比较好？（非必答项，你可以提供一下自己的想法或者做法供作者参考）

.github/workflows/android.yml

@@ -0,0 +1,17 @@
+name: Android CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: set up JDK 1.8
+      uses: actions/setup-java@v1
+      with:
+        java-version: 1.8
+    - name: Build with Gradle
+      run: ./gradlew build aR

HelpDoc.md

@@ -354,7 +354,7 @@ EasyHttp.post(this)
 
 * **需要注意的是：如果上传的文件过多或者过大，可能会导致请求超时，可以重新设置本次请求超时时间，超时时间建议根据文件大小而定，具体设置超时方式文档有介绍，可以在本页面直接搜索。**
 
-* 当然除了可以使用 **File** 类型的对象进行上传，还可以使用 **FileContentResolver** / **InputStream** / **RequestBody** 类型的对象进行上传，如果你需要批量上传，请使用 `List<File>` 或者 `List<MultipartBody.Part>` 类型的对象来做批量上传。
+* 当然除了可以使用 `File` 类型的对象进行上传，还可以使用 `FileContentResolver`、`InputStream`、`RequestBody`、`MultipartBody.Part` 类型的对象进行上传，如果你需要批量上传，请使用 `List<File>`、`List<FileContentResolver>`、`List<InputStream>`、`List<RequestBody>`、`List<MultipartBody.Part>`、 类型的对象来做批量上传。
 
 #### 下载文件
 
@@ -400,6 +400,8 @@ EasyHttp.download(this)
 
 #### 同步请求
 
+* 需要注意的是：同步请求是耗时操作，不能在主线程中执行，请务必保证此操作在子线程中执行
+
 ```java
 PostRequest postRequest = EasyHttp.post(MainActivity.this);
 try {
@@ -433,7 +435,7 @@ public final class RequestHandler implements IRequestHandler {
 
     @Override
     public Object readCache(HttpRequest<?> httpRequest, Type type, long cacheTime) {
-        String cacheKey = GsonFactory.getSingletonGson().toJson(api);
+        String cacheKey = GsonFactory.getSingletonGson().toJson(httpRequest.getRequestApi());
         String cacheValue = mMmkv.getString(cacheKey, null);
         if (cacheValue == null || "".equals(cacheValue) || "{}".equals(cacheValue)) {
             return null;
@@ -447,7 +449,7 @@ public final class RequestHandler implements IRequestHandler {
 
     @Override
     public boolean writeCache(HttpRequest<?> httpRequest, Response response, Object result) {
-        String cacheKey = GsonFactory.getSingletonGson().toJson(api);
+        String cacheKey = GsonFactory.getSingletonGson().toJson(httpRequest.getRequestApi());
         String cacheValue = GsonFactory.getSingletonGson().toJson(result);
         if (cacheValue == null || "".equals(cacheValue) || "{}".equals(cacheValue)) {
             return false;
@@ -479,16 +481,16 @@ public enum CacheMode {
     /**
      * 只使用缓存
      *
-     * 有缓存的情况下：读取缓存 -> 回调成功
-     * 无缓存的情况下：请求网络 -> 写入缓存 -> 回调成功
+     * 已有缓存的情况下：读取缓存 -> 回调成功
+     * 没有缓存的情况下：请求网络 -> 写入缓存 -> 回调成功
      */
     USE_CACHE_ONLY,
 
     /**
      * 优先使用缓存
      *
-     * 有缓存的情况下：先读缓存 —> 回调成功 —> 请求网络 —> 刷新缓存
-     * 无缓存的情况下：请求网络 -> 写入缓存 -> 回调成功
+     * 已有缓存的情况下：先读缓存 —> 回调成功 —> 请求网络 —> 刷新缓存
+     * 没有缓存的情况下：请求网络 -> 写入缓存 -> 回调成功
      */
     USE_CACHE_FIRST,
 
@@ -1114,9 +1116,9 @@ EasyHttp.post(this)
 
 #### 框架只能传入 LifecycleOwner 该怎么办
 
-* 其中 AndroidX.AppCompatActivity 和 AndroidX.Fragment 都是 LifecycleOwner 子类的，这个是毋庸置疑的
+* 其中 `androidx.appcompat.app.AppCompatActivity` 和 `androidx.fragment.app.Fragment` 都是 LifecycleOwner 子类的，这个是毋庸置疑的，可以直接当做 LifecycleOwner 传给框架
 
-* 但是你如果传入的是 Activity 对象，并非 AppCompatActivity 对象，那么你可以这样写
+* 但是你如果传入的是 `android.app.Activity` 对象，并非 `androidx.appcompat.app.AppCompatActivity` 对象，那么你可以这样写
 
 ```java
 EasyHttp.post(new ActivityLifecycle(this))
@@ -1130,32 +1132,9 @@ EasyHttp.post(new ActivityLifecycle(this))
         });
 ```
 
-* 你如果想在 Service 中使用 EasyHttp，请将 Service 直接继承框架中的 LifecycleService 类，又或者在项目中封装一个带有 Lifecycle 特性的 Service 基类，具体实现如下：
-
-```java
-public abstract class LifecycleService extends Service implements LifecycleOwner {
-
-    private final LifecycleRegistry mLifecycle = new LifecycleRegistry(this);
-
-    @NonNull
-    @Override
-    public Lifecycle getLifecycle() {
-        return mLifecycle;
-    }
-
-    @Override
-    public void onCreate() {
-        super.onCreate();
-        mLifecycle.handleLifecycleEvent(Lifecycle.Event.ON_CREATE);
-    }
+* 如果你传入的是 `android.app.Fragment` 对象，并非 `androidx.fragment.app.Fragment` 对象，请将 Fragment 直接继承框架中的 LifecycleAppFragment 类，又或者在项目中封装一个带有 Lifecycle 特性的 Fragment 基类
 
-    @Override
-    public void onDestroy() {
-        super.onDestroy();
-        mLifecycle.handleLifecycleEvent(Lifecycle.Event.ON_DESTROY);
-    }
-}
-```
+* 你如果想在 `android.app.Service` 中使用 EasyHttp，请将 Service 直接继承框架中的 LifecycleService 类，又或者在项目中封装一个带有 Lifecycle 特性的 Service 基类
 
 * 如果以上条件都不满足，但是你就是想在某个地方请求网络，那么你可以这样写
 

README.md

@@ -4,7 +4,7 @@
 
 * 博客地址：[网络请求，如斯优雅](https://www.jianshu.com/p/93cd59dec002)
 
-* 可以扫码下载 Demo 进行演示或者测试，如果扫码下载不了的，[点击此处下载Demo](https://github.com/getActivity/EasyHttp/releases/download/10.6/EasyHttp.apk)
+* 可以扫码下载 Demo 进行演示或者测试，如果扫码下载不了的，[点击此处下载Demo](https://github.com/getActivity/EasyHttp/releases/download/10.8/EasyHttp.apk)
 
 ![](picture/demo_code.png)
 
@@ -26,22 +26,29 @@
 
 #### 集成步骤
 
-* 在项目根目录下的 `build.gradle` 文件中加入
+* 如果你的项目 Gradle 配置是在 `7.0 以下`，需要在 `build.gradle` 文件中加入
 
 ```groovy
-buildscript {
+allprojects {
     repositories {
+        // JitPack 远程仓库：https://jitpack.io
         maven { url 'https://jitpack.io' }
     }
 }
-allprojects {
+```
+
+* 如果你的 Gradle 配置是 `7.0 及以上`，则需要在 `settings.gradle` 文件中加入
+
+```groovy
+dependencyResolutionManagement {
     repositories {
+        // JitPack 远程仓库：https://jitpack.io
         maven { url 'https://jitpack.io' }
     }
 }
 ```
 
-* 在项目 app 模块下的 `build.gradle` 文件中加入
+* 配置完远程仓库后，在项目 app 模块下的 `build.gradle` 文件中加入远程依赖
 
 ```groovy
 android {
@@ -54,7 +61,7 @@ android {
 
 dependencies {
     // 网络请求框架：https://github.com/getActivity/EasyHttp
-    implementation 'com.github.getActivity:EasyHttp:10.6'
+    implementation 'com.github.getActivity:EasyHttp:10.8'
     // OkHttp 框架：https://github.com/square/okhttp
     // noinspection GradleDependency
     implementation 'com.squareup.okhttp3:okhttp:3.12.13'
@@ -67,9 +74,9 @@ dependencies {
 
 |  功能或细节  | [EasyHttp](https://github.com/getActivity/EasyHttp) | [Retrofit](https://github.com/square/retrofit)  | [OkGo](https://github.com/jeasonlzy/okhttp-OkGo) |
 | :----: | :------: |  :-----: |  :-----: |
-|    对应版本  |  10.6 |  2.9.0  |  3.0.4    |
+|    对应版本  |  10.8 |  2.9.0  |  3.0.4    |
 |    issues 数   |  [![](https://img.shields.io/github/issues/getActivity/EasyHttp.svg)](https://github.com/getActivity/EasyHttp/issues)  |  [![](https://img.shields.io/github/issues/square/retrofit.svg)](https://github.com/square/retrofit/issues)  |  [![](https://img.shields.io/github/issues/jeasonlzy/okhttp-OkGo.svg)](https://github.com/jeasonlzy/okhttp-OkGo/issues)  |
-|    **aar 包大小**  |  78 KB  | 123 KB  |  131 KB  |
+|    **aar 包大小**  |  80 KB  | 123 KB  |  131 KB  |
 |    minSdk 要求  |  API 14+ |  API 21+  |  API 14+   |
 |    配置多域名  |  ✅  |  ❌  |   ✅   |
 |    **动态 Host**  |  ✅  |  ❌  |   ❌   |
@@ -208,23 +215,35 @@ EasyHttp.post(this)
 
 #### 作者的其他开源项目
 
-* 安卓技术中台：[AndroidProject](https://github.com/getActivity/AndroidProject)
+* 安卓技术中台：[AndroidProject](https://github.com/getActivity/AndroidProject) ![](https://img.shields.io/github/stars/getActivity/AndroidProject.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidProject.svg)
+
+* 安卓技术中台 Kt 版：[AndroidProject-Kotlin](https://github.com/getActivity/AndroidProject-Kotlin) ![](https://img.shields.io/github/stars/getActivity/AndroidProject-Kotlin.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidProject-Kotlin.svg)
+
+* 权限框架：[XXPermissions](https://github.com/getActivity/XXPermissions) ![](https://img.shields.io/github/stars/getActivity/XXPermissions.svg) ![](https://img.shields.io/github/forks/getActivity/XXPermissions.svg)
+
+* 吐司框架：[ToastUtils](https://github.com/getActivity/ToastUtils) ![](https://img.shields.io/github/stars/getActivity/ToastUtils.svg) ![](https://img.shields.io/github/forks/getActivity/ToastUtils.svg)
+
+* 标题栏框架：[TitleBar](https://github.com/getActivity/TitleBar) ![](https://img.shields.io/github/stars/getActivity/TitleBar.svg) ![](https://img.shields.io/github/forks/getActivity/TitleBar.svg)
+
+* 悬浮窗框架：[XToast](https://github.com/getActivity/XToast) ![](https://img.shields.io/github/stars/getActivity/XToast.svg) ![](https://img.shields.io/github/forks/getActivity/XToast.svg)
+
+* Shape 框架：[ShapeView](https://github.com/getActivity/ShapeView) ![](https://img.shields.io/github/stars/getActivity/ShapeView.svg) ![](https://img.shields.io/github/forks/getActivity/ShapeView.svg)
 
-* 权限框架：[XXPermissions](https://github.com/getActivity/XXPermissions)
+* 语种切换框架：[MultiLanguages](https://github.com/getActivity/MultiLanguages) ![](https://img.shields.io/github/stars/getActivity/MultiLanguages.svg) ![](https://img.shields.io/github/forks/getActivity/MultiLanguages.svg)
 
-* 吐司框架：[ToastUtils](https://github.com/getActivity/ToastUtils)
+* Gson 解析容错：[GsonFactory](https://github.com/getActivity/GsonFactory) ![](https://img.shields.io/github/stars/getActivity/GsonFactory.svg) ![](https://img.shields.io/github/forks/getActivity/GsonFactory.svg)
 
-* 标题栏框架：[TitleBar](https://github.com/getActivity/TitleBar)
+* 日志查看框架：[Logcat](https://github.com/getActivity/Logcat) ![](https://img.shields.io/github/stars/getActivity/Logcat.svg) ![](https://img.shields.io/github/forks/getActivity/Logcat.svg)
 
-* 国际化框架：[MultiLanguages](https://github.com/getActivity/MultiLanguages)
+* Android 版本适配：[AndroidVersionAdapter](https://github.com/getActivity/AndroidVersionAdapter) ![](https://img.shields.io/github/stars/getActivity/AndroidVersionAdapter.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidVersionAdapter.svg)
 
-* 悬浮窗框架：[XToast](https://github.com/getActivity/XToast)
+* Android 代码规范：[AndroidCodeStandard](https://github.com/getActivity/AndroidCodeStandard) ![](https://img.shields.io/github/stars/getActivity/AndroidCodeStandard.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidCodeStandard.svg)
 
-* Shape 框架：[ShapeView](https://github.com/getActivity/ShapeView)
+* Studio 精品插件：[StudioPlugins](https://github.com/getActivity/StudioPlugins) ![](https://img.shields.io/github/stars/getActivity/StudioPlugins.svg) ![](https://img.shields.io/github/forks/getActivity/StudioPlugins.svg)
 
-* Gson 解析容错：[GsonFactory](https://github.com/getActivity/GsonFactory)
+* 表情包大集合：[EmojiPackage](https://github.com/getActivity/EmojiPackage) ![](https://img.shields.io/github/stars/getActivity/EmojiPackage.svg) ![](https://img.shields.io/github/forks/getActivity/EmojiPackage.svg)
 
-* 日志查看框架：[Logcat](https://github.com/getActivity/Logcat)
+* 省市区 Json 数据：[ProvinceJson](https://github.com/getActivity/ProvinceJson) ![](https://img.shields.io/github/stars/getActivity/ProvinceJson.svg) ![](https://img.shields.io/github/forks/getActivity/ProvinceJson.svg)
 
 #### 微信公众号：Android轮子哥
 

app/build.gradle

@@ -13,8 +13,8 @@ android {
         applicationId 'com.hjq.easy.demo'
         minSdkVersion 16
         targetSdkVersion 31
-        versionCode 1060
-        versionName '10.6'
+        versionCode 1080
+        versionName '10.8'
     }
 
     // 支持 JDK 1.8
@@ -71,21 +71,21 @@ dependencies {
     implementation 'com.squareup.okhttp3:okhttp:3.12.13'
 
     // 吐司框架：https://github.com/getActivity/ToastUtils
-    implementation 'com.github.getActivity:ToastUtils:9.6'
+    implementation 'com.github.getActivity:ToastUtils:10.0'
 
     // 权限请求框架：https://github.com/getActivity/XXPermissions
-    implementation 'com.github.getActivity:XXPermissions:12.8'
+    implementation 'com.github.getActivity:XXPermissions:13.2'
 
     // 标题栏框架：https://github.com/getActivity/TitleBar
-    implementation 'com.github.getActivity:TitleBar:9.2'
+    implementation 'com.github.getActivity:TitleBar:9.3'
 
     // Json 解析框架：https://github.com/google/gson
     implementation 'com.google.code.gson:gson:2.8.9'
     // Gson 解析容错：https://github.com/getActivity/GsonFactory
     implementation 'com.github.getActivity:GsonFactory:5.2'
 
     // 日志调试框架：https://github.com/getActivity/Logcat
-    debugImplementation 'com.github.getActivity:Logcat:9.9'
+    debugImplementation 'com.github.getActivity:Logcat:10.0'
 
     // 腾讯 MMKV：https://github.com/Tencent/MMKV
     implementation 'com.tencent:mmkv-static:1.2.11'

app/src/main/AndroidManifest.xml

@@ -32,6 +32,16 @@
             android:name="ScopedStorage"
             android:value="true" />
 
+        <!-- 悬浮窗入口 -->
+        <meta-data
+            android:name="LogcatWindowEntrance"
+            android:value="true" />
+
+        <!-- 通知栏入口 -->
+        <meta-data
+            android:name="LogcatNotifyEntrance"
+            android:value="true" />
+
         <!-- 适配 Android 7.0 文件意图 -->
         <provider
             android:name="androidx.core.content.FileProvider"
@@ -59,4 +69,14 @@
 
     </application>
 
+    <!-- Android 11 软件包可见性适配 -->
+    <queries>
+
+        <!-- 调起其他页面意图：Intent.ACTION_VIEW -->
+        <intent>
+            <action android:name="android.intent.action.VIEW" />
+        </intent>
+
+    </queries>
+
 </manifest>

app/src/main/java/com/hjq/easy/demo/MainActivity.java

@@ -16,6 +16,8 @@
 import androidx.core.content.ContextCompat;
 import androidx.core.content.FileProvider;
 
+import com.hjq.bar.OnTitleBarListener;
+import com.hjq.bar.TitleBar;
 import com.hjq.easy.demo.http.api.SearchAuthorApi;
 import com.hjq.easy.demo.http.api.SearchBlogsApi;
 import com.hjq.easy.demo.http.api.UpdateImageApi;
@@ -64,6 +66,17 @@ protected void onCreate(Bundle savedInstanceState) {
         findViewById(R.id.btn_main_exec).setOnClickListener(this);
         findViewById(R.id.btn_main_update).setOnClickListener(this);
         findViewById(R.id.btn_main_download).setOnClickListener(this);
+
+        TitleBar titleBar = findViewById(R.id.tb_main_bar);
+        titleBar.setOnTitleBarListener(new OnTitleBarListener() {
+            @Override
+            public void onTitleClick(TitleBar titleBar) {
+                Intent intent = new Intent(Intent.ACTION_VIEW);
+                intent.setData(Uri.parse(titleBar.getTitle().toString()));
+                startActivity(intent);
+            }
+        });
+
         requestPermission();
     }