AppleDeviceImages 是一个由开发者借助 Claude 辅助完成的 Swift Package,托管在 GitHub 上。它的作用非常聚焦:只要给它一个 Apple 设备的机型标识符,就能返回 Apple 官方的设备图片,效果与「设置」中 Apple 账户设备列表里显示的图片一致,并且可以按系统版本配上对应的壁纸。项目覆盖 iPhone、iPad、iPod touch、Mac、Apple Watch、HomePod、AirPods、Apple TV、Vision Pro 等产品线,支持 iOS 15、macOS 12、tvOS 15、watchOS 8 与 visionOS 1 及以上系统。对独立开发者来说,它把「找设备图」这件琐事封装成了一个可调用的接口,仓库地址为 GitHub 仓库。
痛点是什么
做 Apple 生态应用时,设备列表、设备详情、多设备管理这类界面几乎绕不开设备图片。过去开发者要么自己截图抠图,要么去网上找素材,分辨率、配色、壁纸版本都对不上,还要为每一代新机型手动补图。更麻烦的是,同一款产品不同颜色、不同系统版本的官方图并不相同,靠人工维护成本极高,图片版权与来源也说不清楚。AppleDeviceImages 正是冲着这个反复出现的琐碎需求而来。
主要功能特点
这个包把设备图片的获取、缓存与降级策略都封装好了,调用方式接近系统自带的 AsyncImage,几行代码即可接入 SwiftUI 或普通 Swift 代码。
按机型直接取图
传入 iPhone18,1 这类标识符即可拿到对应官方设备图,无需自备素材。
壁纸跟随系统版本
传入 osVersion 就能获得与该系统版本匹配的壁纸效果。
颜色编码自动识别
支持多种 Apple 颜色编码格式,按产品线自动匹配对应配色。
缓存与离线兜底
图片取回后写入缓存,macOS 上还可回退到系统自带图标。
为什么值得关注
它解决的是一个小而具体的开发痛点,却把细节做得相当完整:多平台支持、SwiftUI 友好、缓存策略清晰,还提供了颜色表与社区共建机制,适合需要展示 Apple 设备形象的 App 与工具。
接入成本低
通过 Swift Package Manager 添加依赖即可使用,API 设计与系统组件保持一致。
社区共建补全颜色
缺失的颜色编码可由用户提交设备图片地址补全,持续完善覆盖范围。
在 Claude 的帮助下,做了个小项目
AppleDeviceImages 是一个 Swift Package。给它一个机型,就能拿到 Apple 官方的设备图片,和「设置」里 Apple 账户设备列表显示的一样,还会配上对应系统版本的壁纸。iPhone、iPad、Mac、Apple Watch、AirPods 等产品线都支持。
现在还差一些机型的颜色编码。这些编码 Apple 没有公开,只能靠真机来确认。如果你手上有设备,欢迎帮忙补一下,一分钟就够:
1. 用电脑打开 https://account.apple.com/,进入「设备」
2. 在设备图片上右键,选「拷贝图像地址」
3. 到仓库开一个「Add a color」Issue,把地址贴进去
地址里只有型号和颜色,不含任何个人信息。提交后会自动核验,确认过的颜色会补进颜色表。iPhone 的同一种颜色通常各代共用一个编码,所以一台设备往往能补上好几个机型 🙌
目前最缺的是:红色和酒红、黄色、珊瑚橙和宇宙橙、原色钛金属,还有不少 Apple Watch 的不锈钢和钛金属款。完整清单见仓库的颜色表「Wanted」部分。
也欢迎提其他想法和 PR,一起共建
仓库地址:https://github.com/Eirperuier/AppleDeviceImages