项目简介
本项目借助 Apple Configurator 工具,实现了在 iPhone 桌面生成网页快捷方式图标的功能。对于 SPA 或 PWA 网页,使用此技术可大幅提升网站 PV。项目涵盖了从创建描述文件、配置 Web Clips、调试、签名到分发描述文件的完整流程。
项目的主要特性和功能
- 利用 Apple Configurator 工具的多种功能,如域名管理、代理设置、内容过滤、证书管理等,重点实现网页快捷方式创建。
- 支持自定义网页快捷方式的各项属性,包括显示名称、打开的网页地址、是否可删除、图标等。
- 提供配置文件签名功能,可通过 OpenSSL 命令和 Apple Developer 后台证书进行签名。
- 使用 Node.js 搭建服务器实现描述文件的分发。
安装使用步骤
前提条件
假设用户已经下载了本项目的源码文件,且拥有一台 Mac 电脑、一部 iPhone 以及已安装 Node.js 的服务器。
具体步骤
- 准备 Apple Configurator 2:前往 Mac App Store(https://itunes.apple.com/cn/app/apple-configurator-2/id1037126344?mt=12 )下载并安装 Apple Configurator 2 工具。
- 创建并填写描述文件
- 在 Apple Configurator 中创建描述文件。
- 按照提示填写描述文件内容,如 Label(显示在手机界面上的 APP 名称)、Identifier(描述文件的唯一标识)、Organization(公司和组织机构名称)等,并选择 Security 和 Automatically Remove Profile 的相关选项。
- 配置 Web Clips
- 参考说明填写 Web Clips 配置项,如 Label、URL(打开 APP 后显示的网页地址)、Removable(APP 是否可以删除)、Icon(APP 图标)等,完成后保存配置文件。
- 调试
- 用苹果 MFi 认证的数据线将 iPhone 连接到 Mac 电脑,在手机弹出「信任」弹框时选择「信任」。
- 将配置好的描述文件拖拽到 Apple Configurator 2 界面,在手机上点击「安装」等操作完成安装。
- 配置文件签名
- 执行命令
openssl req -x509 -newkey rsa:2048 -keyout my.pem -out signer.pem -days 3650 -nodes
,按提示填写签名的公司信息。 - 执行命令
openssl smime -sign -in Kenny.mobileconfig -out Kenny_signed.mobileconfig -signer signer.pem -inkey my.pem -outform der -nodetach
对配置文件签名。
- 执行命令
- 描述文件签名
- 打开 Apple Developer 后台,进入 https://developer.apple.com/account/ios/certificate/distribution ,下载对应的 distribution.cer 文件并双击安装。
- 用 Apple Configurator 2 打开描述配置文件,选择刚刚下载的 distribution 证书进行「Sign」操作。
- 描述文件分发
- 创建
web-clips-server.ts
文件,将代码复制保存,并将签名后的描述文件放在同目录下。 - 在安装有 Node.js 的服务器上部署该文件,注意修改
host
和port
为需要的值。 - 在 Terminal 里执行
node web-clips-server.ts
启动服务器。 - 让其他用户访问地址(如:http://192.168.1.5:3000/download )下载描述文件进行安装。
- 创建
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】