工具函数
说明
- 工具类模块函数主要是跟Android常用的信息相关联
- 工具类模块的对象前缀是utils,例如 utils.requestShowLogPermission()这样调用
打开App相关
utils.openApp 打开APP
- 打开APP
- @param packageName 程序的包名
- @return 布尔型 true 代表成功,false 代表失败
function main() {
utils.openApp("com.xx");
}
main();
utils.getStartAppCmd 命令打开app
- 拼接打开APP命令
- 适合EC6.8.0+
- @param packageName 程序的包名
- @return
{string}
命令字符串
function main() {
startEnv()
let pkg = "com.youdao.translator";
//获取命令
let d = utils.getStartAppCmd(pkg);
logd(d);
//激活命令执行
//let result = shell.execCommand(d);
//logd("result ="+result);
//root方式执行
//var result = shell.sudo(d);
//logd("result ="+result);
//开启代理服务,使用代理服务执行命令
var result = shell.execAgentCommand(d);
logd("result =" + result);
}
main();
utils.openAppByName 打开APP(应用名称)
- 打开APP,通过应用名称
- @param appName 程序名称,比如今日头条
- @return 布尔型 true 代表成功,false 代表失败
function main() {
utils.openAppByName("xx");
}
main();
utils.openActivity 打开activity
- 打开一个activity,通过map参数
- @param map 例如
{"action":""}
,key的固定只有 - action: 标准的android action字符串
- uri: uri可以是http网址,也可以是文件file:///地址,也可以是 URLSchema语法
- type: uri对应的type,等同于MIME类型,例如安装apk包的type是 application/vnd.android.package-archive
- pkg: 要打开的activity对应的包名
- className: 要打开的 className 对应的类名
- flag: androi打开activity 标准的flag标志位,特殊情况下可以填写
- 其他的都是属于intent参数了
- @param map 例如
- @return 布尔型 true 代表成功,false 代表失败
function main() {
//打开安装包界面
var m = {
"action": "android.intent.action.VIEW",
"uri": "file:///sdcard/a.apk",
"type": "application/vnd.android.package-archive"
};
var x = utils.openActivity(m);
logd("x " + x);
var map = {
"uri": "xx://xx/live/6701887916223941379",
};
utils.openActivity(map);
}
main();
utils.getStartActivityCmd命令 打开activity
- 适合EC6.8.0+
- 打开一个activity,通过map参数
- @param map 例如
{"action":""}
,key的固定只有 - action: 标准的android action字符串
- uri: uri可以是http网址,也可以是文件file:///地址,也可以是 URLSchema语法
- type: uri对应的type,等同于MIME类型,例如安装apk包的type是 application/vnd.android.package-archive
- pkg: 要打开的activity对应的包名
- className: 要打开的 className 对应的类名
- flag: androi打开activity 标准的flag标志位,特殊情况下可以填写
- 其他的都是属于intent参数了
- @param map 例如
- @return 布尔型 true 代表成功,false 代表失败
function main() {
startEnv()
//let pkg = "com.youdao.translator";
let map1 = {
"action": "android.intent.action.VIEW",
"pkg": "com.youdao.translator"
}
//uri演示打电话 这里的uri可以是其他
let map2 = {
"action": "android.intent.action.CALL",
"uri": "tel:1000"
}
//获取命令
let d = utils.getStartActivityCmd(map1);
logd(d);
//激活命令执行
//let result = shell.execCommand(d);
//logd("result ="+result);
//root方式执行
//var result = shell.sudo(d);
//logd("result ="+result);
//开启代理服务,使用代理服务执行命令
var result = shell.execAgentCommand(d);
logd("result =" + result);
}
main()
utils.openIntentAction 通过Action打开某个界面
- 通过Action打开某个界面
- @param action action动作,例如 android.settings.ACCESSIBILITY_SETTINGS = 辅助功能,
- 如果改方法不满足要求,可以直接使用intent进行打开:
- 常用的action有:
- android.settings.ACCESSIBILITY_SETTINGS //辅助功能
- android.settings.ADD_ACCOUNT_SETTINGS //添加账户
- android.settings.AIRPLANE_MODE_SETTINGS //系统设置首页
- android.settings.APN_SETTINGS //APN设置
- android.settings.APPLICATION_SETTINGS //应用管理
- android.settings.BATTERY_SAVER_SETTINGS //节电助手
- android.settings.BLUETOOTH_SETTINGS //蓝牙
- android.settings.CAPTIONING_SETTINGS //字幕
- android.settings.CAST_SETTINGS //无线显示
- android.settings.DATA_ROAMING_SETTINGS //移动网络
- android.settings.DATE_SETTINGS //日期和时间设置
- android.settings.DEVICE_INFO_SETTINGS //关于手机
- android.settings.DISPLAY_SETTINGS //显示设置
- android.settings.DREAM_SETTINGS //互动屏保设置
- android.settings.HARD_KEYBOARD_SETTINGS //实体键盘
- android.settings.HOME_SETTINGS //应用权限,默认应用设置,特殊权限
- android.settings.IGNORE_BATTERY_OPTIMIZATION_SETTINGS //忽略电池优化设置
- android.settings.INPUT_METHOD_SETTINGS //可用虚拟键盘设置
- android.settings.INPUT_METHOD_SUBTYPE_SETTINGS //安卓键盘语言设置(AOSP)
- android.settings.INTERNAL_STORAGE_SETTINGS //内存和存储
- android.settings.LOCALE_SETTINGS //语言偏好设置
- android.settings.LOCATION_SOURCE_SETTINGS //定位服务设置
- android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS //所有应用
- android.settings.MANAGE_APPLICATIONS_SETTINGS //应用管理
- android.settings.MANAGE_DEFAULT_APPS_SETTINGS //与ACTION_HOME_SETTINGS相同
- android.settings.action.MANAGE_OVERLAY_PERMISSION //在其他应用上层显示,悬浮窗
- android.settings.MANAGE_UNKNOWN_APP_SOURCES //安装未知应用 安卓8.0
- android.settings.action.MANAGE_WRITE_SETTINGS //可修改系统设置 权限
- android.settings.MEMORY_CARD_SETTINGS //内存与存储
- android.settings.NETWORK_OPERATOR_SETTINGS //可用网络选择
- android.settings.NFCSHARING_SETTINGS //NFC设置
- android.settings.NFC_SETTINGS //网络中的 更多设置
- android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS //通知权限设置
- android.settings.NOTIFICATION_POLICY_ACCESS_SETTINGS //勿扰权限设置
- android.settings.ACTION_PRINT_SETTINGS //打印服务设置
- android.settings.PRIVACY_SETTINGS //备份和重置
- android.settings.SECURITY_SETTINGS //安全设置
- android.settings.SHOW_REGULATORY_INFO //监管信息
- android.settings.SOUND_SETTINGS //声音设置
- android.settings.SYNC_SETTINGS //添加账户设置
- android.settings.USAGE_ACCESS_SETTINGS //有权查看使用情况的应用
- android.settings.USER_DICTIONARY_SETTINGS //个人词典
- android.settings.VOICE_INPUT_SETTINGS //辅助应用和语音输入
- android.settings.VPN_SETTINGS //VPN设置
- android.settings.VR_LISTENER_SETTINGS //VR助手
- android.settings.WEBVIEW_SETTINGS //选择webview
- android.settings.WIFI_IP_SETTINGS //高级WLAN设置
- android.settings.WIFI_SETTINGS //选择WIFI,连接WIFI
- com.android.settings.Settings$DevelopmentSettingsActivity
- @return null|boolean|*
function main() {
utils.openIntentAction("android.settings.ACCESSIBILITY_SETTINGS");
}
main();
- 直接使用Intent打开方式
importClass(android.content.Intent);
importClass(android.net.Uri)
var intent = new Intent();
intent.setAction("android.settings.APPLICATION_DETAILS_SETTINGS");
intent.setData(Uri.parse("package:com.gibb.easyclick"))
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
try {
context.startActivity(intent);
} catch (e) {
loge(e)
}
图库相关
utils.insertImageToAlbum 图片插入相册
- 将图片插入到相册中,此方法会立刻更新相册数据
- 最好将文件放到 /sdcard/DCIM,相册目录,有些手机不放相册目录不扫描
- @param path 图片路径
function main() {
utils.insertImageToAlbum("/sdcard/DCIM/a.png");
}
main();
utils.insertVideoToAlbum 视频插入相册
- 将视频插入到相册中,此方法会立刻更新相册数据
- 最好将文件放到 /sdcard/DCIM,相册目录,有些手机不放相册目录不扫描
- @param path 视频路径
function main() {
utils.insertVideoToAlbum("/sdcard/DCIM/a.mp4");
}
main();
解压缩
utils.zip 压缩
- 将多个文件压缩成一个zip文件
- 适用版本(EC 5.17.0+)
- @param zipFile 目标zip文件的路径
- @param passwd 目标ip文件密码,空代表无密码
- @param files 要压缩的文件或者文件夹,文件数组例如:
["/sdcard/a.txt","/sdcard/bb/"]
- @return
{bool}
true 代表成功 false代表失败
function main() {
zipFile = "/sdcard/a.zip"
//压缩文件
let passwd = "123";
let files = ["/sdcard/test.json", "/sdcard/gifshow"]
let re = utils.zip(zipFile, passwd, files);
logd("压缩结果: " + re);
let ure = utils.unzip(zipFile, passwd, "/sdcard/test111/");
logd("解压结果: " + ure);
let data = utils.readFileInZip("/sdcard/a.zip", passwd, "test.json")
logd("读取数据结果: " + data);
}
main()
utils.unzip 解压
- 将zip文件解压到一个文件夹中
- 适用版本(EC 5.17.0+)
- @param zipFile 目标zip文件的路径
- @param passwd 目标ip文件密码
- @param destDir 要解压到的目标文件夹
- @return
{bool}
true 代表成功 false代表失败
function main() {
zipFile = "/sdcard/a.zip"
//压缩文件
let passwd = "123";
let files = ["/sdcard/test.json", "/sdcard/gifshow"]
let re = utils.zip(zipFile, passwd, files);
logd("压缩结果: " + re);
let ure = utils.unzip(zipFile, passwd, "/sdcard/test111/");
logd("解压结果: " + ure);
let data = utils.readFileInZip("/sdcard/a.zip", passwd, "test.json")
logd("读取数据结果: " + data);
}
main()
utils.unzipWithEncode 解压带编码
- 解压文件
- 将zip文件解压到一个文件夹中
- 适合EC 10.0.0+
- @param zipFile 目标zip文件的路径
- @param passwd 目标ip文件密码
- @param destDir 要解压到的目标文件夹
- @param fileNameEncode 文件名的编码,Windows压缩的写GBK,其他平台都是UTF-8
- @return
{bool}
true 代表成功 false代表失败
function main() {
let zipFile = "/sdcard/a.zip"
let ure = utils.unzipWithEncode(zipFile, "", "/sdcard/test111/","GBK");
logd("解压结果: " + ure);
}
main()
utils.readFileInZip ZIP中读取
- 从zip文件中读取数据
- 适用版本(EC 5.17.0+)
- @param zipFile zip文件的路径
- @param passwd zip文件密码
- @param filePathInZip 文件在zip中的路径,例如 a/b.txt
- @return
{string}
解析后的字符串
function main() {
zipFile = "/sdcard/a.zip"
//压缩文件
let passwd = "123";
let files = ["/sdcard/test.json", "/sdcard/gifshow"]
let re = utils.zip(zipFile, passwd, files);
logd("压缩结果: " + re);
let ure = utils.unzip(zipFile, passwd, "/sdcard/test111/");
logd("解压结果: " + ure);
let data = utils.readFileInZip("/sdcard/a.zip", passwd, "test.json")
logd("读取数据结果: " + data);
}
main()
加解密相关
encodeDecoder.aesEncrypt AES加密
- AES加密,算法AES/ECB/PKCS5Padding
- 适用版本(EC 5.19.0+)
- @param data 数据字符串
- @param password 密码,至少8个字符
- @return
{string}
加密后的base64字符串
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.aesEncrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.aesDecrypt(d, pwd)
logd("解密后的数据-" + dd);
}
main();
encodeDecoder.aesDecrypt AES解密
- AES解密,算法AES/ECB/PKCS5Padding
- 适用版本(EC 5.19.0+)
- @param data 加密后的base64字符串
- @param password 密码,至少8个字符
- @return
{string}
解密后的字符串
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.aesEncrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.aesDecrypt(d, pwd)
logd("解密后的数据-" + dd);
}
main();
encodeDecoder.desEncrypt DES加密
- DES加密,算法ADES
- 适用版本(EC 5.19.0+)
- @param data 数据字符串
- @param password 密码,至少8个字符
- @return
{string}
加密后的base64字符串
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.desEncrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.desDecrypt(d, pwd)
logd("解密后的数据-" + dd);
}
main();
encodeDecoder.desDecrypt DES解密
- DES解密,算法ADES
- 适用版本(EC 5.19.0+)
- @param data 加密后的base64字符串
- @param password 密码,至少8个字符
- @return
{string}
解密后的字符串
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.desEncrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.desDecrypt(d, pwd)
logd("解密后的数据-" + dd);
}
main();
encodeDecoder.des3Encrypt 3DES加密
- 3DES加密,算法是 DESede/CBC/PKCS5Padding
- 适用版本(EC 5.19.0+)
- @param data 数据字符串
- @param password 密码
- @return
{string}
加密后的base64字符串
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.des3Encrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.des3Decrypt(d, pwd)
logd("解密后的数据-" + dd);
}
main();
encodeDecoder.des3Decrypt 3DES解密
- 3DES解密,算法是 DESede/CBC/PKCS5Padding
- 适用版本(EC 5.19.0+)
- @param data 加密后的base64字符串
- @param password 密码
- @return
{string}
解密后的字符串
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.des3Encrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.des3Decrypt(d, pwd)
logd("解密后的数据-" + dd);
}
main();
encodeDecoder.getErrorMsg 获取加解密错误信息
- 获取上一次加解密的错误信息
- 适用版本(EC 5.19.0+)
- @return
{string}
null代表无错误
function main() {
let dat = "我是数据"
let pwd = "12356783";
let d = encodeDecoder.des3Encrypt(dat, pwd)
logd("加密后的数据-" + d);
let dd = encodeDecoder.des3Decrypt(d, pwd)
logd("解密后的数据-" + dd);
logd("getErrorMsg -" + encodeDecoder.getErrorMsg());
}
main();
二维码
utils.createQRCode 生成一个二维码
- 生成一个二维码
- 适用版本(EC 5.15.0+)
- @param content 二维码字符串内容
- @param width 图像宽度
- @param height 图像高度
- @param logo 图像中心的logo,非必填项,Bitmap 对象,文件转Bitmap请看image模块
- @return
{Bitmap}
Android的Bitmap对象,保存到文件请看image模块
function main() {
//生成一个二维码bitmap 带logo的
let bot = utils.createQRCode("我是大佬的弟弟", 1000, 1000, image.readBitmap("/sdcard/yyb2.png"));
logd("bot " + bot);
//保存的到文件
let saved = image.saveBitmap(bot, "png", 100, "/sdcard/tmp.png");
logd("saved " + saved);
//回收掉防止内存暴涨
if (bot) {
bot.recycle()
}
//扫描二维码
let bitmap = image.readBitmap("/sdcard/tmp.png")
let data = utils.decodeQRCode(bitmap);
logd("data " + data);
//回收掉防止内存暴涨
if (bitmap) {
bitmap.recycle()
}
}
main();
utils.decodeQRCode 解析一个二维码
- 解析一个二维码
- 适用版本(EC 5.15.0+)
- @param src 图像 Bitmap 对象,文件转Bitmap请看image模块
- @return
{string}
解析后的字符串
function main() {
//生成一个二维码bitmap 带logo的
let bot = utils.createQRCode("我是大佬的弟弟", 1000, 1000, image.readBitmap("/sdcard/yyb2.png"));
logd("bot " + bot);
//保存的到文件
let saved = image.saveBitmap(bot, "png", 100, "/sdcard/tmp.png");
logd("saved " + saved);
//回收掉防止内存暴涨
if (bot) {
bot.recycle()
}
//扫描二维码
let bitmap = image.readBitmap("/sdcard/tmp.png")
let data = utils.decodeQRCode(bitmap);
logd("data " + data);
//回收掉防止内存暴涨
if (bitmap) {
bitmap.recycle()
}
}
main();
其他
utils.readConfigInt 读取整型配置
- 读取JSON中的整型数据
- @param jsonObject JSON对象
- @param key 配置项目
- @return 整型,找不到就返回0
function main() {
var testData = utils.readConfigInt(jsonObject, "test_key");
}
main();
utils.readJSONString 读取JSON中字符串
- 读取JSON中的字符串数据
- @param jsonObject JSON对象
- @param key 配置项目
- @return 字符串 找不到就返回空字符串
function main() {
var testData = utils.readConfigString(jsonObject, "test_key");
}
main();