Skip to main content

apk安装介绍

功能说明：用于批量安装 Android apk 文件的接口，支持通过 ZIP 压缩包上传多个 apk 文件并自动安装

批量安装APK打包结构示例：

outer.zip/
├── split1.zip
│   ├── base.apk
├── split2.zip
│   └── feature1.apk
└── split3.zip
    └── feature2.apk

文件要求：

  • 压缩包格式：ZIP
  • 压缩包内文件结构：
    • 每个 APK 单独打一个 ZIP 包（如 com.baidu.browser.apps.zip）
    • 不允许嵌套目录（如 /app/base.apk）
    • 不允许一个 ZIP 包中包含多个 APK（“套娃”无效）

请求方式：POST

请求 URL：

http://{ip}:{port}/installapks

请求参数：

参数名必选类型说明
file是file包含多个 apk打包ZIP 文件的 ZIP 压缩包

参数详解：

  • file: 包含多个 apk打包ZIP 文件的 ZIP 压缩包
    • 步骤：
      1. 将每个apk分别单独打包为一个zip文件
      2. 将这些zip文件压缩为一个zip文件（如 outer.zip）
      3. 上传zip文件

请求示例：

使用 curl 命令：

curl -X POST \
  "http://192.168.99.108:10017/installapks" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/apk.zip"

文件上传示例:

HTML 代码:

<!DOCTYPE html>
<html>
  <head>
    <title>文件上传示例</title>
  </head>
  <body>
    <!--请将"http://ip:9082"替换为实际IP和端口,桥接安卓的端口是9082，非桥接请查看本文档最上面”非桥接模式的端口”表格里对应实例位的安卓
    API 端口-->
    <h1>文件上传示例</h1>
    <form
      action="http://ip:9082/installapks"
      method="post"
      enctype="multipart/form-data"
    >
      <label for="installer">Installer 参数:</label>
      <input
        type="text"
        id="installer"
        name="installer"
        value="com.android.vending"
      />
      <br /><br />
      <input type="file" name="fileToUpload" id="fileToUpload" />
      <input type="submit" value="上传" name="submit" />
    </form>
  </body>
</html>

文件上传示例.png

apk 压缩包示例如下：

apk批量.zip.png

apk01.zip.png

apk02.zip.png

返回示例：

成功 (HTTP 200)：

全部安装完成

失败：

错误返回xxx为java层报错信息，不固定
{
  "code": 202,
  "error": "Java层报错信息"
}

安装成功示例：

企业微信截图_17700059858336.png

注意事项：

  • 支持安卓 10、12（从 v22.9.2 开始）、14
  • ZIP 文件必须包含有效的 APK 文件
  • 安装过程可能需要几分钟，请耐心等待
  • 如果某个 APK 安装失败，其他 APK 仍会继续安装
Last updated on