不用安装任何软件！快速获得 APK¶

⚡ 最快方案：PWA（推荐）¶

不需要打包！直接添加到手机桌面，就像原生 App 一样！

操作步骤¶

部署 Web 版到网上（用下面的一键部署）
用手机打开网址
点击浏览器菜单 → 添加到桌面
完成！跟原生 App 一样！

优点：
✅ 完全不需要打包
✅ 更新即时生效
✅ 安装包大小为 0
✅ 可以离线使用（已访问过的页面）

📱 PWA 添加到桌面教程¶

iPhone (Safari)¶

用 Safari 打开网址
点击底部的「分享」按钮 📤
向下滚动，点击「添加到主屏幕」➕
点击「添加」完成

Android (Chrome)¶

用 Chrome 打开网址
点击右上角菜单 ⋮
点击「安装应用」或「添加到主屏幕」📲
确认安装

华为/小米等国产手机¶

用系统浏览器打开网址
下滑会出现「是否添加到桌面」提示
点击添加即可

🎯 一键部署到 Vercel（获取网址）¶

在你电脑上打开终端，运行：

# 1. 进入项目目录
cd NiuMaBaiShen-web

# 2. 安装 Vercel
npm install -g vercel

# 3. 登录（浏览器会弹出，用 GitHub 或邮箱注册）
vercel login

# 4. 部署
npx vercel --prod

部署成功后，你会得到一个网址如：

https://niumabaishen-xxx.vercel.app

用手机打开这个网址，然后按照上面的步骤「添加到桌面」即可！

🔧 一键构建完整 APK（需要安装软件）¶

如果你坚持要一个真正的 APK 文件：

Windows 用户¶

# 1. 下载并安装 Android Studio
# https://developer.android.com/studio

# 2. 打开终端，输入：
cd NiuMaBaiShen-web\android
gradlew.bat assembleDebug

# 3. APK 在：
# NiuMaBaiShen-web\android\app\build\outputs\apk\debug\app-debug.apk

Mac 用户¶

# 1. 下载并安装 Android Studio
# https://developer.android.com/studio

# 2. 打开终端，输入：
cd NiuMaBaiShen-web/android
chmod +x gradlew
./gradlew assembleDebug

# 3. APK 在：
# NiuMaBaiShen-web/android/app/build/outputs/apk/debug/app-debug.apk

Linux 用户¶

# 1. 安装 Java 和 Android SDK
sudo apt install openjdk-17-jdk
# 下载 Android SDK Command Line Tools

# 2. 构建
cd NiuMaBaiShen-web/android
./gradlew assembleDebug

📊 方案对比¶

方案	难度	时间	APK大小	推荐度
PWA	⭐	10分钟	0MB	⭐⭐⭐⭐⭐
本地打包	⭐⭐⭐⭐	1小时	~20MB	⭐⭐⭐
HBuilderX云打包	⭐⭐	10分钟	~20MB	⭐⭐⭐⭐

🎯 我的建议¶

第一步：用 PWA 方式先上线测试
    ↓
第二步：验证功能是否正常
    ↓
第三步：如果 PWA 体验好，就不用打包 APK 了
    ↓
第四步：需要原生 App 时，再打包也不迟

PWA 方案的好处： - 零开发成本 - 零维护成本 - 更新即时生效 - 用户不需要更新 App

很多知名 App 都在用 PWA，比如：Twitter、Spotify、Instagram！

❓ 常见问题¶

Q: PWA 和原生 App 有区别吗？ A: 功能上几乎没有区别，可以实现 95% 的功能。

Q: PWA 能上架应用商店吗？ A: 部分商店支持（如 Google Play），但国内商店一般需要原生 APK。

Q: 怎么让别人也能用？ A: 分享网址给他们，或者生成二维码。

准备好了吗？先试试 PWA 方案吧！