使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战

由于人事档案具有涉密性,所以本应用没有使用后台服务,全部功能都在APP本地实现。
开发工具采用 APICloud Studio3,基于VSCode的(PS:比基于Atom的autio2好用太多);
数据库采用sqllite,没有使用UI框架,个人觉得AVM本身支持的flex布局配合自写CSS样式,完全可以实现市面上所有的UI框架的元素,这个取决于个人功力。
一、项目思维脑图
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

二、功能介绍
1、人员花名册
2、编制情况
3、个人中心
三、技术要点
手势密码验证,本地数据库操作,语音播报。
用到的模块
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

项目文件目录
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

引用一下官方的关于目录结构的介绍
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

四、功能开发详解
1、首页导航
系统首页使用tabLayout,可以将相关参数配置在JSON文件中,再在config.xml中将content的值设置成该JSON文件的路径。如果底部导航没有特殊需求这里强烈建议大家使用tabLayout为APP进行布局,官方已经将各类手机屏幕及不同的分辨率进行了适配,免去了很多关于适配方面的问题。
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

app.json文件内容,关于json文件的命名是没有限制的,我习惯用app。

{ "name": "root", "textOffset": 6, "color": "#999999", "selectedColor": "#006aff", "scrollEnabled": false, "hideNavigationBar": false, "bgColor": "#fff", "navigationBar": { "background": "#006aff", "shadow": "rgba(0,0,0,0)", "color": "#fff", "fontSize": 18, "hideBackButton": true }, "tabBar": { "background": "#fff", "shadow": "#eee", "color": "#5E5E5E", "selectedColor": "#006aff", "textOffset": 3, "fontSize": 11, "scrollEnabled": true, "index": 1, "preload": 0, "frames": [ { "title": "编制情况", "name": "home", "url": "./pages/records/organ" }, { "title": "人员花名册", "name": "course", "url": "./pages/person/organ" }, { "title": "个人中心", "name": "user", "url": "./pages/main/main" } ], "list": [ { "text": "编制", "iconPath": "./image/authoried-o.png", "selectedIconPath": "./image/authoried.png" }, { "text": "人员", "iconPath": "./image/person-o.png", "selectedIconPath": "./image/person.png" }, { "text": "我的", "iconPath": "./image/user-o.png", "selectedIconPath": "./image/user.png" } ] } }

2、列表显示及分页
通过上拉刷新和下拉操作,配合JS方法实现分页查询功能。


3、表单提交
采用AVM自带的from控件,通过onsubmit进行数据提交
4、头像图片上传及base64转码
由于是本地sqllite数据库,人员头像图片需要转成base64编码存储到数据库中。通过官方模块trans进行图片转码操作。
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

setavator(){ api.actionSheet({ cancelTitle: '取消', buttons: ['拍照', '打开相册'] }, (ret, err) => { if (ret.buttonIndex == 3) { return false; } var sourceType = (ret.buttonIndex == 1) ? 'camera' : 'album'; api.getPicture({ sourceType: sourceType, allowEdit: true, quality: 20, destinationType:'url' }, (ret, err) => { if (ret && ret.data) { var trans = api.require('trans'); trans.decodeImgToBase64({ imgPath: ret.data }, (ret, err) => { // console.log(JSON.stringify(ret)); // console.log(JSON.stringify(err)); if (ret.status) { let b64 ="data:image/jpeg; base64,"+ret.base64Str; this.data.src = https://www.it610.com/article/b64; } else { api.toast({ msg:'照片上传失败,请重新选择!' }) } }); } }); }); },

5、sqllite数据库 db模块
由于数据库文件需要存储的应用安装文件中,所有需要官方fs模块配合使用来进行数据库文件的操作。
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

copyDB(){ var fs = api.require('fs'); fs.copyTo({ oldPath: 'widget://db/doc.db', newPath: 'fs://db' }, function(ret, err) { // console.log(JSON.stringify(ret)); // console.log(JSON.stringify(err)); if (ret.status) { // console.log(JSON.stringify(ret)); api.toast({ msg:'拷贝数据库成功!' }) } else { // console.log(JSON.stringify(err)); api.toast({ msg:JSON.stringify(err) }) } }); }, openDB(){ var db = api.require('db'); db.subfile({ directory:'fs://db' }, (ret, err)=> { // console.log(JSON.stringify(ret)); // console.log(JSON.stringify(err)); if (ret.status) { // console.log(JSON.stringify(ret)); //打开数据库 db.openDatabase({ name: 'doc', path: ret.files[0] }, (ret, err)=> { // console.log(JSON.stringify(ret)); // console.log(JSON.stringify(err)); if (ret.status) { // console.log(JSON.stringify(ret)); api.toast({ msg:'打开数据库成功!' }) } else { // console.log(JSON.stringify(err)); api.toast({ msg:JSON.stringify(err) }) } }); } else { // console.log(JSON.stringify(err)); api.toast({ msg:JSON.stringify(err) }) } }); }, closeDB(){ var db = api.require('db'); db.closeDatabase({ name: 'doc' }, function(ret, err) { if (ret.status) { console.log(JSON.stringify(ret)); api.toast({ msg:'关闭数据库成功' }) } else { // console.log(JSON.stringify(err)); api.toast({ msg:JSON.stringify(err) }) } }); }, updateDB(){ var fs = api.require('fs'); var db = api.require('db'); db.closeDatabase({ name: 'doc' }, (ret, err) => { if (ret.status) { //拷贝文件 fs.copyTo({ oldPath: 'widget://doc.db', newPath: 'fs://db/' }, (ret, err) => { if (ret.status) { db.subfile({ directory:'fs://db' }, (ret, err)=> { if(ret.status){ //打开数据库 db.openDatabase({ name: 'doc', path: ret.files[0] }, (ret, err)=> { if (ret.status) { api.toast({ msg:'数据库更新成功!' }) } else { api.toast({ msg:JSON.stringify(err) }) } }); } else{ api.toast({ msg:JSON.stringify(err) }) } }) } else { api.toast({ msg:JSON.stringify(err) }) } }); } else { api.toast({ msg:JSON.stringify(err) }) } }); },

6、语音播报功能
采用官方提供的IFLyVoice模块,需要注意的是,基础资源文件和发音人资源文件(.jet文件)需要到科大讯飞开发者平台进行下载导入的项目中。还有对数字的解读不是精确,尤其是年份,最好不要用数字,而是用中文。
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

//添加朗读按钮 api.setNavBarAttr({ rightButtons: [{ text: '朗读' }] }); //监听右上角按钮点击事件 api.addEventListener({ name: 'navitembtn' }, (ret, err) => { // console.log(JSON.stringify(this.data.info)); if (ret.type == 'right') { var IFlyVoice = api.require('IFlyVoice'); IFlyVoice.initSpeechSynthesizer((ret)=>{ //console.log(JSON.stringify(ret)); }); IFlyVoice.startSynthetic({ text:this.data.info, commonPath_Android:'widget://res/android/common.jet', pronouncePath_Android:'widget://res/android/xiaoyan.jet', pronounceName:'xiaoyan', speed:40 },(ret,err)=>{ // console.log(JSON.stringify(ret)); // console.log(JSON.stringify(err)); if (ret.status) { // console.log('合成成功'); } else { // console.log(JSON.stringify(err)); } }); } });

7、手势密码保护
手势密码保护由于官方模块存在样式问题,及原生模块存在遮罩问题,所以采用了平台上提供的H5模块。APICloud强大之处在这里进行了淋漓尽致的体现,通过AVM及原生模块无法实现的功能,可以再用H5的方式来实现!牛逼!!!!,通过设置全局变量来记录是否已设置手机密码,每次应用启动通过这个变量来判断是否开启手势密码保护。
this.data.islock =api.getPrefs({sync: true,key: 'islock'}); if(this.data.islock=='Y'){ api.openFrame({ name: 'h5lock', url:'../../html/h5lock.html' }) } else{ api.toast({ msg:'您还没有设置手势密码,为了数据安全,请尽快设置。' }) }

H5lock - 锐客网body { text-align: center; background-color: #000000; } .title { /*color: #87888a; */ margin-top: 85px; font-size: 20px; font-weight:lighter; }

(function(){ window.H5lock = function(obj){ this.height = obj.height; this.width = obj.width; this.chooseType = Number(window.localStorage.getItem('chooseType')) || obj.chooseType; this.devicePixelRatio = window.devicePixelRatio || 1; }; H5lock.prototype.drawCle = function(x, y) { // 初始化解锁密码面板 小圆圈 this.ctx.strokeStyle = '#87888a'; //密码的点点默认的颜色 this.ctx.lineWidth = 2; this.ctx.beginPath(); this.ctx.arc(x, y, this.r, 0, Math.PI * 2, true); this.ctx.closePath(); this.ctx.stroke(); } H5lock.prototype.drawPoint = function(style) { // 初始化圆心 for (var i = 0 ; i < this.lastPoint.length ; i++) { this.ctx.fillStyle = style; this.ctx.beginPath(); this.ctx.arc(this.lastPoint[i].x, this.lastPoint[i].y, this.r / 2.5, 0, Math.PI * 2, true); this.ctx.closePath(); this.ctx.fill(); } } H5lock.prototype.drawStatusPoint = function(type) { // 初始化状态线条 for (var i = 0 ; i < this.lastPoint.length ; i++) { this.ctx.strokeStyle = type; this.ctx.beginPath(); this.ctx.arc(this.lastPoint[i].x, this.lastPoint[i].y, this.r, 0, Math.PI * 2, true); this.ctx.closePath(); this.ctx.stroke(); } } H5lock.prototype.drawLine = function(style, po, lastPoint) {//style:颜色 解锁轨迹 this.ctx.beginPath(); this.ctx.strokeStyle = style; this.ctx.lineWidth = 3; this.ctx.moveTo(this.lastPoint[0].x, this.lastPoint[0].y); for (var i = 1 ; i < this.lastPoint.length ; i++) { this.ctx.lineTo(this.lastPoint[i].x, this.lastPoint[i].y); } this.ctx.lineTo(po.x, po.y); this.ctx.stroke(); this.ctx.closePath(); } H5lock.prototype.createCircle = function() {// 创建解锁点的坐标,根据canvas的大小来平均分配半径 var n = this.chooseType; var count = 0; this.r = this.ctx.canvas.width / (1 + 4 * n); // 公式计算 this.lastPoint = []; this.arr = []; this.restPoint = []; var r = this.r; for (var i = 0 ; i < n ; i++) { for (var j = 0 ; j < n ; j++) { count++; var obj = { x: j * 4 * r + 3 * r, y: i * 4 * r + 3 * r, index: count }; this.arr.push(obj); this.restPoint.push(obj); } } this.ctx.clearRect(0, 0, this.ctx.canvas.width, this.ctx.canvas.height); for (var i = 0 ; i < this.arr.length ; i++) { this.drawCle(this.arr[i].x, this.arr[i].y); } //return arr; } H5lock.prototype.getPosition = function(e) {// 获取touch点相对于canvas的坐标 var rect = e.currentTarget.getBoundingClientRect(); var po = { x: (e.touches[0].clientX - rect.left)*this.devicePixelRatio, y: (e.touches[0].clientY - rect.top)*this.devicePixelRatio }; return po; } H5lock.prototype.update = function(po) {// 核心变换方法在touchmove时候调用 this.ctx.clearRect(0, 0, this.ctx.canvas.width, this.ctx.canvas.height); for (var i = 0 ; i < this.arr.length ; i++) { // 每帧先把面板画出来 this.drawCle(this.arr[i].x, this.arr[i].y); } this.drawPoint('#27AED5'); // 每帧花轨迹 this.drawStatusPoint('#27AED5'); // 每帧花轨迹 this.drawLine('#27AED5',po , this.lastPoint); // 每帧画圆心 // if (this.lastPoint.length == 4) { //// debugger // } for (var i = 0 ; i < this.restPoint.length ; i++) { if (Math.abs(po.x - this.restPoint[i].x) < this.r && Math.abs(po.y - this.restPoint[i].y) < this.r) { this.drawPoint(this.restPoint[i].x, this.restPoint[i].y); this.lastPoint.push(this.restPoint[i]); this.restPoint.splice(i, 1); break; } } } H5lock.prototype.checkPass = function(psw1, psw2) {// 检测密码 var p1 = '', p2 = ''; for (var i = 0 ; i < psw1.length ; i++) { p1 += psw1[i].index + psw1[i].index; } for (var i = 0 ; i < psw2.length ; i++) { p2 += psw2[i].index + psw2[i].index; } return p1 === p2; } H5lock.prototype.storePass = function(psw) {// touchend结束之后对密码和状态的处理 if (this.pswObj.step == 1) { if (this.checkPass(this.pswObj.fpassword, psw)) { this.pswObj.step = 2; this.pswObj.spassword = psw; document.getElementById('title').innerHTML = '密码保存成功'; this.drawStatusPoint('#2CFF26'); this.drawPoint('#2CFF26'); window.localStorage.setItem('passwordxx', JSON.stringify(this.pswObj.spassword)); window.localStorage.setItem('chooseType', this.chooseType); } else { document.getElementById('title').innerHTML = '两次不一致,重新输入'; this.drawStatusPoint('red'); this.drawPoint('red'); delete this.pswObj.step; } } else if (this.pswObj.step == 2) { if (this.checkPass(this.pswObj.spassword, psw)) { var title = document.getElementById("title"); title.style.color = "#2CFF26"; title.innerHTML = '解锁成功'; this.drawStatusPoint('#2CFF26'); //小点点外圈高亮 this.drawPoint('#2CFF26'); this.drawLine('#2CFF26',this.lastPoint[this.lastPoint.length-1] , this.lastPoint); // 每帧画圆心 api.closeFrame(); } else if (psw.length < 4) {this.drawStatusPoint('red'); this.drawPoint('red'); this.drawLine('red',this.lastPoint[this.lastPoint.length-1] , this.lastPoint); // 每帧画圆心 var title = document.getElementById("title"); title.style.color = "red"; title.innerHTML = '请连接4个点'; } else { this.drawStatusPoint('red'); this.drawPoint('red'); this.drawLine('red',this.lastPoint[this.lastPoint.length-1] , this.lastPoint); // 每帧画圆心 var title = document.getElementById("title"); title.style.color = "red"; title.innerHTML = '手势密码错误,请重试'; } } else { this.pswObj.step = 1; this.pswObj.fpassword = psw; document.getElementById('title').innerHTML = '再次输入'; } } H5lock.prototype.makeState = function() { if (this.pswObj.step == 2) { // document.getElementById('updatePassword').style.display = 'block'; //document.getElementById('chooseType').style.display = 'none'; var title = document.getElementById("title"); title.style.color = "#87888a"; title.innerHTML = '请解锁'; } else if (this.pswObj.step == 1) { //document.getElementById('chooseType').style.display = 'none'; // document.getElementById('updatePassword').style.display = 'none'; } else { // document.getElementById('updatePassword').style.display = 'none'; //document.getElementById('chooseType').style.display = 'block'; } } H5lock.prototype.setChooseType = function(type){ chooseType = type; init(); } H5lock.prototype.updatePassword = function(){ window.localStorage.removeItem('passwordxx'); window.localStorage.removeItem('chooseType'); this.pswObj = {}; document.getElementById('title').innerHTML = '绘制解锁图案'; this.reset(); } H5lock.prototype.initDom = function(){ var wrap = document.createElement('div'); var str = '请绘制您的图形密码'; wrap.setAttribute('style','position: absolute; top:0; left:0; right:0; bottom:0; '); var canvas = document.createElement('canvas'); canvas.setAttribute('id','canvas'); canvas.style.cssText = 'background-color: #000; display: inline-block; margin-top: 76px; '; wrap.innerHTML = str; wrap.appendChild(canvas); var width = this.width || 320; var height = this.height || 320; document.body.appendChild(wrap); // 高清屏锁放 canvas.style.width = width + "px"; canvas.style.height = height + "px"; canvas.height = height * this.devicePixelRatio; canvas.width = width * this.devicePixelRatio; } H5lock.prototype.init = function() { this.initDom(); this.pswObj = window.localStorage.getItem('passwordxx') ? { step: 2, spassword: JSON.parse(window.localStorage.getItem('passwordxx')) } : {}; this.lastPoint = []; this.makeState(); this.touchFlag = false; this.canvas = document.getElementById('canvas'); this.ctx = this.canvas.getContext('2d'); this.createCircle(); this.bindEvent(); } H5lock.prototype.reset = function() { this.makeState(); this.createCircle(); } H5lock.prototype.bindEvent = function() { var self = this; this.canvas.addEventListener("touchstart", function (e) { e.preventDefault(); // 某些android 的 touchmove不宜触发 所以增加此行代码 var po = self.getPosition(e); for (var i = 0 ; i < self.arr.length ; i++) { if (Math.abs(po.x - self.arr[i].x) < self.r && Math.abs(po.y - self.arr[i].y) < self.r) { self.touchFlag = true; self.drawPoint(self.arr[i].x,self.arr[i].y); self.lastPoint.push(self.arr[i]); self.restPoint.splice(i,1); break; } } }, false); this.canvas.addEventListener("touchmove", function (e) { if (self.touchFlag) { self.update(self.getPosition(e)); } }, false); this.canvas.addEventListener("touchend", function (e) { if (self.touchFlag) { self.touchFlag = false; self.storePass(self.lastPoint); setTimeout(function(){ self.reset(); }, 1000); } }, false); //document.getElementById('updatePassword').addEventListener('click', function(){ //self.updatePassword(); //}); } })();

8、设置手势密码
登录成功之后,在个人中心来设置手势密码。可通过参数设置来初始化密码强度。
H5lock - 锐客网body { text-align: center; background-color: #000000; } .title { /*color: #87888a; */ margin-top: 85px; font-size: 20px; font-weight:lighter; } .reset{ position: relative; top: 200px; font-size: 20px; text-align: center; }

9、修改密码
系统默认设定了用户的初始密码,用户登录系统后会提示进行密码修改,修改后的密码进行了MD5加密,由于没有后台系统,所以密码的MD5加密,采用了JS来进行加密。通过开发工具调试控制台安装js插件
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

安装成功之后会在文件目录中显示
使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片

然后在用的地方直接引入即可。
import $md5 from '../../node_modules/js-md5/build/md5.min.js' var db = api.require('db'); db.executeSql({ name: 'doc', sql: "update user set password = '"+ md5(ret.text) +"' where id = 1" }, (ret, err)=> { // console.log(JSON.stringify(ret)); // console.log(JSON.stringify(err)); if (ret.status) { api.alert({ title: '消息提醒', msg: '密码修改成功,请重新登陆', }, (ret, err) => { //清除用户信息 api.removePrefs({ key: 'username' }); api.removePrefs({ key: 'userid' }); api.removePrefs({ key: 'password' }); $util.openWin({ name: 'login', url: '../main/login.stml', title: '', hideNavigationBar:true }); }); } else { api.toast({ msg:JSON.stringify(err) }) } });

10、封装工具类插件 utils.js
在需要用到插件中通用方法的地方,直接引用即可。
import $util from "../../utils/utils.js"

const $util = { openWin(param){ var param = { name: param.name, url: param.url, title: param.title||'', pageParam: param.pageParam||{}, hideNavigationBar: param.hideNavigationBar || false, navigationBar:{ background:'#1492ff', shadow: '#fff', color: '#fff' } }; if (this.isApp()) { api.openTabLayout(param); } else { api.openWin(param); } }, isApp(){ if (api.platform && api.platform == 'app') { return true; } return false; }, fitRichText(richtext, width){ var str = `使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
文章图片


【使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战】在系统索引页进行动态权限获取提醒,本系统只涉及到了文件存储权限的获取,如需要获取多个权限,在List[]数组中继续添加需要的权限,然后根据添加的权限个数,做相应的几个判断即可。
let limits=[]; //获取权限 var resultList = api.hasPermission({ list: ['storage'] }); if (resultList[0].granted) { // 已授权,可以继续下一步操作 } else { limits.push(resultList[0].name); } if(limits.length>0){ api.requestPermission({ list: limits, }, (res) => {}); }

    推荐阅读