#图标 #shell #动画 #mac #gif #图片缩放 #命令

app laic

为 Mac 生成动画应用程序图标的简单 CLI 工具

1 个不稳定版本

0.1.0 2023年6月7日

#3#动画

MIT 许可证

29KB
575

Mac 上的 Live App Icon

在您的 Dock 上显示动画应用程序图标,点击时可以执行任意 shell 脚本。

要求

  • macOS 13 (Ventura) 或更高版本
  • Xcode (或至少 xcodebuild) 版本 14.1 或更高
  • Apple 开发者证书
  • 不要太旧的 git

如果您有最新版本的 Xcode,则应满足上述要求。

安装 laic

laic (Live App Icon Creator) 是一个简单的 CLI 工具,用于在 macOS 上生成实时应用程序图标。安装 laic 有两种方式:使用 Rust 的 cargo 或下载二进制文件。

使用 cargo

如果您是 Rust 开发者,由于它发布在 crate.io,因此使用 cargo 安装 laic 是最简单的方式。

cargo install laic

下载二进制文件

发布页面 上有预编译的二进制文件。您可以手动下载并将其安装到适当的位置(例如 /usr/local/bin)。如果您使用的是 Apple Silicon Mac,请选择 laic-aarch64-apple-darwin,如果是 Intel Mac,请选择 laic-x86_64-apple-darwin

以下单行命令将自动将 laic 安装到 Apple Silicon Mac 的 /usr/local/bin

curl -L -o laic https://github.com/fujidaiti/live-app-icon/releases/download/v0.0.1/laic-aarch64-apple-darwin && chmod +x ./laic && sudo mv ./laic /usr/local/bin

或在 Intel Mac 上

curl -L -o laic https://github.com/fujidaiti/live-app-icon/releases/download/v0.0.1/laic-x86_64-apple-darwin && chmod +x ./laic && sudo mv ./laic /usr/local/bin

用法

laic 至少需要 3 个参数

  • --name : 要生成的应用程序的名称。用作 Dock 和应用程序启动器中的显示名称。
  • --gif : 用作应用程序图标的动画 GIF 的路径。如果图像的宽度和高度不相等,则将图像缩放到指定的大小。
  • --command : 当点击生成的应用程序时执行的 shell 命令。

以下是一个示例,生成一个名为 "GitHub" 的动画应用程序图标,点击时会打开默认浏览器中的 GitHub 主页。

laic --name "GitHub" --gif path/to/your/gif --command "open https://github.com"

laic 还接受其他选项

  • --resize-method : 指定如何将 GIF 缩放为正方形。有关更多详细信息,请参阅 缩放方法

  • --install-location : 安装应用程序的目录路径。默认路径为 $HOME/Applications

  • --install-action : 当应用程序成功安装时执行的操作。 launch 立即启动应用程序, open-in-finder 在 Finder 中打开应用程序安装的目录,none 不执行任何操作。默认操作为 launch

  • --verbose : 详细日志记录,包括所有执行的 shell 命令。

运行 laic --help 获取更多信息。

调整大小方法

如果给定动画 GIF 的宽度和高度不相等,laic 会根据指定的调整大小方法将其调整为正方形

  • center-crop : 使用与图像较短边相同大小的正方形裁剪图像的中心。
  • center-fit : 将图像放置在透明正方形的中心,该正方形的边长与图像较长边相同。

默认方法为 center-fit

安装完成后

保留应用程序在 Dock 中

建议启用应用程序的“保留在 Dock 中”选项,以便动画始终吸引你的注意 👀。

keep-in-dock

登录项

当生成的应用程序首次启动时,它将自动将其添加到登录项。这是因为应用程序图标的动画仅在应用程序运行时可用。你可能注意到,如果你退出应用程序,动画也会停止。

add-to-login-items

允许通知

此外,应用程序在首次启动时还需要发送通知的权限。如果运行命令时发生错误,它将通过通知通知你。

notification-request

与快捷方式集成

由于生成的应用程序可以运行任意 shell 命令,因此很容易执行使用 快捷方式 创建的复杂工作流程。你知道我们还可以从命令行运行快捷方式吗?例如,要运行名为“我的快捷方式”的快捷方式,你可以使用以下方法

shortcuts run "My Shortcut"

然后你可以轻松地将此快捷方式与 App Live Icon 集成如下

laic --label "My Shortcut" --command "shortcuts run \"My Shortcut\"" --gif path/to/your/gif

请注意,由于快捷方式名称中包含空格,需要在 --command 部分中转义双引号。您可以阅读有关 shortcuts 命令的更多信息,请参阅 从命令行运行快捷方式

卸载

laic

laic 只是一个可执行文件。您可以像这样删除它:sudo rm /usr/local/bin/laic,或者手动将其移动到回收站。

生成的应用程序

只需将其移动到回收站。默认安装位置为 $HOME/Applications,除非您在创建时指定了特定目录。您可能还需要从系统设置中的登录项和通知部分删除应用程序。

故障排除

如果您尝试运行您下载的 laic,您可能会看到如下图片中的警告对话框。这是因为二进制文件未由已识别的开发者签名。在这种情况下,您必须根据以下文章手动允许应用程序运行:[从未识别的开发者打开Mac应用程序](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an- unidentified-developer-mh40616/mac)。

warning-dialog

谢谢

<iframe src="https://giphy.com/embed/L3iUyZxjNJ080YJnlt" width="300" height="300" frameBorder="0" class="giphy-embed" allowFullScreen></iframe>

via GIPHY

贡献

如果您发现任何错误或对改进有建议,请在GitHub存储库中创建一个问题或拉取请求。欢迎并感谢您的贡献!

TODO

命令行工具

  • 验证参数
  • 重构代码
  • 添加通知命令输出的选项
  • 改进报告消息
  • 添加测试

其他

  • 创建GUI图标生成器

  • 提供一种无需Xcode即可创建动画图标的方法

依赖项

~14–24MB
~311K SLoC