Apple Cursor 技术文档

Apple Cursor 技术文档

apple_cursor Free & Open source macOS Cursors. 项目地址: https://gitcode.com/gh_mirrors/ap/apple_cursor

---

安装指南

稳定版与开发版下载

您可以通过访问项目释放页面来获取最新稳定版和开发版的 Apple Cursor。

Arch Linux/Manjaro 用户安装

对于 Arch Linux 和 Manjaro 用户，通过 AUR（Arch User Repository）可以轻松安装：

paru -S apple_cursor

或者使用其他AUR助手工具进行安装。

其他Linux发行版及Windows手动安装

• Linux(X11): 解压下载的.tar.gz文件，并按照以下命令进行本地或全局安装。

  tar -xvf macOS-Bigsur.tar.gz
  mv macOS-* ~/.icons/
  sudo mv macOS-* /usr/share/icons/
  

  卸载时执行：

  rm ~/.icons/macOS-*
  sudo rm /usr/share/icons/macOS-*
  

• Windows: 解压缩.zip文件，右击install.inf并选择“安装”，然后在控制面板个性化设置中选择“macOS Cursors”应用。卸载则运行uninstall.bat或手动处理注册表和文件。

使用说明

Apple Cursor 提供了默认的黑白色系，以及适用于Linux和Windows的多种尺寸。用户可以在系统的个性化设置中选择该主题以立即应用。

API使用文档

本项目不提供传统意义上的API接口，但提供了一套自定义构建流程，允许用户通过CLI工具调整颜色、大小等，具体操作如下：

自定义构建流程

准备环境

确保拥有Python 3.7+，安装clickgen (pip install clickgen)，并配置好Yarn环境。

构建步骤

1. 克隆仓库：

   git clone https://github.com/ful1e5/apple_cursor
   cd apple_cursor
   

2. 基础构建：直接运行yarn build会生成基于默认配置的主题。

3. 自定义尺寸与颜色：

   • 若要改变尺寸或颜色，首先使用npx cbmp命令渲染SVG到不同颜色或尺寸的位图。 例如，创建绿色底色的macOS Big Sur主题：

     npx cbmp -d 'svg/bigsur' -n 'macOS-BigSur-Hacker' -bc '#00FE00' -oc '#000000'
     

   • 然后，使用ctgen构建这些位图成主题文件：

     ctgen build.toml -d 'bitmaps/macOS-BigSur-Hacker' -n 'macOS-BigSur-Hacker' -c 'Green macOS Big Sur cursors.'
     

4. 构建特定平台的光标： 支持指定XCursors (-p x11) 或Windows cursors (-p windows)，并且可以定制大小。

项目安装方式概述

已详细描述上述安装指南，覆盖了Arch Linux/Manjaro通过AUR的安装方法，以及其他Linux与Windows的手动安装步骤，同时也介绍了如何从源码进行高度自定义的构建过程，让用户能够根据自身需求定制独一无二的鼠标指针主题。

apple_cursor Free & Open source macOS Cursors. 项目地址: https://gitcode.com/gh_mirrors/ap/apple_cursor