鸿蒙Next项目如何修改包名

在鸿蒙Next项目中，如何修改应用的包名？我尝试修改了config.json文件中的bundleName字段，但编译时提示错误。请问正确的修改步骤是什么？是否需要同步修改其他配置文件或代码中的引用？

2 回复

鸿蒙Next改包名？简单！在AppScope的app.json5里找到bundleName字段，改成你的新包名，比如com.yourcompany.awesomeapp。记得同步改目录结构哦，不然IDE会一脸懵。搞定后记得清理缓存，不然打包时可能会遇到“包名已存在”的尴尬~

更多关于鸿蒙Next项目如何修改包名的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next项目中修改包名，可以通过以下步骤进行操作：

1. 修改 build-profile.json5

在项目根目录下的 build-profile.json5 文件中，找到 app 配置项，修改 bundleName 字段为新的包名。

{
  "app": {
    "signingConfigs": [],
    "products": [],
    "bundleName": "com.example.newapp", // 修改为新的包名
    "vendor": "example",
    "versionCode": 1,
    "versionName": "1.0.0",
    "minAPIVersion": 9,
    "targetAPIVersion": 9,
    "apiReleaseType": "Release"
  }
}

2. 修改 module.json5

在模块目录（如 entry/src/main）下的 module.json5 文件中，修改 module 配置中的 package 字段为新的包名。

{
  "module": {
    "name": "entry",
    "type": "entry",
    "package": "com.example.newapp", // 修改为新的包名
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": ["phone", "tablet"],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": ["entity.system.home"],
            "actions": ["action.system.home"]
          }
        ]
      }
    ]
  }
}

3. 更新代码中的包名引用

如果代码中硬编码了包名（例如在 Intent 或数据存储中），需要手动更新这些引用。例如：

// 修改前
let intent = {
  bundleName: "com.example.oldapp",
  abilityName: "EntryAbility"
};
// 修改后
let intent = {
  bundleName: "com.example.newapp",
  abilityName: "EntryAbility"
};

4. 清理并重新构建

修改完成后，清理项目并重新构建：

  • 删除 build 目录。
  • 在终端中运行 ohpm install 或通过 DevEco Studio 的 Build > Clean Project 和 Build > Build Project 重新编译。

注意事项：

  • 包名需符合命名规范（如使用反向域名格式）。
  • 如果使用华为应用市场，需确保新包名未被占用。
  • 修改包名后，可能需要重新生成签名文件。

完成以上步骤后，包名即成功修改。

回到顶部