iOS 平台构建选项

ios-build-options

配置选项

可执行文件名

用于指定应用程序主执行文件名称的字段，这个字段被存储在应用的 Info.plist 文件中。如果未填写，系统将根据应用名称字段生成默认值。值的设定只能包含数字、字母、下划线(_)以及减号(-)。

应用 ID 名称（Bundle Identifier）

包名，通常以产品网站 URL 倒序排列，如 com.mycompany.myproduct。

注意：包名中只能包含数字（0~9）、字母（A~Z、a~z）、中划线（-）和点（.），此外包名最后一部分必须以字母开头，不能以下划线或数字开头。详情请参考 包的唯一标识符。

跳过 Xcode 工程的更新

在默认情况下，每次构建都会执行 CMake 命令以生成 Xcode 工程。然而，如果对生成的 Xcode 工程进行了修改或配置，例如通过 CocoaPods 集成了 SDK，这可能会引起问题，因为这些修改在下次构建时会被还原。

如果选中这个选项，后续的构建将不再更新或覆盖 Xcode 工程的配置。

要注意的是，与 CMake 相关的其他修改，例如添加C++源代码，也不会再触发 Xcode 工程的重新生成。

屏幕方向

屏幕方向目前包括 Portrait、Landscape Left、Landscape Right 三种。

  • Portrait：屏幕直立，Home 键在下
  • Landscape Left：屏幕横置，Home 键在屏幕左侧
  • Landscape Right：屏幕横置，Home 键在屏幕右侧

目标系统

默认启动的系统类型：

  • iPhone OS: 真机运行。
  • iOS Simulator: iOS 模拟运行。

这个只是默认值，可以在 Xcode 中随时修改。

渲染后端

渲染后端 目前支持 METAL，详情可参考官方文档 Metal。

开发者

该项用于配置构建编译 iOS 工程时的 Development Team 签名信息。若使用 Xcode 编译时，在 Xcode 中手动配置了签名信息，则以 Xcode 中的配置为准。当执行重新构建时，该项的值会覆盖 Xcode 中配置的值。

目标版本

该项主要用于指定发布 iOS 平台时的 iOS 软件版本，默认值为 12.0。构建后版本号会记录在发布包目录 proj/cfg.cmake 文件的 TARGET_IOS_VERSION 字段中。