CloudAPK 安装与配置指南

1. 项目基础介绍

CloudAPK 是一个开源项目，用于将 Progressive Web App (PWA) 打包成 Android 应用程序。它利用了 Android 的 Trusted Web Activity 技术来实现这一功能。通过该项目，开发者可以生成一个包含 .apk（用于测试）和 .aab（用于提交到 Google Play 商店）文件的 zip 压缩包。

主要编程语言：TypeScript 和 JavaScript。

2. 项目使用的关键技术和框架

• Google Bubblewrap: 用于生成和签署 Android 应用包的工具。
• Docker: 容器化技术，用于创建一致的运行环境。
• Azure CLI: 用于与 Azure 服务交互的命令行工具。
• Node.js: 服务器端 JavaScript 运行环境，用于执行后端逻辑。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保你的系统安装了 Docker。
• 安装 Azure CLI。
• 准备好你的 Progressive Web App 的 manifest.json 文件和相应的图标资源。

安装步骤

1. 克隆仓库

   打开命令行工具，执行以下命令克隆仓库到本地：

   git clone https://github.com/pwa-builder/CloudAPK.git
   

2. 登录 Azure 容器注册中心

   在命令行中运行以下命令以登录到 Azure 容器注册中心：

   az acr login -n pwabuilder
   

3. 构建 Docker 镜像

   在项目目录中，编辑 Dockerfile 文件，将第 13 行更改为 NODE_ENV=test（如果需要的话）。

   然后执行以下命令构建 Docker 镜像：

   npm run docker:build
   

   注意：首次构建可能需要一些时间。

4. 运行 Docker 容器

   构建完成后，运行以下命令启动 Docker 容器：

   npm run docker:run
   

5. 访问测试界面

   在浏览器中访问 localhost，你将看到 CloudAPK 的测试界面。

6. 手动生成应用包

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

   {
     "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 文件。

以上步骤将帮助你成功安装和配置 CloudAPK 项目，从而开始生成你的 Android 应用程序包。