• 命令行工具
  • 安装与更新
    • 安装
    • 更新
  • 功能
    • 预览
    • web 化预览
    • 发布
  • 反馈与建议

命令行工具

安装与更新

npm 工具包下载地址

安装

 


  
npm i swan-toolkit -g

 

• 环境依赖：Node.js 。
• 亦可局部安装，通过npx或node_modules/.bin/swan执行。
• 本工具跨平台，可以部署在 windows/Mac/Linux ，可用于产品集成流水线部署。
• （全局）安装后即可使用全局 shell 命令swan。

更新

当该 npm 包有更新时，将会在使用过程中以命令行输出形式提示，建议请按照提示使用安装命令更新 npm 包；另为了不干扰集成流水线功能，更新提示不会在使用--json参数时展示，对于此种情况建议定期检查并手动更新。

功能

1. 下文提到的登录密钥，因为涉及到个人账户的身份认证，在用于公共机器构建流水线时，建议使用独立开发账号的登录密钥，并做好用户隔离和安全保护，定期修改账户密码。
2. 登录密钥获取方式：在百度智能小程序开发者工具（版本高于 2.4.1）中登录后，可通过“菜单 -> 关于 -> 复制登录密钥”获取。

预览

 


  
swan preview --project-path /path/to/your/project --token THE_TOKEN_WITH_PREVIEW_AUTHORIZATION

 

输入参数

输出

• 预览二维码、bundle_id ；
• exit code 非 0 时，表示过程存在异常，请根据输出报错日志调查原因。

web 化预览

 


  
swan web-preview --project-path /path/to/your/project --token THE_TOKEN_WITH_PREVIEW_AUTHORIZATION

 

输入参数

输出

• 预览二维码；
• exit code 非 0 时，表示过程存在异常，请根据输出报错日志调查原因。

发布

 


  
swan upload --project-path /path/to/your/project --token THE_TOKEN_WITH_PREVIEW_AUTHORIZATION --release-version 1.0.0.0 --desc description

 

输入参数

输出

• 发布成功提示；
• exit code 非 0 时，表示过程存在异常，请根据输出报错日志调查原因。

反馈与建议

如果在使用中遇到问题，或有改进建议，可以在智能小程序开发者社区中发帖向我们反馈，反馈时请注意以下几点：

1. 反馈前请使用swan version获取基本版本信息，并在反馈内容中标明。
2. “问题类型”请选择“开发者工具”，并在反馈内容中标明“cli 命令行工具”。

您的反馈将有助于我们完善产品。