1. 遇到問題，第一個請登入蘋果開發者官網 檢查一遍賬號是否有許可權，是否被停用，是否過期，是否有協議需要同意， 並且在右上角切換賬號後檢查所有關聯的賬號是否工作正常，apple賬號的郵箱也是個重要的地方，當有ipa上傳，賬號有發生變化，被停用，apple經常傳送一些郵件，去檢查郵件通知，根據郵件通知修改調整。只有賬號正常沒問題,功能才能正常使用。apple開發常用的3個網址: 開發者中心 ：  https://developer.apple.com/account/app管理中心：  apple ID管理中心： 

2. 工具只是提高工作效率，不要想著使用工具來突破apple限制，或者實現apple本身沒有的功能。 常見的例如沒給apple 688年費就想著軟體上架，想長期有效突破apple 7天的限制，想著不受蘋果限制的證照期限，裝置數量限制等，都是異想天開，這是不可能的。

彈出空白錯誤提示，請下載最新版本的appuploader試試，或者刪除appuploader目錄下的data目錄試試 收不到簡訊，請在傳送型別地方選擇簡訊型別，選擇自己能收簡訊的號碼，並且一天之內有總簡訊數量限制，沒用超過數量

登入的時候如果沒給apple 688費用的，請勾選未支付688，否則登入進去後會提示免費賬號，這個提示不是說沒啟用appuploader的意思。

最新版本部分電腦有相容問題，可以下老一點的版本(帶數字標記的是老版本)，例如appuploader_win_0608.zip 

下面幾個錯誤是是因為蘋果更新了協議，請登入蘋果官網同意協議。

下面這個提示可能是賬號過期，或者被停用，或者沒付費688給apple，或者有協議需要更新。解決辦法就是登入apple網站，確保賬號正常。

蘋果協議更新的常見的3個網址，每個網址都需要進去檢查一遍， 檢查完了點選右上角的切換賬號按鈕，再進去檢查一遍，檢查完了點選右上角的切換賬號按鈕，再進去檢查一遍，檢查完了點選右上角的切換賬號按鈕，再進去檢查一遍，重要的事情說3遍開發者中心 ：  https://developer.apple.com/account/app管理中心：  apple ID管理中心：  證照管理中心  https://developer.apple.com/account/resources/certificates/list

 

上傳後出現下面的圖，success表示已經上傳成功了。上傳成功後apple會經過幾分鐘到幾個小時的時間檢測你的ipa是否有問題，檢測完後會傳送一封郵件到你的apple賬號對應的郵箱，上傳完後請登入郵箱檢視郵件，特別留意垃圾郵箱是否有apple發過來的郵件。如果apple檢測到ipa有問題，是不會出現在app管理後臺中的，就會出現大家經常遇到的在apple app管理中心找不到版本

 

這是因為bundle id不正確導致的。修改ipa裡面的bundle id，或者在app 管理中心 修改app的套裝id未ipa的 bundle id。如下圖例子，則ipa裡面的bundle id必須是com.jia.netjia,保持一致就不會報此錯誤。 

在開發工具裡面修改build version，hbuilder裡面叫應用版本號，把此數字調大一個數，然後重新編譯app，再上傳 

 

網路問題導致，可以切換通道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賬號的密碼，他是在 裡面點選app-specific密碼生成的一個字串，這個密碼主要是用來給上傳ipa使用。點選專用密碼設定介面的漢字可以檢視更多幫助 

 

當未登入apple賬號密碼，直接使用上傳專用密碼上傳時，這個資訊是不會儲存的，如果希望儲存，請先點選其他按鈕，彈出登入框後登入apple賬號密碼，然後再設定上傳專用密碼，這樣就會記住密碼了。

 

這是因為軟體釋出的時候使用的證照不是釋出證照,在工具裡面製作一個證照選擇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連線，重新連線試試，或者點選返回後再進入這個介面看看是否修復 

 

可以下載最新版本的appuploader，新版本不再需要icloud，如果因為無法啟動最新版本用的老版本需要安裝icloud。但是獲取裝置udid還是需要安裝驅動程式的。

安裝icloud，並且下載apple官網版本，不要從windows store下載安裝  如果失效請從下面地址進入然後選擇 在 Windows 7 和 Windows 8 上，您可以從 Apple 網站下載 Windows 版 iCloud。 

apple的驅動在itunes 內包含，如果安裝icloud後還提示錯誤，請安裝itunes windows版本，就會自動安裝驅動

 

工具裡面只能下載使用工具製作的證照，製作證照時如果取消勾選使用kxapp服務同步，則只能手動自己管理在不同電腦之間傳輸。如果需要任意電腦下載，刪除證照在工具appuploader裡面重新制作，並且勾選使用kxapp服務同步 

 

上傳appstore，製作帶推送功能的證照，描述，都需要支付688給apple後才能使用。免費的賬號，只能製作7天免費的app。登入賬號介面勾選未支付 688可以開發軟體，但是不能上傳。

 

下載後直接使用apple賬號登入就自動獲得7天免費試用時間，無需其他操作。每個賬號只有一次試用時間，不是7天過後又7天。

IOS開發工具官網地址 

最新版本已經最佳化了沒支付688給apple的賬號登入流程，無需再安裝其他軟體。部分電腦最新版本無法啟動，請下載老版本。

 appuploader_win_0608.zip 在appuploader官網首頁下載，如果您是windows電腦，則選擇點選 windows版，如果是mac 電腦則選擇 mac版 下載後解壓到電腦中就安裝完成了。

windows系統裡面，解壓後雙擊appuploader.exe就可以直接執行了。 儘量不要放c盤，不要放帶中文路徑的盤。如果不行可以右擊然後選擇管理員執行試試。 

如果是在mac或者linux電腦中，需要使用命令列，對appuploader修改許可權。 在appuploader解壓後的目錄，開啟命令列工具，執行下面的命令，使appuploader具備可執行許可權。就可以雙擊啟動了。

sudo chmod -R 777 ./*

不會命令列的也可以試試，把各項許可權都改查可執行。 

有些電腦可能會對runtime下的元件進行許可權控制，導致無法呼叫元件，例如無法上傳，可以雙擊執行下試試是否被系統許可權阻止，正常會是一個黑色框一閃而過，如果系統提示許可權錯誤，則放開許可權，允許執行。

安裝測試，自動讀取裝置udid需要安裝蘋果手機驅動，驅動下載地址。部分電腦缺少程式執行的基本庫，可以安裝驅動解決。下載後把資料夾內的exe都安裝後重啟工具。 

如果是未支付688的apple賬號，還需要安裝icloudicloud下載地址：  

這個密碼不是賬號密碼，而是一個保護證照的密碼，是p12檔案的密碼，此密碼設定後沒有其他地方可以找到，忘記了只能刪除證照重新制作，所以請務必記住密碼。還有為了安全起見，密碼不要太簡單。證照名稱是你為了在證照列表裡面便於區別的一個字元，自己好辨識就可以，儘量是是字母和數字之類

 帶distribution的是釋出型別，帶development的是開發型別。
 apple型別=ios+mac，所以開發時選擇ios app development和apple development 型別都是可以的

只有部分型別的證照需要選擇bundle id，例如推送證照。因為大部分證照是不和app關聯的。而是透過描述檔案profile檔案關聯app。

如果期望製作好證照後在其他電腦上同樣可以下載到這個證照，或者和你同事同步此證照，則需要勾選使用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)

其他證照不是很常用，可以自行百度各種證照說明

1. 雙擊appuploader.exe 啟動appuploader

2. 點選底部的未登入，彈出登入框

3. 在登入框內輸入apple開發者賬號

4. 如果沒有apple開發者賬號，只是普通的apple賬號，請勾選上未支付688

5. 然後軟體會提示輸入驗證碼，點選驗證，驗證成功就可以使用各項功能了 最新版本已經最佳化了未支付688給apple的賬號的登入流程，無需再安裝其他軟體，可以直接

為了安全，賬號必須開啟驗證碼驗證功能，才能使用appuploader，啟用驗證碼功能請前往   ,在賬號管理裡面可以設定密保手機。

驗證碼輸入介面留意是簡訊還是裝置碼，如果是收到了簡訊則選擇簡訊，如果是裝置碼則選擇裝置碼。

每天驗證碼數量是有限制的，如果不斷髮送，賬號會被限制登入，所以不要快速不斷的點選傳送。如果提示驗證碼傳送次數過多，則需要等待第二天再試了。

如果您只有上傳許可權，沒有賬號的其他許可權，也沒有賬號的密碼，可以透過上傳專用密碼登入。 開啟軟體後點選 選擇ipa 或者選擇截圖 按鈕，會彈出直接輸入上傳專用密碼登入功能，此方法登入後只能上傳ipa和截圖，無法進行其他的證照管理之類的功能。並且此方法登入後，賬號和上傳密碼不會被記住，每次開啟軟體都需要重新輸入。

沒支付費用給apple的賬號，或者過期的賬號，沒有正常的開發者許可權，只有非常有限的開發測試許可權功能。 限制比較多，例如無法進行上傳上架，無法建立釋出證照，app無法使用推送功能，測試裝置最多3個，有效期最多7天等等。但是進行普通的開發和安裝到自己手機進行測試還是可以的。

登入的時候需要，勾選未支付688選項，登入進去後，管理證照的時候也只有開發證照一種型別。免費賬號，在登入appuploader之前，需要下載icloud，並且登入icloud，確保賬號是ok的 。 icloud下載地址：  。安裝icloud，並且 下載apple官網版本，不要從windows store下載 ,您可以從 Apple 網站下載 Windows 版 iCloud。

在主介面上點選描述檔案按鈕。 

然後點選新建，然後輸入描述檔名稱，描述檔名稱字元和數字，自己好辨識就可以。然後選擇描述檔案型別，再選擇bundle ID，如果沒有bundle id，可以點選 彈出框框下面的新增bundle 按鈕， bundle id也叫app id，app和描述檔案繫結，不和證照繫結，所以每個app有一個單獨的描述檔案，但是很多app可以公用一個證照。

如果全部證照旁邊沒有證照 可能的原因

1. 沒有建立證照

2. 證照是ios push型別

3. 證照和描述檔案不匹配，例如證照是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都會發郵件

 點選進入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檔案，上傳不了

下一篇 2022 ios APP最新開發測試教程2022 ios APP最新開發測試教程

1.本文詳細介紹最新的在windows上進行ios app開發編譯打包安裝到手機測試的完整流程。介紹ios開發經常遇到的問題和解

決方法，包括ios開發證照，ios開發描述檔案等。

2.Apple開發常用的三個網址：

開發者中心：   https://developer.apple.com/account/

App 管理中心： 

App ID管理中心：

Ios開發助手工具：

App Uploader下載安裝

1.進入App Uploader官網下載下載地址： 最新版下載地址：

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沒有新增進入描述檔案，則需要新增描述檔案後重新編譯。