您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

Android 官方文檔本地離線閱讀卡頓？一鍵移除 Google 字體與 JS 依賴的 Java 方案

編輯：Java 綜合教學

問題根因

下載 Android 官方文檔離線包（docs-*.zip）後，本地用瀏覽器開啟 index.html 卻極度緩慢、甚至卡死。原因在於 HTML 仍包含指向 Google 伺服器的外部資源：

Google Fonts CSS：fonts.googleapis.com/css?family=Roboto+Condensed、fonts.googleapis.com/css?family=Roboto:light,regular,medium,thin,italic,mediumitalic,bold
Google JS API：www.google.com/jsapi
Analytics/追蹤腳本：developer.android.com/ytblogger_lists_unified.js

瀏覽器嘗試下載這些資源，受限於網路環境導致長時間阻塞渲染。

解決方案：Java 批次清理腳本

編寫一個遞迴掃描工具，將所有 HTML 檔案中的上述外部連結完全移除（替換為空字串），保留本地相對路徑資源，實現真正離線秒開。

核心程式碼

package com.example.androiddoc;

import java.io.*;
import java.nio.file.*;

public class AndroidDocCleaner {
    // 需移除的外部資源片段（精確匹配，含屬性值）
    private static final String[] TARGETS = {
        "<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Roboto+Condensed\">",
        "<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Roboto:light,regular,medium,thin,italic,mediumitalic,bold\" title=\"roboto\">",
        "<script src=\"https://www.google.com/jsapi\" type=\"text/javascript\"></script>",
        "<script src=\"https://developer.android.com/ytblogger_lists_unified.js\" type=\"text/javascript\"></script>"
    };

    public static void main(String[] args) throws IOException {
        if (args.length != 1) {
            System.err.println("用法: java AndroidDocCleaner <文檔根目錄>");
            return;
        }
        Path root = Paths.get(args[0]);
        if (!Files.isDirectory(root)) {
            System.err.println("目錄不存在: " + root);
            return;
        }
        cleanDirectory(root);
        System.out.println("清理完成！");
    }

    private static void cleanDirectory(Path dir) throws IOException {
        try (var stream = Files.walk(dir)) {
            stream.filter(p -> p.toString().endsWith(".html"))
                  .forEach(AndroidDocCleaner::cleanFile);
        }
    }

    private static void cleanFile(Path file) {
        try {
            String content = Files.readString(file);
            boolean changed = false;
            for (String target : TARGETS) {
                if (content.contains(target)) {
                    content = content.replace(target, "");
                    changed = true;
                }
            }
            if (changed) {
                Files.writeString(file, content);
                System.out.println("已清理: " + file);
            }
        } catch (IOException e) {
            System.err.println("處理失敗: " + file + " - " + e.getMessage());
        }
    }
}

使用步驟

將 Android 文檔解壓至目錄（如 D:\android-docs）。
編譯上述 Java 檔案：javac AndroidDocCleaner.java
執行清理：java AndroidDocCleaner D:\android-docs
用瀏覽器開啟 index.html，享受流暢離線閱讀。

進階優化建議

正則表達式：若版本不同導致屬性順序/空白差異，可改用 Pattern.compile("<link[^>]*fonts\\.googleapis\\.com[^>]*>") 等模式匹配。
備份機制：清理前自動複製原目錄至 _backup，防誤刪。
並行處理：大量檔案時用 Files.walk(...).parallelStream() 加速。
保留本地字體：將 Google Fonts 下載至本地 fonts/，並修改 CSS @font-face 指向本地路徑，保持視覺一致性。