【Android 进程保活】应用进程拉活 ( 账户同步拉活 | 账号添加

文章目录

一、账号添加
二、代码示例
- 1、账号添加工具类
- 2、权限注册
- 3、在 Activity 中调用上述工具类
- 4、运行效果
三、源码资源

一、账号添加

在上一篇博客【Android 进程保活】应用进程拉活 ( 账户同步拉活 | 账号服务注册 | 源码资源 ) 介绍了应用账号服务注册 ;

本博客中进行账号添加 ;

账号添加时 , 首先要获取 AccountManager , 通过如下代码获取 :

代码语言：javascript复制

(AccountManager) context.getSystemService(Context.ACCOUNT_SERVICE)

查询应用的账户类型中 , 是否有该账户 , 调用 accountManager.getAccounts() 方法获取指定账户类型的账户 ,

代码语言：javascript复制

        // 需要使用 android.permission.GET_ACCOUNTS 权限
        Account[] accounts = accountManager.getAccounts();

这里的账户类型在 account-authenticator 标签中的 android:accountType 属性中定义的 , 如下示例 :

代码语言：javascript复制

<account-authenticator
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:accountType="keep_progress_alive.account"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name" />

调用 AccountManager 的 getAccounts() 函数 , 需要用到 android.permission.GET_ACCOUNTS 权限 , 在 AndroidManifest.xml 中声明该权限 ;

代码语言：javascript复制

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="kim.hsl.keep_progress_alive">
    <uses-permission
        android:name="android.permission.GET_ACCOUNTS"
        android:maxSdkVersion="22" />
    <application />
</manifest>

如果获取的账户数组不为空 , 说明账户已经存在 , 这里不再进行处理 ;

如果获取的账户数组为空 , 说明账户还没有添加 , 这里需要创建并添加账户 ;

创建账户 : 需要传入账户名称 , 以及账户类型 ;

代码语言：javascript复制

            //创建账户
            Account account = new Account("kim.hsl", ACCOUNT_TYPE);

添加账户 : 需要设置创建的账户 , 账户对应密码 , 账户数据 , 这里设置为空 ;

代码语言：javascript复制

            // 添加一个新账户
            accountManager.addAccountExplicitly(account, "123456", new Bundle());

调用 AccountManager.addAccountExplicitly 需要使用 android.permission.AUTHENTICATE_ACCOUNTS 权限 , 需要在 AndroidManifest.xml 中声明账户 ;

代码语言：javascript复制

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="kim.hsl.keep_progress_alive">
    <uses-permission
        android:name="android.permission.GET_ACCOUNTS"
        android:maxSdkVersion="22" />
    <uses-permission
        android:name="android.permission.AUTHENTICATE_ACCOUNTS"
        android:maxSdkVersion="22" />
    <application />
</manifest>

二、代码示例

1、账号添加工具类

账号添加工具类 :

代码语言：javascript复制

package kim.hsl.keep_progress_alive.account_service;

import android.accounts.Account;
import android.accounts.AccountManager;
import android.annotation.SuppressLint;
import android.content.Context;
import android.os.Bundle;

public class AccountUtils {

    /**
     * 添加账户类型
     * 在 account-authenticator xml 标签中的 android:accountType 属性中定义的
     */
    public static final String ACCOUNT_TYPE = "keep_progress_alive.account";

    /**
     * 添加账户
     * @param context
     */
    public static void addAccount (Context context){
        AccountManager accountManager = (AccountManager) context.getSystemService(Context.ACCOUNT_SERVICE);

        // 需要使用 android.permission.GET_ACCOUNTS 权限
        Account[] accounts = accountManager.getAccounts();

        // 该类型账号不为空
        if (accounts.length > 0){
            // 账户已存在 , 不进行处理

        }else{
            //创建账户
            Account account = new Account("kim.hsl", ACCOUNT_TYPE);
            // 添加一个新账户
            accountManager.addAccountExplicitly(account, "123456", new Bundle());

        }
    }

}

2、权限注册

需要注册如下两个权限 :

代码语言：javascript复制

    <uses-permission
        android:name="android.permission.GET_ACCOUNTS"
        android:maxSdkVersion="22" />

    <uses-permission
        android:name="android.permission.AUTHENTICATE_ACCOUNTS"
        android:maxSdkVersion="22" />

完整清单文件示例 :

代码语言：javascript复制

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

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

    <uses-permission
        android:name="android.permission.GET_ACCOUNTS"
        android:maxSdkVersion="22" />

    <uses-permission
        android:name="android.permission.AUTHENTICATE_ACCOUNTS"
        android:maxSdkVersion="22" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.Keep_Progress_Alive">


        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <!--
            设置最近任务列表中不显示该 Activity 组件 ( 不要被用户察觉 )
            android:excludeFromRecents="true"

            设置 Activity 亲和性
            让该界面在一个独立的任务栈中 , 不要与本应用的其它任务栈放在一起
            避免解除锁屏后 , 关闭 1 像素界面 , 将整个任务栈都唤醒
            android:taskAffinity="kim.hsl.keep_progress_alive.alive"
        -->
        <activity
            android:name=".one_pixel_activity.OnePixelActivity"
            android:excludeFromRecents="true"
            android:taskAffinity="kim.hsl.keep_progress_alive.onepixel"
            android:theme="@style/OnePixelActivityTheme" />

        <!-- 用于提权的前台进程 -->
        <service
            android:name=".foreground_service.ForegroundService"
            android:enabled="true"
            android:exported="true" />

        <!-- 用于提权的前台进程, 关闭通知操作 -->
        <service
            android:name=".foreground_service.CancelNotificationService"
            android:enabled="true"
            android:exported="true" />

        <!-- 系统 Service 机制拉活 -->
        <service
            android:name=".stick_service.StickService"
            android:enabled="true"
            android:exported="true" />

        <!-- 用于账户同步拉活 -->
        <service
            android:name=".account_service.AuthenticationService"
            android:enabled="true"
            android:exported="true" >
            <intent-filter>
                <action android:name="android.accounts.AccountAuthenticator"/>
            </intent-filter>
            <meta-data
                android:name="android.accounts.AccountAuthenticator"
                android:resource="@xml/account_authenticator"/>
        </service>

    </application>

</manifest>

3、在 Activity 中调用上述工具类

代码语言：javascript复制

package kim.hsl.keep_progress_alive;

import androidx.appcompat.app.AppCompatActivity;

import android.content.Intent;
import android.os.Bundle;

import kim.hsl.keep_progress_alive.account_service.AccountUtils;
import kim.hsl.keep_progress_alive.foreground_service.ForegroundService;
import kim.hsl.keep_progress_alive.one_pixel_activity.KeepProgressAliveManager;
import kim.hsl.keep_progress_alive.stick_service.StickService;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 1.  1 像素 Activity 提升应用权限
        // 注册广播接收者 , 1 像素 Activity 启动的 广播接收者
        //KeepProgressAliveManager.getmInstance().registerReceiver(this);

        // 2. 通过前台 Service 提升应用权限
        // 启动普通 Service , 但是在该 Service 的 onCreate 方法中执行了 startForeground
        // 变成了前台 Service 服务
        //startService(new Intent(this, ForegroundService.class));

        // 3. 使用 Service 机制拉活
        //startService(new Intent(this, StickService.class));

        // 4. 账户同步拉活
        AccountUtils.addAccount(this);

    }

    @Override
    protected void onDestroy() {
        super.onDestroy();

        // 1. 取消注册广播接收者, 也可以不取消注册
        //KeepProgressAliveManager.getmInstance().registerReceiver(this);
    }
}