这是一个使用 CLI 方式开发的 uni-app 项目,支持 App 和微信小程序平台,完全不需要 HBuilderX。
npm run dev:mp-weixin
运行后,在微信开发者工具中导入项目,选择 dist/dev/mp-weixin 目录。
npm run dev:app
dist/dev/app 目录File → Open → 选择 dist/dev/app 目录npm run dev:app
# 进入生成的目录
cd dist/dev/app
# 使用 adb 安装(需要先打包成 APK,或使用 Android Studio)
注意:npm run dev:app 命令会显示 "打开 HBuilderX" 的提示,这是 uni-app CLI 的默认提示,可以忽略。实际上你不需要 HBuilderX,直接使用 Android Studio 或真机调试即可。
npm run build:mp-weixin
打包完成后,在 dist/build/mp-weixin 目录生成小程序代码,可直接上传到微信公众平台。
npm run build:app
打包完成后,在 dist/build/app-plus 目录生成 App 资源包(注意:这不是 APK,只是资源包)。
⚠️ 重要提示:
npm run build:app只生成资源包,不会直接生成 APK。
详细步骤请查看 BUILD_APK.md
方式一:使用命令行工具自动打包(推荐)
安装打包工具:
npm install -g @xzcoder/pack-cli
配置打包参数:
# 复制示例配置文件
cp pack-config.json.example pack-config.json
# 编辑 pack-config.json,填写你的 Android SDK 路径和签名信息
执行打包:
npm run build:app:apk
# 或者直接使用
pack-cli --config pack-config.json
打包完成后,APK 文件会在 dist/release/apk 目录。
方式二:使用 Android Studio 打包
npm run build:app 生成资源包File → Open → 选择 dist/build/app-plus 目录Build → Build Bundle(s) / APK(s) → Build APK(s)app/build/outputs/apk/release/ 目录方式三:使用 uni-app 云打包服务
dist/build/app-plus 目录方式四:使用 uni-app 官方云打包 API(高级)
如果你有 DCloud 开发者账号,可以使用 API 进行自动化打包,详情参考:https://dev.dcloud.net.cn/docs/api/
src/ - 源代码目录src/pages/ - 页面文件src/manifest.json - 应用配置src/pages.json - 页面路由配置dist/ - 构建输出目录
dist/dev/app - App 开发资源(用于 Android Studio)dist/build/app-plus - App 打包资源(用于最终打包)⚠️ 关于 HBuilderX 提示:运行 npm run dev:app 时可能会看到 "打开 HBuilderX" 的提示,这是 uni-app CLI 的默认消息,可以完全忽略。你不需要安装或使用 HBuilderX,直接使用 Android Studio 或其他原生开发工具即可。