From fc31889b6ec957504ffd16ac002f07e80a15cc66 Mon Sep 17 00:00:00 2001 From: ZhanGSKen Date: Wed, 7 Jan 2026 20:49:30 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E5=BA=94=E7=94=A8=E9=80=9A?= =?UTF-8?q?=E7=9F=A5=E6=B8=A0=E9=81=93=E8=AE=BE=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- contacts/build.gradle | 2 +- contacts/build.properties | 4 +- contacts/src/main/AndroidManifest.xml | 1 - .../contacts/services/AssistantService.java | 86 ++- .../studio/contacts/services/MainService.java | 85 ++- .../utils/NotificationManagerUtils.java | 505 ++++++++++++++++++ 6 files changed, 582 insertions(+), 101 deletions(-) create mode 100644 contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java diff --git a/contacts/build.gradle b/contacts/build.gradle index 1c0013f..6af0c27 100644 --- a/contacts/build.gradle +++ b/contacts/build.gradle @@ -91,7 +91,7 @@ dependencies { //api 'androidx.fragment:fragment:1.1.0' // WinBoLL库 nexus.winboll.cc 地址 - api 'cc.winboll.studio:libaes:15.12.12' + api 'cc.winboll.studio:libaes:15.12.13' api 'cc.winboll.studio:libappbase:15.14.2' // WinBoLL备用库 jitpack.io 地址 diff --git a/contacts/build.properties b/contacts/build.properties index edaa0a5..0d278b1 100644 --- a/contacts/build.properties +++ b/contacts/build.properties @@ -1,8 +1,8 @@ #Created by .winboll/winboll_app_build.gradle -#Tue Jan 06 20:25:41 HKT 2026 +#Wed Jan 07 12:45:14 GMT 2026 stageCount=3 libraryProject= baseVersion=15.14 publishVersion=15.14.2 -buildCount=0 +buildCount=6 baseBetaVersion=15.14.3 diff --git a/contacts/src/main/AndroidManifest.xml b/contacts/src/main/AndroidManifest.xml index 174e272..d11377f 100644 --- a/contacts/src/main/AndroidManifest.xml +++ b/contacts/src/main/AndroidManifest.xml @@ -104,7 +104,6 @@ diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java b/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java index 22930c8..efb2ced 100644 --- a/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java +++ b/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java @@ -1,18 +1,14 @@ package cc.winboll.studio.contacts.services; -import android.app.Notification; -import android.app.NotificationChannel; -import android.app.NotificationManager; import android.app.Service; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.ServiceConnection; import android.os.Binder; -import android.os.Build; import android.os.IBinder; -import cc.winboll.studio.contacts.R; import cc.winboll.studio.contacts.model.MainServiceBean; +import cc.winboll.studio.contacts.utils.NotificationManagerUtils; import cc.winboll.studio.libappbase.LogUtils; /** @@ -115,38 +111,38 @@ public class AssistantService extends Service { /** * 创建前台服务通知（Android 8.0+ 必须配置渠道） */ - private Notification createForegroundNotification() { - // 1. 创建通知渠道（API 26+ 必需） - if (Build.VERSION.SDK_INT >= ANDROID_8_API) { - NotificationChannel channel = new NotificationChannel( - FOREGROUND_CHANNEL_ID, - "守护服务", - NotificationManager.IMPORTANCE_LOW - ); - channel.setDescription("守护服务后台运行，保障主服务存活"); - // 空指针防护 - NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); - if (manager != null) { - manager.createNotificationChannel(channel); - LogUtils.d(TAG, "createForegroundNotification: 通知渠道创建成功"); - } - } - - // 2. 构建通知（Java 7 分步设置，取消链式调用简化） - Notification.Builder builder; - if (Build.VERSION.SDK_INT >= ANDROID_8_API) { - builder = new Notification.Builder(this, FOREGROUND_CHANNEL_ID); - } else { - builder = new Notification.Builder(this); - } - builder.setSmallIcon(R.drawable.ic_launcher); - builder.setContentTitle("守护服务运行中"); - builder.setContentText("正在监控主服务状态"); - builder.setPriority(Notification.PRIORITY_LOW); - builder.setOngoing(true); // 不可手动取消 - - return builder.build(); - } +// private Notification createForegroundNotification() { +// // 1. 创建通知渠道（API 26+ 必需） +// if (Build.VERSION.SDK_INT >= ANDROID_8_API) { +// NotificationChannel channel = new NotificationChannel( +// FOREGROUND_CHANNEL_ID, +// "守护服务", +// NotificationManager.IMPORTANCE_LOW +// ); +// channel.setDescription("守护服务后台运行，保障主服务存活"); +// // 空指针防护 +// NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); +// if (manager != null) { +// manager.createNotificationChannel(channel); +// LogUtils.d(TAG, "createForegroundNotification: 通知渠道创建成功"); +// } +// } +// +// // 2. 构建通知（Java 7 分步设置，取消链式调用简化） +// Notification.Builder builder; +// if (Build.VERSION.SDK_INT >= ANDROID_8_API) { +// builder = new Notification.Builder(this, FOREGROUND_CHANNEL_ID); +// } else { +// builder = new Notification.Builder(this); +// } +// builder.setSmallIcon(R.drawable.ic_launcher); +// builder.setContentTitle("守护服务运行中"); +// builder.setContentText("正在监控主服务状态"); +// builder.setPriority(Notification.PRIORITY_LOW); +// builder.setOngoing(true); // 不可手动取消 +// +// return builder.build(); +// } // ====================== Service 生命周期方法区 ====================== @Override @@ -154,22 +150,6 @@ public class AssistantService extends Service { super.onCreate(); LogUtils.d(TAG, "onCreate: 守护服务创建"); - // 适配 Android 12+ 后台启动限制：应用后台时启动为前台服务 - if (Build.VERSION.SDK_INT >= ANDROID_12_API) { - Notification notification = createForegroundNotification(); - // 修复：使用 dataSync 类型，添加异常捕获防止崩溃 - try { - if (Build.VERSION.SDK_INT >= ANDROID_10_API) { - startForeground(FOREGROUND_NOTIFICATION_ID, notification, FOREGROUND_SERVICE_TYPE_DATA_SYNC); - } else { - startForeground(FOREGROUND_NOTIFICATION_ID, notification); - } - LogUtils.d(TAG, "onCreate: 守护服务已启动为前台服务（dataSync 类型）"); - } catch (IllegalArgumentException e) { - LogUtils.e(TAG, "onCreate: 启动前台服务失败", e); - } - } - // 初始化主服务连接回调 if (mMyServiceConnection == null) { mMyServiceConnection = new MyServiceConnection(); diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java b/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java index db08f8e..1b7d469 100644 --- a/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java +++ b/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java @@ -2,8 +2,6 @@ package cc.winboll.studio.contacts.services; import android.app.ActivityManager; import android.app.Notification; -import android.app.NotificationChannel; -import android.app.NotificationManager; import android.app.Service; import android.content.ComponentName; import android.content.Context; @@ -11,11 +9,9 @@ import android.content.Intent; import android.content.ServiceConnection; import android.media.AudioManager; import android.os.Binder; -import android.os.Build; import android.os.Handler; import android.os.IBinder; import android.os.Looper; -import cc.winboll.studio.contacts.R; import cc.winboll.studio.contacts.bobulltoon.TomCat; import cc.winboll.studio.contacts.dun.Rules; import cc.winboll.studio.contacts.handlers.MainServiceHandler; @@ -23,6 +19,7 @@ import cc.winboll.studio.contacts.listenphonecall.CallListenerService; import cc.winboll.studio.contacts.model.MainServiceBean; import cc.winboll.studio.contacts.model.RingTongBean; import cc.winboll.studio.contacts.receivers.MainReceiver; +import cc.winboll.studio.contacts.utils.NotificationManagerUtils; import cc.winboll.studio.libappbase.LogUtils; import java.util.Timer; import java.util.TimerTask; @@ -247,43 +244,43 @@ public class MainService extends Service { * 创建前台服务通知（Android8.0+需渠道，低版本兼容） * @return Notification 前台服务通知实例 */ - private Notification createForegroundNotification() { - // 1. Android8.0+创建通知渠道（必需，否则通知不显示） - if (Build.VERSION.SDK_INT >= ANDROID_8_API) { - NotificationChannel channel = new NotificationChannel( - FOREGROUND_CHANNEL_ID, - "拨号主服务", - NotificationManager.IMPORTANCE_LOW - ); - channel.setDescription("主服务后台运行，保障通话监听与号码识别功能正常"); - channel.setSound(null, null); // 关闭通知声音 - channel.enableVibration(false); // 关闭振动 - - NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); - if (notificationManager != null) { - notificationManager.createNotificationChannel(channel); - LogUtils.d(TAG, "createForegroundNotification: Android8.0+通知渠道创建成功"); - } else { - LogUtils.e(TAG, "createForegroundNotification: NotificationManager获取失败，渠道创建失败"); - } - } - - // 2. 构建通知实例（分版本兼容Builder） - Notification.Builder builder; - if (Build.VERSION.SDK_INT >= ANDROID_8_API) { - builder = new Notification.Builder(this, FOREGROUND_CHANNEL_ID); - } else { - builder = new Notification.Builder(this); - } - builder.setSmallIcon(R.drawable.ic_launcher); - builder.setContentTitle("拨号服务运行中"); - builder.setContentText("后台保障通话监听与号码识别，请勿手动关闭"); - builder.setPriority(Notification.PRIORITY_LOW); // 低优先级，不打扰用户 - builder.setOngoing(true); // 不可手动清除，保障服务存活 - - LogUtils.d(TAG, "createForegroundNotification: 前台服务通知构建完成"); - return builder.build(); - } +// private Notification createForegroundNotification() { +// // 1. Android8.0+创建通知渠道（必需，否则通知不显示） +// if (Build.VERSION.SDK_INT >= ANDROID_8_API) { +// NotificationChannel channel = new NotificationChannel( +// FOREGROUND_CHANNEL_ID, +// "拨号主服务", +// NotificationManager.IMPORTANCE_LOW +// ); +// channel.setDescription("主服务后台运行，保障通话监听与号码识别功能正常"); +// channel.setSound(null, null); // 关闭通知声音 +// channel.enableVibration(false); // 关闭振动 +// +// NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); +// if (notificationManager != null) { +// notificationManager.createNotificationChannel(channel); +// LogUtils.d(TAG, "createForegroundNotification: Android8.0+通知渠道创建成功"); +// } else { +// LogUtils.e(TAG, "createForegroundNotification: NotificationManager获取失败，渠道创建失败"); +// } +// } +// +// // 2. 构建通知实例（分版本兼容Builder） +// Notification.Builder builder; +// if (Build.VERSION.SDK_INT >= ANDROID_8_API) { +// builder = new Notification.Builder(this, FOREGROUND_CHANNEL_ID); +// } else { +// builder = new Notification.Builder(this); +// } +// builder.setSmallIcon(R.drawable.ic_launcher); +// builder.setContentTitle("拨号服务运行中"); +// builder.setContentText("后台保障通话监听与号码识别，请勿手动关闭"); +// builder.setPriority(Notification.PRIORITY_LOW); // 低优先级，不打扰用户 +// builder.setOngoing(true); // 不可手动清除，保障服务存活 +// +// LogUtils.d(TAG, "createForegroundNotification: 前台服务通知构建完成"); +// return builder.build(); +// } /** * 检查指定服务是否正在运行（通过ActivityManager查询） @@ -423,8 +420,8 @@ public class MainService extends Service { // 1. 优先启动前台服务（避免前台服务启动超时崩溃，核心优先级） try { - Notification foregroundNotification = createForegroundNotification(); - startForeground(FOREGROUND_NOTIFICATION_ID, foregroundNotification, FOREGROUND_SERVICE_TYPE_DATA_SYNC); + NotificationManagerUtils notificationManagerUtils = new NotificationManagerUtils(this); + notificationManagerUtils.startForegroundServiceNotify(this, "主要拨号服务已启动。"); LogUtils.i(TAG, "startCoreBusiness: 前台服务启动成功，通知ID=" + FOREGROUND_NOTIFICATION_ID); } catch (IllegalArgumentException e) { LogUtils.e(TAG, "startCoreBusiness: 前台服务启动失败（服务类型不匹配）", e); @@ -463,7 +460,7 @@ public class MainService extends Service { Intent assistantIntent = new Intent(this, AssistantService.class); // Android10+应用后台启动服务需用前台服务模式 LogUtils.d(TAG, "wakeupAndBindAssistantService: Android10+，前台服务模式启动守护服务"); - startForegroundService(assistantIntent); + startService(assistantIntent); // 绑定守护服务（BIND_IMPORTANT：高优先级绑定，断开时回调） bindService(assistantIntent, mServiceConnection, Context.BIND_IMPORTANT); diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java new file mode 100644 index 0000000..46a91bb --- /dev/null +++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java @@ -0,0 +1,505 @@ +package cc.winboll.studio.contacts.utils; + +import android.app.Notification; +import android.app.NotificationChannel; +import android.app.NotificationManager; +import android.app.PendingIntent; +import android.app.Service; +import android.content.Context; +import android.content.Intent; +import android.content.SharedPreferences; +import android.content.pm.PackageInfo; +import android.content.pm.PackageManager; +import android.graphics.Bitmap; +import android.graphics.BitmapFactory; +import android.media.RingtoneManager; +import android.os.Build; +import android.provider.Settings; + +import cc.winboll.studio.contacts.MainActivity; +import cc.winboll.studio.contacts.R; +import cc.winboll.studio.libappbase.LogUtils; + +/** + * 通知工具类：统一管理前台服务/临时通知 + * @Author 豆包&ZhanGSKen + * @CreateTime 2025/12/14 21:01:00 + * @LastEditTime 2026/01/07 22:00:00 + * @Describe 适配API30，支持拨号服务前台保活通知、临时通知提醒，提供通知的创建、更新、取消功能；支持通知版本管理，版本变更时自动清理旧渠道 + */ +public class NotificationManagerUtils { + // ================================== 静态常量（置顶统一管理，杜绝魔法值）================================= + public static final String TAG = "NotificationManagerUtils"; + // ********** 新增：通知版本管理常量 ********** + /** 通知版本标识（源码标记版本，变更时会清理旧渠道） */ + public static final String NOTIFICATION_VERSION = "v1.0.0"; + /** SP存储键：已保存的通知版本 */ + private static final String SP_KEY_NOTIFICATION_VERSION = "sp_key_notification_version"; + /** SP文件名 */ + private static final String SP_NAME_NOTIFICATION = "sp_notification_manager"; + // ****************************************** + // 通知渠道ID（API26+ 必需，区分通知类型） + public static final String CHANNEL_ID_FOREGROUND = "cc.winboll.studio.contacts.channel.foreground"; + public static final String CHANNEL_ID_TEMPORARY = "cc.winboll.studio.contacts.channel.temporary"; + // 通知ID（唯一标识，避免重复） + public static final int NOTIFY_ID_FOREGROUND_SERVICE = 1001; + public static final int NOTIFY_ID_TEMPORARY = 1002; + // 低版本兼容：默认通知图标（API<21 避免显示异常） + private static final int NOTIFICATION_DEFAULT_ICON = R.drawable.ic_launcher; + // 通知内容兜底常量 + private static final String FOREGROUND_NOTIFY_TITLE_DEFAULT = "拨号服务前台通知"; + private static final String FOREGROUND_NOTIFY_CONTENT_DEFAULT = "前台通知内容"; + private static final String TEMPORARY_NOTIFY_TITLE_DEFAULT = "拨号服务临时通知"; + private static final String TEMPORARY_NOTIFY_CONTENT_DEFAULT = "临时通知内容"; + // PendingIntent请求码 + private static final int PENDING_INTENT_REQUEST_CODE_FOREGROUND = 0; + private static final int PENDING_INTENT_REQUEST_CODE_TEMPORARY = 1; + // 消息通知自增ID（起始值） + private static int snMessageNotificationID = 10000; + + // ================================== 成员变量（私有封装，按依赖优先级排序）================================= + // 核心上下文（应用级，避免内存泄漏） + private Context mContext; + // 系统通知服务（核心依赖） + private NotificationManager mNotificationManager; + // 前台服务通知实例（单独持有，便于更新/取消） + private Notification mForegroundServiceNotify; + // ********** 新增：SP实例（用于版本存储） ********** + private SharedPreferences mSp; + + // ================================== 构造方法（初始化核心资源，前置校验）================================= + public NotificationManagerUtils(Context context) { + LogUtils.d(TAG, "NotificationManagerUtils() 构造方法调用 | context=" + context); + // 前置校验：Context非空 + if (context == null) { + LogUtils.e(TAG, "NotificationManagerUtils() 构造失败：context is null"); + return; + } + // 初始化核心资源 + this.mContext = context.getApplicationContext(); + this.mNotificationManager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE); + // ********** 新增：初始化SP ********** + this.mSp = mContext.getSharedPreferences(SP_NAME_NOTIFICATION, Context.MODE_PRIVATE); + LogUtils.d(TAG, "NotificationManagerUtils() 核心资源初始化完成 | mContext=" + mContext + " | mNotificationManager=" + mNotificationManager + " | mSp=" + mSp); + + // ********** 新增：版本检查与旧渠道清理 ********** + checkNotificationVersionAndCleanOldChannels(); + + // 初始化通知渠道（API26+ 必需） + initNotificationChannels(); + LogUtils.d(TAG, "NotificationManagerUtils() 构造完成"); + } + + // ================================== 新增核心方法：通知版本检查与旧渠道清理 ================================= + /** + * 检查当前通知版本与SP中保存的版本是否一致 + * 若不一致，清理所有旧通知渠道，并更新SP中的版本记录 + */ + private void checkNotificationVersionAndCleanOldChannels() { + LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 方法调用 | 源码版本=" + NOTIFICATION_VERSION + " | SP版本=" + getSavedNotificationVersion()); + // 1. 版本一致，无需处理 + if (NOTIFICATION_VERSION.equals(getSavedNotificationVersion())) { + LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 版本一致，无需清理渠道"); + return; + } + + // 2. 版本不一致，清理所有旧渠道 + LogUtils.w(TAG, "checkNotificationVersionAndCleanOldChannels() 版本不一致，开始清理所有旧通知渠道"); + cleanAllNotificationChannels(); + + // 3. 取消所有旧通知 + cancelAllNotifications(); + LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 已取消所有旧通知"); + + // 4. 更新SP中的版本记录 + saveNotificationVersion(NOTIFICATION_VERSION); + LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 已更新SP版本记录为：" + NOTIFICATION_VERSION); + } + + /** + * 从SP中获取已保存的通知版本 + * @return 已保存的版本号，无则返回空字符串 + */ + private String getSavedNotificationVersion() { + return mSp.getString(SP_KEY_NOTIFICATION_VERSION, ""); + } + + /** + * 将当前通知版本保存到SP + * @param version 要保存的版本号 + */ + private void saveNotificationVersion(String version) { + mSp.edit().putString(SP_KEY_NOTIFICATION_VERSION, version).commit(); + } + + /** + * 清理所有已创建的通知渠道（API26+ 有效） + */ + private void cleanAllNotificationChannels() { + LogUtils.d(TAG, "cleanAllNotificationChannels() 方法调用"); + // API<26 无渠道机制，直接返回 + if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O || mNotificationManager == null) { + LogUtils.d(TAG, "cleanAllNotificationChannels() API<26 或 NotificationManager为空，无需清理"); + return; + } + + // 遍历所有渠道并删除 + for (NotificationChannel channel : mNotificationManager.getNotificationChannels()) { + LogUtils.d(TAG, "cleanAllNotificationChannels() 正在删除渠道：" + channel.getId() + " | " + channel.getName()); + mNotificationManager.deleteNotificationChannel(channel.getId()); + } + LogUtils.d(TAG, "cleanAllNotificationChannels() 所有旧渠道清理完成"); + } + + // ================================== 核心初始化方法（通知渠道，API分级适配）================================= + /** + * 初始化通知渠道：前台服务渠道（无铃声+无振动）、临时提醒渠道（系统默认铃声+无振动） + */ + private void initNotificationChannels() { + LogUtils.d(TAG, "initNotificationChannels() 方法调用"); + // API<26 无渠道机制，直接返回 + if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) { + LogUtils.d(TAG, "initNotificationChannels() API<26，无需创建渠道，直接返回"); + return; + } + // 通知服务为空，避免空指针 + if (mNotificationManager == null) { + LogUtils.e(TAG, "initNotificationChannels() 失败：NotificationManager is null"); + return; + } + + // 1. 前台服务渠道（低优先级，后台保活无打扰） + NotificationChannel foregroundChannel = new NotificationChannel( + CHANNEL_ID_FOREGROUND, + "拨号服务保活", + NotificationManager.IMPORTANCE_LOW + ); + foregroundChannel.setDescription("拨号服务后台运行，无声音、无振动"); + foregroundChannel.enableLights(false); + foregroundChannel.enableVibration(false); + foregroundChannel.setSound(null, null); + foregroundChannel.setShowBadge(false); + foregroundChannel.setLockscreenVisibility(Notification.VISIBILITY_SECRET); + LogUtils.d(TAG, "initNotificationChannels() 前台服务渠道配置完成"); + + // 2. 临时提醒渠道（中优先级，系统默认铃声，无振动） + NotificationChannel temporaryChannel = new NotificationChannel( + CHANNEL_ID_TEMPORARY, + "临时通知提醒", + NotificationManager.IMPORTANCE_DEFAULT + ); + temporaryChannel.setDescription("拨号服务临时通知，系统默认铃声，无振动"); + temporaryChannel.enableLights(true); + temporaryChannel.enableVibration(false); + temporaryChannel.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT); + temporaryChannel.setShowBadge(false); + temporaryChannel.setLockscreenVisibility(Notification.VISIBILITY_PUBLIC); + LogUtils.d(TAG, "initNotificationChannels() 临时提醒渠道配置完成"); + + // 注册渠道到系统 + mNotificationManager.createNotificationChannel(foregroundChannel); + mNotificationManager.createNotificationChannel(temporaryChannel); + LogUtils.d(TAG, "initNotificationChannels() 成功：创建前台服务+临时提醒渠道"); + } + + // ================================== 对外核心方法（前台服务通知：启动/更新/取消）================================= + /** + * 启动前台服务通知（API30适配，无铃声） + * @param service 前台服务实例 + * @param message 通知内容 + */ + public void startForegroundServiceNotify(Service service, String message) { + LogUtils.d(TAG, "startForegroundServiceNotify() 方法调用 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE + " | service=" + service + " | message=" + message); + // 前置校验：参数非空 + if (service == null || mNotificationManager == null) { + LogUtils.e(TAG, "startForegroundServiceNotify() 失败：param is null | service=" + service + " | mNotificationManager=" + mNotificationManager); + return; + } + + // 构建前台通知 + mForegroundServiceNotify = buildForegroundNotification(message); + if (mForegroundServiceNotify == null) { + LogUtils.e(TAG, "startForegroundServiceNotify() 失败：构建通知为空"); + return; + } + + // 启动前台服务（API30无FOREGROUND_SERVICE_TYPE限制） + try { + service.startForeground(NOTIFY_ID_FOREGROUND_SERVICE, mForegroundServiceNotify); + LogUtils.d(TAG, "startForegroundServiceNotify() 成功"); + } catch (Exception e) { + LogUtils.e(TAG, "startForegroundServiceNotify() 异常", e); + } + } + + /** + * 更新前台服务通知内容（复用通知ID，保持无铃声） + * @param message 新的通知内容 + */ + public void updateForegroundServiceNotify(String message) { + LogUtils.d(TAG, "updateForegroundServiceNotify() 方法调用 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE + " | message=" + message); + if (mNotificationManager == null) { + LogUtils.e(TAG, "updateForegroundServiceNotify() 失败：mNotificationManager is null"); + return; + } + + mForegroundServiceNotify = buildForegroundNotification(message); + if (mForegroundServiceNotify == null) { + LogUtils.e(TAG, "updateForegroundServiceNotify() 失败：构建通知为空"); + return; + } + + try { + mNotificationManager.notify(NOTIFY_ID_FOREGROUND_SERVICE, mForegroundServiceNotify); + LogUtils.d(TAG, "updateForegroundServiceNotify() 成功"); + } catch (Exception e) { + LogUtils.e(TAG, "updateForegroundServiceNotify() 异常", e); + } + } + + /** + * 取消前台服务通知（Service销毁时调用） + */ + public void cancelForegroundServiceNotify() { + LogUtils.d(TAG, "cancelForegroundServiceNotify() 方法调用 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE); + cancelNotification(NOTIFY_ID_FOREGROUND_SERVICE); + mForegroundServiceNotify = null; + LogUtils.d(TAG, "cancelForegroundServiceNotify() 成功"); + } + + // ================================== 对外核心方法（临时通知：发送）================================= + /** + * 发送临时通知（自增ID，避免覆盖，系统默认铃声） + * @param context 上下文 + * @param message 通知内容 + */ + public synchronized void showTemporaryNotification(Context context, String message) { + snMessageNotificationID++; + LogUtils.d(TAG, "showTemporaryNotification() 方法调用 | notifyId=" + snMessageNotificationID + " | context=" + context + " | message=" + message); + // 前置校验：参数非空 + if (context == null || mNotificationManager == null) { + LogUtils.e(TAG, "showTemporaryNotification() 失败：param is null | context=" + context + " | mNotificationManager=" + mNotificationManager); + return; + } + + Notification temporaryNotify = buildTemporaryNotification(context, message); + if (temporaryNotify == null) { + LogUtils.e(TAG, "showTemporaryNotification() 失败：构建通知为空"); + return; + } + + try { + mNotificationManager.notify(snMessageNotificationID, temporaryNotify); + LogUtils.d(TAG, "showTemporaryNotification() 成功 | notifyId=" + snMessageNotificationID); + } catch (Exception e) { + LogUtils.e(TAG, "showTemporaryNotification() 异常 | notifyId=" + snMessageNotificationID, e); + } + } + + // ================================== 对外工具方法（通知取消：单个/全部）================================= + /** + * 取消指定ID的通知 + * @param notifyId 通知唯一标识 + */ + public void cancelNotification(int notifyId) { + LogUtils.d(TAG, "cancelNotification() 方法调用 | notifyId=" + notifyId); + if (mNotificationManager == null) { + LogUtils.e(TAG, "cancelNotification() 失败：NotificationManager is null"); + return; + } + try { + mNotificationManager.cancel(notifyId); + LogUtils.d(TAG, "cancelNotification() 成功 | notifyId=" + notifyId); + } catch (Exception e) { + LogUtils.e(TAG, "cancelNotification() 异常 | notifyId=" + notifyId, e); + } + } + + /** + * 取消所有通知（兜底场景使用） + */ + public void cancelAllNotifications() { + LogUtils.d(TAG, "cancelAllNotifications() 方法调用"); + if (mNotificationManager == null) { + LogUtils.e(TAG, "cancelAllNotifications() 失败：NotificationManager is null"); + return; + } + try { + mNotificationManager.cancelAll(); + LogUtils.d(TAG, "cancelAllNotifications() 成功"); + } catch (Exception e) { + LogUtils.e(TAG, "cancelAllNotifications() 异常", e); + } + } + + // ================================== 内部辅助方法（通知构建：前台服务通知）================================= + /** + * 构建前台服务通知（全版本无铃声+无振动） + * @param message 通知内容 + * @return 构建完成的前台通知实例 + */ + private Notification buildForegroundNotification(String message) { + LogUtils.d(TAG, "buildForegroundNotification() 方法调用 | message=" + message); + if (mContext == null) { + LogUtils.e(TAG, "buildForegroundNotification() 失败：mContext is null"); + return null; + } + + // 内容兜底 + String title = FOREGROUND_NOTIFY_TITLE_DEFAULT; + String content = (message != null && !message.isEmpty()) ? message : FOREGROUND_NOTIFY_CONTENT_DEFAULT; + LogUtils.d(TAG, "buildForegroundNotification() 内容兜底完成 | title=" + title + " | content=" + content); + + Notification.Builder builder; + // API分级构建 + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { + builder = new Notification.Builder(mContext, CHANNEL_ID_FOREGROUND); + LogUtils.d(TAG, "buildForegroundNotification() 使用API26+渠道构建"); + } else { + builder = new Notification.Builder(mContext); + builder.setSound(null); + builder.setVibrate(new long[]{0}); + builder.setDefaults(0); + LogUtils.d(TAG, "buildForegroundNotification() 使用API<26手动配置"); + } + + // 通用配置 + builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON) + .setContentTitle(title) + .setContentText(content) + .setAutoCancel(false) + .setOngoing(true) + .setWhen(System.currentTimeMillis()) + .setContentIntent(createJumpPendingIntent(mContext, PENDING_INTENT_REQUEST_CODE_FOREGROUND)); + + // API21+ 新增大图标+主题色 + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { + builder.setLargeIcon(getAppIcon(mContext)) + .setColor(mContext.getResources().getColor(R.color.colorPrimary)) + .setPriority(Notification.PRIORITY_LOW); + LogUtils.d(TAG, "buildForegroundNotification() 补充API21+配置"); + } + + Notification notification = builder.build(); + LogUtils.d(TAG, "buildForegroundNotification() 成功构建前台通知"); + return notification; + } + + // ================================== 内部辅助方法（通知构建：临时通知）================================= + /** + * 构建临时通知（全版本系统默认铃声+无振动） + * @param context 上下文 + * @param message 通知内容 + * @return 构建完成的临时通知实例 + */ + private Notification buildTemporaryNotification(Context context, String message) { + LogUtils.d(TAG, "buildTemporaryNotification() 方法调用 | context=" + context + " | message=" + message); + if (context == null) { + LogUtils.e(TAG, "buildTemporaryNotification() 失败：context is null"); + return null; + } + + // 内容兜底 + String title = TEMPORARY_NOTIFY_TITLE_DEFAULT; + String content = (message != null && !message.isEmpty()) ? message : TEMPORARY_NOTIFY_CONTENT_DEFAULT; + LogUtils.d(TAG, "buildTemporaryNotification() 内容兜底完成 | title=" + title + " | content=" + content); + + Notification.Builder builder; + // API分级构建 + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { + builder = new Notification.Builder(context, CHANNEL_ID_TEMPORARY); + LogUtils.d(TAG, "buildTemporaryNotification() 使用API26+渠道构建"); + } else { + builder = new Notification.Builder(context); + builder.setSound(Settings.System.DEFAULT_NOTIFICATION_URI); + builder.setVibrate(new long[]{0}); + builder.setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_SOUND); + LogUtils.d(TAG, "buildTemporaryNotification() 使用API<26手动配置"); + } + + // 通用配置 + builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON) + .setContentTitle(title) + .setContentText(content) + .setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT) + .setAutoCancel(true) + .setOngoing(false) + .setWhen(System.currentTimeMillis()) + .setContentIntent(createJumpPendingIntent(context, PENDING_INTENT_REQUEST_CODE_TEMPORARY)); + + // API21+ 新增大图标+主题色 + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { + builder.setLargeIcon(getAppIcon(context)) + .setColor(context.getResources().getColor(R.color.colorPrimary)) + .setPriority(Notification.PRIORITY_DEFAULT); + LogUtils.d(TAG, "buildTemporaryNotification() 补充API21+配置"); + } + + Notification notification = builder.build(); + LogUtils.d(TAG, "buildTemporaryNotification() 成功构建临时通知"); + return notification; + } + + // ================================== 内部辅助方法（创建跳转PendingIntent，API30安全适配）================================= + /** + * 创建跳转MainActivity的PendingIntent，API23+ 添加IMMUTABLE标记 + * @param context 上下文 + * @param requestCode 请求码 + * @return 构建完成的PendingIntent + */ + private PendingIntent createJumpPendingIntent(Context context, int requestCode) { + LogUtils.d(TAG, "createJumpPendingIntent() 方法调用 | requestCode=" + requestCode + " | context=" + context); + Intent intent = new Intent(context, MainActivity.class); + intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP); + LogUtils.d(TAG, "createJumpPendingIntent() 跳转Intent配置完成"); + + // API23+ 必需添加IMMUTABLE，适配API30安全规范 + int flags = PendingIntent.FLAG_UPDATE_CURRENT; + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) { + flags |= PendingIntent.FLAG_IMMUTABLE; + LogUtils.d(TAG, "createJumpPendingIntent() 添加FLAG_IMMUTABLE标记（API23+）"); + } + + PendingIntent pendingIntent = PendingIntent.getActivity(context, requestCode, intent, flags); + LogUtils.d(TAG, "createJumpPendingIntent() 成功 | requestCode=" + requestCode); + return pendingIntent; + } + + // ================================== 内部辅助方法（获取APP图标，异常兜底）================================= + /** + * 获取APP图标，失败返回默认图标 + * @param context 上下文 + * @return APP图标Bitmap实例 + */ + private Bitmap getAppIcon(Context context) { + LogUtils.d(TAG, "getAppIcon() 方法调用 | context=" + context); + try { + PackageInfo pkgInfo = context.getPackageManager().getPackageInfo(context.getPackageName(), 0); + Bitmap appIcon = BitmapFactory.decodeResource(context.getResources(), pkgInfo.applicationInfo.icon); + LogUtils.d(TAG, "getAppIcon() 成功：获取应用图标"); + return appIcon; + } catch (PackageManager.NameNotFoundException e) { + LogUtils.e(TAG, "getAppIcon() 异常：获取应用图标失败，使用默认图标", e); + return BitmapFactory.decodeResource(context.getResources(), NOTIFICATION_DEFAULT_ICON); + } + } + + // ================================== 资源释放方法（避免内存泄漏）================================= + /** + * 释放资源，销毁时调用 + */ + public void release() { + LogUtils.d(TAG, "release() 方法调用：执行资源释放"); + cancelForegroundServiceNotify(); + mNotificationManager = null; + mContext = null; + mSp = null; // ********** 新增：释放SP实例 ********** + LogUtils.d(TAG, "release() 成功：所有资源已释放"); + } + + // ================================== 对外 getter 方法（仅前台通知实例，只读）================================= + public Notification getForegroundServiceNotify() { + return mForegroundServiceNotify; + } +} +