Lightbuild projelerini komut satırından derleme

Lightbuild CLI, Lightbuild'in resmi komut satırı aracıdır. Projenizi derleyip test etmek, derleme hedeflerini bulmak ve bağımlılıklarını çözmek için lightbuild komutunu kullanın. Yapay zeka temsilcileriniz aynı komutları çalıştırabilir. Lightbuild şablonundan oluşturduğunuz projelerde, yapay zeka ajanlarına Lightbuild ve Lightbuild KSA ile nasıl çalışacaklarını bildiren bir AGENTS.md dosyası bulunur.

Lightbuild CLI'nin komutları ve seçenekleri hakkında daha fazla bilgi için Lightbuild CLI referansına bakın.

Lightbuild CLI'yı yükleme

Lightbuild KSA, Android KSA ile yüklediğiniz bir Android SDK paketi olarak dağıtılır. Tek bir komutla yükleyip kurabilir veya manuel olarak yükleyebilirsiniz.

Tek adımda yükleme ve ayarlama

Lightbuild CLI'yı yüklemek için işletim sisteminize uygun komutu çalıştırın. Komut, Android SDK'nıza Lightbuild CLI paketini yükler ve ardından paketin kurulum komut dosyasını çalıştırır. Bu komut dosyası, Lightbuild CLI'yı macOS ve Linux'ta ~/.local/bin dizinine, Windows'ta ise $HOME\AppData\LightbuildCLI dizinine kopyalar ve bu dizinin PATH dizininizde olduğundan emin olur:

  • macOS ve 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" }; if ($LASTEXITCODE -eq 0) { $env:Path += ";$HOME\AppData\LightbuildCLI"; setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null }

  • Windows (Komut İstemi):

    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" && setx LIGHTBUILD_REFRESH 1 >nul && reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f >nul

Komut tamamlandıktan sonra yüklemeyi doğrulayın.

Manuel olarak yükleme

Alternatif olarak, Lightbuild KSA'yı yüklemek ve PATH uygulamanıza kendiniz eklemek için aşağıdaki adımları uygulayın:

  1. Android KSA'nız yoksa yükleyin.

  2. Lightbuild paketini yükleyin:

    android sdk install build/lightbuild/0.0.30

  3. lightbuild komutunu herhangi bir dizinden çalıştırabilmek için Lightbuild KSA'yı PATH ortamınızdaki bir dizine kopyalayın. Bu dosyayı PATH değişkeninizde bulunan herhangi bir dizine kopyalayabilir veya kurulum komut dosyasının kullandığı dizini kullanabilirsiniz:

    • macOS ve Linux: lightbuild dosyasını ~/.local/bin dizinine kopyalayın:

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

      ~/.local/bin, PATH içinde değilse kabuğunuzun başlangıç dosyasına (ör. ~/.zshrc veya ~/.bashrc) aşağıdaki satırı ekleyin:

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

    • Windows: PowerShell'de aşağıdaki komutları çalıştırın. lightbuild.exe dosyasını $HOME\AppData\LightbuildCLI dizinine kopyalar, bu dizini kullanıcı Path dosyanıza ekler (henüz eklenmemişse) ve ardından değişikliğin mevcut oturumunuzda ve daha sonra açacağınız terminallerde geçerli olmasını sağlar:

      $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 = (Get-ItemProperty HKCU:\Environment).Path
if (($userPath -split ";") -notcontains $dir) { Set-ItemProperty HKCU:\Environment Path "$userPath;$dir" -Type ExpandString }
setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null
$env:Path += ";$dir"

  4. Yüklemeyi doğrulama

Yüklemeyi doğrulama

Lightbuild KSA'nın yüklü olduğunu doğrulamak için sürümünü kontrol edin:

lightbuild --version

Terminaliniz lightbuild komutunu bulamazsa PATH değişikliklerinizin geçerli olması için yeni bir terminal penceresi açın.

Projenizin derleme hedeflerini bulma

Lightbuild CLI komutları, projenizin derlenecek, test edilecek veya incelenecek bölümünü tanımlayan bir hedef alır. Hedef, app gibi bir modül adı veya app:app-debug.apk gibi daha spesifik bir şey olabilir. Bir modüldeki tüm hedefleri eşleştirmek için modülün adını ve ardından /... ifadesini kullanın (ör. app/...). Projenizdeki tüm hedefleri eşleştirmek için ... kullanın.

Projenizdeki tüm hedefleri listelemek için projenizin kök dizininden sorgulayın:

lightbuild query ...

Bir hedefin ürettiği dosyaları listelemek için --output=files ekleyin. Örneğin, app hedefi için şunu çalıştırın:

lightbuild query app --output=files

Projenizde kullanılabilen komutları listelemek için lightbuild help komutunu çalıştırın.

Uygulamanızı geliştirin

Bir hedefi derlemek için hedefle birlikte lightbuild build komutunu çalıştırın. Örneğin, app modülünü derlemek için şu komutu çalıştırın:

lightbuild build app

Projenizdeki tüm hedefleri oluşturmak için şu komutu çalıştırın:

lightbuild build

Google Play'e yükleyebileceğiniz imzalı bir sürüm uygulama paketi oluşturmak için Lightbuild uygulamanızı yayınlama başlıklı makaleyi inceleyin.

Projenizin derleme çıkışını ve önbelleklerini kaldırmak için şu komutu çalıştırın:

lightbuild clean

Uygulamanızı çalıştırma

Lightbuild CLI, uygulamanızı derler ancak yüklemez veya çalıştırmaz. Uygulamanızı bağlı bir cihazda veya çalışan bir emülatörde çalıştırmak için uygulamayı derleyin ve ardından Android KSA'da android run komutuyla çalıştırın:

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

Bir modülün hedeflerinin her birinin çıkışını nereye yazdığını görmek için şunu çalıştırın: lightbuild query app/... --output=files. Konumlar, modülün dizinine göredir.

Testler yapın

Projenizdeki tüm testleri çalıştırmak için şu komutu çalıştırın:

lightbuild test

Bu komut, geliştirme makinenizde çalışan yerel testlerinizi ve bağlı bir cihazda veya çalışan bir emülatörde çalışan araçlı testlerinizi çalıştırır.

Testleri tek bir modülde çalıştırmak için modülün hedefini (ör. app-core) ekleyin. Yalnızca bir tür test çalıştırmak için modülün hedefine yerel testler için :hostTest, enstrümantasyon testleri için :deviceTest ekleyin. Örneğin:

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

Bağımlılıkları çözme

Her modül, çözümlenen bağımlılıklarını bir resolved.deps dosyasına kaydeder. Bir modül için resolved.deps dosyasını oluşturmak üzere modülün hedefiyle lightbuild resolve komutunu çalıştırın. Örneğin, app modülü için şu komutu çalıştırın:

lightbuild resolve app

Projenizdeki tüm hedefleri çözmek için şu komutu çalıştırın:

lightbuild resolve

Daha fazla bilgi için Çözümlenen bağımlılıklar bölümüne bakın.