当前位置：首页 > news >正文

Houston 命令行工具详解：如何使用 apn 二进制快速测试推送通知

news 2026/5/27 2:28:15

Houston 命令行工具详解：如何使用 apn 二进制快速测试推送通知

【免费下载链接】houstonnomad-cli/houston: Houston 是一个用于 Nomad 集群管理的 Web UI，可以用于构建和管理 Nomad 集群，支持多种 Nomad 集群和云计算平台，如 AWS，Azure，Google Cloud Platform 等。项目地址: https://gitcode.com/gh_mirrors/ho/houston

Apple推送通知服务（APNs）是iOS应用开发中的重要组成部分，但测试推送通知功能通常需要复杂的设置和繁琐的流程。今天，我将为您详细介绍如何使用Houston项目的apn命令行工具，这是一个简单高效的解决方案，让您能够快速测试Apple推送通知功能。🚀

什么是Houston和apn命令行工具？

Houston是一个专门用于发送Apple推送通知的Ruby gem，它提供了一个名为apn的命令行工具，让开发者能够直接从终端发送测试通知。这个工具特别适合在开发过程中快速验证推送功能，无需编写完整的Ruby代码。

重要提示：Houston项目目前仅支持传统的二进制APNs协议，该协议已于2021年3月31日停止支持。对于生产环境，建议迁移到支持新APNs2协议的替代库，如Apnotic。

快速安装与配置指南

安装Houston gem

首先，您需要安装Houston gem。打开终端并执行以下命令：

gem install houston

安装完成后，您就可以使用apn命令行工具了。您可以通过运行apn --help来查看所有可用命令。

准备Apple推送证书

要使用apn工具发送推送通知，您需要一个有效的Apple推送证书（.pem格式）。以下是获取证书的步骤：

从Apple开发者中心获取推送证书
将证书导出为.p12格式
使用OpenSSL转换为.pem格式：

# 未加密的私钥（不要在版本控制中存储此证书） openssl pkcs12 -in cert.p12 -out apple_push_notification.pem -nodes -clcerts # 加密的私钥 openssl pkcs12 -in cert.p12 -out apple_push_notification.pem -aes256 -clcerts

apn命令行工具的核心功能

基本推送命令

apn工具的核心功能是push命令，它允许您向一个或多个设备发送推送通知。基本语法如下：

apn push "<device_token>" -c /path/to/certificate.pem -m "您的消息内容"

命令参数详解

apn push命令支持丰富的参数，让您可以自定义通知的各种属性：

-m, --alert ALERT：通知的提示内容
-b, --badge NUMBER：设置应用图标上的角标数字
-s, --sound SOUND：指定播放的声音文件
-y, --category CATEGORY：通知的分类标识符
-n, --[no]-newsstand：指示Newsstand内容可用
-d, --data KEY=VALUE：传递自定义数据（以逗号分隔的"key=value"格式）
-P, --payload PAYLOAD：JSON格式的通知负载
-e, --environment ENV：推送环境（production或development，默认为development）
-c, --certificate CERTIFICATE：证书文件路径（.pem格式）
-r, --raw-certificate CERTIFICATE VALUE：证书文件的实际内容
-p, --[no]-passphrase：提示输入证书密码

实用示例

示例1：发送简单的文本通知

apn push "<device_token>" -c apple_push_notification.pem -m "Hello, World!"

示例2：发送包含角标和声音的通知

apn push "<device_token>" -c apple_push_notification.pem -m "您有新的消息" -b 5 -s "default"

示例3：发送自定义数据的通知

apn push "<device_token>" -c apple_push_notification.pem -m "订单已发货" -d "order_id=12345,status=shipped"

示例4：使用JSON负载发送通知

apn push "<device_token>" -c apple_push_notification.pem -P '{"aps":{"alert":"测试通知","badge":1,"sound":"default"},"custom_data":{"action":"open_order","order_id":123}}'

高级功能与最佳实践

批量发送通知

apn工具支持一次向多个设备发送通知：

apn push "<token1>" "<token2>" "<token3>" -c certificate.pem -m "批量测试通知"

使用反馈服务

Apple提供了反馈服务来查询未注册的设备令牌。您可以使用以下命令获取这些设备列表：

apn feedback -c /path/to/certificate.pem

这个功能对于清理无效的设备令牌非常重要，Apple会审核提供商以确保他们删除未注册的设备。

环境配置

Houston支持从环境变量读取配置，这使得在生产环境中部署更加方便：

export APN_CERTIFICATE=/path/to/apple_push_notification.pem export APN_CERTIFICATE_PASSPHRASE=your_passphrase export APN_GATEWAY_URI=gateway.push.apple.com