Appuploader 常见错误及解决方法
问题解决秘籍
遇到问题,第一个请登录苹果开发者官网 检查一遍账号是否有权限,是否被停用,是否过期,是否有协议需要同意,并且在右上角切换账号后检查所有关联的账号是否工作正常,apple 账号的邮箱也是个重要的地方,当有 ipa 上传,账号有发生变化,被停用,apple 经常发送一些邮件,去检查邮件通知,根据邮件通知修改调整。只有账号正常没问题,功能才能正常使用。apple 开发常用的 3 个网址: 开发者中心 : Sign In - Apple
app 管理中心: https://appstoreconnect.apple.com/
apple ID 管理中心: Manage your Apple ID
工具只是提高工作效率,不要想着使用工具来突破 apple 限制,或者实现 apple 本身没有的功能。 常见的例如没给 apple 688 年费就想着软件上架,想长期有效突破 apple 7 天的限制,想着不受苹果限制的证书期限,设备数量限制等,都是异想天开,这是不可能的。
登录失败
弹出空白错误提示,请下载最新版本的 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 服务同步
提示免费账号,无法使用
上传 appstore,制作带推送功能的证书,描述,都需要支付 688 给 apple 后才能使用。免费的账号,只能制作 7 天免费的 app。登录账号界面勾选未支付 688 可以开发软件,但是不能上传。
怎么获取 appuploader 免费试用功能
下载后直接使用 apple 账号登录就自动获得 7 天免费试用时间,无需其他操作。每个账号只有一次试用时间,不是 7 天过后又 7 天。