UniApp修改应用名称时，需要在哪些配置文件中调整？

Question

在UniApp项目中修改应用名称时，需要调整多个配置文件以确保名称更改生效。首先，`manifest.json`是核心配置文件，需在“应用名称”字段中修改。其次，针对不同平台有特定设置：微信小程序需修改`project.config.json`中的`appName`；Android平台要调整`AndroidManifest.xml`里的``标签`android:label`属性，同时在`build.gradle`中确认`resValues`设置正确；iOS则需更新`Info.plist`文件中的`CFBundleName`和`CFBundleDisplayName`。此外，若项目中有自定义组件或代码引用了旧名称，也需同步修改，避免运行时出现不一致问题。最后，建议修改后重新构建项目并测试各平台效果，确保名称更改完整无误。

Answer 1

1. 修改应用名称的基本步骤

在UniApp项目中修改应用名称时，首先需要调整核心配置文件`manifest.json`。这个文件定义了应用的基础信息，包括名称、图标和启动页面等。

• 打开`manifest.json`文件。
• 找到“应用名称”字段（通常是`name`或`appName`）。
• 将旧名称替换为新名称。

例如：

{
  "name": "新应用名称",
  "description": "这是一个示例应用"
}
    

2. 针对不同平台的特定设置

不同平台有不同的配置文件和规则，必须逐一调整以确保名称更改生效。

平台	文件	字段
微信小程序	`project.config.json`	`appName`
Android	`AndroidManifest.xml`	``标签中的`android:label`属性
Android	`build.gradle`	`resValues`中的`string`值
iOS	`Info.plist`	`CFBundleName`和`CFBundleDisplayName`

例如，在`build.gradle`中：

android {
    defaultConfig {
        resValue "string", "app_name", "新应用名称"
    }
}
    

3. 检查代码和组件中的引用

除了配置文件外，还需检查项目中的代码和自定义组件是否直接引用了旧的应用名称。

1. 全局搜索旧名称，定位所有可能的引用点。
2. 更新代码中的字符串常量或变量。
3. 测试运行，确保没有因名称不一致导致的功能问题。

例如，如果代码中有以下内容：

console.log('旧应用名称');
    

应将其更改为：

console.log('新应用名称');
    

4. 重新构建和测试

完成所有配置文件和代码的修改后，建议执行以下步骤：

使用Mermaid流程图表示构建和测试过程：

graph TD;
            A[修改配置文件] --> B[检查代码引用];
            B --> C[重新构建项目];
            C --> D[测试各平台效果];

具体操作包括：

• 清理旧的构建缓存。
• 针对每个目标平台分别构建。
• 在模拟器或真实设备上运行，验证名称显示正确。

例如，运行以下命令构建Android版本：

npm run build --platform=android