README

heif-converter是一款多功能的命令行应用程序，附带Docker镜像，提供了一种简单高效的方法将HEIC（和AVIF）图像转换为其他常用格式，如JPEG和PNG，反之亦然。它利用了go-libheif模块，这是一个libheif库的GoLang包装器。此工具可以作为跨多个平台的独立CLI应用程序使用，包括macOS、Linux和Windows，或者通过Docker容器使用，使其成为满足所有HEIC图像转换需求的灵活解决方案。

安装依赖项

heif-converter依赖于libheif，必须在您的系统上安装。为了简化安装过程，我提供了适用于不同操作系统的现成脚本：

• install-libheif.sh
• install-libheif-macos.sh
• install-libheif-windows.bat

注意：这些脚本假设系统上已安装了所需的工具（如macOS的git和brew或Windows的git和C++桌面开发Visual Studio）。

从Docker使用

如果您发现难以安装libheif，可以使用Docker。只需拉取docker镜像

docker pull maestroerror/heif-converter:latest

运行转换器并转换图像

docker run --rm -v /path/to/your/files:/app/files maestroerror/heif-converter [heic|avif|jpeg|png] /app/files/input_file /app/files/output_file

注意：将/path/to/your/files替换为您要转换的图像所在的目录的路径。转换器将在该目录中查找输入文件，并将输出文件写入该目录。

通过Composer使用

您还可以通过Composer使用heif-converter，Composer是PHP的依赖管理器。首先，您需要将heif-converter添加到项目依赖项中。在终端中导航到您的项目根目录，并运行以下命令

composer require maestroerror/heif-converter

安装heif-converter后，您可以在vendor/bin目录中找到可执行文件。根据您的操作系统，使用适当的版本

• Linux：./vendor/bin/heif-converter-linux
• Windows：./vendor/bin/heif-converter-windows
• macOS：./vendor/bin/heif-converter-macos

例如，在Linux系统上转换图像，您可以运行

./vendor/bin/heif-converter-linux heic input.heic output.png

运行安装脚本

在使用heif-converter之前，您可能需要运行您平台的安装脚本。这些脚本安装必要的依赖项（libheif）。

对于Linux，运行install-libheif.sh

./vendor/maestroerror/heif-converter/install-libheif.sh

对于macOS，运行install-libheif-macos.sh

./vendor/maestroerror/heif-converter/install-libheif-macos.sh

对于Windows，您需要使用命令提示符来运行install-libheif-windows.bat

.\vendor\maestroerror\heif-converter\install-libheif-windows.bat

运行适当的脚本后，您应该能够按照下一章中所述使用heif-converter命令。为确保安装就绪，请在没有参数的情况下运行./vendor/bin/heif-converter-linux命令，您应该得到如下输出

Usage: ./vendor/bin/heif-converter-linux [heic|avif|jpeg|png] input_file output_file

用法

只需指向可执行文件（./heif-converter），将当前图像格式（[heic|avif|jpeg|png]）作为第一个参数，输入/输出文件作为第二和第三个参数。

./heif-converter [heic|avif|jpeg|png] path/to/input_file.heic /path/to/output_file.png

注意：它将自动根据扩展名检测输出文件格式
应用程序在bin目录中包含3个二进制文件。根据您的平台选择

• heif-converter-linux
• heif-converter-macos
• heif-converter-windows.exe

贡献

我们热烈欢迎对 heif-converter-image 项目的所有贡献！该项目完全开源，依靠社区的贡献来扩大其影响力、提高其功能性和修复现有问题。

如何贡献

如果您有兴趣为 heif-converter-image 项目做出贡献，您可以自由提交 Pull Requests 和 Issues。您的贡献可以包括修复错误、增强功能、添加文档以及编写测试用例。在提交 Pull Requests 之前，请确保您已彻底测试了您的更改，并且所有测试都已通过。

在您的 Pull Requests 中，请在提交消息和注释中尽可能详细，以帮助维护者理解您的更改。对于 Issues，提供尽可能多的关于问题的详细信息，包括复现步骤、操作系统和版本等。为不同平台构建

目前，heif-converter-image 随带适用于 Windows、Linux 和基于 macOS Intel 架构的可执行文件。然而，我们明白支持更广泛平台的需求和必要性正在增长。

我们特别有兴趣扩展对 Linux ARM64 和 macOS M1 架构的支持。如果您有在这些平台上构建的经验或拥有用于测试的系统，您的贡献将非常受赞赏。

请记住，开源项目依赖于像您这样的开发者的协作和贡献。我们可以共同努力，使 heif-converter-image 更加出色。让我们共同打造一些令人惊叹的东西吧！

开发

• 构建测试二进制文件 go build -o bin/heif-converter

支持

支持我们的工作？🌟 您可以通过小额捐赠来帮助我们保持代码的流动。每一份支持都在维护和改进我们的开源贡献方面发挥了重要作用。点击下面的按钮进行捐赠。感谢您的慷慨！

或使用二维码