Demo2APK

Demo2APK可以将你的 Vibe Coding 创意，一键转为可安装的 Android App

无论你是在 Gemini、ChatGPT、DeepSeek 等 AI 平台生成了一个炫酷 Demo，还是开发了一个 React/Vite 前端项目，Demo2APK 都能帮你无需 Android 开发环境，直接生成可安装的 .apk 文件。

⚠️ 安全提醒：不要随意安装来源不明的 APK。Demo2APK 生成的 APK 仅包含你上传的代码，建议仅用于可信项目。

核心特性

极简使用体验

• 上传即构建：支持 HTML、React、ZIP 项目，自动识别类型并选择最佳打包策略
• 三种输入方式：
  • 单文件上传（.html, .jsx, .tsx 等）
  • 代码粘贴：直接粘贴 HTML 或 React 组件代码
  • ZIP 压缩包：自动区分标准 HTML 项目 与 React/Vite 项目（自动执行 npm build）

个性化定制

• 自定义应用名称、版本号、启动图标
• 支持深色工程蓝图风格 UI，沉浸式构建体验

智能构建引擎

• 自动离线化处理：内联 CDN 资源、预编译 JSX，确保 App 在无网络环境下正常运行
• React 白屏防护：强制设置 base: './'，并建议启用 @vitejs/plugin-legacy 兼容旧版 WebView

可靠的工程化支持

• 智能排队系统：多用户并发时自动排队，实时显示队列位置
• 构建历史记录：刷新页面后自动恢复最近任务状态
• 自动清理：APK 与临时文件 2 小时后自动删除，保护隐私、节省资源

便捷分享

• 构建成功后生成临时下载链接，可直接分享给他人测试

免费公益站点（开箱即用）

开发者提供了一个免费在线服务，无需注册，立即使用：

👉 https://demo2apk.lasuo.ai

• 限流策略：每个 IP 每小时最多 5 次构建
• 功能完整：与自部署版本完全一致
• 适合快速验证，但不适用于生产级高频使用

🖥️ 自部署指南

方式一：Docker 部署（推荐，Linux 服务器）

# 1. 创建目录
mkdir -p ~/demo2apk && cd ~/demo2apk

# 2. 下载配置
curl -O https://raw.githubusercontent.com/DeadWaveWave/demo2apk/main/docker-compose.deploy.yml

# 3. 启动服务
docker compose -f docker-compose.deploy.yml up -d

访问 http://your-server-ip:5173 即可使用。

✅ 仅支持 linux/amd64 架构。macOS 用户请使用本地开发模式。

方式二：本地开发（macOS / Linux）

# 安装依赖
pnpm install

# 启动 Redis（构建队列依赖）
docker run -d -p 6379:6379 redis:alpine

# 构建并启动服务
pnpm build
pnpm dev        # API 服务（3000）
pnpm worker     # 构建 Worker
pnpm frontend   # Web 界面（5173）

API 集成（适合自动化脚本）

HTML 单文件打包

curl -X POST http://localhost:3000/api/build/html \
  -F "file=@demo.html" \
  -F "appName=MyDemo"

React 项目打包（ZIP）

zip -r my-app.zip my-react-app/
curl -X POST http://localhost:3000/api/build/zip \
  -F "file=@my-app.zip" \
  -F "appName=MyReactApp"

代码粘贴构建

curl -X POST http://localhost:3000/api/build/code \
  -F "code=<h1>Hello from Demo2APK</h1>" \
  -F "appName=CodeDemo"

完整 API 文档见项目仓库。

配置说明（.env）

⚠️ React 项目特别提示（避免白屏）

如果你的 React/Vite 项目在 APK 中显示白屏，请在 vite.config.js 中添加：

import legacy from '@vitejs/plugin-legacy'

export default defineConfig({
  plugins: [
    react(),
    legacy({ targets: ['chrome >= 52', 'android >= 5'] })
  ],
  base: './'  // ⚠️ APK 必需！
})

并安装依赖：

npm install -D @vitejs/plugin-legacy terser