飞书小程序开发经验总结
前序
最近一段时间,由于工作需要,我先在微信小程序开发平台上开发了一套程序,但是由于微信小程序不能保证整体的数据流都封闭在内网里,因而决定转战飞书小程序,将整体的功能都迁移至飞书小程序里。但是飞书小程序的开源博客比较少,所以在最开始上手的过程中还是比较痛苦的,现在小程序整体开发已经接近尾声,特此总结一下最近开发飞书小程序积累下的经验与流程。
开放文档与平台
飞书小程序提供了很多原生的API与服务端支持功能,都可以极大的丰富小程序的能力,因此多参考文档,对于程序的设计与开发都会有很大的帮助(主要还是因为飞书小程序的开源社区不太丰富,很多功能没有什么博客介绍用法)
飞书小程序开发文档:
https://open.feishu.cn/document/uYjL24iN/uUDNzUjL1QzM14SN0MTN
飞书开发者工具:
- windows-64-bit
- MacOS
微信小程序 vs 飞书小程序
微信小程序在很多的场景下与飞书小程序的语法格式都是一致的,如果遇到不确定的语法,可以直接参考微信小程序的语法,如果实在不行再去看飞书开发者文档。
一键迁移微信小程序
打开飞书开发者工具,可见右上角部分存在按钮 搬家工具 ,点击搬家工具即可将微信小程序直接迁移至飞书小程序中,该工具可以自动将大部分的微信小程序语法替换为飞书小程序语法,但是不能保证转换结果 绝对正确 ,还是有可能会存在一些语法不正确的情况存在,此时还是需要我们自行调试程序,保证程序的可用性。
更多详细的搬家工具使用方式还请参考:
搬家工具介绍文档
搬家工具使用后遗症
使用完搬家工具后不意味着可以立即进入开发调试阶段,此时我们还需要面对另外一个问题——微信小程序与飞书小程序技术支持的差异。
首先, 我们需要注意修改project.config.json文件中的appid,我们迁移程序后,appid并不会直接帮我们改好。
// 开发者后台中创建应用后即可看到appid : 开发者后台链接
之后,如果我们曾经在微信小程序中使用了云函数与云数据库的话,那么我们可能就会遇到麻烦了,因为飞书小程序更加的轻量化,其并不支持云函数与云数据库。此时对于数据的存储我们可以寻求另一个解决方案——多维表格。关于多维表格的使用,我会在下面介绍。
页面展示与page的坑
一个一个的页面(page)组成了小程序的基本结构,如果要配置小程序打开的默认界面,可以有两个选择:
- 在app.json中增加entryPagePath字段,该字段的值对应的页面将会被配置为入口页面。
“entryPagePath”: “pages/index/index” - app.json 中不配置entryPagePath字段,则默认为 pages 列表的第一项。
{
"pages":[
"pages/index/index"
]
}
一般来说,配置完pages里的内容就可以满足小程序的基本配置需要了
更多app.json全局配置选项参考文档
在pages文件夹内,一般我们会存放每个页面的文件夹
结构一般如下
├── pages
│ │── home
│ │ ├── home.ttml
│ │ ├── home.js
│ │ ├── home.json
│ │ └── home.ttss
│ └── user
│ ├── user.ttml
│ └── user.js
值得一提的是,所有的js文件中,不管会不会用到data对象,我们都需要对data对象进行声明,否则会一直打印报错
Page({
data:{
},
});
另外,所有的json文件也都需要进行初始化,即便没有任何数据,也需要写入一对正反大括号。
获取用户信息 getUserInfo
与微信小程序不同,飞书小程序在获取用户信息时,在调用getUserInfo之前,还需要先调用login方法。
getUserProfile() {
// 用户登录
tt.login({
// 成功回调
success(res) {
console.log(JSON.stringify(res));
// 获取用户信息
tt.getUserInfo({
// 要求敏感信息
withCredentials: true,
success: function(res) {
console.log(JSON.stringify(res));
tt.setStorageSync('user', res);
app.globalData.userName = res.userInfo.nickName;
},
fail: function(res) {
console.log(`getUserInfo fail: ${JSON.stringify(res)}`);
}
});
},
fail(res) {
console.log(`login fail: ${JSON.stringify(res)}`);
}
})
},
更多login信息,请参考tt.login
更多getUserInfo信息,请参考tt.getUserInfo
关于跳转页面栈的问题
在我们的小程序在不同的page之间进行跳转时,我们可能会更习惯使用navigateTo这个方法,但是每一次使用navigateTo方法时,都会将当前页面压入栈中,随后再执行跳转操作,每次左划屏幕边缘回退页面时,都会从页面栈中弹出页面。
例如说,我们存在两个page:pageA,pageB,我们在pageA.js文件中调用
tt.navigateTo({url: '../pageB/pageB'});
此时程序会先将pageA压入栈(stack)中,随后再从页面A跳转至页面B;注意,如果这里讲的是,必须要先将页面压入栈成功后,才会执行跳转操作,如果页面压入失败了,那么是不会执行后边的跳转操作的。如果此时用户在页面B左划屏幕,则会将栈顶的pageA弹出,并跳转至页面A上。
但是值得注意的时,页面栈的最大值为10,当页面栈的大小达到10之后,再次调用navigateTo操作将会不再起作用,页面栈不会更改,页面也不会跳转。
因而我们可以配合redirectTo来进行使用:
tt.navigateTo({
"url": "../shotPhoto/shotPhoto",
success(res) {
console.log(JSON.stringify(res));
},
// 失败回调
fail(res) {
console.log(`navigateTo fail: ${JSON.stringify(res)}`);
tt.redirectTo({
"url": "../shotPhoto/shotPhoto",
success(res) {
console.log(JSON.stringify(res));
},
fail(res) {
console.log(`rediractTo fail: ${JSON.stringify(res)}`);
}
})
}
});
但,依然要注意的一点是,redirectTo只能跳转到非tabBar界面,如果要跳转至tabBar界面,还请使用switchTab方法。
更多关于navigateTo, 请参考 navigateTo
更多关于redirectTo,请参考 redirectTo
更多关于switchTab,请参考 switchTab
鉴权的获取
在飞书小程序的开发中,有时我们在尝试使用其服务端的一些功能时,可能需要我们的鉴权即tenant_access_token,此时我们可以通过小程序调用post请求来获取相关的数据。
值得关注的是,鉴权信息2小时过期,过期后重新申请即可。
tt.request({
url: 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal',
method: "post",
data: {
app_id: "appid",
app_secret: "secret"
},
header: {
'Content-Type': "application/json; charset=utf-8"
},
success: function(res) {
console.log("try to get accessToken success:" + res);
accessToken = res;
tt.setStorageSync("accessToken", res);
tt.setStorageSync("accessTime", new Date().getTime());
},
fail: function(res) {
console.log("try to get accessToken failed:" + res);
}
})
多维表格?简配数据库!
多维表格文档 多维表格
多维表格可以被视为一个简配的关系型数据库,在飞书小程序不支持数据库的前提下,可以作为数据库的一个替代选项。
在对多维表格进行增加操作时,我们需要先自行创建一个多维表格,并获取到其app_token以及table_id,
如我们多维表格的url为
https://abc.feishu.cn/base/abcedfg?table=higklm&view=vewAVZdmul
此时,abcdefg即为app_token,table_id即为higklm。
同时,我们还需要获取鉴权。获取鉴权的方式如上介绍。
此处我们仅展示新增数据:
tt.request({
url:'https://open.feishu.cn/open-apis/bitable/v1/apps/apptokenapptoken/tables/tableidtableid/records',
method: "post",
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + accessTokenString
},
data: {
'fields': {
"人力耗时": 64,
"人力评估": "8",
}
},
success: function(res) {
console.log("上传数据成功"+ res);
},
fail: function(res) {
console.log("上传数据失败" + res);
}
})
持续更新。。。文章来源:https://www.toymoban.com/news/detail-402089.html
初学小白,在线挨打,如果有什么纰漏之处,还请大佬们多多指正。文章来源地址https://www.toymoban.com/news/detail-402089.html
到了这里,关于飞书小程序开发经验的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!