IDE 命令行工具

介绍

开发者工具提供了命令行供外部调用,开发者可以通过命令行工具进行登录、预览、上传等操作。 通过命令行调用安装完成的工具可执行文件,完成登录、预览、上传等操作。

命令行工具所在位置:

macOS: <安装路径>/Contents/Resources/app.asar.unpacked/bytecli

Windows: <安装路径>/resources/app.asar.unpacked/bytecli.bat

请将此路径添加到环境变量中

命令行

1. 打开IDE

# 打开工具
'-o, --open'

2. 命令行登录

  • 字节跳动开发者工具登录

由于字节跳动开发者工具只提供手机号登录方式,因此需要在命令行进行两步验证,1)输入手机号; 2)输入手机验证码

# 1)输入手机号
bytecli -l 176xxxxxxxx
# 2) 输入手机验证码,验证码在手机号后输入,用'@'分隔
bytecli -l 176xxxxxxxx@xxxx
  • 飞书开发者工具登录

飞书开发者工具提供扫描二维码登录方式,输入以下命令,打开手机飞书扫描终端上的二维码,确认登录

# 登录,在终端中打印登录二维码

bytecli -l

3. 命令行预览

预览时必须处于登录状态,如果没有登录,会提示需先登录。

-p, --preview <project_root>: 预览代码,project_root 指定项目根路径。 --preview-qr-output [format[@path]]: 指定二维码输出形式,format 可选值包括 terminal(命令行输出), base64, image。如果有填 path,表示结果输出到指定路径的文件中。如果没填 path,表示将结果输出到命令行。不使用此选项或使用了但没有填 format 的话则默认为命令行打印。

# 预览小程序,在终端中打印预览二维码
bytecli -p /Users/username/demo

# 预览小游戏,在终端中打印预览二维码
bytecli -p /Users/username/demo --preview-game

# 预览小程序,二维码转成 base64 并存到文件 /Users/username/code.txt
bytecli -p /Users/username/demo --preview-qr-output base64@/Users/username/code.txt

# 预览小程序,二维码转成 二进制图片 并存到文件 /Users/username/preview.png
bytecli -p /Users/username/demo --preview-qr-output image@/Users/username/preview.png

4. 命令行上传代码

上传代码时必须处于登录状态,如果没有登录,会提示需先登录。

上传代码需要的信息包括项目根目录、版本号、以及可选的版本备注。

-u, --upload <version@project_root>: 上传代码,version 指定版本号,project_root 指定项目根路径。

# 上传路径 /Users/username/demo 下的项目,指定版本号为 1.0.0,版本备注为 initial release
bytecli -u 1.0.0@/Users/username/demo --upload-desc 'initial release'

# 上传路径 /Users/username/demo 下的小游戏,指定版本号为 1.0.0,版本备注为 initial release
bytecli -u 1.0.0@/Users/username/demo --upload-desc 'initial release' --upload-game