DCloud_App_Array
DCloud_App_Array
  • 发布:2019-11-04 15:31
  • 更新:2024-02-19 17:07
  • 阅读:166004

Android平台应用启动时读写手机存储、访问设备信息(如IMEI)等权限策略及提示信息

分类:HTML5+

说明

Android平台从6.0(API23)开始系统对权限的管理更加严格,所有涉及敏感权限都需要用户授权允许才能获取。
因此一些应用基础业务逻辑需要的权限会在应用启动时申请,并引导用户允许。

<a id="externalstorage"></a>

读写手机存储权限

HBuilderX3.5.5+版本调整申请读写手机存储权限策略默认值为 none

应用需要保存运行状态等数据到手机SD卡中,启动时需要获取读写手机存储权限,此权限为基础权限,影响真机运行、wgt升级。

  • 注意:此权限目标不是要访问相册,是Android把相册写入权限和存储写入权限合并在一个权限里了。
  • 注意:wgt热更新是应用市场不乐见的,不建议明显提示给用户或告知应用市场。

申请读写手机存储需要用户授权,会弹出如下提示框:

  • HBuilderX2.4.2及以下版本,用户拒绝此权限则直接退出应用。
  • HBuilderX2.4.3+版本,用户拒绝后键会弹出以下提示框引导用户重新允许

    点击“取消”退出应用;
    点击“确定”重新弹出授权框,如果用户已经勾选“不再询问”则打开应用的设置界面。
    此提示语可在manifest.json中配置
  • HBuilderX2.5.0+开始支持配置应用启动时申请获取手机存储权限,支持以下三种策略
    • none
      应用启动时不申请
    • once
      应用第一次启动时申请,用户可以拒绝
    • always
      应用每次启动都申请,并且用户必须允许,用户拒绝时会弹出以下提示框引导用户重新允许

源码视图配置

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

  • uni-app项目
    在"app-plus" -> "distribute" -> "android" 节点下添加 permissionExternalStorage 节点
  • 5+ App项目
    在 "plus" -> "distribute" -> "google" 节点下添加 permissionExternalStorage 节点

permissionExternalStorage节点数据格式如下:

    "permissionExternalStorage": {  
        "request": "always",  
        "prompt": "应用保存运行状态等信息,需要获取读写手机存储(系统提示为访问设备上的照片、媒体内容和文件)权限,请允许。"  
     }
  • request
    字符串类型,必填,申请读写手机存储权限策略,可取值none、once、always。
    • HBuilderX3.5.5+版本默认值调整为none
    • HBuilderX3.0以下版本默认值always
  • prompt
    字符串类型,可选,用户拒绝时弹出提示框上的内容。
    默认值为:应用保存运行状态等信息,需要获取读写手机存储(系统提示为访问设备上的照片、媒体内容和文件)权限,请允许。
    国际化配置参考:https://ask.dcloud.net.cn/article/35860#strings
    设置自定义键名称为“dcloud_permission_write_external_storage_message”。

保存后提交云端打包生效

<a id="phonestate"></a>

访问设备信息权限

Android平台应用获取设备信息(如IMEI、IMSI等),统计、推送、广告等业务功能依赖这些信息。
此权限不是必选,拒绝此权限不影响App端基座运行。但拥有本权限可以给开发者提供更准确的统计报表。
而申请获取这些信息需要用户授权,会弹出如下提示框:


华为手机应用的设置中权限列表中为“电话”权限
部分手机设备对该权限描述为“拨打电话,管理电话权限”

HBuilderX2.3.8+开始支持配置应用启动时申请获取设备信息权限,支持以下三种策略

  • none
    应用启动时不申请
  • once
    应用第一次启动时申请,用户可以拒绝
  • always
    应用每次启动都申请,并且用户必须允许,用户拒绝时会弹出以下提示框引导用户重新允许

    此提示框删的文本可自定义,参考下面的prompt字段

HX3.5.5+版本开始默认策略为none,即应用启动不再主动申请

源码视图配置

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

  • uni-app项目
    在 "app-plus" -> "distribute" -> "android" 节点下添加 permissionPhoneState 节点
  • 5+ App项目
    在 "plus" -> "distribute" -> "google" 节点下添加 permissionPhoneState 节点

permissionPhoneState节点数据格式如下:

    "permissionPhoneState": {  
        "request": "always",  
        "prompt": "为保证您正常、安全地使用,需要获取设备识别码(部分手机提示为获取手机号码)使用权限,请允许。"  
     }
  • request
    字符串类型,必填,申请设备信息权限策略,可取值none、once、always。默认值为once。
  • prompt
    字符串类型,可选,用户拒绝时弹出提示框上的内容。
    默认值为:为保证您正常、安全地使用,需要获取设备识别码(部分手机提示为获取手机号码)使用权限,请允许。
    国际化配置参考:https://ask.dcloud.net.cn/article/35860#strings
    设置自定义键名称为“dcloud_permission_read_phone_state_message”。

保存后提交云端打包生效

离线打包提示语配置及弹窗配置。

提示语配置

在主项目的strings.xml中添加如下字段。strings.xml位于 项目目录/src/main/res/values下,如果文件或文件夹不存在,直接新建即可。

存储权限提示语配置

<resources>  
    <string name="dcloud_permission_write_external_storage_message">存储权限提示语</string>  
</resources>  

读取手机状态权限配置

<resources>  
    <string name="dcloud_permission_read_phone_state_message">读取手机状态权限提示语</string>  
</resources>  

弹窗配置

在androidManifest.xml的application节点下添加如下字段。

存储权限弹窗配置

<application>  
<meta-data android:name="DCLOUD_WRITE_EXTERNAL_STORAGE" android:value="once"/>  
</application>  

value可取值为 none、once、always。

读取手机状态弹窗配置

<application>  
<meta-data android:name="DCLOUD_READ_PHONE_STATE" android:value="once"/>  
</application>  

value可取值为 none、once、always。

补充

沟通发现,部分开发者在main.js里面调用了plus.device.getInfo这类方法。

但是其实API操作与permissionExternalStorage设置无关,permissionExternalStorage用于设置应用内部逻辑是否申请访问SD卡权限

开发者是因为在启动的时候调用API触发了权限申请,误以为permissionExternalStorage设置无效(其实设置是生效的)。

其它API操作会根据功能需求来申请权限,比如操作系统相册也会申请访问SDK卡权限、定位操作会申请定位权限等。

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

32 关注 分享
hzq 5***@qq.com sql开发者 老哥教教我 秋凡 2***@qq.com hgdc 876 1***@qq.com 一只攻城狮 没胡子就好了 糖猫猫 c***@163.com skysowe 海中月是天上月 90后菜鸟 雨夜敬清秋 ltlzx 光之子科技 chihiro_yy 美目如当 ai666 愿随风丶飘雪 那年夏杪的木杺 1***@qq.com 2***@qq.com freehippo 4***@qq.com 1***@qq.com 套马杆的套子 wcs Tevin1021

要回复文章请先登录注册

大帮手

大帮手

DELETE_CACHE_FILES对应的名称是什么?还有很多其它KEY对应的名称都是什么
2022-11-21 18:49
李骁

李骁

回复 2***@qq.com :
请问你的解决了吗?我也是遇到了一样的鸟问题
2022-11-19 11:17
2***@qq.com

2***@qq.com

回复 DCloud_Android_ST :
您好,请问一下,我现在遇到这样的问题,大概是什么原因呢:
我用的是HBuildX3.6.4版本的,项目配置里permissionPhoneState和permissionExternalStorage都按照文档在对应的位置配置好了,然后云打包生成apk.我用自己的小米手机MIUI12系统安装apk,首次进入是不会弹拨打电话权限的提示框,但是用安卓6.0.1 MXB48T的小米手机安装,就会提示是否开启拨打电话的权限.(这个时候我怀疑是否是跟手机系统有关)

因为我的项目里通过云端插件的方式,导入了官方插件市场极光推送的插件:JPush和JCore,JPush插件会申请使用到电话的权限.于是我在打包的时候,把JPush插件删除,这个时候,新打包的apk在6.0的系统也不会弹窗了.这个时候好像又跟JPush插件有关.如果是因为JPush插件导致的弹窗,那为什么在MIUI12.0系统又不会弹窗.所以希望您这边能帮忙分析一下大概是什么原因.
2022-11-16 17:38
2***@qq.com

2***@qq.com

这边自己试了一下,发现manifest里,permissionExternalStorage和permissionPhoneState这个配置为none,在安卓6.0系统的手机上确实还是会弹拨打电话的弹窗,在9.0系统上就不会弹了.有没有官方的人可以解释一下,是不是这个配置,没有针对安卓的低版本做适配啊.三方审核平台如果一直用低版本系统的设备去审核,要如何解决呢?
2022-11-16 14:27
2***@qq.com

2***@qq.com

回复 2***@qq.com :
manifest里,permissionExternalStorage和permissionPhoneState都是按照文档进行配置过了的,设置了request为none
2022-11-16 10:23
2***@qq.com

2***@qq.com

提交小米商城,驳回提示“APP首次打开,未见使用权限对应的相关产品或服务时,提前向用户弹窗申请开启存储权限”。报告里的截图是app弹出了拨打电话的授权框,但是我自己用小米手机安装云打包的apk,是没有这个弹窗提示的,小米手机的版本是MIUI12.5.19的.打自定义基座安装也不会出现弹窗.不知道问题出在哪里了.是跟安装的设备系统版本号有关么?
2022-11-16 10:22
开发小白白啊

开发小白白啊

获取位置信息权限,如何开启弹窗
2022-11-09 23:34
3***@qq.com

3***@qq.com

回复 Lin97112479 :
请问你的处理好了吗?
2022-11-04 09:18
3***@qq.com

3***@qq.com

我把permissionExternalStorage或者permissionPhoneState模块的代码放在permissions模块之前,然后request都设置了none。提交云打包后,还是会在第一次启动的时候弹拨打电话权限。请问要怎么配置啊?
2022-11-03 17:30
Lin97112479

Lin97112479

回复 5***@qq.com :
怎么配置的呢 我配置了 拨打电话权限还是会弹
2022-11-03 13:52