Xcode14 设置Display Name不生效问题

news2024/9/21 4:37:13

一、前言

早在Xcode13苹果就对Info.plist做了一次大改革，新建的OC项目默认Info.plist文件是“空的”，Swift项目甚至干脆连Info.plist文件都没有了，苹果这样做是为了建立一个新的Info.plist管理方式，把Info.plist物理文件中的配置挪到Xcode buildSetting中。

然而大部分开发者（比如我）并不买账，仍然使用旧的Info.plist文件模式，如何恢复到旧的Info.plist文件模式，新模式有什么弊端，更多内容见我之前的文章《Xcode13 “消失”的Info.plist文件》。

二、Xcode14 新变化

Xcode14 苹果又偷摸地改一刀。

如果你仍然使用旧的Info.plist文件模式，你会发现在Xcode面板（General - Display Name）设置App名字不会生效。如下图，我们把Display Name设置为“娃哈哈”，你会发现App的名字仍然叫“TestTMP”。

Xcode14之前，Xcode面板中的Display Name值和工程中的Info.plist物理文件CFBundleDisplayName字段同步。

从Xcode14开始，Xcode面板中的Display Name值不再和Info.plist物理文件CFBundleDisplayName字段同步，而是和 Build Setting - Info.plist Values（新增的模块）- Bundle Display Name的值同步（如下图）。

注意：这一点不受 Generate Info.plist File 开关（下文介绍）的影响，开关只影响Info.plist文件的生成模式。即无论开关是YES还是NO，Xcode面板中的Display Name值都是取自Build Setting - Info.plist Values - Bundle Display Name。

1. Generate Info.plist File字段

Build Settings - Generate Info.plist File（GENERATE_INFOPLIST_FILE）这个字段是Xcode13新引入的，它表示是否启用生成Info.plist文件的新模式，YES启动，NO不启用。新建的工程该字段默认为YES，旧的工程该值默认为NO。

当该值为YES时，Xcode使用新的Info.plist文件生成模式。Xcode会在打包时从 Build Setting - Info.plist Values模块 和 Info - Custom iOS Target Properties 中取数据生成最终的Info.plist文件。

当该值为NO时，Xcode使用旧的Info.plist文件生成模式。我们只需要像以前那样在工程中的Info.plist物理文件中配置参数，Xcode打包时会读取Info.plist物理文件中的配置生成最终包体里的Info.plist文件。

2. Display Name不生效问题的原因

首先，我们先明确一点：App的名字最终是由编译出的包体里的Info.plist文件中CFBundleDisplayName字段决定的，如果Info.plist中没有CFBundleDisplayName字段则取CFBundleName字段的值。

由于Xcode14的新特性，Xcode面板中设置的 Display Name只会同步到 Build Setting - Info.plist Values - Bundle Display Name。

由于我们使用了旧的Info.plist文件模式（即 BuildSetting - Generate Info.plist File 的值为NO），导致 BuildSetting - Info.plist Values - Bundle Display Name 的设置不会同步到最终的生成的包体的Info.plist文件中。从而间接导致了在Xcode面板中设置Display Name不生效的问题。