Studio/WinBoLL_Bck20251205_175044_440
Archived
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

源码整理

Browse Source
This commit is contained in:
ZhanGSKen
2025-11-11 20:06:11 +08:00
parent dfc8de83d7
commit 02c9776062
7 changed files with 715 additions and 345 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
appbase/build.properties
View File

@@ -1,8 +1,8 @@
#Created by .winboll/winboll_app_build.gradle #Created by .winboll/winboll_app_build.gradle
#Tue Nov 11 11:52:41 GMT 2025 #Tue Nov 11 12:05:37 GMT 2025
stageCount=10 stageCount=10
libraryProject=libappbase libraryProject=libappbase
baseVersion=15.10 baseVersion=15.10
publishVersion=15.10.9 publishVersion=15.10.9
buildCount=2 buildCount=3
baseBetaVersion=15.10.10 baseBetaVersion=15.10.10

4
libappbase/build.properties
View File

@@ -1,8 +1,8 @@
#Created by .winboll/winboll_app_build.gradle #Created by .winboll/winboll_app_build.gradle
#Tue Nov 11 11:52:41 GMT 2025 #Tue Nov 11 12:05:37 GMT 2025
stageCount=10 stageCount=10
libraryProject=libappbase libraryProject=libappbase
baseVersion=15.10 baseVersion=15.10
publishVersion=15.10.9 publishVersion=15.10.9
buildCount=2 buildCount=3
baseBetaVersion=15.10.10 baseBetaVersion=15.10.10

103
libappbase/src/main/java/cc/winboll/studio/libappbase/APPModel.java
View File

@@ -1,73 +1,138 @@
package cc.winboll.studio.libappbase; package cc.winboll.studio.libappbase;
/** /**
* @Author ZhanGSKen<zhangsken@qq.com> * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
* @Date 2025/03/02 10:28:08 * @Date 2025/11/11 20:01
* @Describe 应用调试模型 * @Describe WinBoLL 应用全局数据模型类
* 继承自 BaseBean，用于存储和管理应用的核心配置信息（如调试状态），
* 支持 JSON 序列化/反序列化，便于数据持久化或跨组件传递
*/ */
import android.util.JsonReader; import android.util.JsonReader;
import android.util.JsonWriter; import android.util.JsonWriter;
import cc.winboll.studio.libappbase.BaseBean;
import java.io.IOException; import java.io.IOException;
public class APPModel extends BaseBean { public class APPModel extends BaseBean {
/**
* 日志打印标签，用于区分当前类的日志输出
*/
public static final String TAG = "APPModel"; public static final String TAG = "APPModel";
// 应用是否处于正在调试状态 /**
// * 应用调试状态标识
boolean isDebuging = false; * true：应用处于调试模式（可输出详细日志、启用调试功能等）
* false：应用处于正式模式（关闭调试相关功能，优化性能）
*/
private boolean isDebugging = false; // 修正拼写：原 isDebuging -> isDebugging（符合命名规范）
/**
* 无参构造方法
* 初始化调试状态为默认值：false（正式模式）
*/
public APPModel() { public APPModel() {
this.isDebuging = false; this.isDebugging = false;
} }
public APPModel(boolean isDebuging) { /**
this.isDebuging = isDebuging; * 带参构造方法
* 可通过参数指定应用的初始调试状态
* @param isDebugging 初始调试状态（true：调试模式；false：正式模式）
*/
public APPModel(boolean isDebugging) {
this.isDebugging = isDebugging;
} }
public void setIsDebuging(boolean isDebuging) { /**
this.isDebuging = isDebuging; * 设置应用调试状态
* @param isDebugging 目标调试状态（true：开启调试；false：关闭调试）
*/
public void setIsDebugging(boolean isDebugging) {
this.isDebugging = isDebugging;
} }
public boolean isDebuging() { /**
return isDebuging; * 获取当前应用调试状态
* @return 调试状态（true：调试中；false：非调试）
*/
public boolean isDebugging() {
return isDebugging;
} }
/**
* 重写父类方法，返回当前类的全限定名
* 用于标识数据模型的类类型（可用于反射、序列化校验等场景）
* @return 类的全限定名（如：cc.winboll.studio.libappbase.APPModel）
*/
@Override @Override
public String getName() { public String getName() {
return APPModel.class.getName(); return APPModel.class.getName();
} }
/**
* 重写父类方法，将当前模型的字段序列化到 JSON 中
* 用于将调试状态等核心数据转换为 JSON 格式（如持久化到文件、网络传输）
* @param jsonWriter JSON 写入器对象，用于输出 JSON 数据
* @throws IOException 当 JSON 写入失败时抛出（如流关闭、格式错误）
*/
@Override @Override
public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException { public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
// 先调用父类方法，序列化父类中的字段（若 BaseBean 有可序列化字段）
super.writeThisToJsonWriter(jsonWriter); super.writeThisToJsonWriter(jsonWriter);
jsonWriter.name("isDebuging").value(isDebuging()); // 序列化当前类的调试状态字段：key 为 "isDebuging"（保持与原代码一致，避免兼容性问题），value 为当前状态
jsonWriter.name("isDebuging").value(isDebugging());
} }
/**
* 重写父类方法，从 JSON 中解析字段并初始化当前对象
* 用于将 JSON 格式的配置数据解析为 APPModel 实例（如从文件读取、网络接收后解析）
* @param jsonReader JSON 读取器对象，用于读取 JSON 数据
* @param name 当前解析的 JSON 字段名
* @return true：字段解析成功；false：字段不属于当前类，需由调用者处理
* @throws IOException 当 JSON 读取失败时抛出（如流关闭、数据格式错误）
*/
@Override @Override
public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException { public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else { // 先调用父类方法，解析父类中的字段（若 BaseBean 有可解析字段）
if (name.equals("isDebuging")) { if (super.initObjectsFromJsonReader(jsonReader, name)) {
setIsDebuging(jsonReader.nextBoolean()); return true; // 父类已处理该字段，直接返回成功
} else { } else {
// 解析当前类的字段
if (name.equals("isDebuging")) {
// 读取 JSON 中 "isDebuging" 字段的值，设置为当前对象的调试状态
setIsDebugging(jsonReader.nextBoolean());
} else {
// 字段不属于当前类，返回 false 提示调用者跳过该字段
return false; return false;
} }
} }
// 字段解析成功，返回 true
return true; return true;
} }
/**
* 重写父类方法，从 JSON 读取器中完整解析一个 APPModel 实例
* 负责处理 JSON 对象的开始/结束标记，循环解析所有字段
* @param jsonReader JSON 读取器对象，用于读取 JSON 数据
* @return 解析完成的当前 APPModel 实例（支持链式调用）
* @throws IOException 当 JSON 读取失败时抛出（如流关闭、数据格式错误）
*/
@Override @Override
public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException { public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
// 开始解析 JSON 对象（对应 JSON 中的 '{'）
jsonReader.beginObject(); jsonReader.beginObject();
// 循环读取 JSON 中的所有字段（直到对象结束）
while (jsonReader.hasNext()) { while (jsonReader.hasNext()) {
// 获取当前字段名
String name = jsonReader.nextName(); String name = jsonReader.nextName();
// 解析字段：若当前类无法处理该字段，则跳过（避免解析异常）
if (!initObjectsFromJsonReader(jsonReader, name)) { if (!initObjectsFromJsonReader(jsonReader, name)) {
jsonReader.skipValue(); jsonReader.skipValue();
} }
} }
// 结束 JSON 对象 // 结束解析 JSON 对象（对应 JSON 中的 '}'）
jsonReader.endObject(); jsonReader.endObject();
// 返回解析完成的实例（当前对象）
return this; return this;
} }
} }

337
libappbase/src/main/java/cc/winboll/studio/libappbase/BaseBean.java
View File

@@ -1,9 +1,12 @@
package cc.winboll.studio.libappbase; package cc.winboll.studio.libappbase;
/** /**
* @Author ZhanGSKen<zhangsken@qq.com> * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
* @Date 2025/01/15 11:11:52 * @Date 2025/11/11 20:03
* @Describe Json Bean 基础类。 * @Describe WinBoLL JSON 数据模型基类（抽象类）
* 定义 Json Bean 的核心规范：序列化/反序列化、文件持久化、列表处理等通用逻辑，
* 子类（如 APPModel）需实现抽象方法，实现自身字段的 JSON 读写
* @param <T> 泛型约束，限定子类必须继承自 BaseBean
*/ */
import android.content.Context; import android.content.Context;
import android.util.JsonReader; import android.util.JsonReader;
@@ -16,172 +19,249 @@ import java.util.ArrayList;
public abstract class BaseBean<T extends BaseBean> { public abstract class BaseBean<T extends BaseBean> {
/** 日志标签，用于当前基类的日志输出标识 */
public static final String TAG = "BaseBean"; public static final String TAG = "BaseBean";
/** JSON 中存储 Bean 类名的字段键（用于校验 Bean 类型一致性） */
static final String BEAN_NAME = "BeanName"; static final String BEAN_NAME = "BeanName";
/**
* 无参构造方法（子类需默认实现，支持反射实例化）
*/
public BaseBean() {} public BaseBean() {}
/**
* 抽象方法：获取当前 Bean 的全限定类名
* 子类需实现，用于标识 Bean 类型（序列化/校验时使用）
* @return 类的全限定名（如：cc.winboll.studio.libappbase.APPModel）
*/
public abstract String getName(); public abstract String getName();
/**
* 获取单个 Bean 的 JSON 持久化文件路径
* 路径：外部存储/应用私有目录/BaseBean/[类名].json
* @param context 上下文（用于获取应用存储目录）
* @return 单个 Bean 的文件绝对路径
*/
public String getBeanJsonFilePath(Context context) { public String getBeanJsonFilePath(Context context) {
return context.getExternalFilesDir(TAG) + "/" + getName() + ".json"; return context.getExternalFilesDir(TAG) + "/" + getName() + ".json";
} }
/**
* 获取 Bean 列表的 JSON 持久化文件路径
* 路径：外部存储/应用私有目录/BaseBean/[类名]_List.json
* @param context 上下文（用于获取应用存储目录）
* @return Bean 列表的文件绝对路径
*/
public String getBeanListJsonFilePath(Context context) { public String getBeanListJsonFilePath(Context context) {
return context.getExternalFilesDir(TAG) + "/" + getName() + "_List.json"; return context.getExternalFilesDir(TAG) + "/" + getName() + "_List.json";
} }
/**
* 将 Bean 类名写入 JSON（序列化基础字段）
* 子类可重写扩展，添加自身字段的 JSON 写入逻辑
* @param jsonWriter JSON 写入器（用于输出 JSON 数据）
* @throws IOException JSON 写入失败时抛出（如流异常）
*/
public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException { public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
// 写入 Bean 类名字段（用于反序列化时校验类型）
jsonWriter.name(BEAN_NAME).value(getName()); jsonWriter.name(BEAN_NAME).value(getName());
} }
/**
* 从 JSON 读取字段并初始化 Bean（反序列化基础逻辑）
* 子类需重写，实现自身字段的解析逻辑
* @param jsonReader JSON 读取器（用于读取 JSON 数据）
* @param name 当前解析的 JSON 字段名
* @return true：字段解析成功（当前类处理）；false：字段未处理（需跳过）
* @throws IOException JSON 读取失败时抛出（如流异常）
*/
public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException { public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
return false; return false; // 基类未处理任何字段，返回 false
} }
/**
* 抽象方法：从 JSON 读取器解析并返回 Bean 实例
* 子类需实现，处理自身字段的完整解析逻辑
* @param jsonReader JSON 读取器（用于读取 JSON 数据）
* @return 解析完成的 Bean 实例
* @throws IOException JSON 读取失败时抛出（如流异常）
*/
abstract public T readBeanFromJsonReader(JsonReader jsonReader) throws IOException; abstract public T readBeanFromJsonReader(JsonReader jsonReader) throws IOException;
/**
* 校验 JSON 文件中的 Bean 列表与目标类是否一致
* 对比文件中每个 Bean 的类名与目标类名，返回不一致信息
* @param szFilePath JSON 文件路径（存储 Bean 列表的文件）
* @param clazz 目标 Bean 类（用于校验类型）
* @return 空串：校验一致；非空串：不一致信息（总数/差异数）或异常信息
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> String checkIsTheSameBeanListAndFile(String szFilePath, Class<T> clazz) { public static <T extends BaseBean> String checkIsTheSameBeanListAndFile(String szFilePath, Class<T> clazz) {
StringBuilder sbResult = new StringBuilder(); StringBuilder sbResult = new StringBuilder();
String szErrorInfo = "Check Is The Same Bean List And File Error : "; String szErrorInfo = "Check Is The Same Bean List And File Error : ";
try { try {
int nSameCount = 0; int sameCount = 0; // 类名匹配的 Bean 数量
int nBeanListCout = 0; int totalCount = 0; // 文件中 Bean 总数量
// 反射创建目标 Bean 实例（用于获取类名）
T beanTemp = clazz.newInstance(); T beanTemp = clazz.newInstance();
String szBeanSimpleName = beanTemp.getName(); String targetBeanName = beanTemp.getName();
String szListJson = UTF8FileUtils.readStringFromFile(szFilePath); // 读取文件中的 JSON 字符串
StringReader stringReader = new StringReader(szListJson); String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
StringReader stringReader = new StringReader(listJson);
JsonReader jsonReader = new JsonReader(stringReader); JsonReader jsonReader = new JsonReader(stringReader);
jsonReader.beginArray();
jsonReader.beginArray(); // 开始解析 JSON 数组（Bean 列表）
while (jsonReader.hasNext()) { while (jsonReader.hasNext()) {
nBeanListCout++; totalCount++;
jsonReader.beginObject(); jsonReader.beginObject(); // 开始解析单个 Bean 对象
while (jsonReader.hasNext()) { while (jsonReader.hasNext()) {
String name = jsonReader.nextName(); String name = jsonReader.nextName();
// 只校验 BEAN_NAME 字段，其他字段跳过
if (name.equals(BEAN_NAME)) { if (name.equals(BEAN_NAME)) {
if (szBeanSimpleName.equals(jsonReader.nextString())) { // 对比当前 Bean 类名与目标类名
nSameCount++; if (targetBeanName.equals(jsonReader.nextString())) {
sameCount++;
} }
} else { } else {
jsonReader.skipValue(); jsonReader.skipValue(); // 跳过非目标字段
} }
} }
jsonReader.endObject(); jsonReader.endObject(); // 结束单个 Bean 对象解析
} }
jsonReader.endArray(); jsonReader.endArray(); // 结束 JSON 数组解析
// 返回检查结果 // 生成校验结果
if (nSameCount == nBeanListCout) { if (sameCount == totalCount) {
// 检查一致直接返回空串 return ""; // 全部匹配，返回空串
return "";
} else { } else {
// 检查不一致返回对比信息 // 部分不匹配，返回统计信息
sbResult.append("Total : "); sbResult.append("Total : ").append(totalCount)
sbResult.append(nBeanListCout); .append(" Diff : ").append(totalCount - sameCount);
sbResult.append(" Diff : ");
sbResult.append(nBeanListCout - nSameCount);
} }
} catch (InstantiationException e) { } catch (InstantiationException e) {
sbResult.append(szErrorInfo); // 反射实例化失败（如无无参构造）
sbResult.append(e); sbResult.append(szErrorInfo).append(e);
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} catch (IllegalAccessException e) { } catch (IllegalAccessException e) {
sbResult.append(szErrorInfo); // 反射访问权限异常
sbResult.append(e); sbResult.append(szErrorInfo).append(e);
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} catch (IOException e) { } catch (IOException e) {
sbResult.append(szErrorInfo); // 文件读取或 JSON 解析异常
sbResult.append(e); sbResult.append(szErrorInfo).append(e);
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return sbResult.toString(); return sbResult.toString();
} }
/**
* 将 JSON 字符串解析为目标 Bean 实例
* 通过反射创建 Bean 实例，调用子类解析逻辑完成初始化
* @param szBean JSON 字符串（单个 Bean 的 JSON 数据）
* @param clazz 目标 Bean 类（用于反射实例化）
* @return 解析成功的 Bean 实例；失败返回 null
* @throws IOException JSON 解析失败时抛出
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> T parseStringToBean(String szBean, Class<T> clazz) throws IOException { public static <T extends BaseBean> T parseStringToBean(String szBean, Class<T> clazz) throws IOException {
// 创建 JsonWriter 对象
StringReader stringReader = new StringReader(szBean); StringReader stringReader = new StringReader(szBean);
JsonReader jsonReader = new JsonReader(stringReader); JsonReader jsonReader = new JsonReader(stringReader);
try { try {
// 反射创建 Bean 实例
T beanTemp = clazz.newInstance(); T beanTemp = clazz.newInstance();
// 调用子类解析方法，返回解析后的实例
return (T) beanTemp.readBeanFromJsonReader(jsonReader); return (T) beanTemp.readBeanFromJsonReader(jsonReader);
} catch (InstantiationException e) { } catch (InstantiationException | IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); // 反射异常日志记录
} catch (IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return null; return null;
} }
/**
* 将 JSON 字符串解析为 Bean 列表
* 清空目标列表，将解析后的 Bean 逐个添加到列表中
* @param szBeanList JSON 字符串（Bean 列表的 JSON 数组）
* @param beanList 目标列表（存储解析后的 Bean）
* @param clazz 目标 Bean 类（用于反射实例化）
* @return true：解析成功；false：解析失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean parseStringToBeanList(String szBeanList, ArrayList<T> beanList, Class<T> clazz) { public static <T extends BaseBean> boolean parseStringToBeanList(String szBeanList, ArrayList<T> beanList, Class<T> clazz) {
try { try {
// 初始化目标列表（为空则创建，非空则清空）
if (beanList == null) { if (beanList == null) {
beanList = new ArrayList<T>(); beanList = new ArrayList<T>();
} else { } else {
beanList.clear(); beanList.clear();
} }
StringReader stringReader = new StringReader(szBeanList); StringReader stringReader = new StringReader(szBeanList);
JsonReader jsonReader = new JsonReader(stringReader); JsonReader jsonReader = new JsonReader(stringReader);
jsonReader.beginArray();
jsonReader.beginArray(); // 开始解析 JSON 数组
while (jsonReader.hasNext()) { while (jsonReader.hasNext()) {
// 反射创建 Bean 实例，解析并添加到列表
T beanTemp = clazz.newInstance(); T beanTemp = clazz.newInstance();
T bean = (T) beanTemp.readBeanFromJsonReader(jsonReader); T bean = (T) beanTemp.readBeanFromJsonReader(jsonReader);
if (bean != null) { if (bean != null) {
beanList.add(bean); beanList.add(bean);
//LogUtils.d(TAG, "beanList.add(bean)");
} }
} }
jsonReader.endArray(); jsonReader.endArray(); // 结束 JSON 数组解析
return true; return true;
//LogUtils.d(TAG, "beanList.size() is " + Integer.toString(beanList.size())); } catch (InstantiationException | IllegalAccessException | IOException e) {
} catch (InstantiationException e) { // 异常日志记录
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} catch (IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} catch (IOException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return false; return false;
} }
/**
* 重写 toString()，将 Bean 序列化为格式化的 JSON 字符串
* 调用自身序列化逻辑，生成带缩进的 JSON（便于调试）
* @return Bean 的 JSON 字符串；失败返回空串
*/
@Override @Override
public String toString() { public String toString() {
// 创建 JsonWriter 对象
StringWriter stringWriter = new StringWriter(); StringWriter stringWriter = new StringWriter();
JsonWriter jsonWriter = new JsonWriter(stringWriter); JsonWriter jsonWriter = new JsonWriter(stringWriter);
jsonWriter.setIndent(" "); jsonWriter.setIndent(" "); // 设置 JSON 缩进（格式化输出）
try {// 开始 JSON 对象
jsonWriter.beginObject(); try {
// 写入键值对 jsonWriter.beginObject(); // 开始 JSON 对象
writeThisToJsonWriter(jsonWriter); writeThisToJsonWriter(jsonWriter); // 写入 Bean 字段（子类扩展）
// 结束 JSON 对象 jsonWriter.endObject(); // 结束 JSON 对象
jsonWriter.endObject();
return stringWriter.toString(); return stringWriter.toString();
} catch (IOException e) { } catch (IOException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
// 获取 JSON 字符串
return ""; return "";
} }
/**
* 将 Bean 列表序列化为格式化的 JSON 字符串
* 遍历列表，逐个序列化每个 Bean，生成 JSON 数组
* @param beanList 待序列化的 Bean 列表
* @return 列表的 JSON 字符串；失败返回空串
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> String toStringByBeanList(ArrayList<T> beanList) { public static <T extends BaseBean> String toStringByBeanList(ArrayList<T> beanList) {
try { try {
StringWriter stringWriter = new StringWriter(); StringWriter stringWriter = new StringWriter();
JsonWriter jsonWriter = new JsonWriter(stringWriter); JsonWriter jsonWriter = new JsonWriter(stringWriter);
jsonWriter.setIndent(" "); jsonWriter.setIndent(" "); // 格式化缩进
jsonWriter.beginArray();
jsonWriter.beginArray(); // 开始 JSON 数组
for (int i = 0; i < beanList.size(); i++) { for (int i = 0; i < beanList.size(); i++) {
// 开始 JSON 对象 jsonWriter.beginObject(); // 单个 Bean 开始
jsonWriter.beginObject(); beanList.get(i).writeThisToJsonWriter(jsonWriter); // 调用 Bean 自身序列化
// 写入键值对 jsonWriter.endObject(); // 单个 Bean 结束
beanList.get(i).writeThisToJsonWriter(jsonWriter);
// 结束 JSON 对象
jsonWriter.endObject();
} }
jsonWriter.endArray(); jsonWriter.endArray(); // 结束 JSON 数组
jsonWriter.close(); jsonWriter.close();
return stringWriter.toString(); return stringWriter.toString();
} catch (IOException e) { } catch (IOException e) {
@@ -190,47 +270,74 @@ public abstract class BaseBean<T extends BaseBean> {
return ""; return "";
} }
/**
* 从默认路径（getBeanJsonFilePath）加载 Bean 实例
* 读取应用私有目录下的 JSON 文件，解析为目标 Bean
* @param context 上下文（用于获取文件路径）
* @param clazz 目标 Bean 类（用于反射实例化）
* @return 加载成功的 Bean 实例；失败返回 null
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> T loadBean(Context context, Class<T> clazz) { public static <T extends BaseBean> T loadBean(Context context, Class<T> clazz) {
try { try {
// 反射创建 Bean 实例，获取默认文件路径
T beanTemp = clazz.newInstance(); T beanTemp = clazz.newInstance();
return loadBeanFromFile(beanTemp.getBeanJsonFilePath(context), clazz); return loadBeanFromFile(beanTemp.getBeanJsonFilePath(context), clazz);
} catch (InstantiationException e) { } catch (InstantiationException | IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} catch (IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return null; return null;
} }
/**
* 从指定文件路径加载 Bean 实例
* 检查文件是否存在，存在则读取 JSON 并解析为目标 Bean
* @param szFilePath 目标文件路径（存储 Bean 的 JSON 文件）
* @param clazz 目标 Bean 类（用于反射实例化）
* @return 加载成功的 Bean 实例；失败返回 null
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> T loadBeanFromFile(String szFilePath, Class<T> clazz) { public static <T extends BaseBean> T loadBeanFromFile(String szFilePath, Class<T> clazz) {
try { try {
try { File file = new File(szFilePath);
File fTemp = new File(szFilePath); if (file.exists()) { // 检查文件是否存在
if (fTemp.exists()) { T beanTemp = clazz.newInstance();
T beanTemp = clazz.newInstance();String szJson = UTF8FileUtils.readStringFromFile(szFilePath); // 读取文件 JSON 字符串，解析为 Bean
return beanTemp.parseStringToBean(szJson, clazz); String json = UTF8FileUtils.readStringFromFile(szFilePath);
return beanTemp.parseStringToBean(json, clazz);
} }
} catch (InstantiationException e) { } catch (InstantiationException | IllegalAccessException | IOException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} catch (IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
}
} catch (IOException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return null; return null;
} }
/**
* 将 Bean 保存到默认路径（getBeanJsonFilePath）的文件中
* 序列化 Bean 为 JSON，写入应用私有目录下的文件
* @param context 上下文（用于获取文件路径）
* @param bean 待保存的 Bean 实例
* @return true：保存成功；false：保存失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean saveBean(Context context, T bean) { public static <T extends BaseBean> boolean saveBean(Context context, T bean) {
return saveBeanToFile(bean.getBeanJsonFilePath(context), bean); return saveBeanToFile(bean.getBeanJsonFilePath(context), bean);
} }
/**
* 将 Bean 保存到指定文件路径
* 序列化 Bean 为 JSON 字符串，写入目标文件（覆盖原有内容）
* @param szFilePath 目标文件路径（保存 JSON 的文件）
* @param bean 待保存的 Bean 实例
* @return true：保存成功；false：保存失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean saveBeanToFile(String szFilePath, T bean) { public static <T extends BaseBean> boolean saveBeanToFile(String szFilePath, T bean) {
try { try {
String szJson = bean.toString(); // 序列化 Bean 为 JSON 字符串
UTF8FileUtils.writeStringToFile(szFilePath, szJson); String json = bean.toString();
// 写入文件（UTF-8 编码）
UTF8FileUtils.writeStringToFile(szFilePath, json);
return true; return true;
} catch (IOException e) { } catch (IOException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
@@ -238,50 +345,92 @@ public abstract class BaseBean<T extends BaseBean> {
return false; return false;
} }
/**
* 从默认路径（getBeanListJsonFilePath）加载 Bean 列表
* 读取应用私有目录下的列表 JSON 文件，解析并填充到目标列表
* @param context 上下文（用于获取文件路径）
* @param beanListDst 目标列表（存储加载后的 Bean）
* @param clazz 目标 Bean 类（用于反射实例化）
* @return true：加载成功；false：加载失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean loadBeanList(Context context, ArrayList<T> beanListDst, Class<T> clazz) { public static <T extends BaseBean> boolean loadBeanList(Context context, ArrayList<T> beanListDst, Class<T> clazz) {
try { try {
// 反射创建 Bean 实例，获取默认列表文件路径
T beanTemp = clazz.newInstance(); T beanTemp = clazz.newInstance();
return loadBeanListFromFile(beanTemp.getBeanListJsonFilePath(context), beanListDst, clazz); return loadBeanListFromFile(beanTemp.getBeanListJsonFilePath(context), beanListDst, clazz);
} catch (InstantiationException e) {} catch (IllegalAccessException e) { } catch (InstantiationException | IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return false; return false;
} }
/**
* 从指定文件路径加载 Bean 列表
* 检查文件是否存在，存在则读取 JSON 数组，解析并填充到目标列表
* @param szFilePath 目标文件路径（存储列表 JSON 的文件）
* @param beanList 目标列表（存储加载后的 Bean）
* @param clazz 目标 Bean 类（用于反射实例化）
* @return true：加载成功；false：加载失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean loadBeanListFromFile(String szFilePath, ArrayList<T> beanList, Class<T> clazz) { public static <T extends BaseBean> boolean loadBeanListFromFile(String szFilePath, ArrayList<T> beanList, Class<T> clazz) {
try { try {
File fTemp = new File(szFilePath); File file = new File(szFilePath);
if (fTemp.exists()) { if (file.exists()) { // 检查文件是否存在
String szListJson = UTF8FileUtils.readStringFromFile(szFilePath); // 读取文件中的 JSON 字符串（Bean 列表数组）
return parseStringToBeanList(szListJson, beanList, clazz); String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
// 解析 JSON 字符串为 Bean 列表，填充到目标列表
return parseStringToBeanList(listJson, beanList, clazz);
} }
} catch (IOException e) { } catch (IOException e) {
// 日志记录文件读取或解析异常
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return false; return false;
} }
/**
* 将 Bean 列表保存到默认路径（getBeanListJsonFilePath）的文件中
* 序列化列表为 JSON 数组，写入应用私有目录下的文件
* @param context 上下文（用于获取文件路径）
* @param beanList 待保存的 Bean 列表
* @param clazz 目标 Bean 类（用于反射获取保存路径）
* @return true：保存成功；false：保存失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean saveBeanList(Context context, ArrayList<T> beanList, Class<T> clazz) { public static <T extends BaseBean> boolean saveBeanList(Context context, ArrayList<T> beanList, Class<T> clazz) {
try { try {
// 反射创建 Bean 实例，获取默认列表保存路径
T beanTemp = clazz.newInstance(); T beanTemp = clazz.newInstance();
return saveBeanListToFile(beanTemp.getBeanListJsonFilePath(context), beanList); return saveBeanListToFile(beanTemp.getBeanListJsonFilePath(context), beanList);
} catch (InstantiationException e) { } catch (InstantiationException | IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); // 日志记录反射实例化异常
} catch (IllegalAccessException e) {
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return false; return false;
} }
/**
* 将 Bean 列表保存到指定文件路径
* 序列化列表为 JSON 数组字符串，写入目标文件（覆盖原有内容）
* @param szFilePath 目标文件路径（保存列表 JSON 的文件）
* @param beanList 待保存的 Bean 列表
* @return true：保存成功；false：保存失败
* @param <T> 泛型约束，限定为 BaseBean 子类
*/
public static <T extends BaseBean> boolean saveBeanListToFile(String szFilePath, ArrayList<T> beanList) { public static <T extends BaseBean> boolean saveBeanListToFile(String szFilePath, ArrayList<T> beanList) {
try { try {
String szJson = toStringByBeanList(beanList); // 序列化 Bean 列表为 JSON 字符串（数组格式）
UTF8FileUtils.writeStringToFile(szFilePath, szJson); String json = toStringByBeanList(beanList);
//LogUtils.d(TAG, "FileUtil.writeFile beanList.size() is " + Integer.toString(beanList.size())); // 将 JSON 字符串写入文件（UTF-8 编码）
UTF8FileUtils.writeStringToFile(szFilePath, json);
return true; return true;
} catch (IOException e) { } catch (IOException e) {
// 日志记录文件写入或序列化异常
LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace()); LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
} }
return false; return false;
} }
} }

118
libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalApplication.java
View File

@@ -1,70 +1,134 @@
package cc.winboll.studio.libappbase; package cc.winboll.studio.libappbase;
/** /**
* @Author ZhanGSKen<zhangsken@qq.com> * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
* @Date 2025/01/05 10:10:23 * @Date 2025/11/11 19:56
* @Describe 全局应用类 * @Describe 全局 Application 类，用于初始化应用核心组件、管理全局状态（如调试模式）
* 需在 AndroidManifest.xml 中配置 android:name=".GlobalApplication" 使其生效
*/ */
import android.app.Application; import android.app.Application;
import android.content.Context; import android.content.Context;
import android.content.pm.ApplicationInfo; import android.content.pm.ApplicationInfo;
import android.content.pm.PackageManager; import android.content.pm.PackageManager;
import cc.winboll.studio.libappbase.GlobalApplication; import android.content.pm.PackageManager.NameNotFoundException;
public class GlobalApplication extends Application { public class GlobalApplication extends Application {
/** 日志标签 */
public static final String TAG = "GlobalApplication"; public static final String TAG = "GlobalApplication";
// 应用是否处于调试状态 /**
volatile static boolean isDebuging = false; * 应用调试模式标记（volatile 保证多线程可见性）
* true：调试模式（开启日志、调试功能）；false：正式模式（关闭调试相关功能）
*/
private static volatile boolean isDebugging = false;
public static void setIsDebuging(boolean isDebuging) { /**
GlobalApplication.isDebuging = isDebuging; * 设置应用调试模式
* @param debugging 调试模式状态（true/false）
*/
public static void setIsDebugging(boolean debugging) {
isDebugging = debugging;
} }
public static void saveDebugStatus(Context context) { /**
APPModel.saveBeanToFile(getAPPModelFilePath(context), new APPModel(GlobalApplication.isDebuging)); * 保存调试模式状态到本地文件（持久化存储，重启应用后生效）
* @param application 全局 Application 实例（通过 getInstance() 获取更规范，此处保留原有参数）
*/
public static void saveDebugStatus(GlobalApplication application) {
// 将调试状态封装为 APPModel 并保存到文件
APPModel.saveBeanToFile(
getAppModelFilePath(application),
new APPModel(isDebugging)
);
} }
static String getAPPModelFilePath(Context context) { /**
return context.getDataDir().getPath() + "/APPModel.json"; * 获取 APPModel 配置文件的存储路径
* 路径：应用私有数据目录 / APPModel.json（仅当前应用可访问，安全）
* @param application 全局 Application 实例
* @return 配置文件绝对路径
*/
private static String getAppModelFilePath(GlobalApplication application) {
return application.getDataDir().getPath() + "/APPModel.json";
} }
public static boolean isDebuging() { /**
return isDebuging; * 获取当前应用调试模式状态
* @return true：调试模式；false：正式模式
*/
public static boolean isDebugging() {
return isDebugging;
} }
/**
* 应用启动时初始化（仅执行一次）
* 初始化核心框架、恢复调试状态、配置全局异常处理等
*/
@Override @Override
public void onCreate() { public void onCreate() {
super.onCreate(); super.onCreate();
setIsDebuging(true); // 初始化基础组件（日志、崩溃处理、Toast）
// 添加日志模块 initCoreComponents();
LogUtils.init(this); // 恢复/初始化调试模式状态（从本地文件读取，无文件则默认关闭调试）
// 设置应用异常处理窗口 restoreDebugStatus();
CrashHandler.init(this); }
// 初始化 Toast 框架
ToastUtils.init(this); /**
* 初始化应用核心组件（日志、崩溃处理、Toast 框架）
*/
private void initCoreComponents() {
// 初始化日志工具（传入 Application 上下文）
LogUtils.init(this);
// 初始化全局异常处理器（捕获应用崩溃信息，用于调试或上报）
CrashHandler.init(this);
// 初始化 Toast 工具（统一 Toast 样式、避免内存泄漏等）
ToastUtils.init(this);
}
/**
* 恢复调试模式状态（从本地配置文件读取）
* 1. 读取本地 APPModel.json 文件
* 2. 读取成功：使用保存的调试状态；读取失败（文件不存在）：默认关闭调试并创建配置文件
*/
private void restoreDebugStatus() {
// 从文件加载 APPModel 实例（存储调试状态的模型类）
APPModel appModel = APPModel.loadBeanFromFile(
getAppModelFilePath(this),
APPModel.class
);
// 应用保存的调试标志
APPModel appModel = APPModel.loadBeanFromFile(getAPPModelFilePath(this), APPModel.class);
if (appModel == null) { if (appModel == null) {
setIsDebuging(false); // 配置文件不存在，默认关闭调试模式并创建文件
setIsDebugging(false);
saveDebugStatus(this); saveDebugStatus(this);
} else { } else {
setIsDebuging(appModel.isDebuging()); // 配置文件存在，使用保存的调试状态
setIsDebugging(appModel.isDebugging());
} }
} }
/**
* 获取应用名称（从 AndroidManifest.xml 的 android:label 读取）
* @param context 上下文（建议传入 Application 上下文，避免内存泄漏）
* @return 应用名称（读取失败返回 null）
*/
public static String getAppName(Context context) { public static String getAppName(Context context) {
PackageManager packageManager = context.getPackageManager(); PackageManager packageManager = context.getPackageManager();
try { try {
// 获取应用信息（包含应用名称、图标等）
ApplicationInfo applicationInfo = packageManager.getApplicationInfo( ApplicationInfo applicationInfo = packageManager.getApplicationInfo(
context.getPackageName(), 0); context.getPackageName(), // 当前应用包名
0 // 额外标志（0 表示默认获取基本信息）
);
// 从应用信息中获取应用名称（支持多语言）
return (String) packageManager.getApplicationLabel(applicationInfo); return (String) packageManager.getApplicationLabel(applicationInfo);
} catch (PackageManager.NameNotFoundException e) { } catch (NameNotFoundException e) {
// 包名不存在（理论上不会发生，捕获异常避免崩溃）
e.printStackTrace(); e.printStackTrace();
} }
return null; return null;
} }
} }

166
libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashActivity.java
View File

@@ -1,8 +1,11 @@
package cc.winboll.studio.libappbase; package cc.winboll.studio.libappbase;
/** /**
* @Author ZhanGSKen<zhangsken@qq.com> * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
* @Date 2025/02/11 00:14:05 * @Date 2025/11/11 19:58
* @Describe 应用异常报告观察活动窗口类
* 核心功能：应用发生未捕获崩溃时，由 CrashHandler 启动此页面，展示崩溃日志详情，
* 并提供「复制日志」「重启应用」操作入口，便于开发者定位问题和用户恢复应用
*/ */
import android.app.Activity; import android.app.Activity;
import android.content.ClipData; import android.content.ClipData;
@@ -18,77 +21,166 @@ import cc.winboll.studio.libappbase.R;
public final class GlobalCrashActivity extends Activity implements MenuItem.OnMenuItemClickListener { public final class GlobalCrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
private static final int MENUITEM_COPY = 0; /** 日志标签（用于调试日志输出，唯一标识当前 Activity） */
private static final int MENUITEM_RESTART = 1;
GlobalCrashReportView mGlobalCrashReportView;
String mLog;
public static final String TAG = "GlobalCrashActivity"; public static final String TAG = "GlobalCrashActivity";
/** 菜单标识：复制崩溃日志（用于区分菜单项点击事件） */
private static final int MENU_ITEM_COPY = 0;
/** 菜单标识：重启应用（用于区分菜单项点击事件） */
private static final int MENU_ITEM_RESTART = 1;
/** 崩溃报告展示自定义视图 */
// 负责渲染崩溃日志文本、提供 Toolbar 容器，封装了日志展示和菜单样式控制逻辑
private GlobalCrashReportView mCrashReportView;
/** 崩溃日志文本内容 */
// 从 CrashHandler 通过 Intent 传递过来，包含异常堆栈、设备信息等完整崩溃数据
private String mCrashLog;
/**
* Activity 创建时初始化（生命周期核心方法，仅执行一次）
* @param savedInstanceState 保存的实例状态（崩溃页面无需恢复状态，此处仅作兼容）
*/
@Override @Override
protected void onCreate(Bundle savedInstanceState) { protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); super.onCreate(savedInstanceState);
CrashHandler.AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
mLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_INFO); // 初始化崩溃安全防护机制
//setTheme(android.R.style.Theme_Holo_Light_NoActionBar); // 作用：防止应用重启后短时间内再次崩溃，由 CrashHandler 内部实现防护逻辑
//setTheme(R.style.APPBaseTheme); CrashHandler.AppCrashSafetyWire.getInstance()
.postResumeCrashSafetyWireHandler(getApplicationContext());
// 从 Intent 中获取崩溃日志数据（EXTRA_CRASH_INFO 为 CrashHandler 定义的常量键）
mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_INFO);
// 设置当前 Activity 的布局文件（展示崩溃报告的 UI 结构）
setContentView(R.layout.activity_globalcrash); setContentView(R.layout.activity_globalcrash);
mGlobalCrashReportView = findViewById(R.id.activityglobalcrashGlobalCrashReportView1);
mGlobalCrashReportView.setReport(mLog);
setActionBar(mGlobalCrashReportView.getToolbar());
// 初始化崩溃报告展示视图（通过布局 ID 找到自定义 View 实例）
mCrashReportView = findViewById(R.id.activityglobalcrashGlobalCrashReportView1);
// 将崩溃日志设置到视图中，由自定义 View 负责排版和显示
mCrashReportView.setReport(mCrashLog);
// 设置页面的 ActionBar（复用自定义 View 中的 Toolbar 作为系统 ActionBar）
setActionBar(mCrashReportView.getToolbar());
// 配置 ActionBar 标题和副标题（非空判断避免空指针异常）
if (getActionBar() != null) {
// 设置标题：使用 CrashHandler 中定义的统一标题（如 "应用崩溃报告"）
getActionBar().setTitle(CrashHandler.TITTLE); getActionBar().setTitle(CrashHandler.TITTLE);
// 设置副标题：显示当前应用名称（从全局 Application 工具方法获取）
getActionBar().setSubtitle(GlobalApplication.getAppName(getApplicationContext())); getActionBar().setSubtitle(GlobalApplication.getAppName(getApplicationContext()));
} }
}
/**
* 重写返回键点击事件
* 逻辑：点击手机返回键时，直接重启应用（而非返回上一页，因崩溃后上一页状态可能异常）
*/
@Override @Override
public void onBackPressed() { public void onBackPressed() {
restart(); restartApp();
} }
private void restart() { /**
PackageManager pm = getPackageManager(); * 重启当前应用（核心工具方法）
Intent intent = pm.getLaunchIntentForPackage(getPackageName()); * 实现逻辑：
if (intent != null) { * 1. 获取应用的启动意图（默认启动 AndroidManifest 中配置的主 Activity）
intent.addFlags( * 2. 设置意图标志，清除原有任务栈，避免残留异常页面
Intent.FLAG_ACTIVITY_NEW_TASK * 3. 启动主 Activity 并终止当前进程，确保应用完全重启
| Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_CLEAR_TASK */
); private void restartApp() {
startActivity(intent); // 获取 PackageManager 实例（用于获取应用相关信息和意图）
PackageManager packageManager = getPackageManager();
// 获取应用的启动意图（参数为当前应用包名，返回主 Activity 的意图）
Intent launchIntent = packageManager.getLaunchIntentForPackage(getPackageName());
if (launchIntent != null) {
// 设置意图标志：
// FLAG_ACTIVITY_NEW_TASK：创建新的任务栈启动 Activity
// FLAG_ACTIVITY_CLEAR_TOP：清除目标 Activity 之上的所有 Activity
// FLAG_ACTIVITY_CLEAR_TASK：清除当前任务栈中的所有 Activity
launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
| Intent.FLAG_ACTIVITY_CLEAR_TOP
| Intent.FLAG_ACTIVITY_CLEAR_TASK);
// 启动应用主 Activity
startActivity(launchIntent);
} }
// 关闭当前崩溃报告页面
finish(); finish();
// 终止当前应用进程（确保释放所有资源，避免内存泄漏）
android.os.Process.killProcess(android.os.Process.myPid()); android.os.Process.killProcess(android.os.Process.myPid());
// 强制退出虚拟机（彻底终止应用，防止残留线程继续运行）
System.exit(0); System.exit(0);
} }
/**
* 菜单项点击事件回调（实现 MenuItem.OnMenuItemClickListener 接口）
* @param item 被点击的菜单项实例
* @return boolean：true 表示事件已消费，不再向下传递；false 表示未消费
*/
@Override @Override
public boolean onMenuItemClick(MenuItem item) { public boolean onMenuItemClick(MenuItem item) {
// 根据菜单项 ID 判断点击的是哪个功能
switch (item.getItemId()) { switch (item.getItemId()) {
case MENUITEM_COPY: case MENU_ITEM_COPY:
ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE); // 点击「复制」菜单，执行复制崩溃日志到剪贴板
cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog)); copyCrashLogToClipboard();
Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
break; break;
case MENUITEM_RESTART: case MENU_ITEM_RESTART:
// 点击「重启」菜单：先恢复崩溃防护机制到最大等级，再重启应用
CrashHandler.AppCrashSafetyWire.getInstance().resumeToMaximumImmediately(); CrashHandler.AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
restart(); restartApp();
break; break;
} }
return false; return false;
} }
/**
* 创建页面顶部菜单（ActionBar 菜单）
* @param menu 菜单容器，用于添加菜单项
* @return boolean：true 表示显示菜单；false 表示不显示
*/
@Override @Override
public boolean onCreateOptionsMenu(Menu menu) { public boolean onCreateOptionsMenu(Menu menu) {
menu.add(0, MENUITEM_COPY, 0, "Copy").setOnMenuItemClickListener(this) // 添加「复制」菜单项：
.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); // 参数说明：菜单组 ID（0 表示默认组）、菜单项 ID（MENU_ITEM_COPY）、排序号（0）、菜单文本（"Copy"）
menu.add(0, MENUITEM_RESTART, 0, "Restart").setOnMenuItemClickListener(this) // setOnMenuItemClickListener(this)：绑定点击事件到当前 Activity
// setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM)：有空间时显示在 ActionBar 上，否则放入溢出菜单
menu.add(0, MENU_ITEM_COPY, 0, "Copy")
.setOnMenuItemClickListener(this)
.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
// 更新菜单文字风格 // 添加「重启」菜单项（参数含义同上）
mGlobalCrashReportView.updateMenuStyle(); menu.add(0, MENU_ITEM_RESTART, 0, "Restart")
.setOnMenuItemClickListener(this)
.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
// 调用自定义视图的方法，更新菜单文字样式（如颜色、字体大小等，由自定义 View 内部实现）
mCrashReportView.updateMenuStyle();
return true; return true;
} }
/**
* 将崩溃日志复制到系统剪贴板（工具方法）
* 功能：用户点击复制菜单后，将完整崩溃日志存入剪贴板，方便粘贴到聊天工具或文档中
*/
private void copyCrashLogToClipboard() {
// 获取系统剪贴板服务（需通过 getSystemService 方法获取）
ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
// 创建剪贴板数据：
// 参数 1：标签（用于标识剪贴板内容来源，此处用应用包名）
// 参数 2：实际复制的文本内容（崩溃日志）
ClipData clipData = ClipData.newPlainText(getPackageName(), mCrashLog);
// 将数据设置到剪贴板（完成复制操作）
clipboardManager.setPrimaryClip(clipData);
// 显示复制成功的 Toast 提示（告知用户操作结果）
Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
} }
}

2
libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtils.java
View File

@@ -60,7 +60,7 @@ public class LogUtils {
// 初始化函数 // 初始化函数
// //
public static void init(Context context, LOG_LEVEL logLevel) { public static void init(Context context, LOG_LEVEL logLevel) {
if (GlobalApplication.isDebuging()) { if (GlobalApplication.isDebugging()) {
// 初始化日志缓存文件路径 // 初始化日志缓存文件路径
_mfLogCacheDir = new File(context.getApplicationContext().getExternalCacheDir(), TAG); _mfLogCacheDir = new File(context.getApplicationContext().getExternalCacheDir(), TAG);
if (!_mfLogCacheDir.exists()) { if (!_mfLogCacheDir.exists()) {