云端构建 Android APK 包——CloudAPK 开源项目教程

1. 项目介绍

CloudAPK 是 PWABuilder 的 Android 平台，它能够使用 Android 的 Trusted Web Activity 技术从渐进式 Web 应用生成 Android 应用包。该项目利用 Google 的 Bubblewrap 工具生成并签名 Android 应用包，生成的 zip 文件包含一个用于测试的 .apk 文件和一个用于提交到 Google Play 商店的 .aab 文件。

2. 项目快速启动

要本地运行 CloudAPK 服务，您需要 Docker 和 Azure CLI。以下是启动服务的步骤：

# 登录到 Azure 容器注册表
az acr login -n pwabuilder

# 如果在本地测试，修改 Dockerfile 文件第 13 行，将环境变量设置为测试模式
# NODE_ENV=test

# 构建 Docker 镜像
npm run docker:build

# 构建完成后，运行 Docker 容器
npm run docker:run

构建完成后，访问 localhost 查看 CloudAPK 测试界面。

如果您不希望使用测试界面，也可以通过发送 POST 请求到 /generateAppPackage 手动生成应用包。请求的 JSON 主体应包含以下内容：

{
  "additionalTrustedOrigins": [],
  "appVersion": "1.0.0.0",
  "appVersionCode": 1,
  "backgroundColor": "#3f51b5",
  "display": "standalone",
  "enableNotifications": false,
  "enableSiteSettingsShortcut": true,
  "fallbackType": "customtabs",
  "features": {
    "locationDelegation": { "enabled": true },
    "playBilling": { "enabled": false }
  },
  "host": "https://sadchonks.com",
  "iconUrl": "https://sadchonks.com/kitteh-512.png",
  "includeSourceCode": false,
  "isChromeOSOnly": false,
  "launcherName": "Chonks",
  "maskableIconUrl": null,
  "monochromeIconUrl": null,
  "name": "Sad Chonks",
  "navigationColor": "#3f51b5",
  "navigationColorDark": "#3f51b5",
  "navigationDividerColor": "#3f51b5",
  "navigationDividerColorDark": "#3f51b5",
  "orientation": "default",
  "packageId": "com.sadchonks",
  "serviceAccountJsonFile": null,
  "shareTarget": {
    "action": "/share-target/",
    "method": "GET",
    "params": {
      "title": "title",
      "text": "text",
      "url": "url"
    }
  },
  "shortcuts": [{
    "name": "New Chonks",
    "short_name": "New",
    "url": "/?shortcut",
    "icons": [{
      "sizes": "128x128",
      "src": "/favicon.png"
    }]
  }],
  "signing": null,
  "signingMode": "none",
  "splashScreenFadeOutDuration": 300,
  "startUrl": "/saved",
  "themeColor": "#3f51b5",
  "themeColorDark": "#0d1117",
  "webManifestUrl": "https://sadchonks.com/manifest.json"
}

响应将是一个包含生成的应用的 zip 文件。

3. 应用案例和最佳实践

在开发渐进式 Web 应用时，最佳实践是确保应用可以在不同的设备和浏览器上运行良好。以下是一些案例和最佳实践：

• 确保您的 Web 应用支持最新的 Web 标准。
• 优化应用性能，确保快速加载和流畅的用户体验。
• 设计响应式界面，适配各种屏幕尺寸和分辨率。
• 使用 Web Manifest 文件定义应用的元数据和启动行为。

4. 典型生态项目

在 CloudAPK 的生态中，有多个相关的开源项目可以帮助开发者构建和优化渐进式 Web 应用，例如：

• PWA Builder：一个帮助开发者构建渐进式 Web 应用的工具。
• Bubblewrap：Google 提供的一个工具，用于将 Web 应用打包成 Android 应用。

以上就是 CloudAPK 开源项目的教程，希望对您的开发工作有所帮助。