SharpIco

SharpIco是一个纯 C# AOT 实现的轻量级图标生成工具，用于生成和检查ICO图标文件。可将一张高分辨率 PNG 图片一键生成标准的 Windows .ico 图标文件，内含多种尺寸（16x16 到 512x512），还可以自定义尺寸。

通过SharpIco，您可以轻松将PNG图像转换为包含多种尺寸的ICO图标，完全摆脱命令行依赖，无需 ImageMagick、Node.js 或 Python，适合在 .NET 项目中内嵌、分发或集成自动打包流程中使用。

除了图标生成，SharpIco 还内置图标结构分析功能，助你轻松验证 .ico 文件中包含的图层与尺寸。

🚀 跨平台、零依赖、极速生成，一切尽在 SharpIco！

✨ 功能特点

• 🖼️ 将PNG图像转换为多尺寸ICO图标
• 🔍 支持生成包含自定义尺寸的ICO图标（最高支持1024×1024）
• 🧐 检查ICO文件的内部结构和信息
• 📏 准确识别并显示超大尺寸图标（如512×512、1024×1024）的实际尺寸

🤝 相关项目

• SharpIcoWeb - 基于 SharpIco 的 Web 版本，提供更直观的图形界面操作。

📦 安装

使用 Scoop 安装 (Windows)

# 添加自定义 bucket
scoop bucket add sharp-ico https://github.com/star-plan/sharp-ico-bucket

# 安装 SharpIco
scoop install sharp-ico

作为 .NET Global Tool 安装

dotnet tool install --global SharpIco

从源码构建

git clone https://github.com/star-plan/sharp-ico.git
cd SharpIco
dotnet build -c Release

🚀 使用方法

生成ICO图标

sharpico generate -i input.png -o output.ico

可选参数:

• -s, --sizes: 指定图标尺寸，默认为 16,32,48,64,128,256,512,1024

示例:

sharpico generate -i input.png -o output.ico -s 16,32,64,128

检查ICO文件结构

sharpico inspect icon.ico

📋 参数说明

生成命令(generate)

参数	缩写	说明	是否必需
--input	-i	输入PNG图像文件路径	是
--output	-o	输出ICO文件路径	是
--sizes	-s	图标尺寸列表，以逗号分隔	否，默认为16,32,48,64,128,256,512,1024

检查命令(inspect)

参数	说明	是否必需
ico-file	要检查的ICO文件路径	是

📝 示例输出

生成ICO图标

正在将 logo.png 转换为 logo.ico...
生成尺寸: 16, 32, 48, 64, 128, 256, 512, 1024
ICO 文件已生成: logo.ico

检查ICO文件

正在检查ICO文件: logo.ico
图标数量: 8
- 第1张图像: 16x16, 32bpp, 大小: 840字节, 偏移: 150
- 第2张图像: 32x32, 32bpp, 大小: 1939字节, 偏移: 990
- 第3张图像: 48x48, 32bpp, 大小: 3375字节, 偏移: 2929
- 第4张图像: 64x64, 32bpp, 大小: 4951字节, 偏移: 6304
- 第5张图像: 128x128, 32bpp, 大小: 13782字节, 偏移: 11255
- 第6张图像: 256x256, 32bpp, 大小: 37823字节, 偏移: 25037
- 第7张图像: 512x512, 32bpp, 大小: 114655字节, 偏移: 62860
  注意: 文件头中指定的尺寸为256x256，但实际图像尺寸为512x512
- 第8张图像: 1024x1024, 32bpp, 大小: 248965字节, 偏移: 177515
  注意: 文件头中指定的尺寸为256x256，但实际图像尺寸为1024x1024

🔍 关于ICO格式的说明

ICO文件格式在表示图像尺寸时有一个限制：宽度和高度字段各只有一个字节，值范围是0-255。当这些字段为0时，按照规范表示256像素。对于大于256的尺寸（如512×512或1024×1024），在文件头中仍然会显示为0（即256），但实际图像数据可以包含更大尺寸的图像。

SharpIco的inspect命令会解析每个图像的实际数据，以获取其真实尺寸。这使得工具能够准确显示ICO文件中图像的实际分辨率，即使它们超过了ICO头部表示的范围限制。当头部信息与实际图像尺寸不一致时，SharpIco会显示相应的提示信息。

🛠️ 技术实现

SharpIco使用以下技术：

• .NET 9.0
• SixLabors.ImageSharp - 用于图像处理
• System.CommandLine - 用于命令行参数解析

📄 许可证

MIT License

开发者指南

构建项目

dotnet build

发布模式

SharpIco 支持两种发布模式：

AOT 发布 (原生性能，无需 .NET 运行时)

dotnet publish -r win-x64 -c release /p:PublishAot=true /p:TrimMode=full /p:InvariantGlobalization=true /p:IlcGenerateStackTraceData=false /p:IlcOptimizationPreference=Size /p:IlcFoldIdenticalMethodBodies=true /p:JsonSerializerIsReflectionEnabledByDefault=true

支持的平台:

• Windows: win-x64
• macOS: osx-x64, osx-arm64
• Linux: linux-x64, linux-arm64

Framework Dependent 发布 (需要 .NET 运行时)

# 发布为 NuGet 包 (.NET Tool)
dotnet pack

# 安装本地打包的工具
dotnet tool install --global --add-source ./SharpIco/nupkg SharpIco

创建 Scoop 安装包

• 编译 AOT 版本并创建 zip 文件
• 在 GitHub Releases 中发布 AOT 编译的 zip 包
• 计算 zip 文件的 SHA256 哈希值
• 更新 bucket/sharp-ico.json 中的版本号和哈希值

sharp-ico.json 内容示例

{
    "version": "1.0.0",
    "description": "轻量级ICO图标生成和检查工具",
    "homepage": "https://github.com/star-plan/sharp-ico",
    "license": "MIT",
    "architecture": {
        "64bit": {
            "url": "https://github.com/star-plan/sharp-ico/releases/download/v1.0.0/sharpico-win-x64.zip",
            "hash": "SHA256哈希值，发布后填写"
        }
    },
    "bin": "sharpico.exe",
    "checkver": "github",
    "autoupdate": {
        "architecture": {
            "64bit": {
                "url": "https://github.com/star-plan/sharp-ico/releases/download/v$version/sharpico-win-x64.zip"
            }
        }
    }
}

使用此方法，您的用户可以通过以下简单步骤安装您的工具：

scoop bucket add sharp-ico https://github.com/star-plan/sharp-ico
scoop install sharp-ico

当您发布新版本时，用户只需运行 scoop update sharp-ico 即可获取最新版本。

两种发布流程

AOT 发布流程 (Scoop/独立应用)

1. 编译 AOT 版本:

dotnet publish -r win-x64 -c release /p:PublishAot=true /p:TrimMode=full /p:InvariantGlobalization=true /p:IlcGenerateStackTraceData=false /p:IlcOptimizationPreference=Size /p:IlcFoldIdenticalMethodBodies=true /p:JsonSerializerIsReflectionEnabledByDefault=true

2. 打包生成的文件:

# 进入发布目录
cd SharpIco/bin/release/net9.0/win-x64/publish/
# 创建 zip 包
powershell Compress-Archive -Path * -DestinationPath sharpico-win-x64.zip

3. 将生成的 zip 文件上传到 GitHub Releases

.NET Tool 发布流程

1. 打包为 NuGet 包:

dotnet pack

2. 生成的包将位于 ./SharpIco/nupkg 目录中

3. 发布到 NuGet:

dotnet nuget push ./SharpIco/nupkg/SharpIco.1.0.0.nupkg --api-key 您的API密钥 --source https://api.nuget.org/v3/index.json

本地测试

测试 .NET Tool

# 安装本地打包的工具
dotnet tool install --global --add-source ./SharpIco/nupkg SharpIco

# 卸载工具
dotnet tool uninstall --global SharpIco

测试 AOT 发布版本

直接运行生成的可执行文件:

./SharpIco/bin/release/net9.0/win-x64/publish/sharpico.exe