备案字段</th>	iOS 对应信息</th></tr></thead>
App 包名 / iOS 应用标识符</td>	Bundle ID</td></tr>
公钥 / 平台公钥</td>	Apple Distribution 证书公钥</td></tr>
签名 MD5 / SHA-1</td>	iOS 填证书 SHA-1</td></tr> </tbody></table> 注意：</p> Android 通常填 MD5。</li> iOS 通常填 SHA-1。</li> 不要把 Android 的 MD5 填到 iOS。</li> 不要把推送证书、公钥 `.p8</code>、登录私钥当成备案公钥。</li>` Bundle ID、公钥、SHA-1 要来自同一个要上架的 App 和签名证书。</li> </ul> 十二、App Store Connect 里填写 ICP 编号#</a> </h2> 备案通过后，会拿到 ICP 备案号。</p> 进入：</p> https://appstoreconnect.apple.com </span></code></pre> 找到对应 App：</p> App 信息 -> 在中国大陆的供应情况 </span></code></pre> 按页面要求填写 ICP 备案信息。</p> 这里要注意：</p> App Store Connect 里的 App 名称、开发者主体、备案主体信息要尽量保持一致。</li> 简体中文 App 信息要和备案信息一致。</li> 如果没有配置简体中文，本地化信息要和主要语言里的备案信息一致。</li> 游戏、新闻、出版、宗教等类型可能还要额外许可证。</li> </ul> 十三、常见问题#</a> </h2> 1. 证书里看不到私钥怎么办？#</a> </h3> 说明当前 Mac 没有这个证书对应的私钥。</p> 解决办法：</p> 去生成 CSR 的那台 Mac 导出 .p12</code></li> 或者重新生成 CSR</li> 重新创建 Apple Distribution 证书</li> 重新生成描述文件</li> </ol> 2. SHA-1 和公钥用开发证书还是发布证书？#</a> </h3> 备案和上架一般用发布证书，也就是 Apple Distribution</code>。</p> 不要用 Apple Development</code> 证书去填生产 App 的备案信息。</p> 3. Bundle ID 可以改吗？#</a> </h3> 如果 App 已经在 App Store Connect 创建并上传过构建版本，Bundle ID 基本就不能改了。</p> 如果还没上传，可以重新建 App ID，但要同步修改 Xcode、描述文件、云打包配置。</p> 4. p12 密码忘了怎么办？#</a> </h3> .p12</code> 密码忘了无法找回。</p> 如果钥匙串里还有证书和私钥，可以重新导出一份 .p12</code> 并设置新密码。</p> 如果私钥也没了，就重新创建证书。</p> 5. 备案平台提示 SHA-1 格式错误怎么办？#</a> </h3> 先确认是不是填了证书 SHA-1，而不是 App 文件的哈希。</p> 再尝试两种格式：</p> AA:BB:CC:DD... </span></code></pre> 或：</p> AABBCCDD... </span></code></pre> 不同备案服务商的输入校验不完全一样。</p> 十四、给开发和客户的资料清单#</a> </h2> 可以按下面这个清单交付：</p> App 名称： </span>开发者主体： </span>Bundle ID： </span>证书名称： </span>Team ID： </span>SHA-1： </span>公钥： </span>p12 文件： </span>p12 密码： </span>mobileprovision 文件： </span></code></pre> 建议把 .p12</code>、密码分开传，不要放在同一个聊天窗口里。</p> 十五、参考入口#</a> </h2> Apple Developer：https://developer.apple.com/account</li> App Store Connect：https://appstoreconnect.apple.com</li> 阿里云 App 备案特征信息说明：https://help.aliyun.com/zh/icp-filing/basic-icp-service/user-guide/fill-in-app-feature-information</li> 腾讯云 App 备案特征信息说明：https://cloud.tencent.com/document/product/243/97789</li> Apple App 信息说明：https://developer.apple.com/cn/help/app-store-connect/reference/app-information/app-information</li> </ul> 小结#</a> </h2> iOS App 备案最容易混淆的是证书相关信息。记住这几个对应关系就行：</p> Bundle ID = iOS App 唯一标识 </span>公钥 = Apple Distribution 证书里的公钥 </span>SHA-1 = Apple Distribution 证书的 SHA-1 指纹 </span>p12 = 证书 + 私钥，用来打包 </span>mobileprovision = Bundle ID + 证书 + 权限配置，用来描述签名范围 </span></code></pre> 备案前先把 Bundle ID、证书、描述文件统一好，后面打包、备案、上架都会省很多事。</p> IOS app发布更新 2025-11-11T00:00:00+00:00 前几天新打包iOS app，打算提交一下审核。结果登错账号了，找不着入口。后来才发现等错账号里，有点可笑。#</a> </h2> 首先需要打包#</a> </h3> 打包时版本号必须更新，要不然又得重新打包一次，浪费时间</li> 在appstore的https://appstoreconnect.apple.com/apps 页面新建版本，然后通过Tranporter软件（苹果自家的）上传我们打包好的新版本。</li> 创建新版本页面选择我们上传的版本，填写更新信息后就可以提交审核了。</li> 审核信息在手机上通过Connnet app可以查看。我选择得是审核通过后自动发布。</li> </ol>

iOS App 备案需要的 Bundle ID、公钥、SHA-1 和证书制作

2026-05-18T00:00:00+00:00

iOS App 做国内 App 备案时，平台一般会要求填写 App 的特征信息，常见包括：</p>

Bundle ID
</span>公钥
</span>SHA-1
</span></code></pre>
这几个信息都和苹果开发者账号里的证书、标识符有关。这里记录一下从创建 Bundle ID、制作证书，到获取公钥和 SHA-1 的完整流程。</p>
一、先分清几个概念#</a>
</h2>
1. Bundle ID#</a>
</h3>
Bundle ID 是 iOS App 的唯一标识，类似 Android 的包名。</p>
常见格式：</p>
com.company.appname
</span></code></pre>
例如：</p>
com.example.mall
</span></code></pre>
备案时填写的 Bundle ID，要和 App Store Connect、Xcode 项目、打包使用的描述文件保持一致。</p>
2. 公钥#</a>
</h3>
备案里说的公钥，一般是签名证书里的 Public Key。它用于识别 App 签名证书。</p>
注意：这里不是 Apple Push Notification 的推送 Key，也不是 Sign in with Apple 的私钥 .p8</code>。</p>
3. SHA-1#</a>
</h3>
iOS 备案里的 SHA-1，一般指苹果签名证书的 SHA-1 指纹，通常是 16 进制格式。</p>
常见格式长这样：</p>
AA:BB:CC:DD:EE:FF:11:22:33:44:55:66:77:88:99:00:AA:BB:CC:DD
</span></code></pre>
有些备案平台填写时可以带冒号，有些平台要求去掉冒号。如果提交失败，就把冒号去掉再试：</p>
AABBCCDDEEFF11223344556677889900AABBCCDD
</span></code></pre>
二、需要准备什么#</a>
</h2>
1. Apple Developer Program 账号
</span>2. Mac 电脑
</span>3. 钥匙串访问 Keychain Access
</span>4. App 的 Bundle ID
</span>5. Apple Distribution 证书
</span>6. App Store 描述文件 .mobileprovision
</span></code></pre>
如果只是备案，核心是拿到 Bundle ID</code>、证书 公钥</code>、证书 SHA-1</code>。</p>
如果还要打包上架，还需要 .p12</code> 证书和 .mobileprovision</code> 描述文件。</p>
三、创建 Bundle ID#</a>
</h2>
登录苹果开发者后台：</p>
https://developer.apple.com/account
</span></code></pre>
进入：</p>
Certificates, Identifiers & Profiles
</span></code></pre>
创建步骤：</p>

左侧选择 Identifiers</code></li>
点击 +</code></li>
选择 App IDs</code></li>
类型选择 App</code></li>
填写描述，例如 Mall App</code></li>
填写 Bundle ID，例如 com.example.mall</code></li>
勾选 App 需要的能力，例如 Push Notifications、Associated Domains、Sign in with Apple</li>
保存</li>
</ol>
创建完成后，在 Identifiers</code> 列表里看到的 IDENTIFIER</code> 就是备案要填的 Bundle ID。</p>
如果项目已经存在，也可以在 Xcode 里查看：</p>
Target -> Signing & Capabilities -> Bundle Identifier
</span></code></pre>
或者看 Info.plist</code> / 构建配置里的：</p>
PRODUCT_BUNDLE_IDENTIFIER
</span></code></pre>
四、创建证书请求 CSR#</a>
</h2>
在 Mac 上打开：</p>
钥匙串访问
</span></code></pre>
菜单栏选择：</p>
钥匙串访问 -> 证书助理 -> 从证书颁发机构请求证书
</span></code></pre>
填写：</p>
用户电子邮件地址：你的 Apple ID 邮箱
</span>常用名称：公司名或开发者名
</span>CA 电子邮件地址：留空
</span>请求是：存储到磁盘
</span></code></pre>
保存后会得到一个文件：</p>
CertificateSigningRequest.certSigningRequest
</span></code></pre>
这个 CSR 文件用来在苹果开发者后台创建证书。</p>
注意：生成 CSR 的同时，Mac 钥匙串里会生成一把对应的私钥。后面导出 .p12</code> 时必须在同一台 Mac 上操作，或者确保私钥已经同步到了当前 Mac。</p>
五、创建 Apple Distribution 证书#</a>
</h2>
登录：</p>
https://developer.apple.com/account
</span></code></pre>
进入：</p>
Certificates, Identifiers & Profiles -> Certificates
</span></code></pre>
创建步骤：</p>

点击 +</code></li>
选择 Apple Distribution</code></li>
上传刚才生成的 .certSigningRequest</code></li>
点击生成</li>
下载证书文件</li>
</ol>
下载后通常是：</p>
distribution.cer
</span></code></pre>
双击这个 .cer</code> 文件，系统会导入到钥匙串。</p>
在钥匙串里应该能看到类似这样的证书：</p>
Apple Distribution: 公司名称 (TEAMID)
</span></code></pre>
如果证书左侧有一个小三角，展开后能看到私钥，说明这台 Mac 上有对应私钥，可以正常导出 .p12</code>。</p>
如果没有私钥，后面打包会有问题，需要回到生成 CSR 的那台 Mac 上导出，或者重新生成 CSR 和证书。</p>
六、导出 p12 证书#</a>
</h2>
打开：</p>
钥匙串访问 -> 登录 -> 我的证书
</span></code></pre>
找到：</p>
Apple Distribution: 公司名称 (TEAMID)
</span></code></pre>
右键选择：</p>
导出
</span></code></pre>
文件格式选择：</p>
个人信息交换 .p12
</span></code></pre>
设置一个密码，导出后得到：</p>
ios_distribution.p12
</span></code></pre>
这个 .p12</code> 一般用于 HBuilderX、uni-app、Flutter CI、Fastlane、云打包等场景。</p>
七、创建描述文件 mobileprovision#</a>
</h2>
进入苹果开发者后台：</p>
Certificates, Identifiers & Profiles -> Profiles
</span></code></pre>
创建步骤：</p>

点击 +</code></li>
选择 App Store Connect</code></li>
选择刚才创建的 App ID / Bundle ID</li>
选择对应的 Apple Distribution</code> 证书</li>
填写 Profile 名称</li>
生成并下载</li>
</ol>
下载后得到：</p>
appstore.mobileprovision
</span></code></pre>
打包时，.p12</code> 和 .mobileprovision</code> 要对应同一个 Bundle ID 和同一个团队。</p>
八、获取 Bundle ID#</a>
</h2>
最直接的方式是在苹果开发者后台看：</p>
Certificates, Identifiers & Profiles -> Identifiers
</span></code></pre>
列表里的 IDENTIFIER</code> 就是 Bundle ID。</p>
也可以从 Xcode 看：</p>
Target -> Signing & Capabilities -> Bundle Identifier
</span></code></pre>
如果手里已经有 .ipa</code> 文件，可以先解压：</p>
unzip</span> app.ipa</span> -d</span> ipa_tmp
</span></code></pre>
然后读取：</p>
/usr/libexec/PlistBuddy -c </span>"</span>Print :CFBundleIdentifier</span>" ipa_tmp/Payload/*.app/Info.plist
</span></code></pre>
九、获取 SHA-1#</a>
</h2>
方法一：在钥匙串里查看#</a>
</h3>
打开：</p>
钥匙串访问 -> 登录 -> 证书
</span></code></pre>
找到：</p>
Apple Distribution: 公司名称 (TEAMID)
</span></code></pre>
双击证书，展开详细信息，找到：</p>
SHA-1
</span></code></pre>
复制这个值填到备案平台。</p>
方法二：用 openssl 查看#</a>
</h3>
如果你手里有苹果下载的 .cer</code> 文件，可以执行：</p>
openssl</span> x509</span> -inform</span> DER</span> -in</span> distribution.cer</span> -noout -fingerprint -sha1
</span></code></pre>
输出类似：</p>
sha1 Fingerprint=AA:BB:CC:DD:EE:FF:11:22:33:44:55:66:77:88:99:00:AA:BB:CC:DD
</span></code></pre>
等号后面的就是 SHA-1。</p>
如果备案平台不接受冒号，去掉冒号即可。</p>
十、获取公钥#</a>
</h2>
方法一：在苹果开发者后台查看#</a>
</h3>
登录苹果开发者后台：</p>
Certificates, Identifiers & Profiles -> Certificates
</span></code></pre>
点进对应的证书详情页，部分备案教程会让你在这里查看证书详情里的 Public Key / 公共密钥。</p>
如果页面显示不完整，可以先点击省略号展开；如果还是不完整，就按备案平台提示复制能显示出来的公钥内容。</p>
方法二：从证书文件导出公钥#</a>
</h3>
如果你手里有 .cer</code> 文件：</p>
openssl</span> x509</span> -inform</span> DER</span> -in</span> distribution.cer</span> -pubkey -noout
</span></code></pre>
输出类似：</p>
-----BEGIN PUBLIC KEY-----
</span>...
</span>-----END PUBLIC KEY-----
</span></code></pre>
有些备案系统要填的是完整 PEM 公钥，有些只要中间那段内容，有些平台页面会提示“10 进制或 16 进制”。实际以你提交备案的平台输入框说明为准。</p>
如果平台要求一行，可以去掉头尾和换行，只保留中间内容。</p>
十一、备案平台填写时怎么对应#</a>
</h2>
常见填写关系：</p>
备案字段</th> iOS 对应信息</th></tr></thead>

App 包名 / iOS 应用标识符</td> Bundle ID</td></tr>
公钥 / 平台公钥</td> Apple Distribution 证书公钥</td></tr>
签名 MD5 / SHA-1</td> iOS 填证书 SHA-1</td></tr>
</tbody></table>
注意：</p>

Android 通常填 MD5。</li>
iOS 通常填 SHA-1。</li>
不要把 Android 的 MD5 填到 iOS。</li>
不要把推送证书、公钥 .p8</code>、登录私钥当成备案公钥。</li>
Bundle ID、公钥、SHA-1 要来自同一个要上架的 App 和签名证书。</li>
</ul>
十二、App Store Connect 里填写 ICP 编号#</a>
</h2>
备案通过后，会拿到 ICP 备案号。</p>
进入：</p>
https://appstoreconnect.apple.com
</span></code></pre>
找到对应 App：</p>
App 信息 -> 在中国大陆的供应情况
</span></code></pre>
按页面要求填写 ICP 备案信息。</p>
这里要注意：</p>

App Store Connect 里的 App 名称、开发者主体、备案主体信息要尽量保持一致。</li>
简体中文 App 信息要和备案信息一致。</li>
如果没有配置简体中文，本地化信息要和主要语言里的备案信息一致。</li>
游戏、新闻、出版、宗教等类型可能还要额外许可证。</li>
</ul>
十三、常见问题#</a>
</h2>
1. 证书里看不到私钥怎么办？#</a>
</h3>
说明当前 Mac 没有这个证书对应的私钥。</p>
解决办法：</p>

去生成 CSR 的那台 Mac 导出 .p12</code></li>
或者重新生成 CSR</li>
重新创建 Apple Distribution 证书</li>
重新生成描述文件</li>
</ol>
2. SHA-1 和公钥用开发证书还是发布证书？#</a>
</h3>
备案和上架一般用发布证书，也就是 Apple Distribution</code>。</p>
不要用 Apple Development</code> 证书去填生产 App 的备案信息。</p>
3. Bundle ID 可以改吗？#</a>
</h3>
如果 App 已经在 App Store Connect 创建并上传过构建版本，Bundle ID 基本就不能改了。</p>
如果还没上传，可以重新建 App ID，但要同步修改 Xcode、描述文件、云打包配置。</p>
4. p12 密码忘了怎么办？#</a>
</h3>
.p12</code> 密码忘了无法找回。</p>
如果钥匙串里还有证书和私钥，可以重新导出一份 .p12</code> 并设置新密码。</p>
如果私钥也没了，就重新创建证书。</p>
5. 备案平台提示 SHA-1 格式错误怎么办？#</a>
</h3>
先确认是不是填了证书 SHA-1，而不是 App 文件的哈希。</p>
再尝试两种格式：</p>
AA:BB:CC:DD...
</span></code></pre>
或：</p>
AABBCCDD...
</span></code></pre>
不同备案服务商的输入校验不完全一样。</p>
十四、给开发和客户的资料清单#</a>
</h2>
可以按下面这个清单交付：</p>
App 名称：
</span>开发者主体：
</span>Bundle ID：
</span>证书名称：
</span>Team ID：
</span>SHA-1：
</span>公钥：
</span>p12 文件：
</span>p12 密码：
</span>mobileprovision 文件：
</span></code></pre>
建议把 .p12</code>、密码分开传，不要放在同一个聊天窗口里。</p>
十五、参考入口#</a>
</h2>

Apple Developer：https://developer.apple.com/account</li>
App Store Connect：https://appstoreconnect.apple.com</li>
阿里云 App 备案特征信息说明：https://help.aliyun.com/zh/icp-filing/basic-icp-service/user-guide/fill-in-app-feature-information</li>
腾讯云 App 备案特征信息说明：https://cloud.tencent.com/document/product/243/97789</li>
Apple App 信息说明：https://developer.apple.com/cn/help/app-store-connect/reference/app-information/app-information</li>
</ul>
小结#</a>
</h2>
iOS App 备案最容易混淆的是证书相关信息。记住这几个对应关系就行：</p>
Bundle ID = iOS App 唯一标识
</span>公钥 = Apple Distribution 证书里的公钥
</span>SHA-1 = Apple Distribution 证书的 SHA-1 指纹
</span>p12 = 证书 + 私钥，用来打包
</span>mobileprovision = Bundle ID + 证书 + 权限配置，用来描述签名范围
</span></code></pre>
备案前先把 Bundle ID、证书、描述文件统一好，后面打包、备案、上架都会省很多事。</p>


IOS app发布更新
2025-11-11T00:00:00+00:00
前几天新打包iOS app，打算提交一下审核。结果登错账号了，找不着入口。后来才发现等错账号里，有点可笑。#</a>
</h2>
首先需要打包#</a>
</h3>

打包时版本号必须更新，要不然又得重新打包一次，浪费时间</li>
在appstore的https://appstoreconnect.apple.com/apps 页面新建版本，然后通过Tranporter软件（苹果自家的）上传我们打包好的新版本。</li>
创建新版本页面选择我们上传的版本，填写更新信息后就可以提交审核了。</li>
审核信息在手机上通过Connnet app可以查看。我选择得是审核通过后自动发布。</li>
</ol>

orhan.cn - IOS

iOS App 备案需要的 Bundle ID、公钥、SHA-1 和证书制作

IOS app发布更新