Kompilowanie projektów Lightbuild z poziomu wiersza poleceń

Interfejs wiersza poleceń Lightbuild to oficjalne narzędzie wiersza poleceń Lightbuild. Użyj polecenia lightbuild, aby skompilować i przetestować projekt, znaleźć jego cele kompilacji i rozwiązać zależności. Agenty AI mogą wykonywać te same polecenia. Projekty tworzone na podstawie szablonu Lightbuild zawierają plik AGENTS.md, który informuje agenty AI, jak pracować z Lightbuild i interfejsem wiersza poleceń Lightbuild.

Więcej informacji o poleceniach i opcjach interfejsu wiersza poleceń Lightbuild znajdziesz w dokumentacji interfejsu wiersza poleceń Lightbuild.

Instalowanie interfejsu wiersza poleceń Lightbuild

Interfejs wiersza poleceń Lightbuild jest rozpowszechniany jako pakiet Android SDK, który instalujesz za pomocą interfejsu wiersza poleceń Androida. Możesz go zainstalować i skonfigurować za pomocą jednego polecenia lub zainstalować ręcznie.

Instalowanie i konfigurowanie w jednym kroku

Aby zainstalować interfejs wiersza poleceń Lightbuild, uruchom polecenie dla swojego systemu operacyjnego. Polecenie instaluje pakiet Lightbuild CLI w pakiecie Android SDK, a następnie uruchamia skrypt konfiguracyjny pakietu, który kopiuje Lightbuild CLI do ~/.local/bin w systemach macOS i Linux lub do $HOME\AppData\LightbuildCLI w systemie Windows i sprawdza, czy ten katalog znajduje się w PATH:

  • macOS i Linux:

    android sdk install build/lightbuild/0.0.30 && bash "$(android info sdk)/build/lightbuild/0.0.30/cli/install.sh"

  • Windows (PowerShell):

    android sdk install build/lightbuild/0.0.30; if ($LASTEXITCODE -eq 0) { & "$(android info sdk)\build\lightbuild\0.0.30\cli\install.cmd" }

  • Windows (znak zachęty):

    android sdk install build/lightbuild/0.0.30 && for /f "delims=" %p in ('android info sdk') do call "%p\build\lightbuild\0.0.30\cli\install.cmd"

Po zakończeniu wykonywania polecenia sprawdź instalację.

Zainstaluj ręcznie

Aby samodzielnie zainstalować interfejs wiersza poleceń Lightbuild i dodać go do PATH, wykonaj te czynności:

  1. Jeśli nie masz interfejsu wiersza poleceń Androida, zainstaluj go.

  2. Zainstaluj pakiet Lightbuild:

    android sdk install build/lightbuild/0.0.30

  3. Skopiuj interfejs wiersza poleceń Lightbuild do katalogu w PATH, aby móc uruchamiać lightbuild z dowolnego katalogu. Możesz go skopiować do dowolnego katalogu, który znajduje się już w zmiennej PATH, lub użyć tego samego katalogu, którego używa skrypt konfiguracyjny:

    • macOS i Linux: skopiuj plik lightbuild do ~/.local/bin:

      mkdir -p ~/.local/bin
cp "$(android info sdk)/build/lightbuild/0.0.30/cli/lightbuild" ~/.local/bin/

      Jeśli zmienna ~/.local/bin nie znajduje się w zmiennej PATH, dodaj ten wiersz do pliku startowego powłoki, np. ~/.zshrc lub ~/.bashrc:

      export PATH="$PATH:$HOME/.local/bin"

    • Windows: uruchom te polecenia w PowerShell. Kopiują plik lightbuild.exe do katalogu $HOME\AppData\LightbuildCLI i dodają ten katalog do zmiennej Path użytkownika, jeśli jeszcze go tam nie ma:

      $dir = "$HOME\AppData\LightbuildCLI"
New-Item -ItemType Directory -Force $dir | Out-Null
Copy-Item "$(android info sdk)\build\lightbuild\0.0.30\cli\lightbuild.exe" $dir
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if (($userPath -split ";") -notcontains $dir) { [Environment]::SetEnvironmentVariable("Path", "$userPath;$dir", "User") }

  4. Weryfikowanie instalacji

Weryfikowanie instalacji

Aby sprawdzić, czy interfejs wiersza poleceń Lightbuild jest zainstalowany, sprawdź jego wersję:

lightbuild --version

Jeśli terminal nie może znaleźć polecenia lightbuild, otwórz nowe okno terminala, aby zmiany w PATH zaczęły obowiązywać.

Znajdowanie celów kompilacji projektu

Polecenia interfejsu wiersza poleceń Lightbuild przyjmują cel, który identyfikuje część projektu do skompilowania, przetestowania lub sprawdzenia. Elementem docelowym może być nazwa modułu, np. app, lub coś bardziej szczegółowego, np. app:app-debug.apk. Aby dopasować wszystkie cele w module, użyj nazwy modułu, a po niej /..., np. app/.... Aby dopasować wszystkie cele w projekcie, użyj ....

Aby wyświetlić listę wszystkich celów w projekcie, wyślij zapytanie z katalogu głównego projektu:

lightbuild query ...

Aby wyświetlić listę plików, które tworzy cel, dodaj --output=files. Na przykład w przypadku celu app uruchom:

lightbuild query app --output=files

Aby wyświetlić listę poleceń dostępnych w projekcie, uruchom lightbuild help.

Tworzenie aplikacji

Aby utworzyć środowisko docelowe, uruchom lightbuild build z tym środowiskiem. Aby na przykład skompilować moduł app, uruchom:

lightbuild build app

Aby skompilować wszystkie cele w projekcie, uruchom:

lightbuild build

Aby usunąć dane wyjściowe kompilacji i pamięć podręczną projektu, uruchom:

lightbuild clean

Uruchom aplikację

Interfejs wiersza poleceń Lightbuild kompiluje aplikację, ale jej nie instaluje ani nie uruchamia. Aby uruchomić aplikację na połączonym urządzeniu lub działającym emulatorze, utwórz ją, a następnie uruchom za pomocą polecenia android run w interfejsie wiersza poleceń Androida:

lightbuild build app
android run --apks=app/build/app-debug.apk

Aby zobaczyć, gdzie każdy z celów modułu zapisuje dane wyjściowe, uruchom lightbuild query app/... --output=files. Lokalizacje są względne względem katalogu modułu.

Przeprowadzanie testów

Aby uruchomić wszystkie testy w projekcie, uruchom:

lightbuild test

To polecenie uruchamia testy lokalne, które są wykonywane na komputerze używanym do programowania, oraz testy z instrumentacją, które są wykonywane na połączonym urządzeniu lub uruchomionym emulatorze.

Aby uruchomić testy w jednym module, dodaj cel modułu, np. app-core. Aby uruchomić tylko jeden typ testu, dodaj do celu modułu :hostTest w przypadku testów lokalnych lub :deviceTest w przypadku testów z instrumentacją. Przykład:

lightbuild test app-core:hostTest
lightbuild test app-core:deviceTest

Rozwiązywanie zależności

Każdy moduł rejestruje rozwiązane zależności w pliku resolved.deps. Aby wygenerować plik resolved.deps dla modułu, uruchom lightbuild resolve z docelowym modułem. Na przykład w przypadku modułu app uruchom:

lightbuild resolve app

Aby rozwiązać wszystkie cele w projekcie, uruchom:

lightbuild resolve

Więcej informacji znajdziesz w sekcji Rozwiązane zależności.