实现 Android 熄屏休眠 APP 保活的完整指南

在Android开发中，熄屏后保持应用活跃是一个常见的需求，特别是对于需要持续运行的应用，如音乐播放器、导航应用等。以下是实现这一功能的步骤和代码详解。

流程概述

在实现Android熄屏休眠APP保活的过程中，可以分为几个主要步骤。以下是这些步骤的流程表：

步骤 描述
步骤 1 创建一个新的 Android 项目
步骤 2 修改 AndroidManifest.xml 以请求适当的权限
步骤 3 创建一个服务以运行后台任务
步骤 4 在服务中实现保持唤醒的逻辑
步骤 5 在熄屏时继续处理需要保持活跃的操作
步骤 6 检查效果，确保应用在熄屏状态下依旧能够运行

流程图

flowchart TD
    A[创建新 Android 项目] --> B[修改 AndroidManifest.xml]
    B --> C[创建服务]
    C --> D[实现保持唤醒逻辑]
    D --> E[实现熄屏操作处理]
    E --> F[检查效果]

步骤详解

步骤 1：创建一个新的 Android 项目

首先，打开 Android Studio 并创建一个新的项目。选择 "Empty Activity" 模板，以便从基础上理解每个组件。

步骤 2：修改 AndroidManifest.xml

在项目中找到 AndroidManifest.xml 文件，添加必要的权限声明，以允许我们在后台运行服务。打开 AndroidManifest.xml 文件，并添加以下代码：

<manifest xmlns:android="
    package="com.example.keepalive">

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

    <application
        ... >
        ...
    </application>
</manifest>
注释：
  • WAKE_LOCK: 允许应用保持 CPU 运行，防止设备进入休眠状态。
  • FOREGROUND_SERVICE: 允许我们的服务在前台运行，从而防止被系统杀死。

步骤 3：创建一个服务

在项目的 java 文件夹中，创建一个新的 Java 类，命名为 KeepAliveService。

import android.app.Service;
import android.content.Intent;
import android.os.IBinder;
import android.util.Log;

public class KeepAliveService extends Service {

    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}
注释：
  • KeepAliveService 类扩展了 Service 类，是我们实现后台任务的核心。

步骤 4：在服务中实现保持唤醒的逻辑

在 KeepAliveService 类中，我们需要实现保持唤醒的逻辑：

import android.app.Notification;
import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.os.Build;
import android.os.PowerManager;
import android.app.PendingIntent;

public class KeepAliveService extends Service {

    private static final String CHANNEL_ID = "KeepAliveChannel";
    private PowerManager.WakeLock wakeLock;

    @Override
    public void onCreate() {
        super.onCreate();
        // 获取PowerManager实例
        PowerManager powerManager = (PowerManager) getSystemService(POWER_SERVICE);
        
        // 创建一个Wakelock保持CPU唤醒
        wakeLock = powerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK,
                "MyApp::KeepAliveWakelock");
        
        // 开启Wakelock
        wakeLock.acquire();

        // 创建通知
        startForegroundService();
    }

    private void startForegroundService() {
        // 创建通知并显示
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel serviceChannel = new NotificationChannel(
                    CHANNEL_ID,
                    "Keep Alive Service Channel",
                    NotificationManager.IMPORTANCE_DEFAULT
            );
            NotificationManager manager = getSystemService(NotificationManager.class);
            manager.createNotificationChannel(serviceChannel);
        }

        Intent notificationIntent = new Intent(this, MainActivity.class);
        PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, notificationIntent, 0);

        Notification notification = new Notification.Builder(this, CHANNEL_ID)
                .setContentTitle("App is Running")
                .setContentText("Keeping the app alive")
                .setSmallIcon(R.drawable.ic_notification) // 用你自己的图标
                .setContentIntent(pendingIntent)
                .build();

        startForeground(1, notification);
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        // 释放WakeLock
        if (wakeLock != null && wakeLock.isHeld()) {
            wakeLock.release();
        }
    }
}
注释：
  • PowerManager.WakeLock: 用于保持设备的 CPU 唤醒而不让设备完全进入休眠状态。
  • startForegroundService(): 创建并启动前台服务，显示一个通知，防止系统杀死服务。

步骤 5：在熄屏时继续处理需要保持活跃的操作

要确保在熄屏时继续处理所需的操作，可以在 KeepAliveService 中添加合适的代码逻辑。您可以使用 BroadcastReceiver 来监听屏幕打开和关闭的事件。

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;

public class ScreenReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_SCREEN_OFF.equals(intent.getAction())) {
            // 设备熄屏操作
            Log.d("ScreenReceiver", "Screen turned off");
        } else if (Intent.ACTION_SCREEN_ON.equals(intent.getAction())) {
            // 设备开屏操作
            Log.d("ScreenReceiver", "Screen turned on");
        }
    }
}

然后在 AndroidManifest.xml 中注册 BroadcastReceiver：

<receiver android:name=".ScreenReceiver" >
    <intent-filter>
        <action android:name="android.intent.action.SCREEN_ON"/>
        <action android:name="android.intent.action.SCREEN_OFF"/>
    </intent-filter>
</receiver>

步骤 6：检查效果

最后，编译并运行您的应用。在熄屏状态下，查看是否能够保持应用活跃，并随时测试来确保切换屏幕不会导致应用被停止。

结尾

通过以上步骤，我们已经成功地实现了一个在熄屏状态下依旧保持活跃的 Android 应用。这里的重要点是使用 WakeLock 和前台服务来确保应用在需要时不会被系统关闭。希望本指南能帮助您顺利实现这一功能。通过不断的学习和实践，您将能够深入理解 Android 开发的更多细节。