萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 除錯工具類實作:記憶體監控、Log 封裝與效能分析

設計目標

開發階段需要一個輕量、可控的除錯工具類,支援:

  • 統一開關控制所有除錯輸出(正式版自動關閉)
  • 分級日誌(Log.i、System.out)
  • 記憶體即時監控(總量、剩餘、變化量)
  • 背景執行緒定期採樣,不阻塞主執行緒

核心類別:AndroidDebug

public final class AndroidDebug {

    private static boolean sDebugEnabled = false;
    private static Thread sMonitorThread;
    private static long sLastFreeMemory = 0;

    /** 全域開關,建議在 Application.onCreate() 依 BuildConfig.DEBUG 設定 */
    public static void setDebugEnabled(boolean enabled) {
        sDebugEnabled = enabled;
    }

    public static boolean isDebugEnabled() {
        return sDebugEnabled;
    }

    /** 簡易輸出 */
    public static void log(String tag, String msg) {
        if (sDebugEnabled) Log.i(tag, msg);
    }

    public static void println(String msg) {
        if (sDebugEnabled) System.out.println(msg);
    }

    /** 強制 GC(僅供除錯觀察) */
    public static void gc() {
        if (sDebugEnabled) System.gc();
    }

    /** 列印堆記憶體總量 */
    public static void printTotalMemory() {
        if (!sDebugEnabled) return;
        Runtime rt = Runtime.getRuntime();
        println("Total memory: " + formatBytes(rt.totalMemory()));
    }

    /** 列印剩餘記憶體 */
    public static void printFreeMemory() {
        if (!sDebugEnabled) return;
        gc();
        Runtime rt = Runtime.getRuntime();
        println("Free memory: " + formatBytes(rt.freeMemory()));
    }

    /** 列印記憶體變化量(正數=釋放,負數=佔用) */
    public static void printMemoryDelta() {
        if (!sDebugEnabled) return;
        gc();
        Runtime rt = Runtime.getRuntime();
        long freeNow = rt.freeMemory();
        long delta = freeNow - sLastFreeMemory;
        sLastFreeMemory = freeNow;
        if (delta > 0) println("Memory freed: " + formatBytes(delta));
        else if (delta < 0) println("Memory allocated: " + formatBytes(-delta));
    }

    /** 啟動/停止背景記憶體監控(每 100ms 採樣一次) */
    public static void setMemoryMonitoring(boolean enable) {
        if (enable) {
            if (sMonitorThread == null) {
                sMonitorThread = new Thread(() -> {
                    while (!Thread.currentThread().isInterrupted()) {
                        try {
                            Thread.sleep(100);
                            printMemoryDelta();
                        } catch (InterruptedException e) {
                            Thread.currentThread().interrupt();
                        }
                    }
                }, "MemoryMonitor");
                sMonitorThread.setDaemon(true);
                sMonitorThread.start();
            }
        } else {
            if (sMonitorThread != null) {
                sMonitorThread.interrupt();
                sMonitorThread = null;
            }
        }
    }

    private static String formatBytes(long bytes) {
        if (bytes < 1024) return bytes + " B";
        if (bytes < 1024 * 1024) return String.format("%.2f KB", bytes / 1024f);
        return String.format("%.2f MB", bytes / (1024f * 1024f));
    }
}

使用範例

// Application 初始化
public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        AndroidDebug.setDebugEnabled(BuildConfig.DEBUG);
        // 開發期可開啟背景監控
        if (BuildConfig.DEBUG) AndroidDebug.setMemoryMonitoring(true);
    }
}

// 任意處呼叫
AndroidDebug.log("Network", "Request: " + url);
AndroidDebug.printFreeMemory();

進階建議

  • 生產環境零開銷:配合 BuildConfig.DEBUG,Release 版本編譯時自動移除所有除錯代碼(需啟用 R8/ProGuard)。
  • 替代方案:正式專案建議接入 Logger、Timber 等成熟日誌框架,支援標籤、格式化、檔案輸出、崩潰上報。
  • 記憶體分析:針對 OOM 或洩漏,請使用 Android Studio Memory Profiler 或 LeakCanary,比手工採樣更精準。
copyright © 萬盛學電腦網 all rights reserved