使用APICloud开发app的动态权限及Android平台targetSdkVersion设置教程-阿里云开发者社区

先介绍一下关于Android动态权限和targetSdkVersion背景：

targetSdkVersion：自2018年11月开始，GooglePlay以及国内大部分应用市场要求app编译目标SDK必须为26及以上，否则不予提交审核；有许多已有app转到APICloud开发后，因targetSdkVersion降级而导致无法覆盖安装；2020年以来，国家网信办等监管机构也加强了对app权限合规的监管。

动态权限：Android自系统6.0开始，提供动态权限机制，对于敏感权限（存储，定位，录音，拍照，录像等），需要在app运行过程中动态向用户申请，这就和iOS系统的权限使用体验保持一致了（iOS一直以来就是动态权限）。

使用APICloud开发平台开发app时，如果需要获取权限，需要动态申请。因此APICloud开发平台统一了Android和iOS两个平台的动态权限操作，提供两个API：hasPermission 和 requestPermission。文档地址为：https://docs.apicloud.com/Client-API/api

在Android上使用动态权限，要求app编译的目标SDK（即targetSdkVersion）为23及以上（对应为android6.0及以上系统），22及以下系统会执行缺省处理（手机厂商也可能定制处理），APICloud为满足更普遍的开发需求，默认配置targetSdkVersion为22，即权限走系统缺省处理。

开启动态权限，需要按照以下说明操作：

1、新建manifest.xml文件，添加如下代码：

<?xml version="1.0" encoding="UTF-8"?>

</manifest>

将其中的targetSdkVersion更新为目标值，例如30；

2、将manifest.xml置于你的/项目代码/res/目录下（widget/res/manifest.xml）；

3、将你的app代码中所有涉及到需要动态权限的操作，参照示例中的代码，改造一遍（例如进行拍照录制视频等需要使用摄像头，以前的缺省处理中不需要申请摄像头权限，而开启动态权限后，必须在进行拍照之前，判断是否有摄像头权限，没有则进行申请，只有用户同意了摄像头权限才能进行接下来拍照的操作）；

4、提交代码；

5、云编译界面勾选app所需的权限；

6、云编译app或自定义loader即可。

在这里需要注意的是，当你设置的targetSdkVersion大于等于23时，即意味着开启了动态权限，如果你的app带有获取IMEI、定位、录音、拍照、录像等敏感功能时，必须使用动态权限机制，先判断是否具有该功能操作权限，再进行操作，如果不具备相应的权限，对应的功能是失效的，也可能导致app崩溃。

为保证动态权限尽可能适配更多厂商的手机以及顺利上线Google Play，targetSdkVersion目前推荐设置为30。

以下为代码示例：

<!DOCTYPE HTML>

<html>

<head>

content="maximum-scale=1.0, minimum-scale=1.0, user-scalable=0, initial-scale=1.0, width=device-width" />

<style>

.marg {

margin: 3px 15px;

font-size: 18px;

}

</style>

apiready = function () {

}

function hasPermission(one_per) {

var perms = new Array();

if (one_per) {

perms.push(one_per);

} else {

var prs = document.getElementsByName("p_list");

for (var i = 0; i < prs.length; i++) {

if (prs[i].checked) {

perms.push(prs[i].value);

}

var rets = api.hasPermission({

list: perms

});

if (!one_per) {

apialert('判断结果：' + JSON.stringify(rets));

return;

}

return rets;

}

function reqPermission(one_per, callback) {

var perms = new Array();

if (one_per) {

perms.push(one_per);

} else {

var prs = document.getElementsByName("p_list_r");

for (var i = 0; i < prs.length; i++) {

if (prs[i].checked) {

perms.push(prs[i].value);

}

api.requestPermission({

list: perms,

code: 100001

}, function (ret, err) {

if (callback) {

callback(ret);

return;

}

var str = '请求结果：\n';

str += '请求码: ' + ret.code + '\n';

str += "是否勾选\"不再询问\"按钮: " + (ret.never ? '是' : '否') + '\n';

str += '请求结果: \n';

var list = ret.list;

for (var i in list) {

str += list[i].name + '=' + list[i].granted + '\n';

}

apialert(str);

console.log(JSON.stringify(ret));

});

}

function opWithPermission(perm) {

if (!confirmPer(perm)) {

return;

}

if ('calendar' == perm) {

//操作日历

} else if ('camera' == perm) {

api.getPicture({

sourceType: 'camera',

mediaValue: 'pic',

destinationType: 'url',

}, function (ret, err) {

if (ret) {

apialert(JSON.stringify(ret));

} else {

apialert(JSON.stringify(err));

}

});

} else if ('contacts' == perm) {

api.openContacts({

test: true

}, function (ret, err) {

if (ret && ret.status) {

apialert(JSON.stringify(ret));

} else {

apialert(JSON.stringify(err));

}

});

} else if ('location' == perm) {

api.getLocation(function (ret, err) {

if (ret && ret.status) {

apialert(JSON.stringify(ret));

} else {

apialert(JSON.stringify(err));

}

});

} else if ('microphone' == perm) {

api.startRecord({

path: 'fs://perm-test.amr'

});

} else if ('phone' == perm) {

api.call({

type: 'tel',

number: '10086'

});

} else if ('sensor' == perm) {

//操作身体传感器

} else if ('sms' == perm) {

api.sms({

numbers: ['10086'],

text: '余额',

silent: true

});

} else if ('storage' == perm) {

api.readFile({

path: 'fs://test.txt'

}, function (ret, err) {

if (ret.status) {

console.log('readFile: ' + ret.data);

} else {

apialert(err.msg + ": \n" + api.fsDir);

}

});

}

function confirmPer(perm) {

var has = hasPermission(perm);

if (!has || !has[0] || !has[0].granted) {

api.confirm({

title: '提醒',

msg: '没有获得 ' + perm + " 权限\n是否前往设置？",

buttons: ['去设置', '取消']

}, function (ret, err) {

if (1 == ret.buttonIndex) {

reqPermission(perm);

}

});

return false;

}

return true;

}

</script>

</head>

<body>

<div>

<h1>权限管理测试</h1>

</div>

<div class='marg'>请选择一个或者多个权限进行判断:</div>

<div class='marg'>身体传感器<input type="checkbox" name="p_list" value="sensor" /></div>

<div class="clickbtn" tapmode="active" onclick="hasPermission()">点击开始判断</div>

<div class='marg'>请选择一个或者多个权限进行请求:</div>

<div class='marg'>身体传感器<input type="checkbox" name="p_list_r" value="sensor" /></div>

<div class="clickbtn" tapmode="active" onclick="reqPermission()">点击开始请求</div>

<div class='itemtitle'>三、需要权限的API操作</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('calendar')">点击操作日历</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('camera')">点击操作照相机</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('contacts')">点击操作通讯录</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('location')">点击操作位置信息</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('microphone')">点击操作麦克风</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('phone')">点击操作电话</div>

<div class='marg'>7、身体传感器</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('sensor')">点击操作身体传感器</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('sms')">点击操作短信</div>

<div class="clickbtn" tapmode="active" onclick="opWithPermission('storage')">点击操作存储空间</div>

<br>

</div>

</body>

</html>

使用APICloud开发app的动态权限及Android平台targetSdkVersion设置教程

热门文章

最新文章

相关课程

相关电子书

相关实验场景