源码整理

appbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Wed Nov 12 20:28:00 GMT 2025
+#Wed Nov 12 21:06:14 GMT 2025
 stageCount=10
 libraryProject=libappbase
 baseVersion=15.10
 publishVersion=15.10.9
-buildCount=22
+buildCount=27
 baseBetaVersion=15.10.10

appbase/src/main/java/cc/winboll/studio/appbase/App.java

@@ -1,27 +1,40 @@
 package cc.winboll.studio.appbase;
 
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+
 /**
  * @Author ZhanGSKen<zhangsken@qq.com>
  * @Date 2025/01/05 09:54:42
- * @Describe APPbase 应用类
+ * @Describe 应用全局入口类（继承基础库 GlobalApplication）
+ * 负责应用初始化、全局资源管理与生命周期回调处理，是整个应用的核心入口
  */
-import cc.winboll.studio.libappbase.GlobalApplication;
-import cc.winboll.studio.libappbase.ToastUtils;
-
 public class App extends GlobalApplication {
 
+    /** 当前应用类的日志 TAG（用于调试输出，标识日志来源） */
     public static final String TAG = "App";
-    
+
+    /**
+     * 应用创建时回调（全局初始化入口）
+     * 在应用进程启动时执行，仅调用一次，用于初始化全局工具类、第三方库等
+     */
     @Override
     public void onCreate() {
-        super.onCreate();
-		ToastUtils.init(getApplicationContext());
-		
+        super.onCreate(); // 调用父类初始化逻辑（如基础库配置、全局上下文设置）
+        // 初始化 Toast 工具类（传入应用全局上下文，确保 Toast 可在任意地方调用）
+        ToastUtils.init(getApplicationContext());
     }
 
-	@Override
-	public void onTerminate() {
-		super.onTerminate();
-		ToastUtils.release();
-	}
+    /**
+     * 应用终止时回调（资源释放入口）
+     * 仅在模拟环境（如 Android Studio 模拟器）中可靠触发，真机上可能因系统回收进程不执行
+     * 用于释放全局资源，避免内存泄漏
+     */
+    @Override
+    public void onTerminate() {
+        super.onTerminate(); // 调用父类终止逻辑（如基础库资源释放）
+        // 释放 Toast 工具类资源（销毁全局 Toast 实例，避免内存泄漏）
+        ToastUtils.release();
+    }
 }
+

appbase/src/main/java/cc/winboll/studio/appbase/MainActivity.java

@@ -14,75 +14,127 @@ import cc.winboll.studio.libappbase.LogActivity;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.ToastUtils;
 
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 未标注（建议补充创建日期）
+ * @Describe 应用主界面 Activity（入口界面）
+ * 包含功能测试按钮（崩溃测试、日志查看、Toast测试）、顶部工具栏（菜单功能），是应用交互的核心入口
+ */
 public class MainActivity extends Activity {
 
+    /** 当前 Activity 的日志 TAG（用于调试输出，标识日志来源） */
     public static final String TAG = "MainActivity";
 
-    Toolbar mToolbar;
+    /** 顶部工具栏（用于展示标题、菜单，绑定布局中的 Toolbar 控件） */
+    private Toolbar mToolbar;
 
+    /**
+     * Activity 创建时回调（初始化界面）
+     * 在 Activity 首次创建时执行，用于加载布局、初始化控件、设置事件监听
+     * @param savedInstanceState 保存 Activity 状态的 Bundle（如屏幕旋转时的数据恢复）
+     */
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        ToastUtils.show("onCreate");
-        setContentView(R.layout.activity_main);
+        ToastUtils.show("onCreate"); // 显示 Activity 创建提示（调试用）
+        setContentView(R.layout.activity_main); // 加载主界面布局
 
+        // 初始化 Toolbar 并设置为 ActionBar
         mToolbar = findViewById(R.id.toolbar);
-        setActionBar(mToolbar);
+        setActionBar(mToolbar); // 将 Toolbar 替代系统默认 ActionBar
     }
 
+    /**
+     * 创建菜单时回调（加载工具栏菜单）
+     * 初始化 ActionBar 菜单，加载自定义菜单布局
+     * @param menu 菜单对象（用于承载菜单项）
+     * @return true：显示菜单；false：不显示菜单
+     */
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
+        // 加载菜单布局（R.menu.toolbar_main 为自定义菜单文件）
         getMenuInflater().inflate(R.menu.toolbar_main, menu);
         return super.onCreateOptionsMenu(menu);
     }
 
+    /**
+     * 菜单 item 点击时回调（处理菜单事件）
+     * 响应 Toolbar 菜单项的点击事件，执行对应业务逻辑
+     * @param item 被点击的菜单项
+     * @return true：消费点击事件；false：不消费（传递给父类）
+     */
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
-		switch (item.getItemId()) {
-			case R.id.item_home : {
-					openWebsiteInBrowser(this);
-				}
-		}
-        // 在switch语句中处理每个ID，并在处理完后返回true，未处理的情况返回false。
+        switch (item.getItemId()) {
+            case R.id.item_home:
+                // 点击 "首页/官网" 菜单项，唤起浏览器打开指定网站
+                openWebsiteInBrowser(this);
+                break;
+				// 可扩展其他菜单项（如设置、关于等）的处理逻辑
+        }
         return super.onOptionsItemSelected(item);
     }
 
+    /**
+     * 崩溃测试按钮点击事件（触发应用崩溃，用于调试异常捕获）
+     * 故意执行非法操作（循环获取不存在的字符串资源），强制应用崩溃
+     * @param view 触发事件的 View（对应布局中的崩溃测试按钮）
+     */
     public void onCrashTest(View view) {
-		for (int i = Integer.MIN_VALUE; i < Integer.MAX_VALUE; i++) {
-			getString(i);
-		}
+        // 循环从 Integer.MIN_VALUE 到 Integer.MAX_VALUE，获取不存在的字符串资源 ID，触发崩溃
+        for (int i = Integer.MIN_VALUE; i < Integer.MAX_VALUE; i++) {
+            getString(i); // i 超出资源 ID 范围，抛出 Resources.NotFoundException 导致崩溃
+        }
     }
 
+    /**
+     * 日志测试按钮点击事件（打开日志查看界面）
+     * 启动 LogActivity，用于查看应用运行日志
+     * @param view 触发事件的 View（对应布局中的日志测试按钮）
+     */
     public void onLogTest(View view) {
+        // 启动日志查看 Activity（通过静态方法传入上下文，简化跳转逻辑）
         LogActivity.startLogActivity(this);
     }
-	
-	public void onToastUtilsTest(View view) {
-		LogUtils.d(TAG, "onToastUtilsTest");
-        ToastUtils.show("Hello, WinBoLL!");
-		new Thread(new Runnable(){
+
+    /**
+     * Toast 工具测试按钮点击事件（测试全局 Toast 功能）
+     * 测试主线程、子线程中 Toast 的显示效果，验证 ToastUtils 的可用性
+     * @param view 触发事件的 View（对应布局中的 Toast 测试按钮）
+     */
+    public void onToastUtilsTest(View view) {
+        LogUtils.d(TAG, "onToastUtilsTest"); // 打印调试日志，标识进入 Toast 测试
+        ToastUtils.show("Hello, WinBoLL!"); // 主线程显示 Toast
+
+        // 开启子线程，延迟 2 秒后显示 Toast（测试子线程 Toast 兼容性）
+        new Thread(new Runnable() {
 				@Override
 				public void run() {
 					try {
-						Thread.sleep(2000);
+						Thread.sleep(2000); // 线程休眠 2 秒
+						// 若 ToastUtils 已处理主线程切换，此处可直接调用；否则需通过 Handler 切换到主线程
 						ToastUtils.show("Thread.sleep(2000);ToastUtils.show...");
-					} catch (InterruptedException e) {}
+					} catch (InterruptedException e) {
+						// 捕获线程中断异常（如线程被销毁时），不做处理（测试场景）
+						e.printStackTrace();
+					}
 				}
 			}).start();
     }
 
-	/**
-	 * 唤起默认浏览器打开指定网站
-	 * @param context 上下文（如 Activity.this）
-	 */
-	public void openWebsiteInBrowser(Context context) {
-		// 目标网站地址
-		String url = "https://www.winboll.cc";
-		// 构建打开浏览器的意图
-		Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
-		// 设置标志：避免创建新的任务栈（可选，按需求调整）
-		intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-		context.startActivity(intent);
-		
-	}
+    /**
+     * 唤起系统默认浏览器打开指定网站（跳转至应用官网）
+     * 通过 Intent.ACTION_VIEW 隐式意图，触发浏览器打开目标 URL
+     * @param context 上下文对象（如 Activity、Application，此处为 MainActivity）
+     */
+    public void openWebsiteInBrowser(Context context) {
+        String url = "https://www.winboll.cc"; // 目标网站 URL（应用官网）
+        // 构建隐式意图：ACTION_VIEW 表示查看指定数据（Uri 为网站地址）
+        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
+        // 设置标志：在新的任务栈中启动 Activity（避免与当前应用任务栈混淆）
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 启动意图（唤起浏览器）
+        context.startActivity(intent);
+    }
 }
+