问题解决秘籍

1.遇到问题，第一个请登录苹果开发者官网

检查一遍账号是否有权限，是否被停用，是否过期，是否有协议需要同意，并且在右上角切换账号后

检查所有关联的账号是否工作正常，apple账号的邮箱也是个重要的地方，当有ipa上传，账号有发

生变化，被停用，apple经常发送一些邮件，去检查邮件通知，根据邮件通知修改调整。只有账号正

常没问题,功能才能正常使用。apple开发常用的3个网址:

• 开发者中心 ： https://developer.apple.com/account/
• app管理中心： https://appstoreconnect.apple.com/
• apple ID管理中心： https://appleid.apple.com/

2.工具只是提高工作效率，不要想着使用工具来突破apple限制，或者实现apple本

身没有的功能。常见的例如没给apple 688年费就想着软件上架，想长期有效突破

apple 7天的限制，想着不受苹果限制的证书期限，设备数量限制等，都是异想天

开，这是不可能的。

登录失败

弹出空白错误提示，请下载最新版本的appuploader试试，或者删除appuploader

目录下的data目录试试收不到短信，请在发送类型地方选择短信类型，选择自己能

收短信的号码，并且一天之内有总短信数量限制，没用超过数量登录的时候如果没

给apple 688费用的，请勾选未支付688，否则登录进去后会提示免费账号，这个提

示不是说没激活appuploader的意思。

don’t have access,提示没权限或同意协议

下面几个错误是是因为苹果更新了协议，请登录苹果官网同意协议。

下面这个提示可能是账号过期，或者被停用，或者没付费688给apple，或者有协议

需要更新。解决办法就是登录apple网站，确保账号正常。

苹果协议更新的常见的3个网址，每个网址都需要进去检查一遍，检查完了点击右上

角的切换账号按钮，再进去检查一遍，检查完了点击右上角的切换账号按钮，再进

去检查一遍，检查完了点击右上角的切换账号按钮，再进去检查一遍，重要的事情

说3遍开发者中心 ：

• 开发者中心 ： https://developer.apple.com/account/
• app管理中心： https://appstoreconnect.apple.com/
• apple ID管理中心： https://appleid.apple.com/

上传后在app管理中心找不到版本提交

上传后出现下面的图，success表示已经上传成功了。上传成功后apple会经过几分

钟到几个小时的时间检测你的ipa是否有问题，检测完后会发送一封邮件到你的

apple账号对应的邮箱，上传完后请登录邮箱查看邮件，特别留意垃圾邮箱是否有

apple发过来的邮件。如果apple检测到ipa有问题，是不会出现在app管理后台中

的，就会出现大家经常遇到的在apple app管理中心找不到版本

不是等待上传状态

这是因为bundle id不正确导致的。修改ipa里面的bundle id，或者在app 管理中

心https://appstoreconnect.apple.com/apps

修改app的套装id未ipa的 bundle id。如下图例子，则ipa里面的bundle id必须

是com.jia.netjia,保持一致就不会报此错误。

提示已经上传过包

在开发工具里面修改build version，hbuilder里面叫应用版本号，把此数字调大

一个数，然后重新编译app，再上传

上传提示tcpPort or udpPorts错误

网络问题导致，可以切换通道2试试，通道2不支持中文目录和中文，特殊字符等文

件名称。或者试试换网络试试。遇到此错误第一个请确保工具是最新的，不是最新

的或不确定是不是最新的就重新下载工具后再试试。

如果还是出现此错误，请尝试 关闭防火墙，或者换一个网络，例如wifi，或者手机

热点之类，因为这个是提示网络连接端口被禁止了。

[2021-12-23 15:10:19 CST] <Thread-15> ERROR: There was a general exception while executing
[2021-12-23 15:10:19 CST] <Thread-15> ERROR: An exception has occurred: either tcpPorts or udpPorts must be non-empty

上传提示已经有进程在上传

这是因为之前上传失败，软件出现异常导致。关闭软件重新尝试。如果还不行，在

提示的文字中有一个文件，这个文件名字带token，找到他的完整路径，然后把这个

文件删除了，然后重新再试应该就可以了。如果不会，则重启电脑或者换个电脑试

试也可能能修复

保存上传专用密码提示错误

上传专用密码不是apple账号的密码，他是在https://appleid.apple.com/里面点击

app-specific密码生成的一个字符串，这个密码主要是用来给上传ipa使用。点击

专用密码设置界面的汉字可以查看更多帮助 https://support.apple.com/zh-cn/HT204397

上传专用密码记住失败

当未登录apple账号密码，直接使用上传专用密码上传时，这个信息是不会保存的，

如果希望保存，请先点击其他按钮，弹出登录框后登录apple账号密码，然后再设置

上传专用密码，这样就会记住密码了。

编译app失败提示错误

这是因为软件发布的时候使用的证书不是发布证书,在工具里面制作一个证书选择

ios distribution 类型或者apple distribution 类型。

编译提示描述文件和证书不匹配

这个是因为选错了描述文件(.mobileprofile文件)，或者描述文件制作的时候没有

勾选对应的证书，导致描述和证书不一致不匹配，重新选择或者制作描述文件或者

证书

编译提示不包含权限

这个是因为apple id未开启apple登录授权功能，可以选择在开发工具里面关闭app

的apple登录功能，或者登录apple开发者中心

然后点击对应的apple app bundle id，找到Sign In with Apple ，开

启，然后重新制作描述文件，重新下载描述文件，然后重新编译app。 当然类似的

还有提示没有推送权限，那就开启推送权限后重新编译app

安装提示验证失败

这是因为ipa不是使用开发证书编译，或者开发证书描述文件里面没有加入当前设备

的udid。在工具或者apple官网添加设备的udid后，重新制作描述文件，重新下载

描述文件，并重新编译app后再试。

安装弹出空白错误

此错误是因为手机和电脑连接出现了错误，一般拔出usb连接，重新连接试试，或者

点击返回后再进入这个界面看看是否修复

证书下载失败提示未使用kxapp服务同步

工具里面只能下载使用工具制作的证书，制作证书时如果取消勾选使用kxapp服务同

步，则只能手动自己管理在不同电脑之间传输。如果需要任意电脑下载，删除证书

在工具appuploader里面重新制作，并且勾选使用kxapp服务同步

提示免费账号，无法使用

上传appstore，制作带推送功能的证书，描述，都需要支付688给apple后才能使

用。免费的账号/过期账号，只能制作7天免费的app。登录账号界面勾选未支付>免

费的账号/过期账号，只能制作7天免费的app。登录账号界面勾选未支付 688可以开发软件，但是不能上传。

怎么获取appuploader免费试用功能

下载后直接使用apple账号登录就自动获得7天免费试用时间，无需其他操作。每个

账号只有一次试用时间，不是7天过后又7天。

登录失败

弹出空白错误提示，请下载最新版本的appuploader试试，或者删除appuploader

目录下的data目录试试，收不到短信，请在发送类型地方选择短信类型，选择自己

能收短信的号码，并且一天之内有总短信数量限制，没用超过数量，登录的时候如

果没给apple 688费用的，请勾选未支付688，否则登录进去后会提示免费账号，这

个提示不是说没激活appuploader的意思。

已经上架的版本失效了，可以恢复吗

不可恢复，只能重新上传APP

上传的版本一直没有更新出来

看看垃圾邮箱是否有邮件，没有的话修改编译版本号重传

提示失败时出现未知错误，请重试

1.首先更新软件到最新版本

2.检查开发者账号是否过期了

3.没支付688的是无法提交上架的

688（99美金）跟168的区别

1. 688是支付apple的，拥有苹果开发者账号可以上架，没支付688的是无法提交上架的

2. 168激活码是用于appuploder过期了激活工具，然后appuploder工具可以正常使用

苹果官网可以登录，但是appuploder登录提示账号错误

账号和密码都区分大小写，appleid.apple.com直接复制账号。

苹果app无法验证其完整性错误

苹果app无法验证其完整性是因为app的签名或者证书掉了导致的，用户只需要去手机设置找到通用描述文件，安装描述文件就可以了。
1、打开手机设置，点击通用
2、选择描述文件，点击安装描述文件即可以上就是苹果手机app无法验证其完整性怎么办的内容

ios上架SDK版本问题

英文：

提示如下内容：

SDK Version Issue. This app was built with the iOS 15.2 SDK. Starting April 2023, all iOS apps submitted to the App Store must be built with the iOS 16.1 SDK or later, included in Xcode 14.1 or later. (90725)

SDK版本问题。此应用程序是使用IOS 15.2 SDK构建的。从2023年4月开始，提交到应用商店的所有iosapp都必须使用IOS 16.1 SDK或更高版本构建，包括Xcode 14.1或更高版。

解决方法：这是警告，不影响审核，官方正在升级打包机，直接下一步操作即可。

SDK问题解决

sdk问题。更新开发工具，修改打包版本号，重新编译ipa

无法提交，显示网络问题

两小时了没有上传成功

使用老通道试试， 或者使用手机热点， 这个是因为网络问题导致的

提示找不到提交的IPA文件

解决方法：

1.检查工具是不是最新版本，如果不是，更新到最新版本

2.使用软件时先把软件解压后执行，不要直接在zip里双击启动

添加描述文件的时候不显示添加过的设备

1.点击设备管理查看状态，我们可以看到是状态那栏显示 ineligible（审核中）

2.到苹果官网找到对应的设备管理，可以查看具体还需要审核多久

登录验证码错误

重启一下工具，验证码可能会延迟，不要频繁输入，不然可能输入的都是上一次的

提示profile文件不支持推通知功能，但manifest.json中选择了Fush(消息推送)模块，请重新生成profile文件或去除Push模块

开发者后台开通push权限后重新制作描述文件，apple开发者中心对bundle id设置

IOS上传后描述文件就失效了是正常的吗？并且上架成功后用户从应用市场下载的APP打不开，APP打不开和描述文件失效有关系吗？

说明无效了，需要重新制作，上架后和描述文件就没关系了