取得 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() 封裝上述邏輯。