Web 应用一键打包 Android APK 方案实践

3. Java 客户端调用示例

为了便于集成，我们提供了 Java SDK 风格的调用类。它通过 HTTP API 与打包服务器通信，支持直接返回 Base64 编码的 APK 内容，避免了文件路径跨平台兼容性问题。

package com.ghdi.api.service;

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.file.*;
import java.util.Base64;

/**
 * Web to App 打包服务（HTTP API 模式）
 * 通过 HTTP 接口与 Docker 服务器通信，无需 SSH 配置
 */
public class WebToAppService {

    // Linux 服务器 HTTP API 配置
    private String apiBaseUrl = System.getenv("LINUX_SERVER_URL") != null 
        ? System.getenv("LINUX_SERVER_URL") 
        : "http://your-server:8080";  // 默认值，请修改为实际服务器地址

    /**
     * 构建 APK 并返回 base64 编码（不保存到本地文件）
     *
     * @param webUrl Web 地址（必需）
     * @param iconPath 图标文件路径（必需，支持 png/jpg，Windows 路径）
     * @param appName 应用名称（必需）
     * @return base64 编码的 APK 文件内容，失败抛出异常
     */
    public String buildApkAsBase64(String webUrl, String iconPath, String appName) {
        return buildApkAsBase64(webUrl, iconPath, appName, null);
    }

    /**
     * 构建 APK 并返回 base64 编码（不保存到本地文件）
     *
     * @param webUrl Web 地址（必需）
     * @param iconPath 图标文件路径（必需，支持 png/jpg，Windows 路径）
     * @param appName 应用名称（必需）
     * @param appId 应用包名（可选，默认"com.webapp.app"）
     * @return base64 编码的 APK 文件内容，失败抛出异常
     */
    public String buildApkAsBase64(String webUrl, String iconPath, String appName, String appId) {
        // 参数验证
        if (webUrl == null || webUrl.trim().isEmpty()) {
            throw new IllegalArgumentException("Web 地址不能为空");
        }
        if (iconPath == null || iconPath.trim().isEmpty()) {
            throw new IllegalArgumentException("图标文件路径不能为空");
        }
        if (appName == null || appName.trim().isEmpty()) {
            throw new IllegalArgumentException("应用名称不能为空");
        }

        // 设置默认值
        if (appId == null || appId.trim().isEmpty()) {
            appId = "com.webapp.app";
        }

        System.out.println("==========================================");
        System.out.println("[WebToApp] 开始打包请求（返回 base64）");
        System.out.println("==========================================");
        System.out.println("API 地址：" + apiBaseUrl);
        System.out.println("Web 地址：" + webUrl);
        System.out.println("图标路径：" + iconPath);
        System.out.println("应用名称：" + appName);
        System.out.println("应用 ID: " + appId);
        System.out.println("");

        try {
            // 步骤 1：读取图标并编码为 base64
            System.out.println("[WebToApp] [1/3] 读取图标文件...");
            String iconBase64 = readIconAsBase64(iconPath);
            System.out.println("[WebToApp]       ✓ 图标已读取并编码为 base64 (" + (iconBase64.length() / 1024) + " KB)");
            System.out.println("");

            // 步骤 2：发送 HTTP 请求
            System.out.println("[WebToApp] [2/3] 发送打包请求到服务器...");
            BuildResponse response = sendBuildRequest(webUrl, iconBase64, appName, appId);
            System.out.println("[WebToApp]       ✓ 服务器响应：" + response.message);
            System.out.println("");

            if (!response.success) {
                throw new RuntimeException("打包失败：" + response.message);
            }

            // 步骤 3：下载 APK 到内存并转换为 base64
            System.out.println("[WebToApp] [3/3] 下载 APK 文件并转换为 base64...");
            System.out.println("[WebToApp]       APK 路径：" + response.apkPath);
            System.out.println("[WebToApp]       APK 大小：" + (response.apkSize / 1024 / 1024) + " MB");
            System.out.println("[WebToApp]       APK URL: " + response.apkUrl);

            // 验证 apkUrl 是否存在
            if (response.apkUrl == null || response.apkUrl.trim().isEmpty()) {
                throw new RuntimeException("APK 下载 URL 为空，无法下载 APK 文件");
            }

            try {
                // 下载 APK 到内存并转换为 base64
                String apkBase64 = downloadApkAsBase64(response.apkUrl);
                
                System.out.println("[WebToApp]       ✓ APK 已下载并转换为 base64");
                System.out.println("[WebToApp]       Base64 长度：" + (apkBase64.length() / 1024) + " KB");
                System.out.println("");

                return apkBase64;
            } catch (Exception e) {
                System.err.println("[WebToApp]       ✗ APK 下载失败：" + e.getMessage());
                e.printStackTrace();
                throw new RuntimeException("下载 APK 文件失败：" + e.getMessage(), e);
            }

        } catch (RuntimeException e) {
            throw e;
        } catch (Exception e) {
            throw new RuntimeException("调用打包服务时发生错误：" + e.getMessage(), e);
        }
    }

    // ... 其他辅助方法如 downloadApkAsBase64, sendBuildRequest 等略 ...

    /**
     * 从 URL 下载 APK 文件到内存并转换为 base64 编码
     */
    private String downloadApkAsBase64(String apkUrl) throws Exception {
        System.out.println("[WebToApp]       [下载] 开始下载 APK 到内存...");
        System.out.println("[WebToApp]       [下载] URL: " + apkUrl);

        // 构建完整 URL
        String fullUrl = apkUrl;
        if (!apkUrl.startsWith("http")) {
            fullUrl = apiBaseUrl + (apkUrl.startsWith("/") ? apkUrl : "/" + apkUrl);
            System.out.println("[WebToApp]       [下载] 完整 URL: " + fullUrl);
        }

        URL url = new URL(fullUrl);
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();

        try {
            connection.setRequestMethod("GET");
            connection.setConnectTimeout(30000);
            connection.setReadTimeout(300000);  // 5 分钟下载超时

            System.out.println("[WebToApp]       [下载] 连接服务器...");
            int responseCode = connection.getResponseCode();
            System.out.println("[WebToApp]       [下载] HTTP 响应代码：" + responseCode);

            if (responseCode != 200) {
                String errorMessage = "下载 APK 失败 (HTTP " + responseCode + ")";
                try (BufferedReader reader = new BufferedReader(
                        new InputStreamReader(connection.getErrorStream(), "utf-8"))) {
                    StringBuilder errorResponse = new StringBuilder();
                    String line;
                    while ((line = reader.readLine()) != null) {
                        errorResponse.append(line);
                    }
                    if (errorResponse.length() > 0) {
                        errorMessage += ": " + errorResponse.toString();
                    }
                }
                throw new RuntimeException(errorMessage);
            }

            // 下载文件到内存（使用 ByteArrayOutputStream）
            System.out.println("[WebToApp]       [下载] 开始下载文件内容到内存...");
            ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
            
            try (InputStream inputStream = connection.getInputStream()) {
                byte[] buffer = new byte[8192];
                int bytesRead;
                long totalBytes = 0;

                while ((bytesRead = inputStream.read(buffer)) != -1) {
                    outputStream.write(buffer, 0, bytesRead);
                    totalBytes += bytesRead;

                    // 每下载 1MB 显示一次进度
                    if (totalBytes % (1024 * 1024) == 0) {
                        System.out.println("[WebToApp]       [下载] 已下载：" + (totalBytes / 1024 / 1024) + " MB");
                    }
                }

                System.out.println("[WebToApp]       [下载] 下载完成，总大小：" + (totalBytes / 1024 / 1024) + " MB");
            }

            // 将字节数组转换为 base64 编码
            System.out.println("[WebToApp]       [转换] 开始转换为 base64 编码...");
            byte[] apkBytes = outputStream.toByteArray();
            String base64 = Base64.getEncoder().encodeToString(apkBytes);
            
            System.out.println("[WebToApp]       [转换] Base64 编码完成");
            System.out.println("[WebToApp]       [转换] 原始大小：" + (apkBytes.length / 1024 / 1024) + " MB");
            System.out.println("[WebToApp]       [转换] Base64 大小：" + (base64.length() / 1024) + " KB");

            return base64;

        } catch (Exception e) {
            System.err.println("[WebToApp]       [下载] 下载失败：" + e.getClass().getSimpleName() + " - " + e.getMessage());
            e.printStackTrace();
            throw e;
        } finally {
            connection.disconnect();
        }
    }

    // 内部响应类
    private static class BuildResponse {
        boolean success;
        String message;
        String apkPath;
        String apkUrl;
        long apkSize;
    }
}

落地收益

该方案已在内部多个项目中成功落地，稳定输出可安装的 Android 应用，有效支撑了公司移动端业务的快速拓展。

• 降低技术门槛：Web 团队无需学习 Android 开发即可产出可用的移动应用。
• 提升交付效率：从'小时级'手动配置缩短至'分钟级'自动化生成。
• 支持多租户定制：轻松为不同客户或业务线生成专属品牌 App。
• 便于集成 CI/CD：可无缝接入 Jenkins、GitLab CI 等流水线，实现持续交付。

未来还可进一步扩展支持 iOS（通过类似方案生成 .ipa）或 PWA 增强功能，构建更完整的跨端发布体系。