Appuploader 常见错误及解决方法
问题解决秘籍
- 遇到问题，第一个请登录苹果开发者官网 检查一遍账号是否有权限，是否被停用，是否过期，是否有协议需要同意，并且在右上角切换账号后检查所有关联的账号是否工作正常，apple账号的邮箱也是个重要的地方，当有ipa上传，账号有发生变化，被停用，apple经常发送一些邮件，去检查邮件通知，根据邮件通知修改调整。只有账号正常没问题,功能才能正常使用。apple开发常用的3个网址: 开发者中心 ： https://developer.apple.com/account/app管理中心： https://appstoreconnect.apple.com/apple ID管理中心： https://appleid.apple.com/
- 工具只是提高工作效率，不要想着使用工具来突破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遍开发者中心 ： https://developer.apple.com/account/app管理中心： https://appstoreconnect.apple.com/apple ID管理中心： https://appleid.apple.com/证书管理中心 https://developer.apple.com/account/resources/certificates/list
上传后在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开发者中心 https://developer.apple.com/account/resources/identifiers/list 然后点击对应的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。 https://support.apple.com/zh-cn/HT204283
apple的驱动在itunes 内包含，如果安装icloud后还提示错误，请安装itunes windows版本，就会自动安装驱动
证书下载失败提示未使用kxapp服务同步
工具里面只能下载使用工具制作的证书，制作证书时如果取消勾选使用kxapp服务同步，则只能手动自己管理在不同电脑之间传输。如果需要任意电脑下载，删除证书在工具appuploader里面重新制作，并且勾选使用kxapp服务同步
提示免费账号，无法使用
上传appstore，制作带推送功能的证书，描述，都需要支付688给apple后才能使用。免费的账号，只能制作7天免费的app。登录账号界面勾选未支付 688可以开发软件，但是不能上传。
怎么获取appuploader免费试用功能
下载后直接使用apple账号登录就自动获得7天免费试用时间，无需其他操作。每个账号只有一次试用时间，不是7天过后又7天。
下载和安装appuploader
IOS开发工具官网地址 http://www.applicationloader.net/
最新版本已经优化了没支付688给apple的账号登录流程，无需再安装其他软件。部分电脑最新版本无法启动，请下载老版本。
下载最新版本
下载老版本 appuploader_win_0608.zip 在appuploader官网首页下载，如果您是windows电脑，则选择点击 windows版，如果是mac 电脑则选择 mac版 下载后解压到电脑中就安装完成了。
windows启动
windows系统里面，解压后双击appuploader.exe就可以直接运行了。 尽量不要放c盘，不要放带中文路径的盘。如果不行可以右击然后选择管理员运行试试。
mac和linux 电脑启动处理
如果是在mac或者linux电脑中，需要使用命令行，对appuploader修改权限。 在appuploader解压后的目录，打开命令行工具，执行下面的命令，使appuploader具备可执行权限。就可以双击启动了。
sudo chmod -R 777 ./*
不会命令行的也可以试试，把各项权限都改查可执行。 mac电脑修改文件权限
部分功能不可用处理
有些电脑可能会对runtime下的组件进行权限控制，导致无法调用组件，例如无法上传，可以双击运行下试试是否被系统权限阻止，正常会是一个黑色框一闪而过，如果系统提示权限错误，则放开权限，允许执行。
驱动安装
安装测试，自动读取设备udid需要安装苹果手机驱动，驱动下载地址。部分电脑缺少程序运行的基本库，可以安装驱动解决。下载后把文件夹内的exe都安装后重启工具。 下载apple手机驱动apple_drivers_win.zip
如果是未支付688的apple账号，还需要安装icloudicloud下载地址：https://support.apple.com/zh-cn/HT204283 下载icloud
IOS证书制作教程
点击苹果证书 按钮
点击新增
输入证书密码，名称
这个密码不是账号密码，而是一个保护证书的密码，是p12文件的密码，此密码设置后没有其他地方可以找到，忘记了只能删除证书重新制作，所以请务必记住密码。还有为了安全起见，密码不要太简单。证书名称是你为了在证书列表里面便于区别的一个字符，自己好辨识就可以，尽量是是字母和数字之类
选择证书类型
带distribution的是发布类型，带development的是开发类型。 apple类型=ios+mac，所以开发时选择ios app development和apple development 类型都是可以的
选择bundle ID
只有部分类型的证书需要选择bundle id，例如推送证书。因为大部分证书是不和app关联的。而是通过描述文件profile文件关联app。
使用appuploader服务同步
如果期望制作好证书后在其他电脑上同样可以下载到这个证书，或者和你同事同步此证书，则需要勾选使用appuploader服务同步。否则您需要手动管理p12文件在不同电脑之间的传输，并且一但创建下载后，无法在其他电脑下载，只能手动复制文件过去。一般情况下，推荐使用appuploader服务同步。
证书类型说明
IOS开发选择apple development或者ios app development 类型ios 发布选择 apple distribution或者 ios distribution （app store and ad hoc）开发推送证书选择 apple push notification service ssl (sandbox)发布推送证书选择 apple push notification service ssl (sandbox & production)
其他证书不是很常用，可以自行百度各种证书说明
登录appuploader
常规使用登录方法
双击appuploader.exe 启动appuploader
点击底部的未登录，弹出登录框
在登录框内输入apple开发者账号
如果没有apple开发者账号，只是普通的apple账号，请勾选上未支付688
然后软件会提示输入验证码，点击验证，验证成功就可以使用各项功能了 最新版本已经优化了未支付688给apple的账号的登录流程，无需再安装其他软件，可以直接 下载最新版本
验证码说明
为了安全，账号必须开启验证码验证功能，才能使用appuploader，启用验证码功能请前往 https://appleid.apple.com ,在账号管理里面可以设置密保手机。
验证码输入界面留意是短信还是设备码，如果是收到了短信则选择短信，如果是设备码则选择设备码。
每天验证码数量是有限制的，如果不断发送，账号会被限制登录，所以不要快速不断的点击发送。如果提示验证码发送次数过多，则需要等待第二天再试了。
使用上传专用密码登录
如果您只有上传权限，没有账号的其他权限，也没有账号的密码，可以通过上传专用密码登录。 打开软件后点击 选择ipa 或者选择截图 按钮，会弹出直接输入上传专用密码登录功能，此方法登录后只能上传ipa和截图，无法进行其他的证书管理之类的功能。并且此方法登录后，账号和上传密码不会被记住，每次打开软件都需要重新输入。
未支付688给apple账号登录
没支付费用给apple的账号，或者过期的账号，没有正常的开发者权限，只有非常有限的开发测试权限功能。 限制比较多，例如无法进行上传上架，无法创建发布证书，app无法使用推送功能，测试设备最多3个，有效期最多7天等等。但是进行普通的开发和安装到自己手机进行测试还是可以的。
登录的时候需要，勾选未支付688选项，登录进去后，管理证书的时候也只有开发证书一种类型。免费账号，在登录appuploader之前，需要下载icloud，并且登录icloud，确保账号是ok的 。 icloud下载地址：https://support.apple.com/zh-cn/HT204283 下载icloud 。安装icloud，并且下载apple官网版本，不要从windows store下载 ,您可以从 Apple 网站下载 Windows 版 iCloud。
在主界面上点击描述文件按钮。
新建ios描述文件
然后点击新建，然后输入描述文件名称，描述文件名称字符和数字，自己好辨识就可以。然后选择描述文件类型，再选择bundle ID，如果没有bundle id，可以点击 弹出框框下面的添加bundle 按钮， bundle id也叫app id，app和描述文件绑定，不和证书绑定，所以每个app有一个单独的描述文件，但是很多app可以公用一个证书。
开发证书
如果全部证书旁边没有证书 可能的原因
没有创建证书
证书是ios push类型
证书和描述文件不匹配，例如证书是ios app development，但是描述文件是app store类型
解决办法是需要先去证书管理先创建好对应的证书类型
测试设备
如果选择的类型是ios app development 类型，则全部测试设备旁边必须有测试设备并且勾选上，如果没有显示测试设备，点击框框下面的添加测试，然后把测试设备的udid输入，把ios设备连接到当前pc，会自动获得设备的udid。 如果app编译后无法安装到设备，可能是因为设备的udid没有添加进入描述文件，则需要添加描述文件后重新编译。
描述文件类型说明
带app store类型的是发布类型，带development的是开发类型，push没有描述文件，所以不要问推送选择哪种描述文件类型ios开发选择ios app development类型发布app的时候选择app store类型。
AU上传ipa出现下图红框提示说明成功上传，如果App Store后台没有出现构建版本，请登录 apple账号对应的邮箱查看反馈，特别留意垃圾邮箱，无论成功还是失败，apple都会发邮件
一、首先登录iTunes Connect 后台、查看ipa构建情况
https://appstoreconnect.apple.com/ 点击进入APP，点击活动，所有构建版本选项（下图所示），有两种情况！1、ipa包没问题，显示正在处理，这种就是成功上传，（等待处理即可，一般十几分钟处理时间,偶尔也会要几个小时）2、ipa有问题，没有出现版本正在处理，或者刷新页面正在处理的版本消失（到开发者邮箱查看反馈邮件原因，反馈邮件也可能在垃圾箱）修改好苹果反馈的问题重新打包再传
二、错误反馈邮件示例及说明
错误反馈邮件示例（如下图）！如看不懂英文复制到百度翻译看下。 下图这个错误的意思是此包用开发证书打包的ipa，上架需要用发布证书打包。 当然还有其他各种各样的原因，具体复制反馈邮件翻译看下！
证书类型不正确下面这个是因为证书和描述文件不正确，发布需要选择app store 类型的描述文件和distribution类型的发布证书。
Invalid App Store Icon还有一个非常常见的一个错误（如下反馈）就是APP图标问题，不能使用透明背景，一般把图标做成圆角，圆角那边就是透明的所以不行。 苹果的图标会自动圆角的，所以不需要去改成圆角的，直接正方形的图标上传！ ITMS-90717: Invalid App Store Icon – The App Store Icon in the asset catalog in ‘AppCanPlugin.app’ can’t be transparent nor contain an alpha channel.Best regards,The App Store Team
ITMS-90717：无效的App Store图标 – “AppCanPlugin.app”资产目录中的App Store图标不能透明，也不能包含alpha频道。最好的问候，App Store团队
三、修改相关错误后重新打包版本号的修改
修改错误重新打包的时候记得加下版本号，比如你刚上传的是1.0版本，重新打包时增加下版本号如1.1，如果还是跟之前上传过相同的版本号的ipa文件，上传不了
1.本文详细介绍最新的在windows上进行ios app开发编译打包安装到手机测试的完整流程。介绍ios开发经常遇到的问题和解决方法，包括ios开发证书，ios开发描述文件等。
2.Apple开发常用的三个网址：
开发者中心： https://developer.apple.com/account/
App 管理中心： https://appstoreconnect.apple.com/
App ID管理中心： https://appleid.apple.com/
Ios开发助手工具： http://www.appuploader.net/
App Uploader下载安装
1.进入App Uploader官网下载下载地址： http://www.applicationloader.net/最新版下载地址： https://net-appuploader.oss-cn-qingdao.aliyuncs.com/appuploader_win_0728.zip
2.双击应用程序下载。
3.进入app uploader主界面
切换中文界面
1.根据步骤如图如下操作的，点击中/英文切换，弹出提示后关闭软件重新打开即可切换成功。
apple 账号登录
1.使用开发者账号登录，并且没有支付688，需要勾选‘未支付688’选项进行登录。
2.将绑定手机号收到的验证码输入即可登录。
创建ios(.p12)证书
1.点击苹果证书
2.新增苹果证书
输入证书密码：这个密码不是账号密码，而是一个保护证书的密码，是p12文件的密码
证书名称:是你为了在证书列表里面便于区别的一个字符，自己好辨识就可以，尽量是字母和数字之类。
证书类型说明：IOS开发选择apple development或者ios app development 类型ios 发布选择 appledistribution或者 ios distribution （app store and ad hoc）。
开发推送证书选择 apple push notification service ssl (sandbox),发布推送证书选择 apple push notification service ssl (sandbox & production),其他证书不是很常用，可以自行百度各种证书说明。上架版本需要 使用正式的证书(apple distribution)。
开发测试用开发证书(apple development) 一般都要创建两个证书一个用于开发，一个用 于上架，如果有支付内容，还必需要 Apple Pay 的证书。证书无需创建太多，apple对证书有数量限制，一般3个开发证书就不 让创建更多同类型的证书了。
官网遇到问题，首先登录文章开通的苹果开发官网。检查 是否有权限/是否被停用/是否过 期/是否有协议需要同意。在右上角切换账号检查所关联的账号是否功能正常。Apple邮箱会接收到许多通知消息，如IPA上 传，账号发生变化，被停用，都会有消息提示。
8.点击p12下载到电脑。
添加测试设备UDID
1.点击udid
2.连接苹果手机，即可识别出来udid
创建描述文件
1.点击描述文件
2.点击新增描述文件,在弹出框里面选择要安装测试到的设备，如果是发布类型无需选择设备。选择使用的证书，如果忘记是哪
个 了可以选择全部证书。
描述文件类型说明：带app store类型的是发布类型,带development的是开发类型,， push没有描述文件，所以不要问推送选 择哪种描述文件类型,ios开发选择ios app development类型,发布app的时候选择app store类型。（ps:除了APP Store类型的描述文件外，其他的描述文件都需要选择测试设备）
3.点击下载按钮下载桌面
测试安装App
1.以HBuilder打包Vue项目为例，打开详细设置进行设置完成后，点击保存。
2.官菜单项点击‘发行-> 云打包-打原生包’，出现如下图所示弹框，取消广告勾选，没有错误提示，选择刚才制作的p12
和.mobileprovision文件，输入刚才设置的证书密码。点击打包，等待打包未完成（仅以ios为例）
3.官打包完成后点击确定“OK”按钮查看打包状态信息，打包完成后，保存安装包到目标文件，发送到手机端安装即可运行。
测试设备：如果选择的类型是ios app development 类型，则全部测试设备旁边必须有测试设备并且勾选上，如果没有显示测试设备，点击框框下面的添加测试，然后把测试设备的udid输入，把ios设备连接到当前pc，会自动获得设备的udid。 如果app编译后无法安装到设备，可能是因为设备的udid没有添加进入描述文件，则需要添加描述文件后重新编译。
