如何用个人Apple ID签名IPA？求官方文档及自动重签方案

苹果官方文档说明 #

苹果提供了官方的代码签名文档，覆盖个人Apple ID签名IPA的全流程，核心内容聚焦于codesign、xcrun系列命令行工具的使用，以及个人开发者身份（普通Apple ID可免费启用，仅受7天签名有效期限制）的签名规则。这些文档可在Apple Developer官方资源库中找到，主要包含代码签名基础、设备注册、命令行签名操作这几个模块。

手动签名IPA步骤 #

• 注册设备：通过Xcode的「Window > Devices and Simulators」添加你的iPhone，或用命令xcrun devicectl device add --udid <设备UDID>完成设备绑定，这一步是签名后能安装到设备的前提。
• 获取签名身份：在终端执行security find-identity -p codesigning -v，找到标注为「Apple Development: 你的邮箱地址」的条目，复制其对应的身份ID（通常是一串哈希值）。
• 重签流程：
  1. 解压原始IPA：unzip target.ipa -d temp-dir
  2. 替换描述文件：将你获取的个人开发者描述文件（.mobileprovision）放入temp-dir/Payload/YourApp.app/目录，覆盖原文件。
  3. 执行签名：codesign -f -s "<签名身份ID>" --entitlements entitlements.plist temp-dir/Payload/YourApp.app
  4. 重新打包：cd temp-dir && zip -r signed-app.ipa Payload/ && cd ..

自动重签脚本实现 #

你可以编写Shell脚本自动检测签名有效期并完成重签、安装，核心逻辑如下：

1. 提取当前IPA的签名证书，检查过期时间；
2. 若剩余有效期不足（比如小于1天），自动执行重签流程；
3. 重签完成后自动安装到指定设备。

示例脚本：

#!/bin/bash
# 配置参数
ORIGINAL_IPA="./original.ipa"
SIGNED_IPA="./signed.ipa"
DEVICE_UDID="你的设备UDID"
APP_BUNDLE_PATH="./temp-dir/Payload/YourApp.app"

# 获取个人签名身份
SIGN_ID=$(security find-identity -p codesigning -v | grep "Apple Development" | awk '{print $2}')

# 检查签名有效期
extract_cert() {
    codesign -d -v --extract-certificates "$APP_BUNDLE_PATH" >/dev/null 2>&1
}

check_expiry() {
    extract_cert
    END_DATE=$(openssl x509 -noout -enddate -in cert.pem | cut -d= -f2)
    END_TIMESTAMP=$(date -j -f "%b %d %T %Y %Z" "$END_DATE" +%s)
    CURRENT_TIMESTAMP=$(date +%s)
    return $((END_TIMESTAMP - CURRENT_TIMESTAMP))
}

check_expiry
EXPIRY_DIFF=$?

if [ $EXPIRY_DIFF -lt 86400 ]; then
    echo "签名即将过期，启动自动重签..."
    # 解压IPA
    unzip "$ORIGINAL_IPA" -d temp-dir
    # 替换描述文件
    cp ./embedded.mobileprovision "$APP_BUNDLE_PATH/"
    # 签名
    codesign -f -s "$SIGN_ID" --entitlements ./entitlements.plist "$APP_BUNDLE_PATH"
    # 重新打包
    cd temp-dir && zip -r "../$SIGNED_IPA" Payload/ && cd ..
    # 安装到设备
    xcrun ios-deploy --bundle "$SIGNED_IPA" --udid "$DEVICE_UDID"
    echo "自动重签并安装完成"
    # 清理临时文件
    rm -rf temp-dir cert.pem
else
    echo "签名有效期充足（剩余$((EXPIRY_DIFF/86400))天），无需操作"
    rm -f cert.pem
fi

关键注意事项 #

• 普通Apple ID签名的IPA有效期固定为7天，无法延长，只能通过定期重签维持可用性；
• 必须在iPhone上开启「开发者模式」（设置 > 隐私与安全性 > 开发者模式），否则无法安装签名后的IPA；
• 描述文件必须包含目标设备的UDID，否则签名后的IPA无法在该设备上安装。

内容的提问来源于stack exchange，提问作者linpeng