建立適用于 Android 的 JAVA 應用程式

若要建立您的第一個 Android 應用程式,請遵循下列步驟:

  1. 連線至您的存放庫服務帳戶 (GitHub、Bitbucket、VSTS、Azure DevOps) 。
  2. 選取存放庫和應用程式所在的分支。
  3. 選擇您要建立的 Android 專案。
  4. 設定您的第一個組建。

注意

若要讓應用程式在真實裝置上執行,組建必須是以有效憑證簽署的程式碼。

警告

由於 JCenter 的最新關機,某些應用程式可能會在使用 App Center 建立時遇到 Gradle 工作失敗。 請參閱 Gradle 所提供的遷移指南。 因應措施是,的所有實例都 jcenter() 可以從檔案中移除 build.gradle ,並取代為 jcenter { url "http://jcenter.bintray.com/"} 。 請在 這裡閱讀更多有關 JCenter 關機的資訊。

1. 連結您的存放庫

如果您還沒有連接到您的儲存機制服務帳戶,則必須連線到該帳戶。 一旦您的帳戶連線,請選取 Android 專案所在的存放庫。 若要設定存放庫的組建,您需要其系統管理員和提取許可權。

2. 選取分支

選取存放庫之後,請選取您想要建立的分支。 預設會列出所有作用中的分支。

3. 設定您的第一個組建

在您的第一個組建之前,必須先設定 Android 專案。

3.1. 組建觸發程式

根據預設,每當開發人員推送至設定的分支時,就會觸發新的組建。 這稱為「持續整合」。 如果您想要手動觸發新的組建,您可以在 [設定] 窗格中變更此設定。

3.2. 組建變體

可用的組建變體將會填入 gradle (應用程式層級) 檔中所指定的組建類型和產品類別。 選取應該建立的組建變異。

注意

App Center 組建支援將組建類型的組合作為組建類型的組合, (debug、release 或自訂定義) ,以及其中一個 gradle 宣告的產品類別。 目前不支援多個產品類別 (組合的類別維度偵測) 。

3.3. 建立 Android 應用程式套件組合 (. aab)

Android 應用程式套件組合是上傳至 Play Store 的發佈格式,可用來針對特定裝置產生優化 Apk。 您可以在 官方 android 檔中深入瞭解 Android 應用程式套件組合。

切換 Android 應用程式套件組合的選項,以產生 .aab 除了以外的 .apk 。 如果 build.gradle (應用層級) 檔案包含 android.bundle 區塊,此選項將會是開啟的。

3.4. 遞增版本號碼

啟用時,會自動為每個組建遞增應用程式 AndroidManifest.xml 中的版本代碼。 變更會在實際組建期間發生,且不會認可至您的存放庫。

3.5. 程式碼簽署

成功的組建會產生檔案 .apk 和其他檔案( .aab 如果已啟用)。 若要將組建發行至 Play Store,必須使用儲存在金鑰儲存區中的有效憑證來簽署。 若要簽署從分支產生的組建,請啟用 [設定] 窗格中的程式碼簽署、將金鑰儲存區上傳至您的存放庫,並在 [設定] 窗格中提供相關的認證。 您可以閱讀更多有關 App Center 的 Android 程式碼簽署檔的程式代碼簽署。 .aab將使用與相同的認證進行簽署 .apk

3.6. 在真實裝置上啟動成功的組建

使用新產生的 APK 檔案來測試您的應用程式是否會在實際裝置上啟動。 這會將大約10分鐘新增至總組建時間。 深入瞭解 如何設定啟動測試

3.7。 從 gradle (應用層級) 檔案進行設定

您將會從 Gradle 檔案收集組建的特定資訊,包括相依性、組建工具版本、組建類型和產品類別。

3.8。 散發組建

您可以將每個成功的組建從分支設定為散發至先前建立的通訊群組或存放區目的地。 您可以加入新的通訊群組,或從散發服務內 設定存放區連接 。 一律會有一個名為「共同作業者」的預設通訊群組,其中包含所有可存取應用程式的使用者。

注意

如果散發至 Google Play 商店,則會優先使用 Android 應用程式套件組合 (.aab) ,並在啟用時加以散發。 若為 App Center 通訊群組和 Intune 商店目的地, .apk 即使同時產生,也會使用一般 .aab

4. 建立結果

觸發組建之後,可能會處於下列狀態:

  • 排入 佇列-組建位於等候資源釋放的佇列中。
  • 建立 -應用程式正在建立及執行相關工作。
  • 成功 -組建已順利完成。
  • 失敗 -組建已完成,但失敗。 您可以下載並檢查組建記錄檔以進行疑難排解。
  • 已取消 -組建已由使用者動作取消,或已超時。

4.1. 組建記錄

針對完成的組建 (成功或失敗的) ,請下載記錄檔,以深入瞭解組建的執行方式。 App Center 會使用下列檔案提供封存:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

位於封存) 的組建/目錄中的組建步驟特定記錄 (有助於疑難排解和瞭解組建失敗的步驟和原因。

4.2. 應用程式套件 (APK)

APK 是包含 Android 應用程式和資產的套件。 如果組建已正確簽署,APK 可以安裝在實際的裝置上,並部署至 Play Store。 如果組建尚未簽署,APK 可以在模擬器上執行,或用於其他用途。

4.3. 建立多個 Apk

如果您的應用程式設定會建立多個 Apk,您也需要建立通用 APK。 我們的組建系統適用于一個主要 APK 檔案,而且會忽略特定 CPU ABI 或螢幕密度的所有 Apk。 若要深入瞭解 APK 分割和建立通用 APK,請閱讀 ABI 分割指南

4.4。 Deobfuscation 對應檔 (mapping.txt)

此檔案 mapping.txt 包含有關如何將模糊的應用程式堆疊追蹤對應回原始類別和方法名稱的資訊。

  • 如果您先前在應用程式中整合了 App Center SDK,且已啟用損毀報告模組,並使用 Proguard 或 R8 來縮短和模糊化應用程式二進位檔,則當機報表服務需要此檔案才能 mapping.txt 讓組建顯示 人類可讀取的 (deobfuscated) 損毀報表
  • 如果您先前在應用程式中整合了另一個適用于損毀報告的 SDK (例如,HockeyApp SDK) ,對應的服務會要求檔案 mapping.txt 顯示可讀取的損毀報表。

5. 支援的版本和需求

建立 Android 應用程式所支援的最低版本為 7.0 (API 層級 24) 。 Android 應用程式可以有較低的最小 API 層級來執行,但必須至少以 API 層級24為目標。

應用程式必須使用 Gradle 建立,且必須正確設定 Android Gradle 外掛程式。 您的存放庫必須包含 Gradle 包裝函式。

另請參閱: 雲端組建電腦資訊