VersionIcon

一个简单的工具，可以将带有版本信息的图标蒙罩添加到您的 iOS 应用图标中。蒙罩可以包括带有应用版本的带子（开发，测试，生产，MVP...）以及/或版本号。图标蒙罩可以被定制成多种方式。您还可以使用自己的图形资源。VersionIcon 工具以二进制形式分发，因此它与您的项目配置无关。

要求
安装
使用
许可协议

要求

Xcode 10.0+

安装

Cocoapods

CocoaPods是一个用于 Cocoa 项目的依赖关系管理器。您可以使用以下命令安装它：

$ gem install cocoapods

要使用 CocoaPods 将 VersionIcon 集成到 Xcode 项目中，在您的 Podfile 中指定它：

pod 'VersionIcon', '~> 1.0.8'

然后，运行以下命令：

$ pod install

使用说明

在资源库中复制您的应用图标资源 - 例如，有AppIcon和AppIconOriginal。这个副本用作备份。生产构建通常不包含图标蒙版。（如果您的项目包含除默认名称之外的其他图标资源，您需要使用--appIcon和/或--appIconOriginal参数指定它。）
在您的应用中创建一个新的运行脚本阶段，在"构建设置" > "构建阶段"中
使用以下Shell脚本

if [ "${CONFIGURATION}" = "Release" ]; then
    "Pods/VersionIcon/Bin/VersionIcon" --resources "Pods/VersionIcon/Bin" --original
else
    "Pods/VersionIcon/Bin/VersionIcon"  --ribbon Blue-TopRight.png --title Devel-TopRight.png --resources "Pods/VersionIcon/Bin" --strokeWidth 0.07
fi

如果您的项目包含不同的配置名称，您需要调整脚本。
将此脚本阶段移动到"复制包资源"阶段之上。
如果您需要使用自己的条带或标题资源，您可以指定图像文件的完整路径

参数

条带样式

--ribbon <Icon ribbon>
- 图标条带。Ribbons文件夹包含各种不同颜色和位置的.png文件。您还可以指定自定义.png的绝对路径。
--title <Icon ribbon title>
- 条带的标题。您可以在Titles文件夹中选择几个预定义的标题和不同位置，或者提供自定义条带标题图像的绝对路径。（条带标题是具有透明度的图像，目前不支持自定义文本）

图标版本标题

--fillColor <Title fill color>
- 版本标题的填充颜色，使用十六进制格式#xxxxxx。默认填充颜色为白色（'#FFFFFF'）。
--strokeColor <Title stroke color>
- 版本标题的描边颜色，使用十六进制格式#xxxxxx。默认描边颜色为黑色（'#000000'）。
--strokeWidth <Version Title Stroke Width>
- 与图标宽度相关的标题描边宽度。默认描边宽度为'0.03'。
--font <Version label font>
- 版本标题使用的字体。默认字体是'Impact'。
--titleSize <Version Title Size Ratio>
- 与图标宽度相关的版本标题大小。默认标题大小是'0.2'。
--horizontalTitlePosition <Version Title Size Ratio>
- 与图标宽度相关的版本标题位置。默认位置为'0.5'。
垂直标题位置 <版本标题大小比例>
- 版本标题位置相对于图标宽度。默认 = '0.2'。
--titleAlignment <版本标题文本对齐方式>
- 可能的值是左、中、右。默认 = 'center'。
--versionStyle <版本标签的格式>
- 可能的值有 dash、parenthesis、versionOnly、buildOnly。默认 = 'dash'。

脚本设置

--resources <版本图标资源路径>
- 默认路径为 Ribbons 和 Titles 文件夹的位置。当脚本在 Xcode 中作为构建阶段执行时，不需要设置。
--original
- 如果您需要使用未经修改的原版图标，请使用此参数。生产应用程序通常没有图标覆盖。
--help
- 使用 --help 参数运行 VersionIcon 时，可查看参数的完整描述。

贡献

欢迎提交问题和拉取请求！

作者

丹尼尔·塞赫 GitHub

许可

VersionIcon 是在 MIT 许可下发布的。有关详细信息，请参阅 LICENSE。

版本Icon 1.0.9

VersionIcon 1.0.9