当前位置：首页 > news >正文

Android SDK 版本差异与兼容方案：从适配到实践

news 2025/8/2 6:21:34

Android 生态的碎片化一直是开发者面临的重大挑战。截至 2025 年，Android 市场上同时存在从 Android 6.0（API 23）到 Android 14（API 34）的多个版本，各版本在权限管理、后台限制、用户界面、安全策略等方面存在显著差异。如何让应用在不同版本的设备上都能稳定运行，同时充分利用新版本特性，是每个 Android 开发者必须掌握的技能。本文将系统梳理各主要 Android 版本的核心差异，提供一套完整的版本兼容策略，帮助开发者构建兼容多版本的高质量应用。

一、Android 版本演进与 API 级别概述

Android 自 2008 年发布以来，已历经十余年发展，每个主要版本都带来了重要的 API 变更和系统特性。了解版本演进脉络是进行兼容性开发的基础。

1.1 关键版本时间线与 API 级别

Android 的版本迭代遵循 "甜点命名" 传统（直到 Android 10 打破这一传统），每个版本对应一个 API 级别（API Level），这是代码中进行版本判断的核心依据：

Android 6.0（Marshmallow，API 23）：2015 年发布，引入运行时权限系统，是现代 Android 权限模型的基础。

Android 7.0（Nougat，API 24）：2016 年发布，引入多窗口模式、通知渠道雏形。

Android 8.0（Oreo，API 26）：2017 年发布，正式引入通知渠道、后台执行限制。

Android 9.0（Pie，API 28）：2018 年发布，强化后台限制、引入暗黑模式雏形。

Android 10（API 29）：2019 年发布，引入分区存储、手势导航、位置权限细化。

Android 11（API 30）：2020 年发布，进一步收紧后台权限、引入气泡通知。

Android 12（API 31）：2021 年发布，全新设计语言（Material You）、更严格的前台服务限制。

Android 13（API 33）：2022 年发布，细化媒体权限、通知权限需显式申请。

Android 14（API 34）：2023 年发布，强化隐私控制、引入动态颜色增强。

根据 Google 2025 年发布的平台版本分布数据，目前市场占比最高的三个版本是 Android 13（32%）、Android 12（28%）和 Android 14（18%），但仍有 12% 的设备运行 Android 10 及以下版本。这意味着应用至少需要兼容 API 29（Android 10）及以上版本，同时考虑对低版本的基础支持。

1.2 API 级别在开发中的作用

API 级别是 Android 版本兼容的核心判断依据，体现在以下几个方面：

1.清单文件声明：通过minSdkVersion、targetSdkVersion和compileSdkVersion控制版本范围：

<uses-sdkandroid:minSdkVersion="23"    // 最低支持版本（Android 6.0）android:targetSdkVersion="34" // 目标版本（Android 14）android:compileSdkVersion="34" // 编译版本
/>

2.代码中的版本判断：使用Build.VERSION.SDK_INT进行条件执行：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {// Android 13及以上的代码
} else {// 低版本兼容代码
}

3.系统行为适配：targetSdkVersion决定应用将采用哪个版本的系统行为。例如，当targetSdkVersion >= 23 时，系统会强制执行运行时权限检查。

理解 API 级别的作用，是实现版本兼容的基础。接下来，我们将深入分析各版本的核心差异点。

二、核心版本差异领域解析

Android 各版本的差异涉及系统的方方面面，但对应用兼容性影响最大的集中在权限管理、后台限制、存储策略、用户界面和安全特性五个领域。

2.1 权限管理机制演变

权限系统是 Android 版本差异最大的领域之一，直接影响应用功能的可用性，主要演进节点包括：

Android 6.0（API 23）：运行时权限的引入

变革：将权限分为普通权限（安装时授予）和危险权限（运行时动态申请）。

影响：应用必须在代码中显式请求危险权限（如相机、位置、存储）。

关键 API：Activity.requestPermissions()、Activity.onRequestPermissionsResult()

// 检查并请求相机权限（Android 6.0及以上）
if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {ActivityCompat.requestPermissions(this,arrayOf(Manifest.permission.CAMERA),CAMERA_PERMISSION_REQUEST_CODE)
}

Android 10（API 29）：位置权限细化

变革：将ACCESS_FINE_LOCATION和ACCESS_COARSE_LOCATION拆分为前台和后台权限。

新增权限：ACCESS_BACKGROUND_LOCATION用于后台获取位置。

影响：应用需要明确区分前台和后台位置使用场景。

Android 13（API 33）：媒体权限拆分

变革：将READ_EXTERNAL_STORAGE拆分为READ_MEDIA_IMAGES、READ_MEDIA_VIDEO和READ_MEDIA_AUDIO。

影响：应用只能请求所需类型的媒体权限，提高用户信任度。

// Android 13及以上的媒体权限请求
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {requestPermissions(arrayOf(Manifest.permission.READ_MEDIA_IMAGES),IMAGE_PERMISSION_REQUEST_CODE)
} else {// 旧版本使用READ_EXTERNAL_STORAGErequestPermissions(arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE),IMAGE_PERMISSION_REQUEST_CODE)
}

Android 13（API 33）：通知权限需显式申请

变革：POST_NOTIFICATIONS成为危险权限，必须在运行时请求。

影响：首次启动应用时不会自动授予通知权限，需主动申请。

权限系统的演变体现了 Android 对用户隐私保护的不断强化，也是应用兼容性问题的高发区。

2.2 后台执行限制收紧

为提升设备续航和性能，Android 逐步加强了对后台应用的限制：

Android 8.0（API 26）：后台服务限制

变革：不允许后台应用创建后台服务，必须使用JobScheduler或WorkManager。

例外：可通过startForegroundService()启动前台服务（需显示通知）。

// 启动前台服务（兼容Android 8.0+）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {startForegroundService(Intent(this, MyForegroundService::class.java))
} else {startService(Intent(this, MyForegroundService::class.java))
}// 服务内部需调用startForeground()
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {val notification = createNotification() // 创建通知startForeground(NOTIFICATION_ID, notification)}return super.onStartCommand(intent, flags, startId)
}

Android 9.0（API 28）：后台位置限制

变革：后台应用获取位置的频率被限制（约每小时几次）。

影响：依赖高频后台位置更新的应用（如导航）必须使用前台服务。

Android 10（API 29）：后台启动限制

变革：限制后台应用启动 Activity，避免突然打断用户。

替代方案：使用通知引导用户手动打开 Activity。

Android 12（API 31）：前台服务类型限制

变革：前台服务必须指定android:foregroundServiceType（如 location、camera、microphone）。

清单文件配置：

<serviceandroid:name=".MyLocationService"android:foregroundServiceType="location"android:exported="false"/>

后台限制的不断收紧要求开发者重新设计应用的工作流程，优先使用系统推荐的后台任务调度机制（如 WorkManager）。

2.3 存储策略变迁

Android 的存储访问机制经历了从完全开放到分区存储的重大转变：

Android 10（API 29）：分区存储（Scoped Storage）引入

变革：应用只能直接访问自己的沙盒目录（/data/data/<package>/）和公共媒体目录。

限制：访问其他应用的文件需通过ContentResolver。

过渡期：可通过requestLegacyExternalStorage="true"暂时禁用。

// 保存文件到应用沙盒（兼容所有版本）
val file = File(context.filesDir, "data.txt")
file.writeText("Hello, Scoped Storage!")// 保存到公共图片目录
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {val values = ContentValues().apply {put(MediaStore.Images.Media.DISPLAY_NAME, "photo.jpg")put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/MyApp")}val uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values)uri?.let {contentResolver.openOutputStream(it).use { outputStream ->// 写入图片数据}}
}

Android 11（API 30）：强制分区存储

变革：requestLegacyExternalStorage失效，所有应用必须遵守分区存储规则。

新增功能：媒体文件批量操作 API、应用间文件共享改进。

Android 13（API 33）：照片选择器

变革：引入系统级照片选择器，无需申请存储权限即可让用户选择图片。

优势：提高隐私安全性，减少权限请求。

存储策略的变革是影响最大的兼容性问题之一，尤其是文件管理类应用需要彻底重构以适应分区存储模型。

2.4 用户界面与交互变化

各版本在用户界面和交互方式上的变化，要求应用在保持功能的同时适配不同的视觉风格：

Android 8.0（API 26）：通知渠道

变革：所有通知必须属于某个渠道，用户可单独控制每个渠道的行为。

影响：未设置渠道的通知在 Android 8.0 + 上不会显示。

// 创建通知渠道（Android 8.0+）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {val channel = NotificationChannel(CHANNEL_ID,"重要通知",NotificationManager.IMPORTANCE_HIGH)val notificationManager = getSystemService(NotificationManager::class.java)notificationManager.createNotificationChannel(channel)
}

Android 10（API 29）：手势导航与全面屏

变革：引入手势导航，减少系统导航栏空间。

适配：应用需支持沉浸式模式、避免在底部放置关键交互元素。

Android 12（API 31）：Material You 与动态颜色

变革：引入基于壁纸的动态颜色系统，应用可自动适配系统主题。

适配：使用Theme.Material3.DayNight主题，采用?attr/colorOnPrimary等属性。

<!-- 使用Material3主题支持动态颜色 -->
<style name="AppTheme" parent="Theme.Material3.DayNight.NoActionBar"><item name="colorPrimary">?attr/colorPrimary</item><item name="colorOnPrimary">?attr/colorOnPrimary</item><!-- 其他属性使用系统主题属性 -->
</style>

Android 12（API 31）：应用启动画面

变革：系统强制统一应用启动画面，替代传统的冷启动白屏。

适配：通过SplashScreen API 自定义启动画面。

UI 相关的变更通常不会导致应用崩溃，但会影响用户体验一致性，需要开发者关注视觉和交互的适配。

2.5 安全特性增强

Android 持续强化平台安全性，带来了一些不兼容的 API 变更：

Android 7.0（API 24）：文件 URI 限制

变革：禁止在Intent中使用file:// URI 传递文件，需使用content:// URI。

解决方案：使用FileProvider生成内容 URI。

<!-- 清单文件配置FileProvider -->
<providerandroid:name="androidx.core.content.FileProvider"android:authorities="${applicationId}.fileprovider"android:exported="false"android:grantUriPermissions="true"><meta-dataandroid:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/file_paths"/>
</provider>

// 使用FileProvider获取内容URI
val file = File(context.filesDir, "document.pdf")
val uri = FileProvider.getUriForFile(context,"${context.packageName}.fileprovider",file
)// 启动其他应用打开文件
val intent = Intent(Intent.ACTION_VIEW).apply {setDataAndType(uri, "application/pdf")addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
}
startActivity(intent)

Android 9.0（API 28）：明文流量限制

变革：默认禁止应用使用 HTTP 明文流量，要求使用 HTTPS。

例外：可通过network_security_config.xml配置允许特定域名。

Android 11（API 30）：包可见性限制

变革：应用默认只能看到系统应用和已安装的关联应用。

适配：在清单文件中声明需要访问的应用包名：

<queries><!-- 声明需要访问的应用 --><package android:name="com.example.target"/><!-- 声明需要使用的intent过滤器 --><intent><action android:name="android.intent.action.SEND"/><data android:mimeType="image/*"/></intent>
</queries>

安全特性的增强通常会限制应用的某些行为，需要通过新的 API 或配置方式进行适配。

三、版本兼容策略与最佳实践

面对复杂的版本差异，需要一套系统化的兼容策略，既能利用新版本特性，又能保证在旧版本上的基本功能。

3.1 版本适配的基本原则

在进行版本兼容开发时，应遵循以下原则：

1.最小权限原则：只请求应用必需的权限，按版本逐步申请。

2.渐进增强原则：以最低版本功能为基础，为高版本添加增强功能。

3.使用官方推荐 API：优先使用 AndroidX 组件和 Jetpack 库，它们已内置版本兼容处理。

4.避免硬编码版本判断：尽量使用Build.VERSION_CODES常量而非直接写数字。

5.全面测试：在各主要版本的设备或模拟器上测试核心功能。

这些原则能帮助开发者在兼容性和用户体验之间找到平衡。

3.2 代码级兼容方案

在代码层面，有多种技术手段可以处理版本差异：

条件语句适配

这是最直接的适配方式，使用if-else根据 API 级别执行不同代码：

fun shareText(context: Context, text: String) {val intent = Intent(Intent.ACTION_SEND).apply {type = "text/plain"putExtra(Intent.EXTRA_TEXT, text)}if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP_MR1) {// Android 5.1+支持直接指定包名intent.setPackage("com.whatsapp")context.startActivity(intent)} else {// 低版本使用选择器val chooser = Intent.createChooser(intent, "分享到")context.startActivity(chooser)}
}

注意：条件语句应尽量集中管理，避免散落在代码各处，可封装到工具类中。

封装适配层

对于差异较大的功能，可封装适配层，为不同版本提供统一接口：

// 统一接口
interface NotificationHelper {fun createNotification(title: String, content: String): Notification
}// 低版本实现（API < 26）
class LegacyNotificationHelper(private val context: Context) : NotificationHelper {override fun createNotification(title: String, content: String): Notification {return Notification.Builder(context).setContentTitle(title).setContentText(content).setSmallIcon(R.drawable.ic_notification).build()}
}// 高版本实现（API >= 26）
class ModernNotificationHelper(private val context: Context) : NotificationHelper {override fun createNotification(title: String, content: String): Notification {return Notification.Builder(context, CHANNEL_ID).setContentTitle(title).setContentText(content).setSmallIcon(R.drawable.ic_notification).build()}
}// 工厂类提供合适的实现
object NotificationHelperFactory {fun getInstance(context: Context): NotificationHelper {return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {ModernNotificationHelper(context)} else {LegacyNotificationHelper(context)}}
}

这种方式将版本差异封装在适配层内部，业务代码无需关心版本细节。

使用 AndroidX 和 Jetpack 库

AndroidX 库已经为许多 API 差异提供了封装，推荐优先使用：

1.Activity Result API：替代onRequestPermissionsResult()，简化权限请求：

// 注册权限请求回调
val requestPermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission()
) { isGranted ->if (isGranted) {// 权限授予，执行操作} else {// 权限被拒，提示用户}
}// 发起权限请求
button.setOnClickListener {requestPermissionLauncher.launch(Manifest.permission.CAMERA)
}

2.WorkManager：统一处理后台任务，自动适配各版本的后台限制：

// 定义后台任务
class MyWorker(context: Context, params: WorkerParameters) : Worker(context, params) {override fun doWork(): Result {// 执行后台任务return Result.success()}
}// 调度任务
val constraints = Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED).build()val myWorkRequest = OneTimeWorkRequestBuilder<MyWorker>().setConstraints(constraints).build()WorkManager.getInstance(context).enqueue(myWorkRequest)

3.CoordinatorLayout 与 Material 组件：自动适配不同版本的 UI 行为。

使用这些库可以大幅减少手动版本判断的代码，同时确保最佳实践。

3.3 清单文件与资源适配

除了代码，还可以通过清单文件和资源文件进行版本适配：

1.清单文件中的版本适配

使用uses-sdk声明版本范围

针对不同版本声明不同权限

使用meta-data提供版本特定配置

<!-- 基础权限 -->
<uses-permission android:name="android.permission.INTERNET"/><!-- 仅在Android 13+需要的权限 -->
<uses-permissionandroid:name="android.permission.POST_NOTIFICATIONS"android:maxSdkVersion="32"tools:node="remove"/> <!-- 在API 33以下移除该权限声明 --><!-- 针对Android 10+的配置 -->
<application><meta-dataandroid:name="android.max_aspect"android:value="2.4"android:minSdkVersion="29"/>
</application>

2.资源文件的版本适配

Android 支持为不同 API 级别创建资源目录，自动选择合适的资源：

res/values/               # 默认资源styles.xmlvalues-v21/           # Android 5.0+styles.xmlvalues-v26/           # Android 8.0+styles.xmldrawable-v24/         # Android 7.0+的图片资源layout-v17/           # Android 4.2+的布局

资源适配特别适合 UI 相关的版本差异，避免在代码中进行大量样式判断。

3.4 第三方库的版本兼容

大多数第三方库会处理内部的版本兼容，但集成时仍需注意：

选择活跃维护的库：优先使用持续更新、支持最新 Android 版本的库。

注意库的 minSdkVersion：确保库的最低支持版本不高于应用的minSdkVersion。

使用版本管理工具：通过ext或dependencyResolutionManagement统一管理库版本：

// 项目级build.gradle
ext {compileSdkVersion = 34minSdkVersion = 23targetSdkVersion = 34// 库版本appCompatVersion = "1.6.1"materialVersion = "1.9.0"
}// 模块级build.gradle
dependencies {implementation "androidx.appcompat:appcompat:${rootProject.ext.appCompatVersion}"implementation "com.google.android.material:material:${rootProject.ext.materialVersion}"
}

处理库之间的冲突：使用dependencyInsight分析依赖树，解决版本冲突：

./gradlew app:dependencyInsight --configuration releaseRuntimeClasspath --dependency androidx.appcompat

合理管理第三方库能减少许多兼容性问题。

四、兼容测试与工具链

即使有完善的适配方案，也必须通过全面测试验证兼容性。Android 提供了多种工具支持版本兼容测试。

4.1 测试策略与环境搭建

有效的兼容性测试需要覆盖以下方面：

1.核心版本覆盖：至少测试minSdkVersion、targetSdkVersion、当前主流版本（如 Android 13）和最新版本（Android 14）。

2.功能测试重点：

权限相关功能（尤其是位置、存储、相机）
后台任务和服务
通知展示和交互
文件读写操作
UI 在不同屏幕尺寸和分辨率的表现

3.测试环境搭建：

使用 Android Studio 的 AVD Manager 创建各版本模拟器
配置不同屏幕尺寸和密度的虚拟设备
利用 Firebase Test Lab 进行多设备云测试

4.2 实用测试工具

Android 生态提供了多种工具辅助兼容性测试：

Android Lint

Lint 是 Android Studio 内置的静态代码分析工具，能检测潜在的版本兼容性问题：

// Lint会警告：Call requires API level 26 (current min is 23)
NotificationChannel channel = new NotificationChannel(...)

在build.gradle中配置 Lint 规则：

android {lintOptions {// 将版本兼容问题视为错误error "NewApi"// 忽略某些不重要的警告ignore "OldTargetApi"// 生成详细报告htmlReport truehtmlOutput file("$buildDir/reports/lint-results.html")}
}

Android Studio 的 API 检查

Android Studio 提供了可视化的 API 级别检查：

1.代码编辑器中的标记：使用不同颜色标记不同 API 级别的代码

2.API 级别分布图：在Project Structure中查看方法和类的 API 级别分布

3.Quick Fix 建议：提供自动添加版本判断的快捷修复

版本兼容测试框架

Espresso：编写 UI 测试，在不同版本上自动执行

Robolectric：在 JVM 上模拟 Android 环境，快速测试不同 API 级别行为

Firebase Test Lab：在云端的真实设备上测试应用兼容性

4.3 灰度发布与用户反馈

即使经过充分测试，也难以覆盖所有设备和场景。灰度发布是发现兼容性问题的有效手段：

1.分阶段发布：先向小比例用户（如 10%）发布更新

2.监控崩溃报告：通过 Firebase Crashlytics 或 Google Play Console 收集崩溃数据

3.用户反馈渠道：提供便捷的反馈方式，收集版本相关问题

// 集成Firebase Crashlytics跟踪版本兼容问题
try {// 可能存在版本兼容问题的代码
} catch (e: Exception) {// 记录设备版本信息Crashlytics.log("Android version: ${Build.VERSION.SDK_INT}")Crashlytics.recordException(e)
}

通过用户反馈和崩溃报告，可以持续改进应用的版本兼容性。

五、案例分析：从问题到解决方案

通过实际案例可以更好地理解版本兼容问题的解决思路。

5.1 案例一：存储权限适配

问题：应用在 Android 13 上无法访问图片，在 Android 10 上工作正常。

分析：

Android 13 使用READ_MEDIA_IMAGES权限，而应用仍在请求READ_EXTERNAL_STORAGE

未处理分区存储的文件访问方式

解决方案：

1.权限请求适配：

fun requestImagePermission() {val permissions = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {arrayOf(Manifest.permission.READ_MEDIA_IMAGES)} else {@Suppress("DEPRECATION")arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE)}requestPermissions(permissions, IMAGE_PERMISSION_REQUEST)
}

2.使用媒体存储 API 访问图片：

suspend fun loadImages(): List<Image> {val images = mutableListOf<Image>()val projection = arrayOf(MediaStore.Images.Media._ID,MediaStore.Images.Media.DISPLAY_NAME,MediaStore.Images.Media.SIZE)// 查询条件：只获取最近30天的图片val selection = "${MediaStore.Images.Media.DATE_ADDED} >= ?"val thirtyDaysAgo = System.currentTimeMillis() / 1000 - 30 * 24 * 60 * 60val selectionArgs = arrayOf(thirtyDaysAgo.toString())// 使用ContentResolver查询contentResolver.query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI,projection,selection,selectionArgs,"${MediaStore.Images.Media.DATE_ADDED} DESC")?.use { cursor ->val idColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)val nameColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME)val sizeColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.SIZE)while (cursor.moveToNext()) {val id = cursor.getLong(idColumn)val name = cursor.getString(nameColumn)val size = cursor.getLong(sizeColumn)val uri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id)images.add(Image(uri, name, size))}}return images
}

通过这种方式，应用在所有版本上都能正确访问图片。

5.2 案例二：后台位置更新

问题：应用在 Android 10 及以上版本无法在后台获取位置更新。

分析：

Android 10 + 要求后台位置更新必须持有ACCESS_BACKGROUND_LOCATION权限

应用使用普通 Service 而非前台服务进行位置监听

解决方案：

1.申请后台位置权限：

<!-- 清单文件 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

2.使用前台服务获取位置：

class LocationForegroundService : Service() {private val locationCallback = object : LocationCallback() {override fun onLocationResult(result: LocationResult) {// 处理位置更新val location = result.lastLocationif (location != null) {// 发送位置广播或更新UI}}}override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {// 创建前台服务通知val notification = NotificationCompat.Builder(this, LOCATION_CHANNEL_ID).setContentTitle("正在获取位置").setContentText("为了提供更好的服务").setSmallIcon(R.drawable.ic_location).setPriority(NotificationCompat.PRIORITY_LOW).build()startForeground(LOCATION_NOTIFICATION_ID, notification)// 配置位置请求val locationRequest = LocationRequest.create().apply {interval = 5000fastestInterval = 2000priority = LocationRequest.PRIORITY_HIGH_ACCURACY}// 检查权限并请求位置更新if (ContextCompat.checkSelfPermission(this,Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {LocationServices.getFusedLocationProviderClient(this).requestLocationUpdates(locationRequest, locationCallback, Looper.getMainLooper())}return START_STICKY}// 其他生命周期方法...
}

3.在 Activity 中启动服务：

fun startLocationTracking() {// 检查并请求必要的权限val permissions = mutableListOf(Manifest.permission.ACCESS_FINE_LOCATION)if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {permissions.add(Manifest.permission.ACCESS_BACKGROUND_LOCATION)}if (permissions.all { ContextCompat.checkSelfPermission(this, it) == PackageManager.PERMISSION_GRANTED }) {// 启动前台服务val intent = Intent(this, LocationForegroundService::class.java)if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {startForegroundService(intent)} else {startService(intent)}} else {// 请求权限ActivityCompat.requestPermissions(this, permissions.toTypedArray(), LOCATION_PERMISSION_REQUEST)}
}

通过使用前台服务和申请后台位置权限，应用在各版本上都能稳定获取位置更新。