萬盛學電腦網

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

Android 取得 SDK 版本號與檢測網路連線狀態工具方法

取得 SDK 版本 (API Level)

public static int getSdkVersion() {
    try {
        return Build.VERSION.SDK_INT; // 推薦:整數常量,API 4+
    } catch (NumberFormatException e) {
        return 0;
    }
}
// 旧版兼容 (已棄用)
public static int getSdkVersionLegacy() {
    try {
        return Integer.valueOf(Build.VERSION.SDK); // 字串如 "28"
    } catch (NumberFormatException e) {
        return 0;
    }
}

檢測網路是否連通

public static boolean isNetworkConnected(Context context) {
    ConnectivityManager cm = (ConnectivityManager) 
            context.getSystemService(Context.CONNECTIVITY_SERVICE);
    if (cm == null) return false;

    // API 29+ 推薦用 NetworkCapabilities
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        Network n = cm.getActiveNetwork();
        if (n == null) return false;
        NetworkCapabilities nc = cm.getNetworkCapabilities(n);
        return nc != null && nc.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
                && nc.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED);
    }

    // API 28 及以下
    NetworkInfo activeInfo = cm.getActiveNetworkInfo();
    return activeInfo != null && activeInfo.isConnected();
}

檢測漫遊狀態 (可選)

public static boolean isRoaming(Context context) {
    ConnectivityManager cm = (ConnectivityManager) 
            context.getSystemService(Context.CONNECTIVITY_SERVICE);
    NetworkInfo info = cm.getActiveNetworkInfo();
    return info != null && info.isRoaming();
}

權限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

最佳實踐

  • 網路請求前「檢查連線」屬防禦性編程,**真正可靠的是發請求後處理失敗/重試** (網路狀態瞬息萬變)。
  • 使用 WorkManager 配合 NetworkType.CONNECTED 約束自動排程延遲任務。
  • Kotlin 擴展函數:Context.isOnline() 封裝上述邏輯。
copyright © 萬盛學電腦網 all rights reserved