HarmonyOS 开发实战：快速更改应用名字与图标的终极指南

摘要

在做鸿蒙（HarmonyOS）应用开发时，很多人都会遇到一个小需求------给应用换个更酷的名字，或者换一个更符合品牌调性的图标。虽然看起来只是"换个皮"，但这是应用上线前非常关键的一步，因为用户打开手机首先看到的就是图标和名字。本文会从零开始，讲清楚在鸿蒙项目里如何快速修改应用名字和图标，并结合几个实际场景，给你可直接运行的 Demo 代码。

引言

随着鸿蒙生态越来越成熟，应用的外观和体验不仅仅是 UI 设计的事，图标和名字这种"第一印象"元素，也会直接影响用户的点击欲望和对应用的好感度。

举个例子：

你开发了一个天气应用，想在不同节日换不同的名字和图标，比如春节叫"春节天气"，用个红色喜庆图标。
你的应用经历了一次品牌升级，名字、LOGO 全面换新，需要快速更新到应用包里。
在多版本共存的情况下，你可能需要给测试版和正式版不同的标识。

这些需求，其实都能通过简单修改项目配置文件来完成。

基础操作：修改应用名字和图标

修改名字

在鸿蒙应用工程的 config.json 文件里，有一个 appName 属性，这个就是应用显示在桌面上的名字。

jsonc 复制代码

{
  "app": {
    "bundleName": "com.example.myapp",
    "vendor": "zs",
    "version": {
      "code": 1,
      "name": "1.0.0"
    },
    "appName": "MyApp", // 这里就是应用名字
    "icon": "$media:app_icon"
  }
}

你只需要把 appName 改成想要的名字，比如 "春节天气"，编译打包后，桌面上的名字就会更新。

修改图标

图标在鸿蒙里一般存放在 resources/base/media 目录下，config.json 里的 icon 属性会引用到它。

比如：

json 复制代码

"icon": "$media:app_icon"

这里的 app_icon 就是资源文件名（不带后缀），对应的文件路径可能是：

bash 复制代码

resources/base/media/app_icon.png

如果你要换图标，只需要：

准备好新的 .png 文件（建议正方形，192x192 或更高分辨率）。
替换掉 resources/base/media 里的原图文件（保持文件名一致，或者改名后同步修改 config.json 的引用）。
重新编译打包。

Demo：快速修改名字和图标

假设你现在有一个默认应用，名字是 MyApp，图标是默认的蓝色圆形。

我们要改成：

名字：节日天气
图标：festival_icon.png

config.json 修改：

jsonc 复制代码

{
  "app": {
    "bundleName": "com.example.weather",
    "vendor": "zs",
    "version": {
      "code": 2,
      "name": "2.0.0"
    },
    "appName": "节日天气",
    "icon": "$media:festival_icon"
  }
}

资源目录结构：

csharp 复制代码

resources/
  base/
    media/
      festival_icon.png

改好后重新编译运行，桌面就会显示新的名字和图标。

实际应用场景

场景一：品牌升级

情况：公司决定更换品牌 LOGO 和应用名称。做法：

修改 appName 为新品牌名
替换 icon 为新品牌 LOGO 示例代码：

jsonc 复制代码

"appName": "新品牌助手",
"icon": "$media:new_brand_icon"

场景二：节日主题活动

情况：在春节、国庆等节日推出限时版本，让用户有参与感。做法：

准备节日主题图标（例如红色、灯笼元素）
将 appName 增加节日元素 示例代码：

jsonc 复制代码

"appName": "春节天气",
"icon": "$media:chinese_new_year_icon"

场景三：测试版与正式版区分

情况：为了方便测试团队区分版本，可以给测试包加上特殊标识。做法：

名字后加 [Test]
图标换成灰色或带 TEST 标识的版本 示例代码：

jsonc 复制代码

"appName": "MyApp [Test]",
"icon": "$media:test_version_icon"

QA 环节

Q1：我改了 config.json 但桌面名字没变，为什么？ A：可能是因为手机桌面对应用有缓存，可以尝试卸载旧应用再安装新包，或者清除桌面缓存。

Q2：不同分辨率的图标怎么处理？ A：鸿蒙支持多分辨率资源，你可以在不同的 resources/base/media 子目录放不同尺寸的图片，比如 media-mdpi、media-hdpi，系统会自动适配。

Q3：我能动态更改名字和图标吗？ A：目前鸿蒙官方不支持应用在运行时动态更改桌面图标和名字，需要打包新版本才能生效。

总结

更改鸿蒙应用的名字和图标，其实就是两步：

改 config.json 的 appName 和 icon 属性替换资源目录下的图标文件

虽然看起来简单，但背后涉及用户体验、品牌形象、版本区分等多个方面。在实际开发中，如果你能灵活运用这个技巧，就可以让你的应用在不同场景下更有个性化，让用户一眼就能认出来。