So, you’ve finished working on your Mobile App. Now it’s time to deploy it. Let’s learn how.
Android Publishing
To generate a release build for Android, we can use the following Quasar CLI command
$ quasar build -m capacitor -T android
This will compile the web assets (and if “–ide” param is also specified, it will open up Android Studio IDE where you need to trigger a release build).
Next, we find our unsigned APK file generated by the Android Studio. Now, we need to sign the unsigned APK and run an alignment utility on it to optimize it and prepare it for the app store. If you already have a signing key, skip these steps and use that one instead.
讓我們使用 JDK 內建的 keytool 命令來產生私密金鑰。如果找不到這個工具,請參考安裝指南。
$ keytool -genkey -v -keystore my-release-key.keystore -alias alias_name -keyalg RSA -keysize 2048 -validity 20000
你會先被要求建立金鑰庫的密碼。然後,回答這個好用工具的其他問題。完成後,你應該會在目前的目錄中看到一個名為 my-release-key.keystore 的檔案。
警告
請務必將這個檔案儲存在安全的地方,如果你遺失了它,你將無法提交應用程式的更新!
接下來,我們需要對 APK 進行 zip align 對齊 和簽署。為此,我們會使用 Android SDK build-tools
資料夾中的幾個應用程式,路徑會像 /path/to/Android/Sdk/build-tools/VERSION/
這樣。例如,在安裝了 Android Studio 的 OS X 系統上,zipalign
位於 ~/Library/Android/Sdk/build-tools/VERSION/
。
對 APK 進行 zip align 對齊
$ zipalign -v 4 <path-to-same-apk-file> HelloWorld.apk
簽署 APK
apksigner sign --ks my-release-key.keystore --ks-key-alias alias_name <path-to-unsigned-apk-file>
現在我們有了最終的發布版本二進制檔案,名為 HelloWorld.apk,我們可以將它發布到 Google Play 商店,讓全世界都能使用!
(還有其他幾種簽署 APK 的方法。請參考官方 Android 應用程式簽署文件以取得更多資訊。)
Google Play 商店
現在我們已經準備好發布到 Google Play 商店的 APK,我們可以建立 Play 商店列表並上傳我們的 APK。
首先,你需要訪問 Google Play 商店開發人員控制台 並建立新的開發人員帳戶。遺憾的是,這不是免費的。但是,費用僅為 25 美元,相較於 Apple 的 99 美元。
一旦你有了開發人員帳戶,你就可以繼續點擊「在 Google Play 上發布 Android 應用程式」。
接著,你可以繼續點擊按鈕來編輯商店列表(我們稍後會上傳 APK)。你會需要填寫應用程式的描述。
當你準備好時,上傳發布版本的 APK 並發布列表。請耐心等待,你的辛勤工作應該很快就會上線!
更新你的應用程式
隨著你開發應用程式,你會想要定期更新它。
為了讓 Google Play 商店接受更新的 APK,你需要提高應用程式版本(從 /package.json
或 /quasar.config file > capacitor > version
),然後重新建置應用程式以進行發布。
iOS 發布
首先,你需要加入 Apple 開發人員計畫。與 Google 相同,如果你已經有 Apple 個人帳戶,你可以為你的應用程式建立一個額外的帳戶。
將 Xcode 與你的開發人員帳戶連結
在你收到開發人員資格後,在你的 Mac 上開啟 Xcode,並前往「偏好設定」>「帳號」。點擊左下角的 +
按鈕,並按照指示將你的帳戶新增到 Xcode。
簽署
現在你已經將 Xcode 與你的開發人員帳戶連結,前往「偏好設定」>「帳號」,在左側選擇你的 Apple ID,然後點擊先前圖片中顯示的「檢視詳細資訊」按鈕。
點擊「iOS 發布」選項旁邊的「建立」按鈕。
你可以從官方文件中了解更多關於維護簽署身分和憑證的資訊。
設定應用程式識別碼
接下來,透過 Apple Developer Member Center,我們將設定應用程式 ID 識別碼的詳細資訊。識別碼用於允許應用程式存取特定的應用程式服務,例如 Apple Pay。你可以使用你的 Apple ID 和密碼登入 Apple Developer Member Center。
登入後,你應該選擇「憑證、識別碼與描述檔」選項。然後在「iOS 應用程式」下選擇「識別碼」選項。接著點擊 +
按鈕以新增一個新的 iOS 應用程式 ID。
接著,你必須設定你的應用程式名稱,使用「明確的 App ID」選項,並將「Bundle ID」設定為你的 capacitor.config.json 檔案中 id 的值。
此外,你還必須選擇任何需要啟用的服務。例如,如果你的應用程式中使用了 Apple Pay 或 Wallet,你需要選擇這些選項。
你可以從 官方文件 中了解更多關於註冊應用程式識別碼的資訊。
建立應用程式列表
Apple 使用 iTunes Connect 來管理應用程式提交。登入後,你應該選擇「我的 App」按鈕,然後在下一個畫面中選擇 +
按鈕,它位於 iTunes Connect「我的 App」標題下方。
這將顯示一個下拉選單,其中有三個選項,你應該選擇「新增 App」。之後會出現一個彈出視窗,你必須在其中選擇應用程式名稱、平台、主要語言、Bundle ID 和 SKU。
完成後,點擊「建立」按鈕,你會看到一個畫面,你必須在其中設定一些基本選項,例如隱私權政策 URL、類別和子類別。
現在,在我們填寫列表中的所有內容之前,我們先建置應用程式並使用 Xcode 上傳它。然後你會回來完成列表。
你可以從 官方文件 中了解更多關於在 iTunes Connect 中管理應用程式的資訊。
建置用於生產環境的應用程式
$ quasar build -m capacitor -T ios
這將編譯 Web 資源(如果也指定了「–ide」參數,它將開啟 Xcode,你需要在其中觸發發布版本建置)。
在 Xcode 中設定專案
一旦 Xcode 開啟專案(需要「–ide」參數),你應該會在一般視圖中看到關於你的應用程式的詳細資訊。
你應該檢查 bundle identifier 是否設定正確,使其與你先前在應用程式 ID 中指定的值相同。此外,請確認版本號碼和建置號碼是否正確。「團隊」選項應設定為你的 Apple 開發人員帳戶。在部署目標下,你可以選擇你的應用程式將支援哪些裝置。
建立應用程式的封存檔
在 Xcode 中,選擇「Product」>「Scheme」>「Edit Scheme」以開啟 scheme 編輯器。接著,從左側的列表中選擇「Archive」。確保「Build Configuration」設定為「Release」。
若要建立封存檔,請從專案編輯器的 Scheme 工具列選單中選擇「Generic iOS Device」,或者如果你的裝置已連接到你的 Mac,則選擇你的裝置(如果選擇模擬器,則無法建立封存檔)。
接著,選擇「Product」>「Archive」,「Archive organizer」就會出現並顯示新的封存檔。
此時你可以點擊 Upload to App Store...
按鈕,如果一切順利,你就會上傳應用程式,而剩下要做的就是完成 iTunes Connect 列表並提交以供審查!
此時,在你上傳封存檔後不久,你應該會收到來自 iTunes Connect 的電子郵件,其中包含內容。
完成應用程式列表流程
現在你應該回到 iTunes Connect 入口網站並登入。接著,點擊「APP STORE 資訊」下方左側的「定價與供應狀態」。
你不必擔心忘記插入任何關於你的應用程式的重要且必要的資訊,因為如果你在所有詳細資訊都填寫完整之前嘗試提交應用程式以供審查,你將會收到通知,告知你缺少了什麼以及需要新增/變更什麼。
接著,點擊左側的「1.0 準備提交」按鈕,如下圖所示。當我們上傳封存檔時,iTunes Connect 會自動判斷支援哪些裝置尺寸。你需要為 iTunes Connect 偵測到的每個應用程式尺寸上傳至少一張螢幕截圖。
接著,你必須插入「描述」、「關鍵字」、「支援 URL」和「行銷 URL」(可選)。
在「建置」區段中,你必須點擊 +
按鈕,並選擇在前幾個步驟中透過 Xcode 上傳的建置版本。
接著,你必須上傳圖示、編輯評級,並設定一些額外資訊,例如版權和你的資訊。請注意,你在此處必須上傳的圖示尺寸必須為 1024 x 1024 像素。幸運的是,你可以使用第二個教學中的 splash.png。如果你是唯一的開發人員,那麼「應用程式審查資訊」中的資料應該是你自己的。最後,作為最後一個選項,你可以保留預設勾選的選項,一旦你的應用程式獲得批准,它將自動發布到 App Store。
現在我們已經完成將所有詳細資訊新增到應用程式列表,我們可以按下「儲存」,然後按下「提交以供審查」。最後,你會看到最後一個表單,你必須填寫它。
在你提交應用程式以供審查後,你將在「我的 App」中看到它的狀態為「等待審查」,如下圖所示。此外,在你提交應用程式以供審查後不久,你將收到來自 iTunes Connect 的確認電子郵件,告知你的應用程式正在審查中。
Apple 以人工審查流程為傲,這基本上意味著你的應用程式可能需要幾天才能完成審查。你將會收到關於你的應用程式狀態的任何問題或更新通知。
更新應用程式
由於你可能在某些時候想要更新你的應用程式,你首先需要提高應用程式版本(從 /package.json
),然後重新建置應用程式以進行發布。一旦 Xcode 開啟,請再次遵循相同的步驟。
一旦你提交以供審查,你將必須再次等待審查流程。