Appuploader常见错误及解决方法

问题解决秘籍

遇到问题，首先请登录苹果开发者官网检查账号是否有权限，是否被停用，是否过期，是否有协议需要同意，并且在右上角切换账号后检查所有关联的账号是否工作正常，特别留意邮箱地址，当有ipa上传，账号有发生变化，被停用，apple经常发送一些邮件通知，去检查邮件通知并根据邮件通知修改调整。只有账号正常没问题，功能才能正常使用。以下为apple常用的三个网站:apple开发常用的3个网址: 开发者中心 ： Sign In - Apple

app管理中心： https://appstoreconnect.apple.com/

apple ID管理中心： Manage your Apple ID

工具只是提高工作效率，不要想着使用工具来突破apple限制，或者实现apple本身没有的功能。例如没给apple 688年费就想着软件上架，想长期有效突破apple 7天的限制，想着不受苹果限制的证书期限，设备数量限制等，都是异想天开，这是不可能的。

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

上传后出现下面的图，success表示已经上传成功了。上传成功后apple会经过几分钟到几个小时的时间检测你的ipa是否有问题，检测完后会发送一封邮件到你的apple账号对应的邮箱，上传完后请登录邮箱查看邮件，特别留意垃圾邮箱是否有apple发过来的邮件。如果apple检测到ipa有问题，是不会出现在app管理后台中的，就会出现大家经常遇到的在app管理中心找不到版本。

uploadsuccess

noipa

上传成功但是在app管理中心找不到版本提交的解决方法

这是因为bundle id不正确导致的。修改ipa里面的bundle id，或者在app管理中心https://appstoreconnect.apple.com/apps修改app的套装id为不同的值。如下图例子，则ipa里面的bundle id必须是com.jia.netjia,保持一致就不会报此错误。

登录失败

弹出空白错误提示，请下载最新版本的appuploader试试，或者删除appuploader目录下的data目录试试 收不到短信，请在发送类型地方选择短信类型，选择自己能收短信的号码，并且一天之内有总短信数量限制，没用超过数量

登录的时候如果没给apple 688费用的，请勾选未支付688，否则登录进去后会提示免费账号，这个提示不是说没激活appuploader的意思。

无法启动

最新版本部分电脑有兼容问题，可以下老一点的版本(带数字标记的是老版本)，例如appuploader_win_0608.zip appuploader 老版本

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

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

下面这个提示可能是账号过期，或者被停用，或者没付费688给apple，或者有协议需要更新。解决办法就是登录apple网站，确保账号正常。

苹果协议更新的常见的3个网址，每个网址都需要进去检查一遍，检查完了点击右上角的切换账号按钮，再进去检查一遍，检查完了点击右上角的切换账号按钮，再进去检查一遍，检查完了点击右上角的切换账号按钮，再进去检查一遍，重要的事情说3遍开发者中心 ： Sign In - Appleapp管理中心： https://appstoreconnect.apple.com/apple ID管理中心： Manage your Apple ID证书管理中心 Sign In - Apple

上传后在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账号的密码，他是在Manage your Apple ID里面点击app-specific密码生成的一个字符串，这个密码主要是用来给上传ipa使用。点击专用密码设置界面的汉字可以查看更多帮助 使用 App 专用密码通过 Apple ID 登录 App - 官方 Apple 支持 (中国)

上传专用密码记住失败

当未登录apple账号密码，直接使用上传专用密码上传时，这个信息是不会保存的，如果希望保存，请先点击其他按钮，弹出登录框后登录apple账号密码，然后再设置上传专用密码，这样就会记住密码了。

编译app失败提示错误

这是因为软件发布的时候使用的证书不是发布证书,在工具里面制作一个证书选择ios distribution 类型或者apple distribution 类型。

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

这个是因为选错了描述文件(.mobileprofile文件)，或者描述文件制作的时候没有勾选对应的证书，导致描述和证书不一致不匹配，重新选择或者制作描述文件或者证书

编译提示不包含权限

这个是因为apple id未开启apple登录授权功能，可以选择在开发工具里面关闭app的apple登录功能，或者登录apple开发者中心Sign In - Apple 然后点击对应的apple app bundle id，找到Sign In with Apple ，开启，然后重新制作描述文件，重新下载描述文件，然后重新编译app。 当然类似的还有提示没有推送权限，那就开启推送权限后重新编译app

安装提示验证失败

这是因为ipa不是使用开发证书编译，或者开发证书描述文件里面没有加入当前设备的udid。在工具或者apple官网添加设备的udid后，重新制作描述文件，重新下载描述文件，并重新编译app后再试。

安装弹出空白错误

此错误是因为手机和电脑连接出现了错误，一般拔出usb连接，重新连接试试，或者点击返回后再进入这个界面看看是否修复

提示安装icloud和驱动

可以下载最新版本的appuploader，新版本不再需要icloud，如果因为无法启动最新版本用的老版本需要安装icloud。但是获取设备udid还是需要安装驱动程序的。

安装icloud，并且下载apple官网版本，不要从windows store下载安装icloud地址 如果失效请从下面地址进入然后选择 在 Windows 7 和 Windows 8 上，您可以从 Apple 网站下载 Windows 版 iCloud。 下载 Windows 版 iCloud - 官方 Apple 支持 (中国)

apple的驱动在itunes 内包含，如果安装icloud后还提示错误，请安装itunes windows版本，就会自动安装驱动

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

工具里面只能下载使用工具制作的证书，制作证书时如果取消勾选使用kxapp服务同步，则只能手动自己管理在不同电脑之间传输。如果需要任意电脑下载，删除证书在工具appuploader里面重新制作，并且勾选使用kxapp服务同步