使用APICloud|使用APICloud AVM框架开发人事档案管理助手app实战
由于人事档案具有涉密性，所以本应用没有使用后台服务，全部功能都在APP本地实现。
开发工具采用 APICloud Studio3，基于VSCode的（PS：比基于Atom的autio2好用太多）；
数据库采用sqllite，没有使用UI框架，个人觉得AVM本身支持的flex布局配合自写CSS样式，完全可以实现市面上所有的ＵＩ框架的元素，这个取决于个人功力。
一、项目思维脑图
文章图片
二、功能介绍
１、人员花名册
２、编制情况
３、个人中心
三、技术要点
手势密码验证，本地数据库操作，语音播报。
用到的模块
文章图片
项目文件目录
文章图片
引用一下官方的关于目录结构的介绍
文章图片
四、功能开发详解
1、首页导航
系统首页使用tabLayout，可以将相关参数配置在JSON文件中，再在config.xml中将content的值设置成该JSON文件的路径。如果底部导航没有特殊需求这里强烈建议大家使用tabLayout为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方法实现分页查询功能。
{item.name}
{item.nation}
{loadStateDesc}
3、表单提交
采用AVM自带的from控件，通过onsubmit进行数据提交
4、头像图片上传及base64转码
由于是本地sqllite数据库，人员头像图片需要转成base64编码存储到数据库中。通过官方模块trans进行图片转码操作。
文章图片
5、sqllite数据库 db模块
由于数据库文件需要存储的应用安装文件中，所有需要官方fs模块配合使用来进行数据库文件的操作。
文章图片
文章图片
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文件）需要到科大讯飞开发者平台进行下载导入的项目中。还有对数字的解读不是精确，尤其是年份，最好不要用数字，而是用中文。
文章图片
//添加朗读按钮
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插件
文章图片
安装成功之后会在文件目录中显示
文章图片
然后在用的地方直接引入即可。
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实战】在系统索引页进行动态权限获取提醒，本系统只涉及到了文件存储权限的获取，如需要获取多个权限，在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) => {});
}
推荐阅读
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 如何在Vue中使用debouce防抖函数
- Vue使用Echart图标插件之柱状图
- Flutter使用RepositoryProvider解决跨组件传值问题
- java|java 方法与数组基础使用详解
- C#|C#中Messagebox的简单使用
- 影像组学病理切片案例教学课程（免费赠送）另有现成的代码，模型供大家上手使用
- web后端|django restframework 使用问题收集
- python|pandas、openpyxl、xlrd&xlwt&xlutils耗时对比、使用踩坑
- vue|vue 项目中使用websocket的正确姿势
- Flutter使用AnimatedBuilder实现动效复用