Sfsym: Công cụ CLI xuất Apple SF Symbols sang SVG, PDF và PNG chất lượng cao

Sfsym là một công cụ dòng lệnh (CLI) mới được phát triển nhằm giúp các nhà phát triển và nhà thiết kế xuất khẩu các biểu tượng SF Symbols của Apple sang các định dạng file phổ biến như SVG, PDF và PNG một cách nhanh chóng và chính xác.

Demo Sfsym

Khác với các phương pháp thủ công hoặc việc chụp lại hình ảnh (rasterization), Sfsym truy xuất trực tiếp các đường dẫn vector từ bộ kết xuất (renderer) của macOS. Điều này đảm bảo rằng đầu ra tạo ra có hình học khớp hoàn toàn với những gì hệ thống vẽ, thay vì chỉ là một sự xấp xỉ.

Tính năng chính của Sfsym

Công cụ này hoạt động bằng cách tiếp cận một biến riêng tư (private ivar) trên NSSymbolImageRep để lấy đối tượng CUINamedVectorGlyph. Sau đó, nó vẽ vào CGPDFContext và chuyển đổi luồng nội dung PDF thành các lệnh SVG d.

Một số tính năng nổi bật bao gồm:

• Độ chính xác cao: Đường dẫn vector được lấy trực tiếp từ hệ thống, đảm bảo chất lượng tốt nhất.
• Hỗ trợ đa dạng định dạng: Xuất ra SVG, PDF hoặc PNG tùy theo nhu cầu sử dụng.
• Tương thích AI Agent: Mọi lệnh con đều chấp nhận cờ --json, và lệnh sfsym schema trả về mô tả máy đọc được của toàn bộ CLI, giúp các tác nhân AI có thể sử dụng công cụ này một cách tự động.
• Cập nhật tự động: Danh sách hơn 8.300 tên biểu tượng được đọc trực tiếp từ tệp Assets.car của hệ điều hành, giúp danh sách luôn mới nhất với các bản cập nhật macOS mà không cần cập nhật bảng phiên bản trong binary.
• Tùy chỉnh CSS: Mỗi thẻ <path> trong SVG đều mang thuộc tính data-layer, cho phép người dùng thay đổi giao diện (theming) bằng CSS mà không cần can thiệp vào hình học.

Cách cài đặt và sử dụng

Sfsym có thể được cài đặt dễ dàng trên macOS thông qua Homebrew mà không cần biên dịch hay phụ thuộc vào Xcode.

Homebrew Install

Cú pháp cài đặt:

brew install yapstudios/tap/sfsym

Việc sử dụng công cụ này rất trực quan. Ví dụ, để xuất biểu tượng trái tim sang định dạng SVG:

sfsym export heart.fill -o heart.svg

Bạn cũng có thể tùy chỉnh màu sắc, kích thước hoặc xuất hàng loạt (batch) với tốc độ xử lý rất cao.

Lưu ý về Giấy phép và Kiến trúc

License MIT

Dự án Sfsym được cấp phép MIT, nhưng người dùng cần lưu ý quan trọng về bản quyền của các biểu tượng. SF Symbols là tài sản của Apple Inc. Giấy phép SF Symbols chỉ cho phép sử dụng chúng trong artwork và mockups cho các ứng dụng chạy trên nền tảng Apple. Bạn không được nhúng SF Symbols vào ứng dụng Android hoặc trang web chung.

Về mặt kỹ thuật, Sfsym sử dụng API riêng tư của Apple để truy xuất dữ liệu glyph. Mặc dù tính năng này đã ổn định từ macOS 13 đến macOS 15, nhưng không có sự đảm bảo chính thức từ Apple nếu các bản cập nhật trong tương lai thay đổi cấu trúc này.

Architecture

Sfsym là một công cụ hữu ích cho các lập trình viên muốn tích hợp quy trình thiết kế vào pipeline làm việc tự động, đặc biệt là trong các phiên thiết kế có sự hỗ trợ của AI.