1. 说明

• 工具类模块函数主要是跟Android常用的信息相关联
• 工具类模块的对象前缀是utils，例如 utils.requestShowLogPermission()这样调用

2. 函数

2.1. 打开App相关

2.1.1. utils.openApp

• 打开APP
• @param packageName 程序的包名
• @return 布尔型 true 代表成功，false 代表失败

function main(){
    //打开微信
    utils.openApp("com.tencent.mm");
}
main();

2.1.2. utils.openAppByName

• 打开APP，通过应用名称
• @param appName 程序名称，比如今日头条
• @return 布尔型 true 代表成功，false 代表失败

function main(){
    //打开微信
    utils.openAppByName("微信");
}
main();

2.1.3. utils.openActivity

• 打开一个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参数了
• @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":"snssdk1128://aweme/live/6701887916223941379",
    };
    utils.openActivity(map);
}
main();

2.2. 图库相关

2.2.1. utils.insertImageToAlbum

• 将图片插入到相册中，此方法会立刻更新相册数据
• @param path 图片路径

function main(){
    utils.insertImageToAlbum("/sdcard/a.png");
}
main();

2.2.2. utils.insertVideoToAlbum

• 将视频插入到相册中，此方法会立刻更新相册数据
• @param path 视频路径

function main(){
    utils.insertVideoToAlbum("/sdcard/a.mp4");
}
main();

2.3. 其他

2.3.1. utils.readConfigInt

• 读取JSON中的整型数据
• @param jsonObject JSON对象
• @param key 配置项目
• @return 整型，找不到就返回0

function main(){
    var testData = utils.readConfigInt(jsonObject,"test_key");
}
main();

2.3.2. utils.readJSONString

• 读取JSON中的字符串数据
• @param jsonObject JSON对象
• @param key 配置项目
• @return 字符串 找不到就返回空字符串

function main(){
    var testData = utils.readConfigString(jsonObject,"test_key");
}
main();

2.3.3. utils.isObjectNull

• 判断一个对象为空
• @param o 对象
• @return true或者false

function main(){
    var isNull = utils.isObjectNull("test_key");
}
main();

2.3.4. utils.isObjectNotNull

• 判断一个对象不为空
• @param o 对象
• @return true或者false

function main(){
    var isNull = utils.isObjectNotNull("test_key");
}
main();

2.3.5. utils.getRatio

• 取得比例，例如10参数，就是返回10%的比例，如果是true，说明随机比例正确，否则不正确
• @param ratio 浮点型 1-100
• @return true或者false

function main(){
    var ratio = utils.getRatio(20f);
    toast(ratio);
}
main();

2.3.6. utils.getRangeInt

• 取得某个范围的随机值
• @param min 最小值
• @param max 最大值
• @return 在min和max中间的值,包含最大和最小值

function main(){
    var value = utils.getRangeInt(1,100);
    toast(value);
}
main();

2.3.7. utils.isTrue

• 判断布尔型对象是否为真
• @param r 布尔型对象
• @return true 或者 false

function main(){
    var value = utils.isTrue(true);
}
main();

2.3.8. utils.fileMd5

• 文件的MD5
• @param file 文件路径
• @return 文件MD5字符串或者null

function main(){
    var md5 = utils.fileMd5("/sdcard/a.txt");
}
main();

2.3.9. utils.dataMd5

• 数据计算出来的MD5
• @param data 数据
• @return 数据MD5字符串或者null

function main(){
    var md5 = utils.dataMd5("data");
}
main();

2.3.10. utils.randomInt

• 随机整型数据
• @param length 位数，要随机产生多少位的整型数据
• @return 整型

function main(){
    var r = utils.randomInt(2);
}
main();

2.3.11. utils.randomCharNumber

• 取得随机的数字和字母
• @param length 长度
• @return 字符串数字混合

function main(){
    var r = utils.randomCharNumber(2);
}
main();

2.3.12. utils.getApkPkgName

• 取得App文件的包名
• @param filePath 文件路径
• @return 字符串

function main(){
    var pkgName = utils.getApkPkgName("/sdcard/app.apk");
}
main();

2.3.13. utils.isAppExist

• App是否已经安装
• @param packageName 应用程序的包名
• @return true 代表已经安装，false代表未安装

function main(){
    var result = utils.isAppExist("com.ss.android.article.news");
}
main();

2.3.14. utils.getAppVersionCode

• 取得已安装的程序的版本整型标示
• @param packageName 应用程序的包名
• @return 整型

function main(){
    var versionCode = utils.getAppVersionCode("com.ss.android.article.news");
}
main();

2.3.15. utils.getAppVersionName

• 取得已安装的程序的版本字符串标示
• @param packageName 应用程序的包名
• @return 字符串 例如 1.0.0

function main(){
    var r = utils.getAppVersionName("com.ss.android.article.news");
}
main();

2.3.16. utils.setClipboardText

• 设置剪贴板文本
• @param text 文本
• @return boolean

function main(){
    var r = utils.setClipboardText("com.ss.android.article.news");
    toast("设置结果:"+r);
}
main();

2.3.17. utils.getClipboardText

• 读取剪贴板文本
• @return string

function main(){
    var r = utils.getClipboardText();
    toast("读取结果:"+r);
}
main();