• HTTP
    • 1. 打开工具或指定项目
    • 2. 登录
    • 3. 预览
    • 4. 上传
    • 5. 自动化测试
    • 请求响应

    开发者工具提供了命令行与 HTTP 服务两种接口供外部调用,开发者可以通过命令行或 HTTP 请求指示工具进行登录、预览、上传等操作。

    HTTP

    http 服务在工具启动后自动开启,HTTP 服务端口号在用户目录下记录,可通过检查用户目录、检查用户目录下是否有端口文件及尝试连接来判断工具是否安装/启动。

    端口号文件位置:

    macOS : ~/Library/Application Support/微信web开发者工具/Default/.ide

    Windows : ~/AppData/Local/微信web开发者工具/User Data/Default/.ide

    1. 打开工具或指定项目

    接口定义:

    URL: /open

    HTTP 方法: GET

    URL 参数 必填 说明
    projectpath 打开指定路径中的项目。如项目已打开,自动刷新项目。如项目未创建,自动创建并打开项目

    示例:

    1. # 打开工具
    2. http://127.0.0.1:端口号/open
    3. # 打开/刷新项目
    4. http://127.0.0.1:端口号/open?projectpath=项目全路径

    注意:

    • 项目路径中必须含正确格式的 project.config.json 且其中有 appid 和 projectname 字段。
    • 项目路径需经 URL encode

      2. 登录

    接口定义:

    URL:/login

    HTTP 方法:GET

    URL 参数 必填 说明
    format 指定登录二维码返回格式,可选值有 image、base64、terminal,默认 image。图片格式为 png
    qroutput 指定文件路径,在文件写入二维码数据。如指定,二维码将被写入指定路径的文件内,如未指定,二维码将作为请求相应体返回

    示例:

    1. # 登录,返回图片格式的二维码
    2. http://127.0.0.1:端口号/login
    3. # 登录,取 base64 格式二维码
    4. http://127.0.0.1:端口号/login?format=base64
    5. # 登录,取 base64 格式二维码,并写入 /Users/username/logincode.txt
    6. http://127.0.0.1:端口号/login?format=base64&qroutput=%2FUsers%2Fusername%2Flogincode.txt

    3. 预览

    接口定义:

    URL:/preview

    HTTP 方法:GET

    URL 参数 必填 说明
    projectpath 预览指定路径中的项目。如项目已打开,自动刷新项目。如项目未创建,自动创建并预览项目
    format 指定登录二维码返回格式,可选值有 image、base64、terminal,默认 image。图片格式为 png
    qroutput 指定文件路径,在文件中写入二维码数据。如指定,二维码将被写入指定路径的文件内,如未指定,二维码将作为请求相应体返回

    示例:

    1. # 预览路径为 /Users/username/demo 的项目,返回图片格式的二维码
    2. http://127.0.0.1:端口号/preview?projectpath=%2FUsers%2Fusername%2Fdemo
    3. # 预览路径为 /Users/username/demo 的项目,返回 base64 格式的二维码
    4. http://127.0.0.1:端口号/preview?projectpath=%2FUsers%2Fusername%2Fdemo&format=base64
    5. # 预览路径为 /Users/username/demo 的项目,返回 base64 格式的二维码,并写入 /Users/username/logincode.txt
    6. http://127.0.0.1:端口号/preview?projectpath=%2FUsers%2Fusername%2Fdemo&format=base64&qroutput=%2FUsers%2Fusername%2Flogincode.txt

    4. 上传

    接口定义:

    URL:/upload

    HTTP 方法:GET

    URL 参数 必填 说明
    projectpath 上传指定路径中的项目
    version 版本号
    desc 本次上传的版本备注

    示例:

    1. # 上传路径为 /Users/username/demo 的项目,指定版本号为 v1.0.0
    2. http://127.0.0.1:端口号/upload?projectpath=%2FUsers%2Fusername%2Fdemo&version=v1.0.0
    3. # 上传路径为 /Users/username/demo 的项目,指定版本号为 v1.0.0,并带上备注
    4. http://127.0.0.1:端口号/upload?projectpath=%2FUsers%2Fusername%2Fdemo&version=v1.0.0&desc=test

    5. 自动化测试

    接口定义:

    URL:/test

    HTTP 方法:GET

    URL 参数 必填 说明
    projectpath 测试指定路径中的项目

    示例:

    1. # 提交路径为 /Users/username/demo 的项目进行测试
    2. http://127.0.0.1:端口号/test?projectpath=%2FUsers%2Fusername%2Fdemo

    请求响应

    正常情况下 HTTP 相应状态码为 200,错误时 400,返回如下格式的 JSON 字符串:

    1. {
    2. "code": 40000,
    3. "error": "原因"
    4. }

    原文:

    https://developers.weixin.qq.com/miniprogram/dev/devtools/http.html