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

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

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

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

 

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

 

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

 

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

 

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

1新建manifest.xml文件,添加如下代码:

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
    <application name="targetSdkVersion" value="28"/>
</manifest>

image.gifimage.gif

将其中的targetSdkVersion更新为目标值,例如30
2、将manifest.xml置于你的/项目代码/res/目录下(widget/res/manifest.xml);
3、将你的app代码中所有涉及到需要动态权限的操作,参照示例中的代码,改造一遍(例如进行拍照录制视频等需要使用摄像头,以前的缺省处理中不需要申请摄像头权限,而开启动态权限后,必须在进行拍照之前,判断是否有摄像头权限,没有则进行申请,只有用户同意了摄像头权限才能进行接下来拍照的操作);
4、提交代码;
5、云编译界面勾选app所需的权限;
6、云编译app或自定义loader即可。

 

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

 

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

 

以下为代码示例:

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
        content="maximum-scale=1.0, minimum-scale=1.0, user-scalable=0, initial-scale=1.0, width=device-width" />
    <meta name="format-detection" content="telephone=no, email=no, date=no, address=no">
    <title>权限管理</title>
    <link rel="stylesheet" type="text/css" href="./css/api.css" />
    <link rel="stylesheet" type="text/css" href="./css/box.css" />
    <script type="text/javascript" src="./script/public.js"></script>
    <style>
        .marg {
            margin: 3px 15px;
            font-size: 18px;
        }
    </style>
    <script type="text/javascript">
        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>
        <div id="wrap">
            <div id='header'>
                <div class="back" tapmode="back-aconclick="api.closeWin()">返回</div>
                <h1>权限管理测试</h1>
                <div class="adpt"></div>
            </div>
            <div class='itemtitle'>一、判断权限</div>
            <div class='marg'>请选择一个或者多个权限进行判断:</div>
            <div class='marg'>日历&emsp;&emsp;&emsp;<input type="checkbox" name="p_list" value="calendar" /></div>
            <div class='marg'>相机&emsp;&emsp;&emsp;<input type="checkbox" name="p_list" value="camera" /></div>
            <div class='marg'>通讯录&emsp;&emsp;<input type="checkbox" name="p_list" value="contacts" /></div>
            <div class='marg'>位置信息&emsp;<input type="checkbox" name="p_list" value="location" /></div>
            <div class='marg'>麦克风&emsp;&emsp;<input type="checkbox" name="p_list" value="microphone" /></div>
            <div class='marg'>电话&emsp;&emsp;&emsp;<input type="checkbox" name="p_list" value="phone" /></div>
            <div class='marg'>身体传感器<input type="checkbox" name="p_list" value="sensor" /></div>
            <div class='marg'>短信&emsp;&emsp;&emsp;<input type="checkbox" name="p_list" value="sms" /></div>
            <div class='marg'>存储空间&emsp;<input type="checkbox" name="p_list" value="storage" /></div>
            <div class="clickbtn" tapmode="active" onclick="hasPermission()">点击开始判断</div>
            <div class='itemtitle'>二、请求权限</div>
            <div class='marg'>请选择一个或者多个权限进行请求:</div>
            <div class='marg'>日历&emsp;&emsp;&emsp;<input type="checkbox" name="p_list_r" value="calendar" /></div>
            <div class='marg'>相机&emsp;&emsp;&emsp;<input type="checkbox" name="p_list_r" value="camera" /></div>
            <div class='marg'>通讯录&emsp;&emsp;<input type="checkbox" name="p_list_r" value="contacts" /></div>
            <div class='marg'>位置信息&emsp;<input type="checkbox" name="p_list_r" value="location" /></div>
            <div class='marg'>麦克风&emsp;&emsp;<input type="checkbox" name="p_list_r" value="microphone" /></div>
            <div class='marg'>电话&emsp;&emsp;&emsp;<input type="checkbox" name="p_list_r" value="phone" /></div>
            <div class='marg'>身体传感器<input type="checkbox" name="p_list_r" value="sensor" /></div>
            <div class='marg'>短信&emsp;&emsp;&emsp;<input type="checkbox" name="p_list_r" value="sms" /></div>
            <div class='marg'>存储空间&emsp;<input type="checkbox" name="p_list_r" value="storage" /></div>
            <div class="clickbtn" tapmode="active" onclick="reqPermission()">点击开始请求</div>
            <div class='itemtitle'>三、需要权限的API操作</div>
            <div class='marg'>1、日历</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('calendar')">点击操作日历</div>
            <div class='marg'>2、相机</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('camera')">点击操作照相机</div>
            <div class='marg'>3、通讯录</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('contacts')">点击操作通讯录</div>
            <div class='marg'>4、位置信息</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('location')">点击操作位置信息</div>
            <div class='marg'>5、麦克风</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('microphone')">点击操作麦克风</div>
            <div class='marg'>6、电话</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='marg'>8、短信</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('sms')">点击操作短信</div>
            <div class='marg'>9、存储空间</div>
            <div class="clickbtn" tapmode="active" onclick="opWithPermission('storage')">点击操作存储空间</div>
            <br>
        </div>
    </div>
</body>
</html>

image.gifimage.gif


目录
相关文章
|
1月前
|
安全 Java Android开发
为什么大厂要求安卓开发者掌握Kotlin和Jetpack?深度解析现代Android开发生态优雅草卓伊凡
为什么大厂要求安卓开发者掌握Kotlin和Jetpack?深度解析现代Android开发生态优雅草卓伊凡
69 0
为什么大厂要求安卓开发者掌握Kotlin和Jetpack?深度解析现代Android开发生态优雅草卓伊凡
|
4月前
|
JavaScript Linux 网络安全
Termux安卓终端美化与开发实战:从下载到插件优化,小白也能玩转Linux
Termux是一款安卓平台上的开源终端模拟器,支持apt包管理、SSH连接及Python/Node.js/C++开发环境搭建,被誉为“手机上的Linux系统”。其特点包括零ROOT权限、跨平台开发和强大扩展性。本文详细介绍其安装准备、基础与高级环境配置、必备插件推荐、常见问题解决方法以及延伸学习资源,帮助用户充分利用Termux进行开发与学习。适用于Android 7+设备,原创内容转载请注明来源。
715 76
|
5月前
|
前端开发 Java Shell
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
305 20
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
|
5月前
|
JavaScript 搜索推荐 Android开发
【01】仿站技术之python技术,看完学会再也不用去购买收费工具了-用python扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-客户的麻将软件需要下载落地页并且要做搜索引擎推广-本文用python语言快速开发爬取落地页下载-优雅草卓伊凡
【01】仿站技术之python技术,看完学会再也不用去购买收费工具了-用python扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-客户的麻将软件需要下载落地页并且要做搜索引擎推广-本文用python语言快速开发爬取落地页下载-优雅草卓伊凡
137 8
【01】仿站技术之python技术,看完学会再也不用去购买收费工具了-用python扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-客户的麻将软件需要下载落地页并且要做搜索引擎推广-本文用python语言快速开发爬取落地页下载-优雅草卓伊凡
|
5月前
|
Dart 前端开发 Android开发
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
112 4
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
|
6月前
|
缓存 前端开发 Android开发
【04】flutter补打包流程的签名过程-APP安卓调试配置-结构化项目目录-完善注册相关页面-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程
【04】flutter补打包流程的签名过程-APP安卓调试配置-结构化项目目录-完善注册相关页面-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程
286 12
【04】flutter补打包流程的签名过程-APP安卓调试配置-结构化项目目录-完善注册相关页面-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程
|
5月前
|
安全 Android开发 iOS开发
escrcpy:【技术党必看】Android开发,Escrcpy 让你无线投屏新体验!图形界面掌控 Android,30-120fps 超流畅!🔥
escrcpy 是一款基于 Scrcpy 的开源项目,使用 Electron 构建,提供图形化界面来显示和控制 Android 设备。它支持 USB 和 Wi-Fi 连接,帧率可达 30-120fps,延迟低至 35-70ms,启动迅速且画质清晰。escrcpy 拥有丰富的功能,包括自动化任务、多设备管理、反向网络共享、批量操作等,无需注册账号或广告干扰。适用于游戏直播、办公协作和教育演示等多种场景,是一款轻量级、高性能的 Android 控制工具。
250 1
|
6月前
|
Dart 前端开发 Android开发
【02】写一个注册页面以及配置打包选项打包安卓apk测试—开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈
【02】写一个注册页面以及配置打包选项打包安卓apk测试—开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈
132 1
【02】写一个注册页面以及配置打包选项打包安卓apk测试—开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈
|
7月前
|
搜索推荐 前端开发 API
探索安卓开发中的自定义视图:打造个性化用户界面
在安卓应用开发的广阔天地中,自定义视图是一块神奇的画布,让开发者能够突破标准控件的限制,绘制出独一无二的用户界面。本文将带你走进自定义视图的世界,从基础概念到实战技巧,逐步揭示如何在安卓平台上创建和运用自定义视图来提升用户体验。无论你是初学者还是有一定经验的开发者,这篇文章都将为你打开新的视野,让你的应用在众多同质化产品中脱颖而出。
120 19
|
7月前
|
JSON Java API
探索安卓开发:打造你的首个天气应用
在这篇技术指南中,我们将一起潜入安卓开发的海洋,学习如何从零开始构建一个简单的天气应用。通过这个实践项目,你将掌握安卓开发的核心概念、界面设计、网络编程以及数据解析等技能。无论你是初学者还是有一定基础的开发者,这篇文章都将为你提供一个清晰的路线图和实用的代码示例,帮助你在安卓开发的道路上迈出坚实的一步。让我们一起开始这段旅程,打造属于你自己的第一个安卓应用吧!
200 14