Android 15适配：世上本无坑，targetSdkVersion升到35后全是坑！

导语

“兄弟，Android 15来了，赶紧把targetSdkVersion升到35吧！”
——某群友的激情发言，被我秒回：“升了？坑都给你挖好了！”

是的，Android 15正式发布后，Google强制要求应用targetSdkVersion≥35（对应Android 15 API 35）。无数开发者兴高采烈地一键升级，结果——后台崩溃、权限报错、功能失效，全是坑！
但真相是：世上本无坑，坑是适配不及时自己挖的。 今天，咱就用血泪史给你扒一扒这些“坑”，手把手教你避开雷区！

🔥 坑1：权限管理——位置权限“玩消失”

现象：
App在后台获取位置时突然报错ACCESS_BACKGROUND_LOCATION权限拒绝，用户一删权限，地图功能直接瘫痪。
坑点：
Android 15对后台位置权限管控更严！必须显式申请ACCESS_BACKGROUND_LOCATION，且需在AndroidManifest.xml中声明：

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

解决方案：

// 检查并请求后台位置权限（Android 15+）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_BACKGROUND_LOCATION) 
        != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, 1);
    }
}

💡 血泪教训：别再用ACCESS_COARSE_LOCATION偷懒了！Google的隐私刀，专砍“不合规”应用。

🔥 坑2：后台服务——系统“秒杀”你的服务

现象：
App在后台播放音乐、同步数据时，系统直接杀进程，Log显示Foreground service not started。
坑点：
Android 15进一步收紧后台服务限制！启动后台服务必须调用startForegroundService()，且需在5秒内创建通知栏。
解决方案：

// 启动前台服务（必须！）
Intent serviceIntent = new Intent(this, MyBackgroundService.class);
startForegroundService(serviceIntent); // 关键！不能用startService

// 创建通知（5秒内必须完成）
Notification notification = new Notification.Builder(this)
    .setContentTitle("后台服务运行中")
    .setSmallIcon(R.drawable.ic_notification)
    .build();
startForeground(1, notification); // 5秒内调用！

💡 血泪教训：Android 8.0开始限制后台服务，Android 15只是“加把火”。别再用startService了，系统会直接干掉你！

🔥 坑3：文件访问——`getExternalStoragePublicDirectory`被封杀

现象：
App读取相册图片时崩溃，Log显示File not found，用Environment.getExternalStoragePublicDirectory()直接报错。
坑点：
Android 11+已弃用getExternalStoragePublicDirectory，Android 15彻底移除！必须改用MediaStore或Storage Access Framework。
解决方案：
✅ 正确做法（读取图片）：

// 用MediaStore查询图片（Android 15推荐）
ContentResolver resolver = getContentResolver();
Cursor cursor = resolver.query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    new String[]{MediaStore.Images.Media.DATA},
    null, null, null
);
if (cursor != null && cursor.moveToFirst()) {
    String imagePath = cursor.getString(cursor.getColumnIndex(MediaStore.Images.Media.DATA));
    // 处理图片路径...
}
cursor.close();

💡 血泪教训：别再用/sdcard/路径了！Google的“存储沙盒”政策，正在把旧API一锅端。

🔥 坑4：通知渠道——不注册？通知直接“消失”

现象：
用户点击通知没反应，App日志显示Notification channel not found。
坑点：
Android 8.0要求通知渠道，Android 15强制要求在App启动时初始化渠道，否则通知无法显示。
解决方案：

// 在Application类中初始化通知渠道（必须！）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationChannel channel = new NotificationChannel(
        "default_channel",
        "默认通知",
        NotificationManager.IMPORTANCE_DEFAULT
    );
    channel.setDescription("App默认通知渠道");
    NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
    manager.createNotificationChannel(channel);
}

💡 血泪教训：通知渠道是Android 8.0的“硬性要求”，Android 15只是严格执行。没注册？通知就是“幽灵”。

🔥 坑5：网络权限——`INTERNET`权限竟被“隐藏”？

现象：
App网络请求失败，Log显示Network is not connected，但手机明明有网。
坑点：
Android 15强制要求显式声明INTERNET权限（即使App用不到网络）。
解决方案：

<!-- AndroidManifest.xml 必须添加 -->
<uses-permission android:name="android.permission.INTERNET" />

💡 血泪教训：Google的“权限最小化”政策，连没用到网络的App都要声明权限，别想蒙混过关！

💎 结语：世上本无坑，适配不及时，坑就多了！

Android 15的targetSdkVersion升级，不是为了坑你，而是为了更安全、更流畅的体验。那些“坑”，本质是开发者没跟上Google的隐私与安全节奏。

避坑指南：

提前适配：别等Google强制下架才动手（Android 15要求2026年7月后应用必须targetSdk≥35）；
逐个排查：用Android Studio的Refactor → Migrate to Android 15工具扫描代码；
测试全覆盖：在Android 15模拟器上跑通所有核心流程。

最后送你一句老司机的忠告：
“适配不是负担，是给用户更好的体验。
今天多踩1个坑，明天就少丢100个用户。”

关注「移动开发那些事儿」，回复【Android15】获取完整适配清单+代码模板！
👉 点击右上角「...」→「设为星标」，第一时间获取Android最新适配干货！

#Android15 #targetSdkVersion #移动开发 #适配坑 #Google
转发本文，让团队少踩100个坑！