第一天接手 iOS APNs 推送开发，我是如何从懵逼到通关的？

{
  "aps": {
    "alert": {
      "title": "订单发货提醒📦",
      "body": "您购买的潮流球鞋已安排发货，快递单号：SF10086，请注意查收~"
    },
    "sound": "default",
    "badge": 1
  }
}

🔑 鉴权凭证（.p12证书 或 .p8令牌） ──> 证明“我是正版后端”
🏷️ apns-topic（App 的 Bundle ID） ──> 证明“我要发给哪款App”
📍 Device Token（64位十六进制字符串） ──> 证明“我要发给哪台具体的手机”

// 1. 伪首部（HTTP/2 Pseudo-Header Fields）
:method = POST
:scheme = https
:path = /3/device/00fc13adff785122b4ad28809...  // 路径里直接拼上 Device Token

// 2. 苹果要求的核心头部（Headers）
host = api.sandbox.push.apple.com              // 开发测试网关（线上用 api.push.apple.com）
apns-topic = com.jianding.app                  // 必填：你的 App 包名
apns-push-type = alert                        // 必填：告诉苹果这是会引起亮屏、声音的用户弹窗
apns-expiration = 0                           // 选填：0 代表手机离线就不缓存，立刻丢弃
apns-priority = 10                            // 选填：10 为最高优先级，代表立刻投递，不合并成批次

// 3. 消息体（DATA Frame / JSON Payload）
{
  "aps" : {
    "alert" : {
      "title" : "商品已发货 🚨",
      "body" : "你购买的xx球鞋已发货"
    },
    "sound" : "default",
    "badge" : 1
  }
}

<dependency>
    <groupId>com.eatthepath</groupId>
    <groupId>pushy</groupId>
    <version>0.15.4</version>
</dependency>

import com.eatthepath.pushy.apns.ApnsClient;
import com.eatthepath.pushy.apns.ApnsClientBuilder;
import com.eatthepath.pushy.apns.PushNotificationResponse;
import com.eatthepath.pushy.apns.util.SimpleApnsPushNotification;
import com.eatthepath.pushy.apns.util.TokenUtil;

import java.io.File;
import java.security.interfaces.ECPrivateKey;
import java.util.concurrent.CompletableFuture;

public class ApnsWithPushyP8 {
    public static void main(String[] args) {
        // 1. 准备向 iOS 同学索要的【.p8 原材料】
        String teamId = "ABC123XYZ7";                 // 苹果开发者团队 ID
        String keyId = "KEY9527ABC";                  // .p8 密钥文件自己的 ID
        String p8FilePath = "/path/to/AuthKey_KEY9527ABC.p8"; // .p8 文件的绝对路径
        
        String bundleId = "com.jianding.app";         // App 的唯一包名 (apns-topic)
        String deviceToken = "00fc13adff785122b4ad...";   // 目标测试手机的 Token

        ApnsClient apnsClient = null;
        try {
            // 2. 库在底层会自动读取 .p8 并用算法计算出 JWT 加密签名
            ECPrivateKey privateKey = TokenUtil.loadPrivateKeyFromP8File(new File(p8FilePath));
            
            apnsClient = new ApnsClientBuilder()
                    .setSigningKey(privateKey, teamId, keyId) // 注入密钥三件套
                    .setApnsServer(ApnsClientBuilder.DEVELOPMENT_SERVER) // 指定沙盒测试环境
                    .build();

            // 3. 组装标准 JSON 内容
            String payload = "{\"aps\":{\"alert\":{\"title\":\"发货通知\",\"body\":\"使用Pushy + .p8 发射成功！\"},\"sound\":\"default\"}}";

            // 4. 打包发送对象
            SimpleApnsPushNotification notification = new SimpleApnsPushNotification(deviceToken, bundleId, payload);

            // 5. 异步发送并等待结果
            CompletableFuture<PushNotificationResponse<SimpleApnsPushNotification>> future = apnsClient.sendNotification(notification);
            PushNotificationResponse<SimpleApnsPushNotification> response = future.get();

            if (response.isAccepted()) {
                System.out.println("【成功】通过 .p8 成功送达苹果网关！");
            } else {
                System.err.println("【失败】原因: " + response.getRejectionReason());
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (apnsClient != null) { apnsClient.close(); }
        }
    }
}

import javax.net.ssl.KeyManagerFactory;
import javax.net.ssl.SSLContext;
import java.io.FileInputStream;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.security.KeyStore;
import java.time.Duration;

public class RawApnsJavaP12 {
    public static void main(String[] args) {
        // 1. 准备向 iOS 同学索要的【.p12 原材料】
        String p12FilePath = "/path/to/aps_development.p12"; // .p12 证书路径
        String p12Password = "123456";                        // 证书密码
        
        String bundleId = "com.jianding.app";                 // App 的唯一包名
        String deviceToken = "00fc13adff785122b4ad...";       // 目标测试手机的 Token

        // 苹果测试环境 URL 路径
        String apnsUrl = "https://api.sandbox.push.apple.com/3/device/" + deviceToken;

        try {
            // 2. 安全层：将 .p12 证书直接加载进 Java 底层的 TLS 握手上下文中
            KeyStore keyStore = KeyStore.getInstance("PKCS12");
            try (FileInputStream fis = new FileInputStream(p12FilePath)) {
                keyStore.load(fis, p12Password.toCharArray());
            }

            KeyManagerFactory kmf = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
            kmf.init(keyStore, p12Password.toCharArray());

            SSLContext sslContext = SSLContext.getInstance("TLS");
            sslContext.init(kmf.getKeyManagers(), null, null);

            // 3. 协议层：创建强制支持 HTTP/2 的 Java 原生 HttpClient
            HttpClient client = HttpClient.newBuilder()
                    .sslContext(sslContext)              // 注入绑定了证书的安全上下文
                    .version(HttpClient.Version.HTTP_2)  // 强制指定 HTTP/2 协议
                    .connectTimeout(Duration.ofSeconds(10))
                    .build();

            // 4. 数据层与请求构建
            String jsonPayload = "{\"aps\":{\"alert\":{\"title\":\"发货通知\",\"body\":\"纯原生 Java + .p12 发射成功！\"},\"sound\":\"default\"}}";

            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(apnsUrl))
                    .timeout(Duration.ofSeconds(5))
                    .header("apns-topic", bundleId)      // 必填：告诉苹果发给哪个 App
                    .header("apns-push-type", "alert")    // 必填：弹窗类型
                    .POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
                    .build();

            // 5. 发送并处理状态码
            System.out.println("原生 HTTP/2 投递中...");
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                System.out.println("【大获成功】苹果响应 200 OK，手机已弹窗！");
            } else {
                System.err.println("【投递失败】错误详情: " + response.body());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}