建立或匯入專案

Android Studio for Platform (ASfP) 可協助您設定 Android 開放原始碼計畫 (AOSP) 的開發環境。ASfP 以 IntelliJ Workspace Model 為基礎，支援手動設定和可共用的團隊範本。

啟動專案設定精靈

您可以透過下列兩種方式啟動專案設定精靈：

  • 在歡迎畫面中：按一下「New Project」或「Import ASfP Project」。
  • 從開啟的專案：在主選單中，依序選取「ASfP」>「Project」>「New Project」或「Import ASfP Project」。

從範本匯入

如果團隊共用標準 .asfp-project 設定檔，您可以直接從該範本初始化工作區：

  1. 在專案設定精靈中，選取「從範本匯入」。
  2. 瀏覽並選取共用的 .asfp-project 或 .asfp-template YAML 檔案。
  3. 精靈從範本填入專案設定後，請確認本機的「Repo checkout」路徑，然後按一下「Finish」。

手動設定

如要從頭建立新的專案設定，請按照下列步驟操作：

  1. 在專案設定精靈中，選擇手動設定專案，然後填寫專案詳細資料：

    • 存放區結帳 (模組路徑)：指定本機 AOSP 來源結帳的根目錄絕對路徑 (例如 /path/to/aosp)。
    • 午餐目標：輸入您用於建構的午餐目標 (例如 aosp_cf_x86_64_phone-aosp_current-userdebug)。
    • 專案名稱：為專案命名，方便您辨識。
    • 目錄和模組：列出要納入專案的初始目錄或 Soong 模組 (相對於存放區根目錄，例如 frameworks/base 或 packages/apps/Settings)。
    • 語言：如果工作流程包含 C、C++ 或 Rust 平台程式碼，請選取「C 或 C++」或「Rust」。預設會納入 Java、Kotlin 和 Android.bp。
    • 環境變數和建構選項：在精靈的「環境變數」欄位中，新增任何自訂環境變數 (例如 SOONG_ALLOW_MISSING_DEPENDENCIES=true)，並視需要選取「Soong Partial Compile」(Soong 部分編譯) (SOONG_PARTIAL_COMPILE) 核取方塊，加快增量建構速度。

  2. 按一下「Finish」。ASfP 會建立專案結構、在專案根目錄中產生 .asfp-project 設定檔，並執行初始同步作業。

分享或自訂專案設定

完成初始設定後，隨時可以編輯 .asfp-project 檔案 (依序選取「ASfP」>「Project」>「Open Config」)，自訂專案：

  • 新增或排除目錄和 Soong 模組。
  • 啟用其他語言 (cpp、rust)。
  • 設定自訂 Soong 旗標和環境變數。

如要將設定匯出給隊友，請在「.asfp-project」分頁標籤上按一下滑鼠右鍵，然後選取「匯出至範本」。

如要進一步瞭解 .asfp-project 參數、同步模式和編輯器內 Android.bp 動作，請參閱「專案總覽和 Soong 工作流程」。