第 5 章- 广播实践--强制用户下线功能

最新推荐文章于 2024-08-25 14:26:55 发布

AndroidDev2022

最新推荐文章于 2024-08-25 14:26:55 发布

阅读量2.3k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： Android 基础文章标签： Android 广播强制下线

本文链接：https://blog.youkuaiyun.com/jdfkldjlkjdl/article/details/43018965

Android 基础专栏收录该内容

23 篇文章

订阅专栏

本文介绍了一个Android应用中实现用户强制下线功能的最佳实践方案。通过创建广播接收器ForceOfflineReceiver来监听特定广播，一旦接收到强制下线指令，即关闭所有活动并返回登录界面。

2020 年复盘这个小项目，发现随着 Android 版本的迭代，本文中的项目存在着兼容性问题，主要是：

1. 静态广播在 android 8.0 以后无法接收（参考）

2. Android6.0 之后 SYSTEM_ALERT_WINDOW 权限需要动态申请（参考）

3. Android8.0 之后需要根据不同的版本设置弹框的类型字段(参考)

本次更新就是针对这两个问题做优化。（2020.06.01）

关于广播的基础知识参看我的这篇文章http://blog.youkuaiyun.com/jdfkldjlkjdl/article/details/43017091

下面是一个强制用户线下的例子。仅供参考。

强制下线功能需要先关闭掉所有的活动，然后回到登陆界面。

1.首先创建一个项目BroadcastBestPractice，并新建ActivityController类，

package com.example.broadcastbestpractice;

import java.util.ArrayList;
import java.util.List;

import android.app.Activity;

/** 
* @ClassName: ActivityController 
* @Description: 该类用于管理所有的活动
* @author xzy 
* @date 2015-1-22 上午9:12:48 
*  
*/
public class ActivityController {
	
	public static List<Activity> activities = new ArrayList<Activity>();
	public static void addActivity(Activity activity){
		activities.add(activity);
	}
	
	public static void removeActivity(Activity activity){
		activities.remove(activity);
	}
	
	public static void finishAll(){
		for(Activity activity:activities){
			if(!activity.isFinishing()){
				activity.finish();
			}
		}
	}
}

2.创建BaseActivity作为所有活动的父类。

package com.example.broadcastbestpractice;

import android.app.Activity;
import android.os.Bundle;

/** 
* @ClassName: BaseActivity 
* @Description: 构建所有活动的父类
* @author xzy 
* @date 2015-1-22 上午9:18:18 
*  
*/
public class BaseActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		// TODO Auto-generated method stub
		super.onCreate(savedInstanceState);
		ActivityController.addActivity(this);
	}
	
	@Override
	protected void onDestroy() {
		// TODO Auto-generated method stub
		super.onDestroy();
		ActivityController.removeActivity(this);
	}
}

3.创建一个登陆界面的布局文件login.xml，此处主要实现功能，界面很简单。

<?xml version="1.0" encoding="utf-8"?>
<TableLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:stretchColumns="1" >

    <TableRow>

        <TextView
            android:layout_height="wrap_content"
            android:text="Account:" />

        <EditText
            android:id="@+id/accountEdit"
            android:layout_height="wrap_content"
            android:hint="input your account" />
    </TableRow>

    <TableRow>

        <TextView
            android:layout_height="wrap_content"
            android:text="Password:" />

        <EditText
            android:id="@+id/passwordEdit"
            android:layout_height="wrap_content"
            android:inputType="textPassword" />
    </TableRow>

    <TableRow>

        <Button 
            android:id="@+id/login"
            android:layout_height="wrap_content"
            android:layout_span="2" 
            android:text="Login"
            />
    </TableRow>

</TableLayout>

4.写登陆活动 LoginActivity.java,并让其继承自BaseActivity.java.

在 LoginActivity 需要动态申请 SYSTEM_ALERT_WINDOW 权限。这个权限比较特殊，需要调到设置页面打开对应的开关。

参考这里：

https://blog.youkuaiyun.com/scimence/article/details/101050780https://blog.youkuaiyun.com/scimence/article/details/101050780

package com.example.broadcastbestpractice;

import android.content.Intent;
import android.os.Build;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

import androidx.annotation.RequiresApi;

import com.example.broadcastbestpractice.base.BaseActivity;
import com.example.broadcastbestpractice.permission.FloatTool;

/**
 * 《第一行代码》 第五章，广播的最佳实践 -- 强制下线
 *
 * @author xzy
 */
public final class LoginActivity extends BaseActivity {

    private EditText etAccount, etPass;

    @RequiresApi(api = Build.VERSION_CODES.M)
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 动态申请弹窗权限
        FloatTool.requestOverlayPermission(this);
        setContentView(R.layout.activity_login);
        etAccount = findViewById(R.id.accountEdit);
        etPass = findViewById(R.id.passwordEdit);
        Button btnLogin = findViewById(R.id.login);
        btnLogin.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View arg0) {
                String account = etAccount.getText().toString();
                String password = etPass.getText().toString();
                //模拟登陆
                if ("xu".equals(account) && "123".equals(password)) {
                    Intent intent = new Intent(LoginActivity.this, MainActivity.class);
                    startActivity(intent);
                    finish();
                } else {
                    Toast.makeText(getApplicationContext(), "login failure", Toast.LENGTH_LONG).show();
                }
            }
        });
    }

    /**
     * Activity执行结果
     */
    @Override
    @RequiresApi(api = Build.VERSION_CODES.M)
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        FloatTool.onActivityResult(requestCode, resultCode, data, this);
    }

}

权限获取成功后，模拟登陆到首页。大致逻辑就是这样，我们看一下请求权限的工具类源码：

package com.example.broadcastbestpractice.permission;

import android.app.Activity;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.content.Intent;
import android.net.Uri;
import android.os.Build;
import android.provider.Settings;
import android.util.Log;

import androidx.annotation.RequiresApi;

import java.util.Objects;


/**
 * 参考 https://blog.youkuaiyun.com/scimence/article/details/101050780https://blog.youkuaiyun.com/scimence/article/details/101050780
 * FloatTool.java:应用悬浮窗权限请求
 * <p>
 * AndroidMainifest.xml中添加： <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
 * <p>
 * 用法：
 * 1、请求悬浮窗权限：FloatTool.RequestOverlayPermission(this);
 * 2、处理悬浮窗权限请求结果：FloatTool.onActivityResult(requestCode, resultCode, data, this);
 *
 * @author xzy
 */
public class FloatTool {
    public static boolean CanShowFloat = false;

    private static final int REQUEST_OVERLAY = 5004;

    /**
     * 动态请求悬浮窗权限
     */
    public static void requestOverlayPermission(Activity instance) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            if (!Settings.canDrawOverlays(instance)) {
                Intent intent = new Intent("android.settings.action.MANAGE_OVERLAY_PERMISSION"
                        , Uri.parse("package:" + instance.getPackageName()));
                instance.startActivityForResult(intent, REQUEST_OVERLAY);
            } else {
                CanShowFloat = true;
            }
        }
    }

    /**
     * 浮窗权限请求，Activity执行结果，回调函数
     */
    @RequiresApi(api = Build.VERSION_CODES.M)
    public static void onActivityResult(int requestCode, int resultCode, Intent data, final Activity instance) {
        if (requestCode == REQUEST_OVERLAY) {
            if (resultCode == Activity.RESULT_OK) {
                // 设置标识为可显示悬浮窗
                CanShowFloat = true;
            } else {
                CanShowFloat = false;
                // 若当前未允许显示悬浮窗，则提示授权
                if (!Settings.canDrawOverlays(instance)) {
                    AlertDialog.Builder builder = new AlertDialog.Builder(instance);
                    builder.setCancelable(false);
                    builder.setTitle("悬浮窗权限未授权");
                    builder.setMessage("应用需要悬浮窗权限，以展示浮标");
                    builder.setPositiveButton("去添加 权限", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialog, int which) {
                            dialog.dismiss();
                            requestOverlayPermission(instance);
                        }
                    });

                    builder.setNegativeButton("拒绝则 退出", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialog, int which) {
                            dialog.dismiss();
                            // 若拒绝了所需的权限请求，则退出应用
                            instance.finish();
                            System.exit(0);
                        }
                    });
                    builder.show();
                }
            }
        }
    }
}

5.修改activity_main.xml文件

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity" >

    <Button
        android:id="@+id/force_offline"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Send force offline broadcast" />

</RelativeLayout>

6.修改MainActivity代码，在该代码中实现强制下线功能

package com.example.broadcastbestpractice;

import android.annotation.SuppressLint;
import android.content.Intent;
import android.os.Build;
import android.os.Bundle;
import android.view.View;

import androidx.annotation.Nullable;

import com.example.broadcastbestpractice.base.BaseActivity;

/**
 * @author xzy
 */
public class MainActivity extends BaseActivity {

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.btn_force_offline).setOnClickListener(new View.OnClickListener() {
            @SuppressLint("WrongConstant")
            @Override
            public void onClick(View v) {
                //动态注册广播--需要创建一个广播接收器来接收该广播
                Intent intent = new Intent("com.example.broadcastbestpractice.FORCE_OFFLINE");
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
                    // 参考 https://www.jianshu.com/p/5283ebc225d5?utm_source=oschina-app
                    intent.addFlags(0x01000000);
                }
                sendBroadcast(intent);
            }
        });
    }
}

上面的程序很简单，但是有一个重点，就是我们在按钮里面发送了一条广播，广播的值为com.example.broadcastbestpractice.FORCE_OFFLINE;

注意了，高版本的 Android 系统，这里需要添加一个 flag，才能接收到静态广播。具体原因参考这篇文章的分析：

https://www.jianshu.com/p/5283ebc225d5?utm_source=oschina-app

这条广播是用于通知程序强制用户下线的。也就是说强制用户下线程序并不是卸载MainActivity中，而是应该写在接收这条广播的接收器里面，这样强制下线的功能就不会依附于任何界面，不管在程序的那个界面，只要发送一条这样的广播，就可以完成强制下线的操作了。name毫无疑问，接下来我们就需要创建一个广播接收器了。

7.新建接收器ForceOfflineReceiver,继承自BroadcastReceiver

package com.example.broadcastbestpractice.receiver;

import android.app.AlertDialog;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.os.Build;
import android.view.WindowManager;

import androidx.annotation.RequiresApi;

import com.example.broadcastbestpractice.LoginActivity;
import com.example.broadcastbestpractice.controller.ActivityController;

import java.util.Objects;

/**
 * @author xzy
 */
public class ForceOfflineReceiver extends BroadcastReceiver {

    @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public void onReceive(final Context context, Intent intent) {
        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(context);
        dialogBuilder.setTitle("Warning");
        dialogBuilder.setMessage("You are forced to be offline.Please try to login again.");
        dialogBuilder.setCancelable(false);
        dialogBuilder.setPositiveButton("OK", new DialogInterface.OnClickListener() {

            @Override
            public void onClick(DialogInterface dialog, int which) {
                // TODO Auto-generated method stub
                //销毁所有的活动
                ActivityController.finishAll();
                Intent intent = new Intent(context, LoginActivity.class);
                //在广播接收器里面启动活动，因此一定要给intent加入如下标识。
                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(intent);
            }
        });
        AlertDialog alertDialog = dialogBuilder.create();
        //需要设置AlertDialog的类型，保证在广播接收器中可以正常弹出
        // Android 8.0 以及以后的系统需要这样设置
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            // 前提要动态申请相关权限（android.settings.action.MANAGE_OVERLAY_PERMISSION），不然依然会闪退
            Objects.requireNonNull(alertDialog.getWindow())
                    .setType(WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY);
        } else {
            Objects.requireNonNull(alertDialog.getWindow())
                    .setType(WindowManager.LayoutParams.TYPE_SYSTEM_ALERT);
        }
        alertDialog.show();
    }
}

这次onReceive()方法里可不再是仅仅弹出一个Toast，而是加入较多的代码，首先使用AlertDialog.Builder来构建一个对话框，注意这里一定要调用setCancelable()方法将对话框设置为不可取消，否则用户按一下back键就可以关闭对话框继续使用程序了。然后使用setPositiveButton()方法来给对话框注册确定按钮，当用户点击了确定按钮时，就调用ActivityController的finishAll()方法来销毁所有的活动，并重新启动LoginActivity这个活动，另外，由于我们在广播接收器里面启动活动的，因为一定要给Intent加入FLAG_ACTIVITY_NEW_TASK这个标志。

最后还要设置对话框的类型，高版本（API>=26），需要将类型设置为 TYPE_APPLICATION_OVERLAY,否则设置为 TYPE_SYSTEM_ALERT。如果在高版本不单独设置类型，它将无法在广播接收器里弹出，甚至有可能闪退。

这样的话，所有强制下线的逻辑就已经基本完成，接下来我们还需要对AndroidManifest.xml文件进行配置。

8.配置AndroidManifest.xml文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.broadcastbestpractice">

    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
    <application
        android:name=".application.RootApp"
        android:allowBackup="false"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".LoginActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity android:name=".MainActivity" />

        <receiver
            android:name=".receiver.ForceOfflineReceiver"
            android:permission="com.example.broadcastbestpractice">
            <intent-filter>
                <action android:name="com.example.broadcastbestpractice.FORCE_OFFLINE" />
            </intent-filter>
        </receiver>
    </application>

</manifest>

上面的配置文件需要注意的几点:

1. 由于在ForceOfflineReceiver里弹出了一个系统级别的对话框，因此必须要声明android.permission.SYSTEM_ALERT_WINDOW权限，并且对于高版本，需要动态申请此权限。然后对LoginActivity进行注册，并把它设置为主活动。

2. 对ForceOfflineReceiver进行注册，并指定它接收 broadcastbestpractice.FORCE_OFFLINE 这条广播。

程序源代码：GitHub - hgncxzy/BestPractice: 《第一行代码》每章节最后的最佳实践，代码实操。