2025,感觉这个东西迟到了很多年.
光速体验版:
1. 打开网址:github.com/mx369/vant,点击fork
2. 点他
3. 可能需要点击一下这个(如果没有,忽略)
4. 点击tab回到code界面
5. 创建一个新文件
6. 随便写点内容&文件名,点击提交,后面还有个二次确认的弹窗点击确认就行了
7. 等待执行完成
8. 点击下载你的apk(注意把你的项目改成私有,避免被别人看见,测试项目无所谓)
自有项目使用教程:
- 在你的项目添加当前项目为子项目
git submodule add https://github.com/mx369/WebApkShell.git
2. 添加流水线(windows系统手动复制)
cp ./WebApkShell/workflows/android.yml .github/workflows/android.yml
3. 在你的package.json里面添加apk配置
"webApkShell": {
"build_script": "pnpm run build:site",//项目打包命令
"dist_path": "./packages/vant/site-dist",//打包后文件所在目录
"AP_ID": "com.t.vant",//安卓应用包名
"AP_ICON": "./public/logo.xml",//安卓应用icon,要矢量xml,不支持嵌套外挂资源,可以不写,有默认值;
"AP_NAME": "VANT",//app的名称
"AP_VERSION_NAME": ""
},
4. 修改公共基础路径为./
- 如vite.config.js 里面的
base:'./'
- 其他可能需要修改的
a) package.json如果配置有"packageManager": "pnpm@10.18.3",需要删除,或者改流水线配置
b) 修改流水线的触发分支配置,默认为main
c) 安卓应用图标生成攻略:
-
svg转xml svg2vector.com/
-
svg素材网址 www.iconfont.cn/collections…
d) 状态栏高度
// 获取状态栏高度
const statusBarHeight = window.shell?.getStatusBarHeight() || '0px';
// 可以通过css变量
document.body.style.setProperty('--bar-height', statusBarHeight);
上面的操作执行完成,提交代码到GitHub,就会自动打包项目为APK
🥳🥳 在光速模式最后一步所示位置,点击下载apk