谈一谈 IPA 上传到 App Store Connect 的几种方法
1、前言
關(guān)于上傳 ipa 包到 App Store Connect 的方法,相信有 iOS 開(kāi)發(fā)經(jīng)驗(yàn)的同學(xué),一定知道完成 App 開(kāi)發(fā)后,一般都是用 Xcode 的 Archive 打包后上傳到蘋果后臺(tái)。所以,這個(gè)就是今天要寫的水文?顯示不是吧!答案肯定不是啊,本文將給大家一個(gè)相對(duì)全面介紹。蘋果開(kāi)發(fā)的知識(shí)點(diǎn)非常多,官方文檔也很多,能夠?qū)W好學(xué)完,不一定人人能夠做到。在我的理解,iOS進(jìn)階,不是說(shuō)你必須掌握很高深的技術(shù),而是了解全面的知識(shí),能夠做出不一樣的產(chǎn)品、體驗(yàn),這個(gè)才是優(yōu)秀的開(kāi)發(fā)者!
2、Xcode
利用 Xcode 的 Archive 生成 app 包后,選擇 Distribute App ,將 App 通過(guò) Xcode 上傳到 App Store Connect 后臺(tái),這個(gè)就不多說(shuō)的,iOS 開(kāi)發(fā)都需要經(jīng)歷一下。
3、Application Loader
當(dāng)然,Xcode 這種方式,是需要有源代碼情況下,才能上傳。所以,就會(huì)有沒(méi)有源代碼的情況,怎么上傳的情況啦!
Application Loader 就是這樣一種方式:
Application Loader 是一款 Apple 工具能夠幫助您將 App 的二進(jìn)制文件上傳至 App Store。
Application Loader 上傳速度快、連接穩(wěn)定并且具備早期驗(yàn)證警告功能。
登陸界面:
主界面:
其實(shí),如果了解 Xcode 歷史的同學(xué),會(huì)知道現(xiàn)在的 Application Loader App 的功能已經(jīng)被蘋果弱化了,以前還能夠批量創(chuàng)建提交內(nèi)購(gòu)品項(xiàng)等,現(xiàn)在新版本已經(jīng)去掉了。另外,以前在蘋果開(kāi)發(fā)者官網(wǎng),有單獨(dú)的頁(yè)面,可以下載獨(dú)立版本的 Application Loader 軟件,現(xiàn)在也已經(jīng)去掉了。
可能的原因,在我看來(lái)有幾點(diǎn)。第1點(diǎn)是,單獨(dú)維護(hù)這樣一個(gè)軟件,需要人力,因?yàn)?#xff0c;如果不依賴于 Xcode,在一臺(tái)電腦只安裝了 Application Loader,那個(gè)肯定需要安裝 Command Line Tools 這個(gè)命令行工具,如果是安裝 Xcode 默認(rèn)也帶上,如果更新了 Xcode 版,也會(huì)跟隨升級(jí),所以,維護(hù) Application Loader 軟件,不只是單獨(dú)的一個(gè)應(yīng)用入口,當(dāng)然,也是因?yàn)檫@個(gè) Application Loader 做了一些早期驗(yàn)證警告:
上傳 ipa 包時(shí),工具會(huì)檢查一些要求和內(nèi)容格式等,如果不符合,就會(huì)報(bào)錯(cuò),所以,這些初步的檢查報(bào)錯(cuò),也是 Application Loader 需要維護(hù)的。
第2點(diǎn),Application Loader 需要的人并不多,站在開(kāi)發(fā)者環(huán)境,大多數(shù)開(kāi)發(fā)者負(fù)責(zé)上傳 ipa 包,另外,批量上傳內(nèi)購(gòu)品項(xiàng),一定很多人不知道,所以,蘋果也去掉了。開(kāi)發(fā)者后臺(tái)也去掉了,所以,Application Loader 現(xiàn)在是集成在 Xcode 中,說(shuō)不定,那天就直接去掉。
第3點(diǎn),越來(lái)越多的聲音,希望蘋果能通過(guò) App Store Connect 后臺(tái)能直接上傳 ipa 包、批量創(chuàng)建內(nèi)購(gòu)品項(xiàng)等功能。但根據(jù)我觀察這幾年的 WWDC,蘋果對(duì) App Store Connect 后臺(tái)進(jìn)行了比較大的改變,2022年08月23日就是對(duì) App Store Connect 和 Apple Developer 后臺(tái),2個(gè)賬號(hào)體系合并,主線上,還是整個(gè)系統(tǒng)性上,對(duì)于功能和UI界面上,不知道有沒(méi)有相關(guān)計(jì)劃。我的猜測(cè),還是有希望的。因?yàn)榻陙?lái),跨平臺(tái)開(kāi)發(fā), React Native/ Weex / Flutter,其實(shí),可以不需要依賴 Xcode、macOS 進(jìn)行開(kāi)發(fā),打包上傳 ipa 卻需要一臺(tái) macOS 和 Xcode,有一點(diǎn)不可理解?(當(dāng)然,也不排除蘋果希望大家因此,能多賣出幾臺(tái) Mac 電腦,也許我的猜測(cè)是錯(cuò)的吧,但愿~)
具體關(guān)于 Application Loader 使用方法,大家可以看看官方使用文檔,已經(jīng)非常詳細(xì),而且這幾年,蘋果很多文檔都已經(jīng)有翻譯中文版本啦!Application Loader 介紹(中文):https://help.apple.com/itc/apploader/
4、altool
您可以使用 Application Loader 的命令行工具 altool,驗(yàn)證 App 二進(jìn)制文件并將其上傳至 App Store。
所以,Application Loader 應(yīng)用界面下,也是基于 altool 命令來(lái)處理 ipa 文件。明白了這點(diǎn),對(duì)于命令行就沒(méi)有什么問(wèn)題啦。
若要在上傳之前驗(yàn)證構(gòu)建版本或?qū)⒂行?gòu)建版本自動(dòng)上傳至 App Store,您可在您的持續(xù)集成系統(tǒng)中包含 altool。altool 位于以下文件夾中: Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/
對(duì)于這點(diǎn),如果有做過(guò)自動(dòng)化打包、上傳發(fā)布或 shell 腳本命令的同學(xué),應(yīng)該就知道,我們很多時(shí)候,希望自動(dòng)上傳,而不是人工操作UI,一步一傻瓜的操作,這不是程序員的工作方式!所以,用命令行的目的就在這里。需要說(shuō)明一下,剛才也提到 Application Loader 是有早期驗(yàn)證警告功能,也就是說(shuō),可以檢查這個(gè) ipa 包的內(nèi)容或格式,是不是符合蘋果的規(guī)定和要求。
所以,若要運(yùn)行 altool,請(qǐng)?jiān)诿钚兄付ㄒ韵乱豁?xiàng)操作,可以是檢查(--validate-app),或者上傳(--upload-app)操作:
$ altool --validate-app -f file -u username [-p password] [--output-format xml]$ altool --upload-app -f file -u username [-p password] [--output-format xml]
命令參數(shù)說(shuō)明:
| --validate-app | 您要驗(yàn)證指定的 App。 |
| --upload-app | 您要上傳指定的 App。 |
| -f file | 正在驗(yàn)證或上傳的 App 的路徑和文件名。 |
| -u username | 您的用戶名。 |
| -p password | 您的用戶密碼。 |
| --output-format [xml / normal] | 您想讓 Application Loader 以結(jié)構(gòu)化的 XML 格式還是非結(jié)構(gòu)化的文本格式返回輸出信息。默認(rèn)情況下,Application Loader 以文本格式返回輸出信息。 |
5、Transporter
也許,對(duì)于一般的開(kāi)發(fā)者來(lái)說(shuō),altool 已經(jīng)能滿足基本的上傳 ipa 文件的需求。但是,正好前面說(shuō)的,如果你需要進(jìn)行批量創(chuàng)建內(nèi)購(gòu)品項(xiàng),還有其它操作,可能大多數(shù)開(kāi)發(fā)者不知道,蘋果除了 iOS,還有非常多的服務(wù), iTunes Connect 帳戶(圖書(shū)發(fā)行商或音樂(lè)提供商)、 iTunes Store、Apple Books,盡管我們中國(guó)地區(qū)有些服務(wù)或者非常少用。
所以,蘋果提供 Transporter 來(lái)處理大量和差異化數(shù)據(jù)的操作的工具(可以在 macOS、Windows 和 Linux 操作系統(tǒng)上安裝和運(yùn)行 Transporter。):
Transporter 是 Apple 基于 Java 的命令行工具,用于進(jìn)行大量目錄交付。您可以使用 Transporter 將預(yù)生成的內(nèi)容以 Store 數(shù)據(jù)包的形式交付至 iTunes Store、Apple Books 和 App Store。
不論您使用 iTunes Connect 帳戶(圖書(shū)發(fā)行商或音樂(lè)提供商)、App Store Connect 帳戶(App 開(kāi)發(fā)者)或是編碼工作室?guī)魜?lái)交付圖書(shū)、視頻、音樂(lè)或 App 內(nèi)容,您都可以使用 Transporter 以確保您的元數(shù)據(jù)和素材(例如音頻、視頻、圖書(shū)和 App 文件)適當(dāng)?shù)亟桓吨?iTunes Store、Apple Books 或 App Store,并根據(jù) Apple 的規(guī)范驗(yàn)證 Store 數(shù)據(jù)包。
這里,只會(huì)介紹用 Transporter 命令來(lái)上傳 ipa 文件,更多的功能和說(shuō)明,大家可以查看官方文檔(中文):https://help.apple.com/itc/transporteruserguide/
注意: 下面命令中的 iTMSTransporter 是一個(gè)變量名,【重要事項(xiàng)】 作為一名 App 開(kāi)發(fā)者,您可以在已安裝 Xcode 或 Application Loader 的情況下使用 Transporter,或者您也可以手動(dòng)下載 Transporter。有關(guān)如何為 App 開(kāi)發(fā)者安裝 Transporter 的信息,請(qǐng)參見(jiàn) App 開(kāi)發(fā)者的安裝說(shuō)明。
因?yàn)槲覀兡J(rèn)都安裝了 Xcode,所以 Transporter 命令,我們引用 Xcode 中的 Application Loader 里的 iTMSTransporter, 在 .bash_profile 添加了一個(gè)別名,這樣可以在任何目錄路徑調(diào)用 iTMSTransporter 命令:
alias iTMSTransporter='`xcode-select --print-path`/../Applications/Application Loader.app/Contents/MacOS/itms/bin/iTMSTransporter'
注:
-
1、其中 xcode-select --print-path: print the path of the active developer directory(打印當(dāng)前使用的Xcode版本軟件的開(kāi)發(fā)人員目錄的路徑),然后在當(dāng)前使用的 Xcode 版本對(duì)應(yīng)的 Application Loader 下的 iTMSTransporter。
-
2、當(dāng)然,也可能通過(guò)設(shè)置全局環(huán)境變量來(lái)直接使用命令,添加 TRANSPORTER_HOME 環(huán)境變量。要添加 TRANSPORTER_HOME 環(huán)境變量,請(qǐng)?jiān)谀?.bash_profile 中添加以下行:export TRANSPORTER_HOME=。例如,如果您安裝了 Xcode,則該行應(yīng)如下所示:
export TRANSPORTER_HOME=`xcode-select --print-path`/../Applications/Application Loader.app/Contents/MacOS/itms/bin
其中,我們除了剛才說(shuō)的檢查和上傳模式外,可能會(huì)用于這個(gè)命令的幾種模式,
-
Lookup Metadata 模式
檢索您之前上傳的某個(gè) App 當(dāng)前的元數(shù)據(jù)。如果您之前上傳的是 .itmsp 數(shù)據(jù)包且 Apple 在您初次上傳后修改了元數(shù)據(jù),您需要先檢索修改后的元數(shù)據(jù),再重新發(fā)送元數(shù)據(jù)更新的數(shù)據(jù)包。
iTMSTransporter -m lookupMetadata -u [user] -p [password] -apple_id(-apple_ids) -destination [output_path]
-
Provider 模式
確定您有權(quán)限為哪些帳戶交付內(nèi)容。
iTMSTransporter -m provider -u [user] -p [password]
-
Verify 模式
驗(yàn)證您的 .itmsp 數(shù)據(jù)包,并在交付前確保元數(shù)據(jù)和素材符合技術(shù)要求,以保證上傳數(shù)據(jù)包前解決任何潛在的問(wèn)題。
iTMSTransporter -m verify -u [user] -p [password] -f [itmsp_path] [-vp <text | json>]
-
Upload 模式
檢查您的素材和 .itmsp 數(shù)據(jù)包,驗(yàn)證它們是否準(zhǔn)備就緒以供交付,然后向 App Store 上傳內(nèi)容和元數(shù)據(jù)。
iTMSTransporter -m upload -u [user] -p [password] -f [itmsp_path]
關(guān)于這些模式的參數(shù),蘋果文檔有非常詳細(xì)的說(shuō)明,雖然需要花一點(diǎn)的腦子去理解(文檔真的很~),好了。下面簡(jiǎn)單說(shuō)明一下,上傳命令怎么使用吧
-
上傳 ipa 示例:
iTMSTransporter -m upload -u xxx@xxx.com -p xxx -f /Users/HTC/Desktop/Upload.itmsp
xxx@xxx.com :App Store Connect 賬號(hào) xxx :App Store Connect 賬號(hào)的密碼 /Users/HTC/Desktop/Upload.itmsp :這個(gè)一個(gè)目錄,Upload.itmsp 是一個(gè)文件夾名字,不是文件,里面包含2個(gè)文件,一個(gè)就是要上傳的 ipa 文件,另一個(gè)是一個(gè) xml ,描述這個(gè) ipa 文件的信息。
ipa_metadata.xml:
<?xml version="1.0" encoding="UTF-8"?><package version="software5.10" xmlns="http://apple.com/itunes/importer"> <software_assets apple_id="{apple_id}" app_platform="{app_platform}"> <asset type="{archive_type}"> <data_file> <size>{file_size}</size> <file_name>{file_name}</file_name> <checksum type="md5">{file_md5}</checksum> </data_file> </asset> </software_assets></package>
需要修改 xml 中的一些參數(shù):
{apple_id} :這個(gè) ipa 文件對(duì)應(yīng)的app的 apple id {app_platform} : app的平臺(tái),填寫ios {archive_type} :歸檔類型,填寫bundle {file_size} :ipa 文件的大小 {file_name} :ipa 文件的名字 {file_md5}: ipa 文件的md5值
-
一些重要參數(shù)說(shuō)明:
| -itc_provider | 檢查和上傳時(shí)建議加子賬號(hào)的團(tuán)隊(duì)id,但測(cè)試發(fā)現(xiàn)不用 也行,先不帶,因?yàn)楂@取很麻煩 |
| -errorLogs | 存儲(chǔ)錯(cuò)誤日志的目錄 |
| -loghistory | 記錄成功上傳的數(shù)據(jù)包 |
| -outputFormat xml | 以 XML 格式返回輸出信息 |
| -throughput | 顯示成功上傳數(shù)據(jù)包的總傳輸時(shí)間以及數(shù)據(jù)包大小和每秒字節(jié)數(shù) |
| [-o ] | 記錄輸出信息 |
| [-v ] | 日志級(jí)別,默認(rèn)eXtreme,詳細(xì) |
| -vp | 在驗(yàn)證或上傳數(shù)據(jù)包文件時(shí)顯示進(jìn)度信息 |
| [-Xmx4096m] | 指定 4 GB Java 虛擬機(jī) (JVM) 堆棧內(nèi)存 |
總結(jié)
最后,這就是幾種上傳ipa包的方法,當(dāng)然,如果經(jīng)驗(yàn)豐富的開(kāi)發(fā)者,可能使用過(guò) fastlane 、shenzhen 這樣的自動(dòng)化工具命令,也是可以上傳 ipa 文件,如果你研究過(guò)它們的源代碼,你就會(huì)發(fā)現(xiàn),他們使用的命令就是 iTMSTransporter,這也正是,我想寫這篇文章的原因。現(xiàn)在大家在開(kāi)發(fā)過(guò)程中,一直想提升自己,想進(jìn)階,想成為高手,然而找不到途徑?我希望,大家不要忽視開(kāi)發(fā)過(guò)程的每一個(gè)重要的環(huán)節(jié),這就是進(jìn)階的途徑!愿大家都能感悟達(dá)到~
最后的最后,想說(shuō)一下最近不怎么更新博客的原因?除了比較忙外(什么時(shí)候閑!),寫好一篇文章,需要去考查相關(guān)的資料和知識(shí),對(duì)每一行文字,都要精斟細(xì)酌,因?yàn)楫?dāng)我看到博客的訪問(wèn)量越來(lái)越多人時(shí),為了不誤導(dǎo)大家,所以需要承擔(dān)的責(zé)任感覺(jué)也大了。這也是寫文章的好處吧,除了整理思維,體系構(gòu)建,表達(dá)自己,還有分享,責(zé)任,擔(dān)當(dāng)中國(guó)IT技術(shù)傳承的一份子,安樂(lè)~
appuploader視頻教程:2022最全Hbuilder打包成蘋果iOS-App的詳解 - 騰訊云開(kāi)發(fā)者社區(qū)-騰訊云騰訊云開(kāi)發(fā)者社區(qū)致力于打造開(kāi)發(fā)者的技術(shù)分享型社區(qū)。營(yíng)造云計(jì)算技術(shù)生態(tài)圈,專注于提高開(kāi)發(fā)者的技術(shù)影響力。https://cloud.tencent.com/developer/video/33058
總結(jié)
以上是生活随笔為你收集整理的谈一谈 IPA 上传到 App Store Connect 的几种方法的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: 哪里有mysql认证_国内哪个城市可以考
- 下一篇: 怎么把数据文件上传云服务器,怎么把数据上