1 个不稳定版本
0.1.0 | 2023年6月7日 |
---|
#3 在 #动画
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 中”选项,以便动画始终吸引你的注意 👀。
登录项
当生成的应用程序首次启动时,它将自动将其添加到登录项。这是因为应用程序图标的动画仅在应用程序运行时可用。你可能注意到,如果你退出应用程序,动画也会停止。
允许通知
此外,应用程序在首次启动时还需要发送通知的权限。如果运行命令时发生错误,它将通过通知通知你。
与快捷方式集成
由于生成的应用程序可以运行任意 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)。
谢谢
- DSFDockTile 由 @dagronf 开发:一个swift库,提供创建动画应用程序图标的简单API。
- Funk Bass Sticker 由 @jsot 提供:本包中的图像已从 https://giphy.com 获取。
贡献
如果您发现任何错误或对改进有建议,请在GitHub存储库中创建一个问题或拉取请求。欢迎并感谢您的贡献!
TODO
命令行工具
- 验证参数
- 重构代码
- 添加通知命令输出的选项
- 改进报告消息
- 添加测试
其他
-
创建GUI图标生成器
-
提供一种无需Xcode即可创建动画图标的方法
依赖项
~14–24MB
~311K SLoC