使用 uni-app 开发 Lark 小程序完整指南

Viewed 0

使用 uni-app 开发 Lark 小程序指南

uni-app 是一个开放式跨端跨框架解决方案,能有效提升开发效率,打破运行平台限制,降低维护成本。它支持常用开发框架如 React、Vue、Vue3、Nerv 等,允许开发者使用熟悉的框架进行开发,无需改变开发习惯。基于 Vue.js,uni-app 让开发者编写一套代码即可发布到 iOS、Android、Web 以及各种小程序平台。

1. 创建与配置 Lark 应用

首先,进入 Lark 开放平台开发者后台创建一个自建应用,例如命名为 "hello-world"。创建成功后,在应用详情页中,可以找到该应用并进入详情页。

在应用详情页的左侧菜单栏中,点击“凭证与基础信息”,查看右侧“应用凭证”下的 App ID,这是应用的唯一标识,可以直接复制使用。

接下来,配置 Lark 应用。若需要多人协作管理,可以在“成员管理”模块添加管理员、开发人员和运营人员。若要调用 Lark 提供的接口,则需在“权限管理”模块申请具体权限。此外,如果需要实时获取事件如部门变更或打卡通知,可以在“事件订阅”模块配置推送 URL 并选择具体事件。

2. 基于 uni-app 开发 Lark 小程序

创建 uni-app 项目

在开发工具中,通过文件菜单新建项目,选择 uni-app 类型,输入工程名并选择模板,即可成功创建 uni-app 项目。

调试 Lark 小程序

进入项目后,点击运行菜单中的“运行到小程序模拟器”并选择 Lark 开发者工具。此时,在项目路径下的 unpackage/dist 目录中会生成 dev 文件夹。如果是第一次使用,需要先配置 Lark 开发者工具的安装路径。

打开 Lark 开发者工具,点击“导入项目”,选择项目路径中 unpackage/dist/dev/mp-lark 下的 mp-lark 文件夹。在“详情/项目信息”中,将已创建 Lark 应用的 App ID 进行更新。然后,通过模拟器与调试器进行调试,点击“预览”或“真机调试”体验真机运行效果。注意,登录 Lark 开发者工具的身份需与应用的协作者保持一致。

如果效果不符合预期,需返回 uni-app 开发工具修改代码,重新编译后重复上述步骤;若效果符合预期,则完成代码开发。

发布 Lark 小程序

正式发布前,需在 HBuilderX 中进行发行操作。点击发行菜单中的“小程序”并选择 Lark(仅适用于 uni-app),此时在项目路径的 unpackage/dist 下会生成 build 文件夹。

3. 上传小程序代码包

在 Lark 开发者工具中,重新导入项目路径下 unpackage/dist/build/mp-lark 的文件夹(注意选择 build 文件夹下的文件)。在“详情/项目信息”中更新 App ID,然后点击“上传”完成小程序代码的上传。

4. 发布 Lark 应用

在开发者后台的应用详情页中,进入“应用功能”下的“小程序”部分,打开“启用小程序”开关,选择最新小程序的版本并保存。

若要更新小程序版本,同样在“小程序”部分,打开开关选择新版本并保存。

发布应用时,在应用详情页点击“版本管理与发布”,进入页面后点击“创建版本”。填写版本号、最低兼容 Lark 版本、更新说明和可用性状态等信息,然后保存。保存成功后,点击“申请发布”,待管理员审核通过后,应用将显示为已发布状态。

FAQ

如果 Lark 新开放的接口和组件不支持,可以通过 Lark 开发者工具的反馈功能联系支持团队。若 HBuilderX 找不到运行 Lark 开发者工具的入口,可以尝试下载 HBuilderX 的 alpha 版本。如果 HBuilderX 无法正常启动 Lark 开发者工具,需要手动启动工具,然后将 uni-app 生成的小程序工程路径拷贝到 Lark 开发者工具中,这样在 HBuilderX 中开发时,Lark 开发者工具会实时显示效果。

0 Answers