Android应用（Kotlin）内部网络使用控制策略：实现应用专属数据管理

object AppPreferences {
    const val PREFS_NAME = "app_network_prefs"
    const val KEY_OFFLINE_MODE = "offline_mode_enabled"
}

import android.content.Context
import android.content.SharedPreferences

class NetworkModeManager(context: Context) {

    private val sharedPreferences: SharedPreferences =
        context.getSharedPreferences(AppPreferences.PREFS_NAME, Context.MODE_PRIVATE)

    /**
     * 设置应用的离线模式状态。
     * @param isOffline true表示启用离线模式，false表示禁用离线模式（在线）。
     */
    fun setOfflineMode(isOffline: Boolean) {
        sharedPreferences.edit().putBoolean(AppPreferences.KEY_OFFLINE_MODE, isOffline).apply()
    }

    /**
     * 获取当前应用的离线模式状态。
     * @return true如果离线模式已启用，false如果在线模式已启用。
     */
    fun isOfflineModeEnabled(): Boolean {
        return sharedPreferences.getBoolean(AppPreferences.KEY_OFFLINE_MODE, false) // 默认在线模式
    }
}

import okhttp3.Interceptor
import okhttp3.Response
import java.io.IOException

class NetworkModeInterceptor(private val networkModeManager: NetworkModeManager) : Interceptor {

    override fun intercept(chain: Interceptor.Chain): Response {
        if (networkModeManager.isOfflineModeEnabled()) {
            // 如果离线模式已启用，则不执行网络请求
            // 可以抛出自定义异常，或者返回一个模拟的错误响应
            throw IOException("App is in offline mode. Network requests are disabled.")
            // 或者，更优雅地，返回一个自定义的错误响应，以便Retrofit能够处理
            // 例如：
            // return Response.Builder()
            //     .request(chain.request())
            //     .protocol(okhttp3.Protocol.HTTP_1_1)
            //     .code(503) // Service Unavailable
            //     .message("App is in offline mode.")
            //     .body(okhttp3.ResponseBody.create(null, "{\"error\":\"Offline mode enabled\"}"))
            //     .build()
        }
        // 如果在线模式，则继续执行请求
        return chain.proceed(chain.request())
    }
}

import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory
import okhttp3.OkHttpClient
import android.content.Context

object RetrofitClient {
    private const val BASE_URL = "https://api.example.com/"

    fun getRetrofitInstance(context: Context): Retrofit {
        val networkModeManager = NetworkModeManager(context)

        val okHttpClient = OkHttpClient.Builder()
            .addInterceptor(NetworkModeInterceptor(networkModeManager))
            // 可以添加其他拦截器，如日志拦截器等
            .build()

        return Retrofit.Builder()
            .baseUrl(BASE_URL)
            .client(okHttpClient)
            .addConverterFactory(GsonConverterFactory.create())
            .build()
    }
}

<!-- activity_settings.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="应用网络模式"
        android:textSize="18sp"
        android:textStyle="bold" />

    <Switch
        android:id="@+id/switchOfflineMode"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:text="启用离线模式 (阻止所有网络请求)" />

</LinearLayout>

// SettingsActivity.kt
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import android.widget.Switch

class SettingsActivity : AppCompatActivity() {

    private lateinit var networkModeManager: NetworkModeManager
    private lateinit var switchOfflineMode: Switch

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_settings)

        networkModeManager = NetworkModeManager(this)
        switchOfflineMode = findViewById(R.id.switchOfflineMode)

        // 初始化开关状态
        switchOfflineMode.isChecked = networkModeManager.isOfflineModeEnabled()

        // 监听开关状态变化
        switchOfflineMode.setOnCheckedChangeListener { _, isChecked ->
            networkModeManager.setOfflineMode(isChecked)
            // 可以在这里显示一个Toast提示用户
            val message = if (isChecked) "已启用离线模式" else "已禁用离线模式 (在线)"
            // Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
        }
    }
}