第一步:安装打包工具
在您的 app 目录下(确保在终端执行过 cd app ),运行以下命令来安装打包 App 所需的插件:
# 安装 Capacitor 核心库
npm install @capacitor/core
@capacitor/cli @capacitor/android
第二步:初始化 App 配置
执行初始化命令,为您的 App 起个名字:
# 初始化配置
npx cap init
- App name : 输入 点餐系统
- Package ID : 输入 com.yourname.ordering (类似这种格式)
- Web asset directory : 输入 dist ( 非常关键,必须是 dist )
第三步:创建安卓工程
将您的网页代码"装进"安卓壳子里:
# 1. 先确保项目是打包好的
npm run build
# 2. 添加安卓平台支持
npx cap add android
# 3. 将网页内容同步到安卓工程
npx cap copy
第四步:生成 APK(安装包)
这一步需要用到 Android Studio (如果您电脑没装,建议先去官网下载安装)。
- 打开项目 :运行命令 npx cap open android ,它会自动启动 Android Studio 并加载您的项目。
A problem occurred evaluating project ':app'.
Failed to apply plugin 'com.android.internal.application'.
Your project path contains non-ASCII characters. This will most likely cause the build to fail on Windows. Please move your project to a different directory. See
解决方法:修改配置文件跳过检查
-
在您的 Android Studio 左侧文件栏中,找到以下文件: android/gradle.properties (注意:是在 android 目录下的那个,不是 app 目录下的)。
-
打开该文件,在文件的最后一行添加以下代码:
android.overridePathCheck=true -
添加完成后,点击 Android Studio 右上角出现的 "Sync Now" 。
-
等待同步 :第一次打开会比较慢,等右下角的进度条(Gradle Sync)走完。
-
生成安装包 :
- 在顶部菜单栏点击 Build -> Build Bundle(s) / APK(s) -> Build APK(s) 。
- 等待几分钟,右下角会弹出提示 APK(s) generated successfully 。
- 点击提示里的 locate 链接,就能找到生成的 app-debug.apk 文件了。
第五步:安装到手机
- 将生成的 app-debug.apk 文件通过 QQ/微信 发送到您的安卓手机。
- 在手机上点击安装(可能会提示"来源未知",选择允许安装即可)。
💡 进阶优化建议(让它更像 App)
为了让 App 体验更好,您可以微调一下代码:
-
适配状态栏 :
在 app/index.html 的 标签中加入:<meta name="viewport" content="width=device-width, initial-scale=1, viewport- fit=cover"> -
设置图标 :
如果您有自己的 Logo 图标,可以使用 cordova-res 工具一键生成所有尺寸的 App 图标,避免使用默认的安卓机器人图标。