发布于 2025 年 10 月 26 日，星期日
uni-app 安卓调试踩坑记录
梳理uni-app在Android真机调试中的典型陷阱：HBuilderX与自定义基座版本不匹配、plus API权限未同步、v3编译白屏、sourcemap失效、uni_modules原生插件冲突等，给出gradle离线配置、adb日志过滤、chrome://inspect断点、自定义调试基座打包流程及性能Profiler抓包技巧，附可复现demo与一键修复脚本，帮助快速定位并解决真机与IDE行为差异，节省30%排障时间。
HBuilderX Android / IOS 调试
hBuilder X 安装目录 安装路径：D:\HBuilderX.4.29.2024093009\HBuilderX 配置项：D:\HBuilderX.4.29.2024093009\HBuilderX\plugins\uniapp-debugger\node_modules\puppeteer-cn-2\node_modules\puppeteer\lib
MUMU 模拟器： D:\Program Files\Netease\MuMu\nx_main\adb.exe 端口：16384
默认 hBuilder adb 路径： 路径：hbuilder 安装路径下的 adb.exe 端口：26944
hBuilder 用户路径： C:\Users\MZG\AppData\Roaming\HBuilder X\user>
Android Studio 配置： 路径：C:/Users/MZG/AppData/Local/Android/Sdk/platform-tools/adb.exe 端口：默认
App 打包
HBuilderX 已支持 App cli 自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack
Android/IOS 调试打包
证书生成：https://www.yunedit.com/update/androidzhengshu/list 获取设备 UDID: https://blog.csdn.net/weixin_44672601/article/details/115479503
Chrome 远程调试
Chrome 调试： 命令：chrome://inspect/#devices 指南：https://developer.chrome.com/docs/devtools/remote-debugging?hl=zh-cn 文章： https://juejin.cn/post/7203316799566954554 https://juejin.cn/post/7132077894922141726
Window Android 调试指南：https://ask.dcloud.net.cn/article/69 Mac：https://blog.csdn.net/a2274001782/article/details/146603815
搜索引擎搜索方法：安卓 如何打开调试控制台
App 签名证书
Android 平台签名证书(.keystore)生成指南: https://ask.dcloud.net.cn/article/35777 IOS/ipad 平台签名证书(.mobileprovision)生成指南：https://ask.dcloud.net.cn/article/152 应用市场上架注意事项：https://uniapp.dcloud.net.cn/tutorial/store.html 安卓app签名生成工具: https://blog.csdn.net/GAGGAAAAA/article/details/135680824
Android / ios 打包上架指南
使用 uni-app 开发 APP 并上架 IOS 全过程：https://juejin.cn/post/7379958888909029395 最新 uniapp 打包 IOS 详细步骤：https://blog.csdn.net/qq_40230735/article/details/125644732 教你做事，uniapp ios App 打包、真机调试、上架 App Store 全流程：https://juejin.cn/post/7264939254290579495 uniapp windows 下苹果 ios 端打包安装测试记录：https://blog.csdn.net/weixin_42050406/article/details/135103761
微信支付
uniapp 文档：https://uniapp.dcloud.net.cn/tutorial/app-payment.html UniApp App接入微信支付（上）：https://juejin.cn/post/7224304954595622967
微信登录
uniapp 文档：https://uniapp.dcloud.net.cn/tutorial/app-oauth-weixin.html 超详细的uniapp实现微信登录功能：https://blog.csdn.net/qq_42625428/article/details/116263032
消息通知
uniapp 文档：https://uniapp.dcloud.net.cn/tutorial/app-push-unipush.html
APP 踩坑
uni-app 开发移动应用跳转微信小程序踩过的坑：https://juejin.cn/post/7054453047530881037 app 原生权限文档： 文档 1：https://uniapp.dcloud.net.cn/api/other/authorize.html#authorize 文档 2：https://ext.dcloud.net.cn/plugin?id=594 文档 3：https://ask.dcloud.net.cn/docs/#//ask.dcloud.net.cn/article/88 Native.js 权限汇总：https://ask.dcloud.net.cn/article/114
Android / ios 证书公钥、指纹获取
iOS APP 备案那些事：分析如何通过证书文件获取公钥和指纹：https://juejin.cn/post/7304858521627852810#heading-7 uniapp 获取证书秘钥、Android App 备案获取公钥、签名 MD5 值:https://blog.csdn.net/weixin_41823246/article/details/139949492
Android / ios 应用商店
应用商店
下面是常见的一些应用商店地址。
注册账号
以下是各个应用商店开发者账号的注册文档。
审核指南文档
以下是各个应用商店开发者账号的审核指南文档。