feat: 新增 IMS User Agent 自定义功能

本次更新引入了对 IMS User Agent 字符串的自定义支持，并调整了构建配置。

- **功能新增**:
    - 在 `Feature` 枚举中添加了 `IMS_USER_AGENT` 选项，允许用户自定义 IMS User Agent。
    - 更新 `ImsModifier` 和 `MainViewModel`，支持将自定义的 User Agent 应用于 `CarrierConfigManager.Ims.KEY_IMS_USER_AGENT_STRING` 配置。
    - 同步更新了中英文 `strings.xml` 资源文件及 `README` 文档。

- **构建与代码优化**:
    - 将 `build.gradle.kts` 中的 Kotlin 编译器 `jvmTarget` 升级为 `JVM_21`。
    - 微调 `ImsModifier` 中的代码逻辑，优化了对字符串非空判断的写法（使用 `== true` 替代 Elvis 运算符）。

Author: Mystery00

README.md

@@ -35,6 +35,7 @@ TurboIMS is a tool that allows you to enable or disable IMS features like Voice
 - **Customizable IMS Features**:
     - **Carrier Name**: Override the carrier name displayed on your device.
   - **Country ISO**: Force modify operator country code (Requires Android 14+).
+  - **IMS User Agent**: Override the IMS User Agent string.
     - **VoLTE (Voice over LTE)**: Enable high-definition voice calls over 4G.
     - **VoWiFi (Wi-Fi Calling)**: Make calls over Wi-Fi networks, with options for Wi-Fi only mode.
     - **VT (Video Calling)**: Enable IMS-based video calls.

README_CN.md

@@ -35,6 +35,7 @@ TurboIMS 是一个允许您在 Google Pixel 手机上启用或禁用 VoLTE（高
 - **可定制的 IMS 功能**:
     - **运营商名称**: 覆盖设备上显示的运营商名称。
   - **运营商国家码 (Country ISO)**: 强制修改运营商国家码 (需 Android 14+)。
+  - **IMS User Agent**: 自定义 IMS User Agent 字符串。
     - **VoLTE (高清语音通话)**: 开启 4G 高清语音通话。
     - **VoWiFi (Wi-Fi 通话)**: 通过 Wi-Fi 网络拨打电话，并可选择仅 Wi-Fi 模式。
     - **VT (视频通话)**: 开启基于 IMS 的视频通话。

app/build.gradle.kts

@@ -26,6 +26,7 @@ val appVersionName: String = libs.versions.app.version.get()
 
 kotlin {
     compilerOptions {
+        jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_21)
         optIn.add("androidx.compose.material3.ExperimentalMaterial3Api")
         optIn.add("androidx.compose.material3.ExperimentalMaterial3ExpressiveApi")
     }

app/src/main/java/io/github/vvb2060/ims/model/Feature.kt

@@ -21,6 +21,12 @@ enum class Feature(
         R.string.country_iso_desc,
         "",
     ),
+    IMS_USER_AGENT(
+        FeatureValueType.STRING,
+        R.string.ims_user_agent,
+        R.string.ims_user_agent_desc,
+        "",
+    ),
     VOLTE(
         FeatureValueType.BOOLEAN,
         R.string.volte,

app/src/main/java/io/github/vvb2060/ims/privileged/ImsModifier.kt

@@ -31,6 +31,7 @@ class ImsModifier : Instrumentation() {
         fun buildBundle(
             carrierName: String?,
             countryISO: String?,
+            imsUserAgent: String?,
             enableVoLTE: Boolean,
             enableVoWiFi: Boolean,
             enableVT: Boolean,
@@ -42,20 +43,27 @@ class ImsModifier : Instrumentation() {
         ): Bundle {
             val bundle = Bundle()
             // 运营商名称
-            if (carrierName?.isNotBlank() ?: false) {
+            if (carrierName?.isNotBlank() == true) {
                 bundle.putBoolean(CarrierConfigManager.KEY_CARRIER_NAME_OVERRIDE_BOOL, true)
                 bundle.putString(CarrierConfigManager.KEY_CARRIER_NAME_STRING, carrierName)
                 bundle.putString(CarrierConfigManager.KEY_CARRIER_CONFIG_VERSION_STRING, ":3")
             }
             // 运营商国家码
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
-                if (countryISO?.isNotBlank() ?: false) {
+                if (countryISO?.isNotBlank() == true) {
                     bundle.putString(
                         CarrierConfigManager.KEY_SIM_COUNTRY_ISO_OVERRIDE_STRING,
                         countryISO
                     )
                 }
             }
+            // IMS User Agent
+            if (imsUserAgent?.isNotBlank() == true) {
+                bundle.putString(
+                    CarrierConfigManager.Ims.KEY_IMS_USER_AGENT_STRING,
+                    imsUserAgent
+                )
+            }
 
             // VoLTE 配置
             if (enableVoLTE) {

app/src/main/java/io/github/vvb2060/ims/viewmodel/MainViewModel.kt

@@ -148,6 +148,8 @@ class MainViewModel(private val application: Application) : AndroidViewModel(app
                 if (selectedSim.subId == -1) null else map[Feature.CARRIER_NAME]?.data as String?
             val countryISO =
                 if (selectedSim.subId == -1) null else map[Feature.COUNTRY_ISO]?.data as String?
+            val imsUserAgent =
+                if (selectedSim.subId == -1) null else map[Feature.IMS_USER_AGENT]?.data as String?
             val enableVoLTE = (map[Feature.VOLTE]?.data ?: true) as Boolean
             val enableVoWiFi = (map[Feature.VOWIFI]?.data ?: true) as Boolean
             val enableVT = (map[Feature.VT]?.data ?: true) as Boolean
@@ -160,6 +162,7 @@ class MainViewModel(private val application: Application) : AndroidViewModel(app
             val bundle = ImsModifier.buildBundle(
                 carrierName,
                 countryISO,
+                imsUserAgent,
                 enableVoLTE,
                 enableVoWiFi,
                 enableVT,

app/src/main/res/values-zh-rCN/strings.xml

@@ -28,6 +28,8 @@
     <string name="carrier_name_desc">自定义运营商显示的名称，为空则不修改</string>
     <string name="country_iso">运营商国家码</string>
     <string name="country_iso_desc">自定义运营商国家码，为空则不修改</string>
+    <string name="ims_user_agent">IMS User Agent</string>
+    <string name="ims_user_agent_desc">自定义 IMS User Agent 字符串，为空则不修改</string>
     <string name="volte">VoLTE（4G 语音）</string>
     <string name="volte_desc">启用 4G 高清语音通话</string>
     <string name="vowifi">VoWiFi（WiFi 通话）</string>

app/src/main/res/values/strings.xml

@@ -28,6 +28,8 @@
     <string name="carrier_name_desc">Customize carrier name</string>
     <string name="country_iso">Country ISO</string>
     <string name="country_iso_desc">Customize country ISO code</string>
+    <string name="ims_user_agent">IMS User Agent</string>
+    <string name="ims_user_agent_desc">Customize IMS User Agent string</string>
     <string name="volte">VoLTE (4G Voice)</string>
     <string name="volte_desc">Enable 4G HD voice calls</string>
     <string name="vowifi">VoWiFi (WiFi Calling)</string>