For more information, visit Lark Open Platform.

I. Intro

Lark DevTools is a command line tool used to develop gadgets for Lark. This tool allows you to create projects, carry out local debugging, upload projects, preview gadgets, troubleshoot problems, and provide feedback.

You can also log in and out of the tool. You can use opdev commands in the terminal as soon as the tool is globally installed. Use opdev new to quickly create a new project or opdev preview to preview a gadget in development. You can also use opdev devtools to launch a simulator to debug your gadget. We will explain all of the features in depth in this guide.

II. Installation

1. Prerequisites

1.1 Install Node.js 10.16.0 or above. The node package manager npm will also be automatically installed alongside Node.js.

You can use nvm on the same computer to manage multiple versions of Node.

1.2 Make sure that the npm version number is no lower than 6.9.0.

2. Global installation

Once you've installed Node.js, open the command line and execute the command below to install Lark DevTools. This will install the opdev command globally on your computer.

The installation package download address is <tarball url>. The download address for each version can be found in the CHANGE LOG.

For example：

Next, execute the following command to check if the opdev command has been installed correctly.

You can also use opdev version to check if the version you've installed is the one you wanted.

If you encounter any of the following problems during the installation process, see the FAQ for help.

III. Features

Help information

You can use help for all commands to see relevant help information.

new

The CLI can use a preset template to create a new project. Before creating a project, use opdev template to view the preset template names.

login

Login is required to upload gadgets, preview gadgets, use tt.login API, and log in on the simulator.

logout

If you need to switch accounts or tenants, you will need to log out first.

devtools (debugger)

Launch the debugger

Launch the simulator only (this launches more quickly and is better for quickly viewing code)

Support version 0.7.0 and above. Please use the opdev simulator [project-path] command for versions earlier than 0.7.0.

For more information on the debugger, see the Debug guide

preview

Preview gadgets: The terminal will display a QR code for mobile gadgets. For PC gadgets, a preview link will be sent to the Lark PC client.

Before previewing the gadget, make sure:
You are logged in to the command line tool
The correct appId has been entered in the project.config.json file. To learn how to get the appId, see Find the app ID.

Preview web apps (the debugging feature is currently only compatible with the Lark PC client): A QR code will be displayed in the terminal for mobile apps, and PC apps will be opened in Workplace.

To preview a web gadget, make sure the Lark PC client is no lower than 3.31

Real-time preview

Monitor file changes and directly preview updated mobile gadgets (not support PC gadgets).

upload

Before uploading, make sure:
You are logged in to the command line tool
The correct appId has been entered in the project.config.json file

Upload a gadget to Lark Developer

Upload the main navigation gadget for the mobile version to Lark Developer

feedback

Open Lark DevTools Service Desk to ask a question or send feedback.