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

Viewed 0

使用uni-app开发飞书小程序

uni-app是一个开放式跨端跨框架解决方案,能够有效提升开发效率并打破运行平台的限制,降低维护成本。它支持使用完整的Vue.js框架进行开发,允许开发者编写一套代码并发布到iOS、Android、Web以及各种小程序平台。

1. 创建和配置飞书应用

首先,访问飞书开放平台的开发者后台,创建一个名为“hello-world”的自建应用。创建成功后,应用会出现在企业自建应用目录中;点击进入应用详情页。

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

接下来,配置飞书应用:

  • 协作成员:如果需要多人协作管理,可以在“成员管理”模块添加管理员、开发人员和运营人员。
  • 权限申请:若需调用飞书接口,需在“权限管理”模块根据接口需求申请具体权限。
  • 事件订阅:如需实时获取某些事件,如部门变更或打卡通知,可在“事件订阅”模块配置推送URL并选择事件。

2. 使用uni-app开发飞书小程序

在HBuilderX中创建uni-app项目:点击工具栏的文件 -> 新建 -> 项目,选择uni-app类型,输入工程名,选择模板,然后点击创建。

调试飞书小程序的步骤如下:

  1. 进入项目,点击工具栏的运行 -> 运行到小程序模拟器 -> 飞书开发者工具。此时,在项目路径的unpackage/dist下会生成dev文件夹。注意:首次使用时,需配置飞书开发者工具的安装路径。
  2. 打开飞书开发者工具,点击“导入项目”,选择项目路径下unpackage/dist/dev/mp-lark中的mp-lark文件夹。
  3. 在“详情/项目信息”中,更新已创建飞书应用的App ID。
  4. 使用模拟器与调试器进行调试。
  5. 点击“预览”或“真机调试”,体验真机运行效果。注意,登录身份需与应用的协作者一致。
  6. 若效果不符预期,返回HBuilderX修改代码,重新编译后重复调试步骤。

3. 发布飞书小程序

由于运行模式下代码未压缩且含sourcemap,体积较大,正式发布前需在HBuilderX中进行发行操作。点击HBuilderX工具栏的发行 -> 小程序 -> 飞书(仅适用于uni-app),在项目路径的unpackage/dist下会生成build文件夹。

上传小程序代码包:

  1. 在飞书开发者工具中重新导入项目路径下unpackage/dist/build/mp-lark文件夹。
  2. 更新App ID。
  3. 点击“上传”完成代码上传。

发布飞书应用:
在飞书开发者后台的应用详情页,进入“应用功能 > 小程序”,打开“启用小程序”开关,选择最新版本并保存。更新小程序版本时,同样在此处选择最新版本并保存。

最后,在版本管理与发布页面创建版本,填写版本号、最低兼容飞书版本、更新说明和可用性状态,保存后点击“申请发布”。管理员审核后,应用将变为已发布状态。

常见问题解答(FAQ)

Q:飞书新开放的接口和组件还不支持怎么办?
A: 可以通过飞书开发者工具的反馈功能联系开发团队。

Q:HBuilderX找不到运行飞书开发者工具的入口怎么办?
A: 若正式版本中无法找到,可以尝试下载HBuilderX的alpha版本。

Q:HBuilderX无法正常启动飞书开发者工具怎么办?
A: 需要手动启动飞书开发者工具,然后将uni-app生成的小程序工程路径拷贝到工具中;这样在HBuilderX中开发时,飞书开发者工具可实时显示效果。

0 Answers