專案總覽

Android Studio for Platform (ASfP) 中的專案包含可定義 AOSP 程式碼庫工作區的所有內容，包括原始碼、資產、測試程式碼和建構設定。

當您啟動新專案時，ASfP 會為所有檔案建立必要的結構，並顯示在「Project」視窗中。如要開啟這個視窗，請依序選取「View」>「Tool Windows」>「Project」。

本頁提供專案設定中主要元件的總覽。

專案設定 (.asfp-project)

ASfP 專案設定是由專案目錄根目錄中的 .asfp-project 檔案控管。這個 YAML 檔案可控制專案內容，以及重要功能的運作方式，因此至關重要。您可以透過主選單開啟，方法是依序選取「ASfP」>「Project」>「Open Config」，或在專案檢視畫面中尋找。

專案建立完成後，系統會根據使用者提供的規格建構設定。您可以隨時編輯設定中的所有參數來修改專案規格，例如更新專案目錄或模組，之後必須同步處理，變更才會生效。

設定參數

您可以在 .asfp-project 檔案中設定下列主要參數：

repo

必要

Android 平台存放區根目錄的絕對路徑。

repo: /path/to/aosp

lunch

必要

與專案搭配使用的午餐目標。這項設定適用於所有 Soong 建構動作，包括同步和相關執行設定。

lunch: your-product-variant-userdebug

directories

選用

要納入或排除在專案中的目錄。這些路徑應是相對於 repo 根目錄的相對路徑。

directories:
  include:
    -   frameworks/base
    -   packages/apps/Settings
  exclude:
    -   vendor
    -   out/soong

modules

選用

要納入或排除在專案中的模組。這些項目會與先前指定的 directories 搭配運作。系統支援完整名稱和縮寫名稱。

modules:
  include:
    -   SystemUIGoogle
    -   frameworks/base/services/core/java:services
  exclude:
    -   UnusedModule

test_sources

選用

ASfP 會嘗試區分正式版和測試來源，但在某些情況下，您可能需要明確標示測試來源。請以相對於 repo 根目錄的路徑提供這些檔案。指定路徑的任何子目錄來源根目錄都會標示為測試。

test_sources:
  -   cts/tests/tests/example
  -   tests/mytests

other_languages

選用

Java 支援功能預設為啟用。你可以新增其他語言的支援。 ASfP 也支援 C/C++ (cpp) 和 Rust (rust)。

other_languages:
  -   cpp
  -   rust

build_config

選用

這個參數可讓您在 Soong 建構事件中新增自訂標記或環境變數。這項設定會套用至 IDE 中導致 Soong 建構的所有動作，包括同步和執行設定。

build_config:
  flags:
    -   -j64
  env:
    SOONG_ALLOW_MISSING_DEPENDENCIES: true
    MY_CUSTOM_VAR: value