原创首发于飞书文档由此拜访:
2020 年最初一天的几个小时,点上一根香,泡好茶,带上降噪耳机在音乐的陪伴下写写代码。
2020 年第一天,没搞完的持续搞,加油~
开发环境的搭建
1、零碎是 MacOS,装置 Node.js,装置的同时也会装置好 npm 下载地址 常用命令如下:
# 查看 Node.js 版本
node -v
# 查看 npm 版本
npm -v
# 查看 node 装置目录
which node
# 更新已装置的 npm 库
npm update -g
# 全局装置 n 命令,用 n 命令降级 Node.js
npm install -g n
# 降级到最新稳定版
n stable
# 降级到最新版
n latest
# 降级到指定版
n v14.15.3
# 切换应用版本
n 14.15.3 (ENTER)
2、装置命令行工具
curl -L https://sf1-scmcdn-tos.pstatp.com/obj/larkdeveloper/opdev/scripts/install_1.7.0.sh | sh
3、装置实现后,执行以下命令校验是否装置胜利
# 是否装置胜利
opdev help
# 查看装置的版本
opdev --version
# 查看单个命令帮忙信息,如上传命令
opdev upload --help
4、上传、预等操作须要先登录飞书账号,输出以下命令会关上默认浏览器进行登录。
这个中央比拟坑,不晓得是工具兼容的问题还是什么,尝试屡次失败后敞开终端从新关上才 ok。
# 登录
opdev login
# 抉择要登录的环境,在这里咱们抉择“Feishu”
5、登陆胜利,返回终端,显示以下信息,阐明登录胜利。
创立第一个小程序
1、进入飞书开发者后盾,创立一个企业自建利用
2、在企业自建利用列表中点击方才创立的 HelloWorld 利用进入利用详情页
3、在利用详情页中,点击左侧“凭证与根底信息”标签,查看右侧“利用凭证”下的 App ID(App ID 是利用的惟一标识)并复制。
4、从内置模板中生成一个“HelloWord”的小程序 Demo
# 查看内置模版列表
opdev template
# 返回后果,自带 5 个 Demo
# Available templates:
# - hello-world Gadget base template
# - gadget-demo Gadget api/component demo
# - widget-demo-approve Widget demo for Approve app
# - widget-demo-report Widget Demo for Report app
# - block-demo Block base template
# 用内置模版创立小程序 Demo, [project-path]为 Demo 目录
opdev new [project-path] -t hello-world
5、编辑“project.config.json”中的第 9 行,将方才复制的 App ID 填入,保留退出。
{
"setting": {
"urlCheck": true,
"es6": true,
"postcss": true,
"minified": true,
"newFeature": true
},
"appid": "XXXXXXXXXXXXXX",
"projectname": "Hello World"
}
6、回到命令行,执行“opdev devtools Demo1”命令,会关上左右两个 Chrome 浏览器窗口(右边是模拟器,左边是调试器)。
7、回到代码编辑器,关上 /pages/index/index.ttml,批改其中的内容并保留。
8、再次预览,如果看到上面的后果,那就证实本地预览和调试的办法你曾经把握了。
9、因为本地是基于 Chrome 的模仿预览,还能够通过真机预览来查看小程序的实在成果
opdev preview Demo1 -p Mobile
失常应该返回一个二维码,通过飞书客户端扫码即可实现预览
留神:这个中央容易呈现问题,报错信息如下
起因是以后登录用户没有 node_modules 目录的权限,因为过后装置 node 是用的 root 账户。
解决办法:
# 其中 XXXX 替换成你以后的用户
sudo chown -R XXXX /usr/local/lib/node_modules
上传和公布小程序
1、进入命令行,执行以下命令,-p Mobile 标识上传挪动端小程序版本,输出版本号和形容
复制下图红色框呈现的网址在浏览器中关上
2、关上 启用小程序 开关、抉择最新小程序的版本、点击保留按钮,确认保留胜利。
3、公布利用,在此之前,须要确保小程序的图标曾经设置好。点击左侧 版本治理与公布 进入版本治理与发布页面,点击 创立版本 按钮,进入创立版本详情页。
4、填写完信息后,抉择“申请公布”
5、在飞书客户端会给企业管理员发信息审核,发送信息的是“开发者小助手(原开放平台助手)”
6、点击“去审核”后进入“飞书治理后盾”-“利用审核”- 在右侧点击“审核”按钮
7、点击“通过”按钮实现利用审核
8、实现审核后,能够在“版本治理与公布”中看到版本状态为“已上架”
9、关上飞书客户端,进入工作台,能够看到方才公布的“HelloWorld”小程序,点击能够关上利用。
10、好了,搞定,第一个飞书小程序,过程中还是遇到一些问题的,但后果还是好的。
2021 新年第一天,祝大家新年快乐。
欢送分割作者一起交换飞书开发教训。