DCloud_App_Array
DCloud_App_Array
  • 发布:2020-02-08 00:01
  • 更新:2024-08-22 08:42
  • 阅读:339189

Android平台隐私与政策提示框配置方法

分类:HTML5+

此文档将不再维护,请参考新文档:https://uniapp.dcloud.io/tutorial/app-privacy-android

HBuilderX2.6.3+版本开始支持配置隐私政策提示框
HBuilderX3.1.10+版本优化template模式策略,解决应用市场检测到弹出隐私政策提示框之前读取mac地址和应用列表的问题
HBuilderX3.2.1+版本开始支持androidPrivacy.json文件配置隐私政策提示框,真机运行时也可生效
HBuilderX3.2.5+版本隐私政策提示框内容中的链接支持本地 html 页面地址
注意:目前设置custom模式策略,并不能完全避免在弹出隐私提示框之前,读取设备信息(如mac地址、应用列表等)的情况,主要原因是自定义模式隐私提示框并不能阻塞应用的生命周期,使用到一些三方SDK(如X5 Webview内核、UniPush等)在应用启动时会执行初始化操作,三方SDK这是可能会读取设备信息。碰到此问题的开发者请先使用template模式解决,我们后续会提供新的自定义隐私提示框样式解决方案。

uni小程序SDK暂时不支持uniapp自己配置隐私弹窗,需要宿主自行实现隐私弹窗

请使用HBuilderX3.2.15+ 版本打包,并使用template配置隐私弹窗否则无法正常上架应用市场

概述

根据工业和信息化部关于开展APP侵害用户权益专项整治要求,App提交到应用市场必须满足以下条件:

  • 应用启动运行时需弹出隐私政策协议,说明应用采集用户数据
    这里将详细介绍如何配置弹出“隐私协议和政策”提示框
  • 应用不能强制要求用户授予权限,即不能“不给权限不让用”
    如不希望应用启动时申请“读写手机存储”和“访问设备信息”权限,请参考:https://ask.dcloud.net.cn/article/36549

为了兼顾隐私政策提示框的易用性和灵活性,解决弹出隐私政策提示框之前可能弹出系统授权框的问题。Android平台提供了以下隐私政策提示配置策略:

  • template
    使用原生提供的隐私政策模板提示框,应用启动时在splash界面弹出。
    • 优点:在系统授权提示框之前显示,用户点击确认后才会进入应用
    • 缺点:只能配置提示文本及链接地址,无法自定义提示框样式
  • none
    不处理隐私政策
    不提交到应用市场时使用

DCloud数据采集说明

为了持续优化应用及提供统计报表功能,在运行过程中会采集应用启动时间、异常错误日志等数据,其中包含设备唯一识别码。

DCloud通过了国家信息安全等级保护三级,证书编号:11010813802-20001,保障相关数据的安全性
DCloud并非大数据公司,采集的数据是为开发者提供统计服务和产品持续优化,不包含个人隐私信息

请在《隐私政策》中必告知用户您的应用基于DCloud uni-app(5+ App/Wap2App)开发,增加如下参考条款

我们的产品基于DCloud uni-app(5+ App/Wap2App)开发,应用运行期间需要收集您的设备唯一识别码(IMEI/android ID/DEVICE_ID/IDFA、SIM 卡 IMSI 信息、OAID)以提供统计分析服务,并通过应用启动数据及异常错误日志分析改进性能和用户体验,为用户提供更好的服务。详情内容请访问《DCloud用户服务条款》。(DCloud用户服务条款超链至:https://ask.dcloud.net.cn/protocol.html)

配置方式

HBuilderX3.2.1及以上版本配置方式

从HBuilderX3.2.1+版本开始新增androidPrivacy.json文件配置隐私政策提示框,支持真机运行查看效果,在androidPrivacy.json中也支持配置部分样式(如背景颜色、标题颜色、按钮颜色等)。
打开项目的manifest.json文件,切换到“App启动界面配置”,在“Android启动界面样式”中勾选“使用原生隐私政策提示框”

注意!androidPrivacy.json不要添加注释,会影响隐私政策提示框的显示!!!

勾选后会在项目中自动添加androidPrivacy.json文件,可以双击打开自定义配置以下内容:

{  
  "version": "1",    
  "prompt": "template",  
  "title": "服务协议和隐私政策",  
  "message": "  请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/>  你可阅读<a href=\"\">《服务协议》</a>和<a href=\"\">《隐私政策》</a>了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。",  
  "buttonAccept": "同意并接受",  
  "buttonRefuse": "暂不同意",  
   // HX 3.4.13之后版本新增,system 使用系统webview 打开隐私协议链接,默认使用uni-app内置web组件  
  "hrefLoader":“system|default”  
  "second": {  
    "title": "确认提示",  
    "message": "  进入应用前,你需先同意<a href=\"\">《服务协议》</a>和<a href=\"\">《隐私政策》</a>,否则将退出应用。",  
    "buttonAccept": "同意并继续",  
    "buttonRefuse": "退出应用"  
  },  
  "styles": {  
    "backgroundColor": "#00FF00",  
    "borderRadius":"5px",  
    "title": {  
      "color": "#ff00ff"  
    },  
    "buttonAccept": {  
      "color": "#ffff00"  
    },  
    "buttonRefuse": {  
      "color": "#00ffff"  
    }  
  }  
}
  • version
    隐私政策版本号,如果应用升级后希望重新弹出隐私政策提示框,则需要设置新版本
  • prompt
    是否使用原生隐私政策提示框,值为“template”表示使用,“none”表示不使用
  • title
    隐私政策提示框标题文本内容
  • message
    隐私政策提示框正文内容,支持富文本richtext类型字符串,支持a/font/br等节点,点击a链接会调用内置页面打开其href属性中链接地址。
    注意:务必配置此提示内容,参考上面示例内容并修改《服务协议》和《隐私政策》链接地址
  • buttonAccept
    模板提示框上接受按钮的文本,默认值为“同意”
  • buttonRefuse
    模板提示框上拒绝按钮的文本,默认不显示此按钮
  • hrefLoader
    HX 3.4.13之后版本新增,system 使用系统webview 打开隐私协议链接,默认 default 使用uni-app内置web组件
  • second
    配置二次确认提示框显示内容,message属性值不为空时弹出二次确认提示框
    • title 二次确认提示框上的标题
    • message 二次确认提示框上的内容,支持富文本richtext类型字符串
    • buttonAccept 二次确认提示框上接受按钮的文本
    • buttonRefuse 二次确认提示框上拒绝按钮的文本
  • styles
    配置隐私政策提示框样式
    • backgroundColor 提示框背景颜色,#RRGGBB格式字符串
    • borderRadius 提示框背景圆角半径,单位为px(逻辑像素)
    • title 提示框标题样式,其下仅支持color属性配置文本颜色,值为#RRGGBB格式字符串
    • buttonAccept 接受按钮样式,其下仅支持color属性配置文本颜色,值为#RRGGBB格式字符串
    • buttonRefuse 拒绝按钮样式,其下仅支持color属性配置文本颜色,值为#RRGGBB格式字符串
  • disagreeMode
    未同意隐私政策模式 HBuilder X 3.3.1版本新增支持 具体配置及说明查看https://uniapp.dcloud.io/app-disagreemode
    • support true表示开启disagreeMode;false表示不开启(用户不同意“隐私政策”则退出应用)。默认值为false。
    • loadNativePlugins 表示在disagreeMode模式是否加载uni原生插件,true表示加载;false表示不加载(此时调用uni.requireNativePlugin加载插件扩展Module返回undefined,扩展组件Component也无法使用)。默认值为true。

uni-app项目可以使用uni原生插件能支持更多自定义隐私政策提示框样式,可参考:https://ext.dcloud.net.cn/plugin?id=5581

HBuilderX3.2.0及以下版本配置方法

打开项目的manifest.json文件,切换到“源码视图”项

  • uni-app项目
    在 "app-plus" -> "privacy" 节点下添加 prompt节点
  • 5+ App项目
    在 "plus" -> "privacy" 节点下添加 prompt节点

privacy节点数据格式如下:

    "privacy": {  
      "prompt": "template",  //可取值template、none  
      "template": { //prompt取值为template时有效,用于配置模板提示框上显示的内容  
      }  
    }
  • prompt
    字符串类型,必填,隐私政策提示框配置策略,可取值template,none,默认值为none
    • template
      使用原生提示框模板,可自定义标题、内容已经按钮上的文本
    • none
      不弹出隐私政策提示框
  • template
    json格式,可选,模板提示框上显示的内容

模板提示框

配置promt属性值为template时,表示使用原生模板隐私政策提示框,效果如下:


应用启动前,在Splash页面时显示此提示框,用户点击同意按钮后才会进入应用

可使用以下配置模板提示框内容

    "privacy": {  
      "prompt": "template",  
      "template": {  
        "title": "服务协议和隐私政策",  
        "message": "  请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/>  你可阅读<a href=\"\">《服务协议》</a>和<a href=\"\">《隐私政策》</a>了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。",  
        "buttonAccept": "同意",  
        "buttonRefuse": "暂不同意",  
        "second": {  
          "title": "温馨提示",  
          "message": "  进入应用前,你需先同意<a href=\"\">《服务协议》</a>和<a href=\"\">《隐私政策》</a>,否则将退出应用。",  
          "buttonAccept": "同意并继续",  
          "buttonRefuse": "退出应用",  
        }   
      }  
    }
  • title
    模板提示框上的标题,默认为“服务协议和隐私政策”
  • message
    模板提示框上的内容,richtext类型字符串,支持a/font/br等节点,点击a链接会调用内置页面打开其href属性中链接地址。
    • HBuilderX3.2.5以下版本a链接的href属性仅支持网络地址,以http:或https:开头,如“https://www.dcloud.io/privacy.html”
    • HBuilder3.2.5及以上版本a链接的href属性支持本地地址,相对于应用根目录,如“static/privacy.html”
      注意:务必配置此提示内容,参考上面示例内容并修改《服务协议》和《隐私政策》链接地址
  • buttonAccept
    模板提示框上接受按钮的文本,默认值为“同意”,
    注意:接受按钮设置为“我知道了”在部分应用市场上架时会审核不通过。
  • buttonRefuse
    模板提示框上拒绝按钮的文本,默认不显示此按钮
  • second
    HBuilderX3.1.12+版本新增支持隐私提示框二次确认提示,用于配置二次确认提示框显示内容,message属性值不为空时弹出二次确认提示框
    • title 二次确认提示框上的标题
    • message 二次确认提示框上的内容,支持richtext类型字符串
    • buttonAccept 二次确认提示框上接受按钮的文本
    • buttonRefuse 二次确认提示框上拒绝按钮的文本

配置后提交云端打包后生效

提供5+ API设置/获取状态:

  • 获取是否同意隐私政策
    参考规范:plus.runtime.isAgreePrivacy
    应用启动时调用此API查下状态,如果用户未同意则弹出自定义隐私政策提示框。
    if(!plus.runtime.isAgreePrivacy()){  
    //弹出自定义隐私政策提示框  
    }
  • 设置为同意隐私政策
    参考规范:plus.runtime.agreePrivacy
    在自定义隐私政策提示界面用,用户点击“同意”按钮时需调用此API设置状态
  • 设置为不同意隐私政策
    参考规范:plus.runtime.disagreePrivacy
    在自定义隐私政策提示界面用,用户点击“不同意”按钮时需调用此API设置状态

注意:用户同意隐私政策前不要调用可能弹出系统授权框的API,如定位(plus.geolocation)、录音(plus.audio.getRecorder)等

无提示框

配置prompt属性值为none时,表示不显示隐私政策提示框。
如果不提交到应用市场,可以使用此模式。

离线打包配置方式

HBuilderX3.2.1+版本新增androidPrivacy.json配置隐私政策提示框,优先级高于原生环境配置,新版本没有必要再在原生工程中配置

在原生工程中应用的AndroidManifest.xml中配置隐私提供框模式,在application节点下添加meta-data节点数据,如下:

<application>  
<meta-data  
            android:name="DCLOUD_PRIVACY_PROMPT"  android:value="template"/>  
</application>

android:value可取值为"template"、"none"。

配置使用"template"模板提示框时,需要按以下方法配置提示框内容
在原生工程的res/values目录下的strings.xml配置默认语言内容(为了兼容用户设置不同语言的清空,此文件必须配置)。中文还需要创建res/values-zh目录下的strings.xml文件并配置中文内容。

模板提示框

请在原生工程的strings.xml中添加以下字段配置模板提示框内容。

<resources>  
    <string name="dcloud_privacy_prompt_title">弹窗标题</string>  
    <string name="dcloud_privacy_prompt_accept_button_text">接收按钮文字配置字段(不存在该字段,即使用默认内容“同意”)</string>  
    <string name="dcloud_privacy_prompt_refuse_button_text">拒绝按钮文字配置字段(没有该字段或该字段内容为空,拒绝按钮不显示)</string>  
    <string name="dcloud_privacy_prompt_message"><Data><![CDATA[弹窗内容,如果内容中有富文本,请将内容放入cdata下,如当前配置]]></Data></string>  
</resources>

二次确认提示框

HBuilderX3.1.12+版本新增支持模板隐私提示框二次确认功能,点击隐私模板提示框时用户选择“拒绝”按钮并且二次确认提示框内容dcloud_second_privacy_prompt_message配置不为空时会弹出二次确认提示框。

请在原生工程的strings.xml中添加以下字段配置二次确认提示框内容。

    <string name="dcloud_second_privacy_prompt_title">二级弹窗标题</string>  
    <string name="dcloud_second_privacy_prompt_accept_button_text">接收按钮文字配置字段(不存在该字段,即使用默认内容“确定”)</string>  
    <string name="dcloud_second_privacy_prompt_message"><![CDATA[协议内容]]></string>  
    <string name="dcloud_second_privacy_prompt_refuse_button_text">拒绝按钮文字配置字段(没有该字段或该字段内容为空,拒绝按钮不显示)</string>

国际化

HBuilderX3.2.12+版本androidPrivacy.json支持国际化

  • uni-app项目
    可参考page.json文件国际化方式处理,详见:uni-app项目 pages.json 国际化
  • 5+ App项目
    不支持uni-app形式的国际化配置,可以对androidPrivacy.json文件中需要国际化处理的字段添加Locales,示例如下:
    {  
    "prompt": "template",  
    "buttonAccept" : "默认接受按钮文本"  
    }

    添加buttonAcceptLocales处理buttonAccept的国际化文本,如下

    {  
    "prompt": "template",  
    "buttonAccept" : "默认接受按钮文本",  
    "buttonAcceptLocales": {  
        "en": "英文接受按钮文本",  
        "zh-Hans":"中文简体接受按钮文本",  
        "zh-Hant": "中文繁体接受按钮文本"  
    }  
    }

隐私协议内容需要注意的问题

需要在《隐私政策》中必告知用户您的应用基于DCloud uni-app(5+ App/Wap2App)开发,添加如下参考条款:

我们的产品基于DCloud uni-app(5+ App/Wap2App)开发,应用运行期间需要收集您的设备唯一识别码(IMEI/android ID/DEVICE_ID/IDFA、SIM 卡 IMSI 信息、OAID)以提供统计分析服务,并通过应用启动数据及异常错误日志分析改进性能和用户体验,为用户提供更好的服务。

另外隐私政策中需要补充使用到的三方SDK,参考:

uni-app默认集成三方SDK

请参考文档Android平台各功能模块隐私合规条款

uni原生插件

如果应用使用了uni原生插件,需要注意一下几点:

  • 使用插件时请查看插件详情页面中的 隐私、权限声明 。(插件使用什么sdk?获取了什么用户信息?都应由插件作者提供并填写在 隐私、权限声明中)
  • 将插件中用到的三方SDK信息添加到用户隐私协议中。例如集成了百度定位。就需要在隐私协议中说明集成了百度定位SDK。获取了xxx用户信息!用于xxx.
  • 如果发现插件有获取用户信息而插件详情页并没有提供隐私、权限声明,请与插件开发者或与我们反馈共同督促进行补充。

其它

《隐私政策》必须非常清楚、全面地说明(不要用可能收集、了解用户信息这种模糊不清晰的词语)收集用户个人信息的目的、方式和范围。
如果应用使用“通讯录”、“短信”等相关功能,请根据应用业务场景进行描述。

其它相关问题

Android平台配置权限参考:https://ask.dcloud.net.cn/article/36982
iOS平台隐私与政策提示框实现参考:https://ask.dcloud.net.cn/article/36955

附件

可参考附件隐私权政策协议模板
注意:请修改模板中的公司名称及联系邮件地址

28 关注 分享
半杯可乐 hgdc aliang888 1***@qq.com 一只攻城狮 梁飞鸿 skysowe END丶YunFeng 1***@qq.com 此地无银三百两 雨夜敬清秋 忘记我是谁 ImsuperMan y***@126.com 猫猫儿 老船长9999 六七四十二 H***@163.com 1***@qq.com ltlzx 王佳明 MonikaCeng 3***@qq.com 1***@qq.com 那年夏杪的木杺 3***@qq.com Monuni 1***@qq.com

要回复文章请先登录注册

深蓝的一片海

深蓝的一片海

隐私政策内容问题可以找我QQ728045048
2022-08-19 08:54
1***@qq.com

1***@qq.com

请问这个国际化怎么做
2022-08-09 16:17
aak12345

aak12345

离线打包,隐私政策内容,如果配置了static/privacy.html内部跳转链接的话,发现访问不了(hb版本3.5.3.20220729),可以参考下面的做法:
报错信息:/storage/emulated/0/Android/data/{包名}/apps/{appid}/www/static/privacy.html 这个文件找不到。
原因:因为隐私政策弹出时,用户未点击同意,导致uni的资源没有复制到apps目录下,所以才会报找不到这个文件。
解决方法:
1.extends DCloudApplication
2.在Application,通过SDK.isAgreePrivacy(context)判断用户是否同意了隐私政策,如果没同意,则用代码将assets下的"apps/{appid}/www/static/privacy.html"文件,手动复制到/storage/emulated/0/Android/data/{包名}/apps/{appid}/www/static/privacy.html这个路径下面即可。
2022-08-06 22:44
2***@qq.com

2***@qq.com

回复 y***@qq.com :
我一开始按照文档上面将所有的代码写在androidPrivacy.json文件里,使用公共测试证书,云打包,自定义调试基座,直接安装打包好的apk文件,也会出现这种情况,第一次进入会先弹出安卓的系统授权弹窗,杀死后,第二次进入才会弹隐私协议.后来把隐私协议的代码换了下位置,重新打自定义基座,apk安装就没问题了.具体的代码和对应位置如下:
在manifest源码视图里: 和distribute同目录层级,添加一个privacy对象:
"privacy" : {
"prompt" : "template",
"template" : {
"title" : "服务协议和隐私政策",
"message" : "  感谢您使用****,为了向您提供服务体验,我司需要收集您的个人信息、设备、操作日志等信息用于分析、优化应用性能。<br/>  请点击查看<a href=\\">《服务协议》</a>和<a href=\\">《隐私政策》</a>条款,请您务必审慎阅读、充分理解、并确认是否同意。如您统一,请点击'同意'开始接受我们的服务。",
"buttonAccept" : "同意并接受",
"buttonRefuse" : "暂不同意",
"second" : {
"title" : "确认提示",
"message" : "  进入应用前,你需先同意<a href=\\">《服务协议》</a>和<a href=\\">《隐私政策》</a>,否则将退出应用。",
"buttonAccept" : "同意并继续",
"buttonRefuse" : "退出应用"
}
}
}

文档里有个styles,设置弹窗上按钮和背景颜色的,放在这里我试了一下没有生效,需要写在androidPrivacy.json文件里就可以了.androidPrivacy.json文件的代码如下:
{
"version" : "1",
"prompt" : "template",
"styles" : {
"backgroundColor" : "#fff",
"borderRadius" : "5px",
"title" : {
"color" : "#313133"
},
"buttonAccept" : {
"color" : "#ff1c6d"
},
"buttonRefuse" : {
"color" : "#9696a0"
}
}
}

我的HBuildX版本是3.4.18,目前测试了自定义基座打包,安装apk都是没问题的,你可以先按照这个尝试一下看看行不行.
2022-08-02 14:23
3***@qq.com

3***@qq.com

回复 2***@qq.com :
public class MyApplication extends DCloudApplication {
@Override
public void onCreate() {
super.onCreate();
if(SDK.isAgreePrivacy(getBaseContext())) {
//正常初始化三方SDK
} else {
//初始化三方SDK提供规避隐私合规初始化函数 如果没有则不要初始化
}
}
}
2022-08-01 14:10
3***@qq.com

3***@qq.com

回复 2***@qq.com :
解决
public class MyApplication extends DCloudApplication {
@Override
public void onCreate() {
super.onCreate();
if(SDK.isAgreePrivacy(getBaseContext())) {
//正常初始化三方SDK
} else {
//初始化三方SDK提供规避隐私合规初始化函数 如果没有则不要初始化
}
}
}
2022-08-01 14:09
s***@126.com

s***@126.com

您好 , 没出现弹出窗口
我这样写的。{
"version": "1",
"prompt": "template",
"title": "服务协议和隐私政策",
"message": "  请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/>  你可阅读<a href=\"https://news.silubaba.com.cn/fu_wu_xie_yi\">《服务协议》</a>和<a href=\"https://news.silubaba.com.cn/yin_si_zheng_ce\">《隐私政策》</a>了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。",
"buttonAccept": "同意并接受",
"buttonRefuse": "暂不同意",
// HX 3.4.13之后版本新增,system 使用系统webview 打开隐私协议链接,默认使用uni-app内置web组件
"hrefLoader":“system|default”
"second": {
"title": "确认提示",
"message": "  进入应用前,你需先同意<a href=\"https://news.silubaba.com.cn/fu_wu_xie_yi\">《服务协议》</a>和<a href=\"https://news.silubaba.com.cn/yin_si_zheng_ce\">《隐私政策》</a>,否则将退出应用。",
"buttonAccept": "同意并继续",
"buttonRefuse": "退出应用"
},
"styles": {
"backgroundColor": "#00FF00",
"borderRadius":"5px",
"title": {
"color": "#ff00ff"
},
"buttonAccept": {
"color": "#ffff00"
},
"buttonRefuse": {
"color": "#00ffff"
}
}
}
2022-08-01 00:38
2***@qq.com

2***@qq.com

回复 3***@qq.com :
请问解决了吗
2022-07-30 15:55
1***@qq.com

1***@qq.com

复制代码后记得删除注释,那个不删打包后可能不弹出
2022-07-19 14:32
1***@qq.com

1***@qq.com

回复 9***@qq.com :
请问你处理好了吗
2022-07-14 18:19