Xcode 12/13开发Swift Package时新文件如何自动补全头部版权与包名
Xcode Swift Package 新建文件自动补全头部信息解决方案
下面提供三种可落地的实现方式,可根据使用场景选择:
方法1:全局配置基础信息 + Package 配置宏(最省事,适合所有Swift Package生效)
- 第一步配置全局组织名:打开Xcode,点击顶部菜单栏
Xcode > 偏好设置 > 通用,在「组织名称」输入框填写你的公司/个人名称,Xcode默认会将该字段作为版权声明的主体。 - 第二步给Swift Package添加配置宏:在
Package.swift的对应Target配置中添加xcconfig引用,示例如下:
// Package.swift 示例 let package = Package( name: "MyPackage", products: [ .library(name: "MyPackage", targets: ["MyPackage"]), ], targets: [ .target( name: "MyPackage", // 新增xcconfig配置路径,文件放在Package根目录即可 xcconfig: .path("MyPackage.xcconfig") ), ] )
- 第三步在Package根目录新建
MyPackage.xcconfig文件,填入以下内容:
// 替换为你的包名 PRODUCT_NAME = MyPackage // 版权声明模板,YEAR会自动替换为当前年份,ORGANIZATION_NAME会读取你第一步设置的全局组织名 COPYRIGHT = Copyright © ${YEAR} ${ORGANIZATION_NAME}. All rights reserved.
配置完成后重启Xcode,新建文件就会自动填充包名和版权信息。
方法2:自定义Swift文件模板(适合需要自定义头部格式的场景)
- 打开Finder,按
Shift + Command + G输入路径~/Library/Developer/Xcode/Templates/,如果不存在Templates文件夹就手动新建。 - 依次在Templates目录下新建
File Templates > Source两级文件夹。 - 再次按
Shift + Command + G输入Xcode内置模板路径/Applications/Xcode.app/Contents/Developer/Library/Xcode/Templates/File Templates/Source/,找到Swift File.xctemplate文件夹,复制到刚才新建的Source目录下。 - 打开复制后的
Swift File.xctemplate文件夹内的___FILEBASENAME___.swift文件,直接修改头部内容为你想要的格式,占位符可以用___FILENAME___(文件名)、___PROJECTNAME___(包名)、___FULLUSERNAME___(当前用户名)、___DATE___(日期)、___ORGANIZATIONNAME___(组织名),修改完保存即可。后续新建文件选择你自定义的Swift模板就能生成对应头部。
方法3:自定义代码片段(临时使用无需修改配置)
- 新建空白Swift文件,输入你想要的头部格式,把需要动态替换的内容选中,右键选择「创建代码片段」,设置触发快捷键比如
header,后续新建文件敲快捷键就能快速插入自定义头部。
内容的提问来源于stack exchange,提问作者neatchuck
相关产品推荐
相关产品推荐

