HarmonyOS NEXT鸿蒙开发:修改bundleName应用包名(上架应用商店时的唯一包路径)(app.json5配置文件) 作者:马育民 • 2026-04-04 16:23 • 阅读:10000 需要掌握:[HarmonyOS NEXT鸿蒙开发:bundleName应用包名(上架应用商店时的唯一包路径)(app.json5配置文件)](https://www.malaoshi.top/show_1GWNXoRyHQ.html "HarmonyOS NEXT鸿蒙开发:bundleName应用包名(上架应用商店时的唯一包路径)(app.json5配置文件)") # 介绍 上架用的**唯一包路径(Bundle Name)**,在鸿蒙 NEXT(Stage 模型)里就是 **AppScope/app.json5 里的 bundleName**。 # 修改 修改 AppScope/app.json5 ```json { "app": { // 旧:com.example.xxx // 新:你自己的唯一包名(反域名格式) "bundleName": "com.jilin.agrimonitor", // ← 改这里 "vendor": "jilin", "versionCode": 1000000, "versionName": "1.0.0", // ... } } ``` **命名规则(上架必须遵守)**:[HarmonyOS NEXT鸿蒙开发:bundleName应用包名(上架应用商店时的唯一包路径)(app.json5配置文件)](https://www.malaoshi.top/show_1GWNXoRyHQ.html "HarmonyOS NEXT鸿蒙开发:bundleName应用包名(上架应用商店时的唯一包路径)(app.json5配置文件)") # 删除文件夹才能预览 删除 `entry\.preview` 文件夹才能预览,否则预览报错 # 删除文件夹才能模拟器启动 删除根目录下的 `.hvigor` 文件夹,在模拟器上运行才能成功,否则报错: ``` 17:12:33.953: Launching com.jl.envapplication 17:12:33.954: $ hdc shell aa force-stop com.jl.envapplication 17:12:34.457: $ hdc shell mkdir data/local/tmp/10a32ef77044407b9bfc9a9c8d851bea 17:12:34.656: $ hdc file send D:\HarmonyOS_std\EnvApplication-JiChangXiaoFang\entry\build\default\outputs\default\entry-default-unsigned.hap "data/local/tmp/10a32ef77044407b9bfc9a9c8d851bea" in 199 ms 17:12:36.362: $ hdc shell bm install -p data/local/tmp/10a32ef77044407b9bfc9a9c8d851bea in 1 s 705 ms 17:12:36.434: $ hdc shell rm -rf data/local/tmp/10a32ef77044407b9bfc9a9c8d851bea 17:12:37.405: $ hdc shell aa start -a EntryAbility -b com.jl.envapplication -m entry -D in 674 ms 17:12:37.407: Launch com.jl.envapplication failed, starting handle failure progress ``` 原文出处:http://www.malaoshi.top/show_1GW34RmcTfRI.html