Tworzenie lub importowanie projektu

Android Studio for Platform (ASfP) pomaga skonfigurować środowisko programistyczne dla Projektu Android Open Source (AOSP). ASfP jest oparty na modelu przestrzeni roboczej IntelliJ i obsługuje zarówno konfigurację ręczną, jak i szablony zespołowe, które można udostępniać.

Uruchamianie kreatora konfiguracji projektu

Kreator konfiguracji projektu możesz uruchomić na 2 sposoby:

  • Na ekranie powitalnym: kliknij Nowy projekt lub Importuj projekt ASfP.
  • W otwartym projekcie: w menu głównym wybierz ASfP > Projekt > Nowy projekt lub Importuj projekt ASfP.

Importuj z szablonu

Jeśli Twój zespół udostępnia standardowy plik konfiguracji .asfp-project, możesz zainicjować obszar roboczy bezpośrednio z tego szablonu:

  1. W kreatorze konfiguracji projektu kliknij Importuj z szablonu.
  2. Przejdź do udostępnionego pliku YAML .asfp-project lub .asfp-template i wybierz go.
  3. Gdy kreator wypełni ustawienia projektu na podstawie szablonu, sprawdź lokalną ścieżkę Repo checkout, a potem kliknij Finish (Zakończ).

Konfigurowanie ręczne

Aby utworzyć nową konfigurację projektu od podstaw:

  1. W kreatorze konfiguracji projektu wybierz opcję ręcznej konfiguracji projektu i wypełnij szczegóły projektu:

    • Repo checkout (ścieżki modułów): podaj ścieżkę bezwzględną do katalogu głównego lokalnego wyewidencjonowania źródła AOSP (np. /path/to/aosp).
    • Cel dotyczący lunchu: wpisz cel dotyczący lunchu, którego używasz w przypadku budynku (np. aosp_cf_x86_64_phone-aosp_current-userdebug).
    • Nazwa projektu: nadaj projektowi opisową nazwę.
    • Katalogi i moduły: podaj początkowe katalogi lub moduły Soong, które mają być uwzględnione w projekcie (względem katalogu głównego repozytorium, np. frameworks/base lub packages/apps/Settings).
    • Języki: jeśli przepływ pracy zawiera kod platformy w języku C, C++ lub Rust, wybierz C lub C++ albo Rust. Domyślnie uwzględniane są języki Java, Kotlin i Android.bp.
    • Zmienne środowiskowe i opcje kompilacji: w polu Zmienne środowiskowe kreatora dodaj dowolne niestandardowe zmienne środowiskowe, np. SOONG_ALLOW_MISSING_DEPENDENCIES=true, i opcjonalnie zaznacz pole wyboru Soong Partial Compile (SOONG_PARTIAL_COMPILE), aby przyspieszyć kompilacje przyrostowe.

  2. Kliknij Zakończ. ASfP tworzy strukturę projektu, generuje .asfp-project plik konfiguracji w katalogu głównym projektu i przeprowadza początkową synchronizację.

Udostępnianie i dostosowywanie konfiguracji projektu

Po wstępnej konfiguracji możesz w każdej chwili dostosować projekt, edytując plik .asfp-project (ASfP > Projekt > Otwórz konfigurację):

  • dodawać i wykluczać katalogi oraz moduły Soong;
  • Włącz dodatkowe języki (cpp, rust).
  • Skonfiguruj niestandardowe flagi Soong i zmienne środowiskowe.

Aby wyeksportować konfigurację dla członków zespołu, kliknij prawym przyciskiem myszy kartę .asfp-project i wybierz Eksportuj do szablonu.

Więcej informacji o parametrach .asfp-project, trybach synchronizacji i działaniach Android.bp w edytorze znajdziesz w artykule Omówienie projektów i przepływy pracy Soong.