隐私权限弹框的使用说明（Portal&Bundle 接入方式） - 移动开发平台 mPaaS

背景

监管部门要求在用户点击隐私协议弹框中“同意”按钮之前，App 不可以调用相关敏感API。为应对此监管要求，mPaaS Android 10.1.32.17 以上（32 版本）和 10.1.60.5 以上（60 版本）的基线提供了支持，请您根据实际情况参考本文对工程进行改造。

使用方法

新建隐私许可弹框回调类。
在代码中新建一个类，实现PrivacyListener接口，类的实现可以参考以下代码：

     
      public class MyPrivacyListener implements PrivacyListener {
       // 在本方法内进行隐私许可弹框
       @Override
       public void showPrivacy(final Activity activity, final PrivacyResultCallback privacyResultCallback) {
           if(null==privacyResultCallback){
               return;
           }
           if(null!=activity){
               new AlertDialog.Builder(activity)
                       .setTitle("隐私许可弹框")
                       .setMessage("主体内容")
                       .setPositiveButton("同意继续使用", new DialogInterface.OnClickListener() {
                           @Override
                           public void onClick(DialogInterface dialogInterface, int i) {
                               // 点击确定后，取消弹框
                               dialogInterface.cancel();
                               // 将弹框结果设置为 true
                               privacyResultCallback.onResult(true);
                           }
                       })
                       .setNegativeButton("不同意并退出", new DialogInterface.OnClickListener() {
                           @Override
                           public void onClick(DialogInterface dialogInterface, int i) {
                               // 点击不同意后，取消弹框
                               dialogInterface.cancel();
                               // 将弹框结果设置为 false
                               privacyResultCallback.onResult(false);
                               // 结束掉当前的 activity，框架会杀掉进程
                               if(null!=activity){
                                   activity.finish();
                               }
                           }
                       })
                       .setCancelable(false)
                       .create()
                       .show();
           }else{
               // 如果 activity 是空的话，回调结果设置 false
               privacyResultCallback.onResult(false);
           }
       }
      }

注意：

回调时，一定要弹出一个 dialog 来触发 windowFocusChange，触发后框架才会进行后续的操作。
由于该回调类会由系统框架进行反射初始化，且时机非常早，因此请不要添加带方法名的构造函数，以及在构造函数中加入具体逻辑。
如果您需要在弹出 dialog 这里使用资源，在不同基线下需要采用不同的方法。
- 在 32 基线下，您需要采用如下方法：
  Resources resource = QuinoxAgent.getInstance().getResourcesByBundle("资源所在的bundle的bundlename");
  说明： bundlename 可在 Bundle 工程中的主 module 中的 /build/intermediates/bundle/META-INF/BUNDLE.MF 中查看。
- 在 60 基线下，您需要在 portal 工程的主 module 下，建立 res_slinks 文件，并将您的资源所在的 bundle 的 group 和 artifact 按照规则写到 res_slinks 文件内。规则为 group-artifact.split("-")[0]。如果组合后内容过长需要换行，请您注意进行换行处理
  例如：
  group = com.mpaas.demo.materialdesign
  artifact = materialdesign-build，
  最终写入 res_slinks 文件中的配置是 com.mpaas.demo.materialdesign-materialdesign。

在 AndroidManifest 中注册弹框回调类。
在portal的AndroidManifest中注册隐私许可弹框回调类，value是刚才实现的隐私许可弹框回调类的全路径。代码如下所示。注意将全路径及类名要替换成您自己的回调类。
```
     
      
      <meta-data
       android:name="privacy.listener"
       android:value="com.mpaas.demo.launcher.MyPrivacyListener" />
     
```

在启动时弹框。
在MockLauncherApplicationAgent的preInit中，加入启动弹框拦截。代码如下所示：

     
      //检测是否要向用户进行隐私许可弹框
      if(!PrivacyUtil.isUserAgreed(getApplicationContext())){
       PermissionGate.getInstance().waitForUserConform(mContext, getMicroApplicationContext());
      }

启动第一个 Activity。
在MockLauncherActivityAgent的postInit中，进行第一个Activity的跳转。代码如下所示：

     
      // 判断是否获取了用户隐私许可
      if(PrivacyUtil.isUserAgreed(activity)){
       new Handler().postDelayed(new Runnable() {
           public void run() {
               Intent intent = new Intent(activity, MainActivity.class);
               activity.startActivity(intent);
               activity.finish();
           }
       }, 200);
      }