再次理解Android账号管理体系

目录

✅ 0. 需求

📂 1. 前言

🔱 2. 使用

2.1 账户体系前提

2.2 创建账户服务

2.3 操作账户-增删改查

💠 3. 源码流程

---

✅ 0. 需求

        试想，自己去实现一个账号管理体系，该如何做呢？

        ——————————

        最近有遇到这样一个需求：AR眼镜只支持同时与一个手机绑定，即：AR眼镜已与手机绑定过的话，不再支持与其他手机绑定；如要绑定其他手机，需要先解绑当前手机才能重新绑定。

        理解一下需求，即是：眼镜端需要账号管理体系，主要用来存储已绑定过手机的token。

        AR眼镜绑定手机时序图，如下所示：

---

 

📂 1. 前言

        我们知道，Android的账号管理体系是用来管理用户在Android设备上的身份验证和授权的系统，包括了对账号的创建、授权、修改和删除等操作的管理。

        那么，我们为什么要使用Android的账号管理体系？

        ——————————

        尽管，我们可以自己使用SP、MMKV、文件或数据库等方式来存储、更新、删除账户、密码或AuthToken；但其实涉及到跨进程通信，实现起来其实是稍显麻烦的；并且对于数据安全，信息加密这块的可靠性也有待商榷。

        另外，从本文第一张图可见，我们在架构设计中规划的账号体系服务，是寄生于Android启动时system_server开启的服务，然后通过binder方式，提供给其他进程使用。

        然而，在技术预研时发现，强大的Android早已想到了这点，在Android 2.0开始就加入了新包android.accounts，为我们准备好了这样一个服务ACCOUNT_SERVICE。

        而且，该包功能已十分强大，我们可以直接拿来使用，功能主要包括：

1. 集中式的账户管理API，可以安全地存储和访问认证的令牌和密码；
2. 可以在同一个设备中管理同一应用的多个不同账号，能够自动批量的同步服务器更新账户，甚至可以和不同服务器进行数据同步和安全认证；
3. 把账户的验证过程、AuthToken的获取过程分离出来，降低程序的耦合性；
4. 并且会在”设置”应用中添加一个账户入口；
5. 方便应用间账号共享。

🔱 2. 使用

2.1 账户体系前提

        1）账号体系共享前提：使用相同的签名。

        2）权限申明：

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

2.2 创建账户服务

        步骤一：定义一个action为android.accounts.AccountAuthenticator的Intent的Service，并在meta-data的resource属性指定该Account基本显示信息的xml文件authenticator，模版代码如下：

<service
    android:name=".portal.feature.account.service.AccountService"
    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/authenticator" />
service>

        步骤二：在res下的xml文件夹中新建authenticator.xml文件：

"1.0" encoding="utf-8"?>
<account-authenticator xmlns:android="http://schemas.android.com/apk/res/android"
    android:accountType="com.agg.account"
    android:icon="@drawable/ic_test"
    android:label="AggAccount"
    android:smallIcon="@drawable/ic_test" />

        注：android:accountType表示的是Account类型，它必须是唯一的，一般是包名。

        步骤三：创建继承自AbstractAccountAuthenticator的Authenticator文件，如下：

class Authenticator(context: Context) : AbstractAccountAuthenticator(context) {
 
    override fun editProperties(
        response: AccountAuthenticatorResponse?, accountType: String?
    ): Bundle? {
        return null
    }
 
    override fun addAccount(
        response: AccountAuthenticatorResponse?,
        accountType: String?,
        authTokenType: String?,
        requiredFeatures: Array<out String>?,
        options: Bundle?
    ): Bundle? {
        return null
    }
 
    override fun getAuthToken(
        response: AccountAuthenticatorResponse?,
        account: Account,
        authTokenType: String?,
        options: Bundle?
    ): Bundle? {
        return null
    }
 
    override fun confirmCredentials(
        response: AccountAuthenticatorResponse?, account: Account?, options: Bundle?
    ): Bundle? {
        return null
    }
 
    override fun getAuthTokenLabel(authTokenType: String?): String {
        return ""
    }
 
    override fun updateCredentials(
        response: AccountAuthenticatorResponse?,
        account: Account?,
        authTokenType: String?,
        options: Bundle?
    ): Bundle? {
        return null
    }
 
    override fun hasFeatures(
        response: AccountAuthenticatorResponse?, account: Account?, features: Array<out String>?
    ): Bundle? {
        return null
    }
 
}

        步骤四：创建帐户Service，并在Service的onBind中调AbstractAccountAuthenticator的getIBinder()返回其用于远程调用的IBinder，如下所示：

class AccountService : Service() {
 
    private var authenticator: Authenticator? = null
 
    override fun onCreate() {
        super.onCreate()
        authenticator = Authenticator(this)
    }
 
    override fun onBind(intent: Intent?): IBinder? {
        return authenticator?.iBinder
    }
 
}

        注：运行起来程序后，在“设置”应用-“帐户”-“添加帐户”列表中就已可以发现自己的app了。

2.3 操作账户-增删改查

        1）获取所有账号

    /**
     * 获取所有账号
     */
    fun getAllAccount(context: Context) {
        val accountManager = context.getSystemService(Context.ACCOUNT_SERVICE) as AccountManager
        Log.e(TAG, "getAllAccount: size = ${accountManager.accounts.size}")
        for (account in accountManager.accounts) {
            Log.e(TAG, "getAllAccount: $account")
        }
    }

         2）添加账号

    /**
     * 添加账号
     */
    fun addAccount(
        context: Context, account: Account, password: String, authToken: String
    ) {
        val bundle = Bundle()
        bundle.putString(AccountManager.KEY_ACCOUNT_NAME, account.name)
        bundle.putString(AccountManager.KEY_ACCOUNT_TYPE, account.type)
        bundle.putString(AccountManager.KEY_AUTHTOKEN, authToken)
        bundle.putString(AccountManager.KEY_PASSWORD, password)
        AccountManager.get(context).addAccountExplicitly(account, password, bundle)
    }

         3）更新某个账号

    /**
     * 更新某个账号
     */
    fun updateAccount(
        context: Context, account: Account, password: String = "", authToken: String = ""
    ) {
        var updatePassword = password
        var updateAuthToken = authToken
        AccountManager.get(context).apply {
            if (updatePassword.isEmpty()) {
                updatePassword = getUserData(account, AccountManager.KEY_PASSWORD)
            }
            if (updateAuthToken.isEmpty()) {
                updateAuthToken = getUserData(account, AccountManager.KEY_AUTHTOKEN)
            }
            removeAccountExplicitly(account)
        }
        addAccount(context, account, updatePassword, updateAuthToken)
    }

         4）删除某个账号

    /**
     * 删除某个账号
     */
    fun delAccount(context: Context, account: Account) {
        val isRemoveSuccess = AccountManager.get(context).removeAccountExplicitly(account)
        Log.e(TAG, "delAllAccount: isRemoveSuccess = $isRemoveSuccess, $account")
    }

          5）删除所有账号

    /**
     * 删除所有账号
     */
    fun delAllAccount(context: Context) {
        val accountManager = AccountManager.get(context)
        for (account in accountManager.accounts) {
            val isRemoveSuccess = accountManager.removeAccountExplicitly(account)
            Log.e(TAG, "delAllAccount: isRemoveSuccess = $isRemoveSuccess, $account")
        }
    }

💠 3. 源码流程

• 从系统启动system_server进程，进而启动ACCOUNT_SERVICE服务开始；
• AccountManager是一个面向应用程序开发的组件，它提供了一套对应于IAccountManager协议的应用程序接口；
• 这组接口通过Binder机制与系统服务AccountManagerService进行通信，协作完成帐号相关的操作；
• 同时AccountManager接收authenticators提供的回调，以便在帐号操作完成之后向调用此帐号服务的业务返回对应的接口，同时触发这个业务对结果的处理。