Android多用户适配

构建可感知多用户的应用

对于支持多用户的设备，设备上的应用在必要时需要感知不同的用户。

某些应用需要将一些组件(服务)作为单例运行，并且可以接受来自任意用户的请求。android系统目前仅支持系统应用使用此功能。

系统应用这样做的优势在于：节约资源、判定各个用户之间的一个或多个共享资源、通过使用单个服务器减少网络开销。

多用户权限模型：

构建可感知多用户相关主题：

a) 启用单例组件

要将应用识别为单例，请将android:singleUser="true"添加至Android清单中的服务或提供程序。

在仅以用户0的身份运行的进程中，系统会将该组件实例化。所有连接到该提供程序或服务的用户请求都将按指定路径发送到用户0的进程中。

如果该组件是应用中的唯一组件，则只运行一个应用实例。软件包中的活动仍将在每个用户各自的进程中启动，并且uid出去相应用户的uid范围内。

b) 多个用户或资料中的服务

并非所有服务都需要在其它用户或工作profile中运行实例。如果某些系统服务只需要以用户0的身份运行，则在其它用户的身份运行时停用该服务组件，

以帮组保留资源。以下示例代码显示了如何在服务的入口点执行此操作：

//Add on all entry points such as boot_completed or other manifest-listed receivers and providers

if (!UserManager.isSystemUser()) {
    // Disable the service
    ComponentName targetServiceName = new ComponentName(this, TargetService.class);
    //可以用PackageManager.setApplicationEnabledSetting()停用整个应用
    context.getPackageManager().setComponentEnabledSetting(
        targetServiceName, COMPONENT_ENABLED_STATE_DISABLED, 0);
}

c) 与用户互动

设置权限

       使用多用户相关的API需要下列权限：

       INTERACT_ACROSS_USERS (signature|system)

       INTERACT_ACROSS_USERS_FULL (signature)

       <permission android:name="android.permission.INTERACT_ACROSS_USERS" android:protectionLevel="signature"<!--"system"-->/> 

       <permission android:name="android.permission.INTERACT_ACROSS_USERS_FULL" android:protectionLevel="signature"/>

API

使用下列API，确保应用能够感知多个用户.

1.提取用户句柄、唯一标识：

• int userHandle = UserHandle.getCallingUserId();   //从传入的Binder调用中获取句柄
• int userHandle = getSystemService(Context.USER_SERVICE).getUserHandle();   //获取应用进程运行所在的用户句柄
• int userHandle = getSystemService(Context.USER_SERVICE).getUserHandle(userSerialNumber); //从用户串号获取用户句柄
• long serialNumber =  getSystemService(Context.USER_SERVICE).getSerialNumberForUser(UserHandle user); //获取用户串号

2.启动特定用户的服务，Activity和广播

• Context.startActivityAsUser(Intent,UserHandle)
• Context.bindServiceAsUser(Intent, ... ,UserHandle)
• Context.sendBroadcastAsUser(Intent, ... , UserHandle)
• Context.startServiceAsUser(Intent, ... , UserHandle)

UserHandle可以时显示用户，也可以是以下特殊句柄之一：UserHandle.CURRENT & UserHandle.ALL。CURRENT标识当前位于前台的用户。

ALL标识所有用户，如果您想向所有用户发送广播，则使用UserHandle.ALL。

3. 跨用户组件通信权限

• 与自己应用中的组件通信，使用INTERACT_ACROSS_USERS
• 与其它应用中的组件通信，使用INTERACT_ACROSS_USERS_FULL

4. 您可能需要创建代理组件，这些代理组件在用户进程中运行，之后会访问用户0的singleUser组件

5. 使用UserManager查询设备上的用户

• Boolean supports =UserManager.supportMultipleUsers(); //查询设备对是否支持多用户

• <UserInfo> users= getSystemService(Context.USER_SERVICE).getUsers(); //查询设备上的用户信息，返回用户信息列表

• UserInfo user = getSystemService(Context.USER_SERVICE).getUserInfo(UserHandle); //查询用户信息

6. 注册监听回调

      注册即可借助ContentObserver、PackageMonitor和BroadcastReceiver上为多用户新添加的API监听特定或所有用户以及回调，

（可提供与回调发起用户相关的其它信息）。这类新添加的API显著的特点是在API参数列表中新添加了多用户相关的参数：int userHandle。比如：

      ContentObserver监听uri变化注册接口（ContentResolver类中）

   public final void registerContentObserver(Uri uri, boolean notifyForDescendents,ContentObserver observer, @UserIdInt int userHandle)  //多用户新方法

   public final void registerContentObserver(@NonNull Uri uri, boolean notifyForDescendants,@NonNull ContentObserver observer)