Bu sayfada, bazel build
, bazel run
ve bazel test
gibi çeşitli Bazel komutlarıyla kullanılabilen seçenekler ele alınmaktadır. Bu sayfa, Bazel ile derleme başlıklı makaledeki Bazel komutları listesinin tamamlayıcısıdır.
Hedef söz dizimi
build
veya test
gibi bazı komutlar, hedef listesinde çalışabilir. Oluşturulacak hedefleri belirtme bölümünde açıklanan, etiketlerden daha esnek bir söz dizimi kullanırlar.
Seçenekler
Aşağıdaki bölümlerde, derleme sırasında kullanılabilecek seçenekler açıklanmaktadır. Bir yardım komutunda --long
kullanıldığında, online yardım mesajları her bir seçeneğin anlamı, türü ve varsayılan değeri hakkında özet bilgiler sağlar.
Çoğu seçenek yalnızca bir kez belirtilebilir. Birden çok kez belirtildiğinde son örnek kazanır. Birden çok kez belirtilebilen seçenekler, online yardımda "birden çok kez kullanılabilir" ifadesiyle belirtilir.
Paket konumu
--package_path
Bu seçenek, belirli bir paketin BUILD dosyasını bulmak için aranan dizin grubunu belirtir.
Bazel, paket yolunda arama yaparak paketlerini bulur. Bu, her biri kısmi bir kaynak ağacının kökü olan bazel dizinlerinin iki noktayla ayrılmış sıralı listesidir.
--package_path
seçeneğini kullanarak özel bir paket yolu belirtmek için:
% bazel build --package_path %workspace%:/some/other/root
Paket yolu öğeleri üç biçimde belirtilebilir:
- İlk karakter
/
ise yol mutlaktır. - Yol
%workspace%
ile başlıyorsa en yakın kapsayıcı bazel dizine göre alınır. Örneğin, çalışma dizininiz/home/bob/clients/bob_client/bazel/foo
ise package-path parametresindeki%workspace%
dizesi/home/bob/clients/bob_client/bazel
olarak genişletilir. - Diğer tüm değerler çalışma dizinine göre alınır.
Genellikle bunu yapmak istemezsiniz ve Bazel'i bazel çalışma alanının altındaki dizinlerden kullanırsanız beklenmedik şekilde davranabilir.
Örneğin,
.
paket yolu öğesini kullanır ve ardından cd komutuyla/home/bob/clients/bob_client/bazel/foo
dizine giderseniz paketler/home/bob/clients/bob_client/bazel/foo
dizininden çözülür.
Varsayılan olmayan bir paket yolu kullanıyorsanız kolaylık sağlaması için bunu Bazel yapılandırma dosyanızda belirtin.
Bazel, paketlerin mevcut dizinde olmasını gerektirmez. Bu nedenle, gerekli tüm paketler paket yolunda başka bir yerde bulunabiliyorsa boş bir bazel çalışma alanından derleme yapabilirsiniz.
Örnek: Boş bir istemciden derleme
% mkdir -p foo/bazel % cd foo/bazel % touch WORKSPACE % bazel build --package_path /some/other/path //foo
--deleted_packages
Bu seçenek, Bazel'in silinmiş olarak kabul etmesi ve paket yolundaki herhangi bir dizinden yükleme denemesi yapmaması gereken paketlerin virgülle ayrılmış bir listesini belirtir. Bu yöntem, paketleri gerçekten silmeden paketlerin silinmesini simüle etmek için kullanılabilir.
Hata kontrolü
Bu seçenekler, Bazel'in hata kontrolünü ve/veya uyarılarını kontrol eder.
--[no]check_visibility
Bu seçenek yanlış değerine ayarlanırsa görünürlük kontrolleri uyarı olarak düşürülür. Bu seçeneğin varsayılan değeri, görünürlük kontrolü varsayılan olarak yapılır.
--output_filter=regex
--output_filter
seçeneği yalnızca normal ifadeyle eşleşen hedefler için derleme ve derleme uyarılarını gösterir. Bir hedef, verilen normal ifadeyle eşleşmezse ve yürütülmesi başarılı olursa standart çıkışı ve standart hatası atılır.
Aşağıda bu seçenek için bazı tipik değerler verilmiştir:
`--output_filter='^//(first/project|second/project):'` | Belirtilen paketlerin çıkışını gösterin. |
`--output_filter='^//((?!(first/bad_project|second/bad_project):).)*$'` | Belirtilen paketlerin çıkışını göstermez. |
`--output_filter=` | Her şeyi göster. |
`--output_filter=DONT_MATCH_ANYTHING` | Hiçbir şey gösterme. |
Araç işaretleri
Bu seçenekler, Bazel'in diğer araçlara hangi seçenekleri ileteceğini kontrol eder.
--copt=cc-option
Bu seçenek, derleyiciye iletilecek bir bağımsız değişken alır. Bağımsız değişken; ön işleme, derleme ve/veya C, C++ ya da derleyici kodu derlemek için çağrıldığında derleyiciye aktarılır. Bağlantı oluştururken iletilmez.
Bu seçenek birden çok kez kullanılabilir. Örneğin:
% bazel build --copt="-g0" --copt="-fpic" //foo
foo
kitaplığını hata ayıklama tabloları olmadan derleyerek konuma bağımlı olmayan kod oluşturur.
--host_copt=cc-option
Bu seçenek, ana makine yapılandırmasında derlenen kaynak dosyalar için derleyiciye iletilecek bir bağımsız değişkeni alır. Bu, --copt
seçeneğine benzer ancak yalnızca ana makine yapılandırması için geçerlidir.
--host_conlyopt=cc-option
Bu seçenek, ana makine yapılandırmasında derlenen C kaynak dosyaları için derleyiciye iletilecek bir bağımsız değişken alır. Bu, --conlyopt
seçeneğine benzer ancak yalnızca ana makine yapılandırması için geçerlidir.
--host_cxxopt=cc-option
Bu seçenek, ana makine yapılandırmasında derlenen C++ kaynak dosyaları için derleyiciye iletilecek bir bağımsız değişken alır. Bu, --cxxopt
seçeneğine benzer ancak yalnızca ana makine yapılandırması için geçerlidir.
--host_linkopt=linker-option
Bu seçenek, ana makine yapılandırmasında derlenen kaynak dosyalar için bağlayıcıya iletilecek bir bağımsız değişkeni alır. Bu, --linkopt
seçeneğine benzer ancak yalnızca ana makine yapılandırması için geçerlidir.
--conlyopt=cc-option
Bu seçenek, C kaynak dosyaları derlenirken derleyiciye iletilecek bir bağımsız değişkeni alır.
Bu, --copt
'e benzer ancak yalnızca C derlemesi için geçerlidir, C++ derlemesi veya bağlama için geçerli değildir. Bu nedenle, --conlyopt
kullanarak C'ye özgü seçenekleri (-Wno-pointer-sign
gibi) iletebilirsiniz.
--cxxopt=cc-option
Bu seçenek, C++ kaynak dosyaları derlenirken derleyiciye iletilecek bir bağımsız değişken alır.
Bu --copt
işlevine benzer ancak yalnızca C++ derlemesi için geçerlidir. C derlemesi veya bağlama için geçerli değildir. Bu nedenle, --cxxopt
kullanarak C++'ya özgü seçenekleri (-fpermissive
veya -fno-implicit-templates
gibi) iletebilirsiniz.
Örneğin:
% bazel build --cxxopt="-fpermissive" --cxxopt="-Wno-error" //foo/cruddy_code
--linkopt=linker-option
Bu seçenek, bağlantı oluştururken derleyiciye iletilecek bir bağımsız değişken alır.
Bu, --copt
'e benzer ancak yalnızca bağlantı oluşturma için geçerlidir, derleme için geçerli değildir. Bu nedenle, yalnızca bağlantı sırasında anlamlı olan derleyici seçeneklerini (-lssp
veya -Wl,--wrap,abort
gibi) --linkopt
kullanarak iletebilirsiniz. Örneğin:
% bazel build --copt="-fmudflap" --linkopt="-lmudflap" //foo/buggy_code
Derleme kuralları, özelliklerinde de bağlantı seçeneklerini belirtebilir. Bu seçeneğin ayarları her zaman önceliklidir. Ayrıca cc_library.linkopts parametresine de bakın.
--strip (always|never|sometimes)
Bu seçenek, Bazel'in -Wl,--strip-debug
seçeneğiyle bağlayıcıyı çağırarak tüm ikili dosyalardan ve paylaşılan kitaplıklardan hata ayıklama bilgilerini kaldırıp kaldırmayacağını belirler.
--strip=always
, hata ayıklama bilgilerinin her zaman kaldırılacağı anlamına gelir.
--strip=never
, hata ayıklama bilgilerinin hiçbir zaman kaldırılmayacağı anlamına gelir.
--strip=sometimes
değerinin varsayılan değeri, --compilation_mode
fastbuild
ise sarmalama anlamına gelir.
% bazel build --strip=always //foo:bar
, oluşturulan tüm ikili dosyalardan hata ayıklama bilgilerini kaldırırken hedefi derleyecektir.
Bazel'in --strip
seçeneği, ld'nin --strip-debug
seçeneğine karşılık gelir: Yalnızca hata ayıklama bilgilerini kaldırır. Herhangi bir nedenle yalnızca hata ayıklama simgelerini değil, tüm simgeleri kaldırmak istiyorsanız ld'nin --strip-all
seçeneğini kullanmanız gerekir. Bunu yapmak için --linkopt=-Wl,--strip-all
değerini Bazel'e iletmeniz gerekir. Ayrıca Bazel'in --strip
işaretini ayarladığınızda --linkopt=-Wl,--strip-all
işaretinin geçersiz kılınacağını unutmayın. Bu nedenle, yalnızca birini ayarlamanız gerekir.
Yalnızca tek bir ikili dosya oluşturuyorsanız ve tüm sembollerin kaldırılmasını istiyorsanız --stripopt=--strip-all
parametresini iletebilir ve hedefin //foo:bar.stripped
sürümünü açıkça derleyebilirsiniz. --stripopt
bölümünde açıklandığı gibi, bu işlem, stripping işlemini derlemenin tüm bağlantı işlemlerine dahil etmek yerine nihai ikili bağlandıktan sonra bir stripping işlemi uygular.
--stripopt=strip-option
Bu, *.stripped
ikili dosyası oluştururken strip
komutuna iletilen ek bir seçenektir. Varsayılan değer -S -p
'tir. Bu seçenek birden çok kez kullanılabilir.
--fdo_instrument=profile-output-dir
--fdo_instrument
seçeneği, oluşturulan C/C++ ikili programı yürütüldüğünde FDO (geri bildirim yönlendirmeli optimizasyon) profili çıkışının oluşturulmasını sağlar. GCC için sağlanan bağımsız değişken, her .o dosyası için profil bilgilerini içeren .gcda dosyalarının nesne başına dosya dizini ağacı için dizin ön eki olarak kullanılır.
Profil veri ağacı oluşturulduktan sonra, FDO'ya göre optimize edilmiş derlemeyi etkinleştirmek için profil ağacı sıkıştırılmalı ve --fdo_optimize=profile-zip
Bazel seçeneğine sağlanmalıdır.
LLVM derleyicisi için bu bağımsız değişken, ham LLVM profil veri dosyalarının döküldüğü dizindir. Örneğin:
--fdo_instrument=/path/to/rawprof/dir/
.
--fdo_instrument
ve --fdo_optimize
seçenekleri aynı anda kullanılamaz.
--fdo_optimize=profile-zip
--fdo_optimize
seçeneği, derleme sırasında FDO (geri bildirim odaklı optimizasyon) optimizasyonları gerçekleştirmek için nesne başına dosya profili bilgilerinin kullanılmasını sağlar. GCC için sağlanan bağımsız değişken, her .o dosyası için profil bilgilerini içeren .gcda dosyalarının önceden oluşturulmuş dosya ağacını içeren zip dosyasıdır.
Alternatif olarak, sağlanan bağımsız değişken .afdo uzantısı ile tanımlanan bir otomatik profili de gösterebilir.
LLVM derleyicisi için sağlanan bağımsız değişken, llvm-profdata aracı tarafından hazırlanan dizine eklenen LLVM profil çıkış dosyasını işaret etmeli ve .profdata uzantısına sahip olmalıdır.
--fdo_instrument
ve --fdo_optimize
seçenekleri aynı anda kullanılamaz.
--[no]output_symbol_counts
Etkinleştirilirse C++ yürütülebilir ikilisinin her altın çağrılan bağlantısı, --print-symbol-counts
altın seçeneği aracılığıyla bir simge sayısı dosyası oluşturur. Dosya, her bir bağlayıcı girişi için tanımlanan simgelerin sayısını ve ikili dosyada kullanılan simgelerin sayısını günlüğe kaydeder.
Bu bilgiler, gereksiz bağlantı bağımlılıkları izlemek için kullanılabilir.
Simge sayıları dosyası, [targetname].sc
adıyla ikili dosyanın çıkış yoluna yazılır.
Bu seçenek varsayılan olarak devre dışıdır.
--java_language_version=version
Bu seçenek, Java kaynaklarının sürümünü belirtir. Örneğin:
% bazel build --java_language_version=8 java/com/example/common/foo:all
derleyip yalnızca Java 8 spesifikasyonuyla uyumlu yapılara izin verir.
Varsayılan değer 11'dir. -->
Olası değerler: 8, 9, 10, 11, 14 ve 15'tir. default_java_toolchain
kullanılarak özel Java araç zincirleri kaydedilerek bu değerler uzatılabilir.
--tool_java_language_version=version
Derleme sırasında çalıştırılan araçları oluşturmak için kullanılan Java dili sürümü. Varsayılan değer 11'dir.
--java_runtime_version=version
Bu seçenek, kodu yürütmek ve testleri çalıştırmak için kullanılacak JVM sürümünü belirtir. Örneğin:
% bazel run --java_runtime_version=remotejdk_11 java/com/example/common/foo:java_application
JDK 11'i uzak bir depodan indirip Java uygulamasını bu sürümü kullanarak çalıştırır.
Varsayılan değer localjdk
'tür.
Olası değerler: localjdk
, localjdk_version
,
remotejdk_11
ve remote_jdk17
.
local_java_repository
veya remote_java_repostory
depolama alanı kurallarını kullanarak özel JVM kaydederek değerleri genişletebilirsiniz.
--tool_java_runtime_version=version
Derleme sırasında ihtiyaç duyulan araçları çalıştırmak için kullanılan JVM sürümü.
Varsayılan değer remotejdk_11
'tür.
--jvmopt=jvm-option
Bu seçenek, seçenek bağımsız değişkenlerinin Java sanal makinesine aktarılmasına izin verir. Tek bir büyük bağımsız değişkenle veya bağımsız değişkenlerle birden çok kez kullanılabilir. Örneğin:
% bazel build --jvmopt="-server -Xms256m" java/com/example/common/foo:all
tüm Java ikililerini başlatmak için sunucu sanal makinesini kullanır ve sanal makinenin başlangıç yığın boyutunu 256 MB'a ayarlar.
--javacopt=javac-option
Bu seçenek, seçenek bağımsız değişkenlerinin Javac'ye geçirilmesine izin verir. Tek bir büyük bağımsız değişkenle veya tek tek bağımsız değişkenlerle birden çok kez kullanılabilir. Örneğin:
% bazel build --javacopt="-g:source,lines" //myprojects:prog
bir java_binary dosyasını javac varsayılan hata ayıklama bilgileriyle (bazel varsayılan yerine) yeniden oluşturur.
Seçenek, javac için Bazel yerleşik varsayılan seçeneklerinden sonra ve kural başına seçeneklerden önce javac'a iletilir. Herhangi bir Javac seçeneğinin son spesifikasyonu kazanır. Javac için varsayılan seçenekler şunlardır:
-source 8 -target 8 -encoding UTF-8
--strict_java_deps (default|strict|off|warn|error)
Bu seçenek, Javac'nin eksik doğrudan bağımlılıkları kontrol edip etmediğini kontrol eder. Java hedefleri, doğrudan kullanılan tüm hedefleri bağımlılık olarak açıkça belirtmelidir. Bu işaret, javac'ya her bir Java dosyasının tür kontrolü için gerçekte kullanılan jar'ları belirlemesi ve mevcut hedefin doğrudan bağımlılığının çıktısı değilse uyar/hata mesajı ekleme talimatı verir.
off
, kontrolün devre dışı olduğu anlamına gelir.warn
, javac'ın eksik her doğrudan bağımlılık için[strict]
türündeki standart Java uyarıları oluşturacağı anlamına gelir.default
,strict
veerror
seçeneklerinin tümü, javac'ın uyarı yerine hata oluşturacağı anlamına gelir. Bu da, eksik doğrudan bağımlılık bulunursa geçerli hedefin derlenmesinin başarısız olmasına neden olur. Bu, işaret belirtilmediğinde de varsayılan davranıştır.
Anlamsal yapı oluşturma
Bu seçenekler derleme komutlarını ve/veya çıkış dosyası içeriklerini etkiler.
--compilation_mode (fastbuild|opt|dbg)
(-c)
--compilation_mode
seçeneği (genellikle -c
veya özellikle -c opt
olarak kısaltılır) fastbuild
, dbg
veya opt
bağımsız değişkeni alır ve optimizasyon düzeyi ve hata ayıklama tablolarının eksiksizliği gibi çeşitli C/C++ kod oluşturma seçeneklerini etkiler. Bazel, her derleme modu için farklı bir çıkış dizini kullanır. Böylece her seferde tamamen yeniden derleme yapmanıza gerek kalmadan modlar arasında geçiş yapabilirsiniz.
fastbuild
, mümkün olduğunca hızlı derleme anlamına gelir: minimum hata ayıklama bilgisi oluşturun (-gmlt -Wl,-S
) ve optimize etmeyin. Bu varsayılan ayardır. Not:-DNDEBUG
ayarlanmaz.dbg
, gdb'yi (veya başka bir hata ayıklayıcıyı) kullanabilmeniz için hata ayıklama özelliği etkinleştirilmiş şekilde (-g
) derleme anlamına gelir.opt
, optimizasyon etkin veassert()
çağrıları devre dışı (-O2 -DNDEBUG
) olarak derleme anlamına gelir.--copt -g
parametresini de iletmediğiniz sürece hata ayıklama bilgileriopt
modunda oluşturulmaz.
--cpu=cpu
Bu seçenek, derleme sırasında ikili dosyaların derlenmesi için kullanılacak hedef CPU mimarisini belirtir.
--action_env=VAR=VALUE
Tüm işlemlerin yürütülmesi sırasında kullanılabilen ortam değişkenleri grubunu belirtir.
Değişkenler adıyla belirtilebilir. Bu durumda değer, çağırma ortamından alınır. Değişkenler, name=value
çiftiyle de belirtilebilir. Bu durumda değer, çağırma ortamından bağımsız olarak ayarlanır.
Bu --action_env
işareti birden çok kez belirtilebilir. Birden fazla --action_env
işaretinde aynı değişkene bir değer atanırsa en son atama geçerli olur.
--experimental_action_listener=label
experimental_action_listener
seçeneği, Bazel'e extra_actions
'yi derleme grafiğine eklemek için label tarafından belirtilen action_listener
kuralındaki ayrıntıları kullanmasını söyler.
--[no]experimental_extra_action_top_level_only
Bu seçenek true (doğru) değerine ayarlanırsa --experimental_action_listener
komut satırı seçeneğiyle belirtilen ek işlemler yalnızca üst düzey hedefler için planlanır.
--experimental_extra_action_filter=regex
experimental_extra_action_filter
seçeneği, Bazel'e extra_actions
için planlanacak hedef grubunu filtrelemesini söyler.
Bu işaret yalnızca --experimental_action_listener
işaretiyle birlikte kullanılabilir.
Varsayılan olarak, oluşturma için istenen hedeflerin geçişli kapatma sürecindeki tüm extra_actions
işlemleri yürütülmek üzere planlanır.
--experimental_extra_action_filter
, planlamayı extra_actions
ile kısıtlar ve sahibin etiketi belirtilen normal ifadeyle eşleşir.
Aşağıdaki örnekte, extra_actions
planlaması yalnızca sahibinin etiketinde "/bar/" bulunan işlemler için geçerli olacak şekilde sınırlandırılmıştır:
% bazel build --experimental_action_listener=//test:al //foo/... \ --experimental_extra_action_filter=.*/bar/.*
--host_cpu=cpu
Bu seçenek, ana makine araçlarını oluşturmak için kullanılması gereken CPU mimarisinin adını belirtir.
--fat_apk_cpu=cpu[,cpu]*
android_binary
kurallarının geçişli deps
için C/C++ kitaplıkları oluşturacak CPU'lar. Diğer C/C++ kuralları etkilenmez. Örneğin, bir android_binary
kuralının ve bir cc_binary
kuralının geçişli deps
özelliğinde bir cc_library
varsa cc_library
en az iki kez oluşturulur: android_binary
kuralı için --fat_apk_cpu
ile belirtilen her CPU için bir kez ve cc_binary
kuralı için --cpu
ile belirtilen CPU için bir kez.
Varsayılan değer: armeabi-v7a
.
--fat_apk_cpu
ile belirtilen her CPU için bir .so
dosyası oluşturulur ve APK'ya paketlenir. .so
dosyasının adında, android_binary
kuralının adı "lib" ile başlar. Örneğin, android_binary
öğesinin adı "foo" ise dosya libfoo.so
olur.
--per_file_copt=[+-]regex[,[+-]regex]...@option[,option]...
Mevcut olduğunda, dahil etme normal ifadesi ifadelerinden biriyle eşleşen ve hariç tutma ifadelerinin hiçbiriyle eşleşmeyen bir etikete veya yürütme yoluna sahip olan tüm C++ dosyaları, belirtilen seçeneklerle oluşturulur. Etiket eşleştirme, etiketin standart biçimini kullanır (ör. //package
:label_name
).
Yürütme yolu, C++ dosyasının temel adını (uzantı dahil) içeren çalışma alanı dizininizin göreli yoludur. Platforma bağlı ön ekler de buna dahildir.
Bazel, oluşturulan dosyalarla (ör. genrule çıkışları) eşleştirme yapmak için yalnızca yürütme yolunu kullanabilir. Bu durumda normal ifade, herhangi bir yürütme yoluyla eşleşmediğinden "//" ile başlamamalıdır. Paket adları şu şekilde kullanılabilir:
--per_file_copt=base/.*\.pb\.cc@-g0
. Bu, base
adlı bir dizin altındaki her .pb.cc
dosyasıyla eşleşir.
Bu seçenek birden çok kez kullanılabilir.
Bu seçenek, kullanılan derleme modundan bağımsız olarak uygulanır. Örneğin, --compilation_mode=opt
ile derleme yapmak ve daha güçlü optimizasyonun açık olduğu veya optimizasyonu devre dışı bırakılmış bazı dosyaları seçerek derleyebilirsiniz.
Uyarı: Bazı dosyalar hata ayıklama simgeleriyle seçmeli olarak derlenirse simgeler bağlantı sırasında kaldırılabilir. Bu, --strip=never
ayarlanarak önlenebilir.
Söz dizimi: [+-]regex[,[+-]regex]...@option[,option]...
Burada regex
, dahil edilen kalıpları tanımlamak için +
, hariç tutulan kalıpları tanımlamak için -
ön ekiyle eklenebilen bir normal ifadeyi temsil eder. option
, C++ derleyicisine iletilen rastgele bir seçeneği temsil eder. Bir seçenek ,
içeriyorsa \,
gibi tırnak içine alınmalıdır. Normal ifadeleri seçeneklerden ayırmak için yalnızca ilk @
kullanıldığından seçenekler, @
değerini de içerebilir.
Örnek:
--per_file_copt=//foo:.*\.cc,-//foo:file\.cc@-O0,-fprofile-arcs
file.cc
hariç //foo/
içindeki tüm .cc
dosyaları için C++ derleyicisinin komut satırına -O0
ve -fprofile-arcs
seçeneklerini ekler.
--dynamic_mode=mode
Derleme kurallarındaki linkstatic özelliği ile etkileşime geçerek C++ ikili dosyalarının dinamik olarak bağlanıp bağlanmayacağını belirler.
Modlar:
auto
: Platforma bağlı bir moda dönüştürülür; linux içindefault
, cygwin içinoff
.default
: Bazel'in dinamik olarak bağlanıp bağlanmayacağını seçmesine olanak tanır. Daha fazla bilgi için linkstatic adresine göz atın.fully
: Tüm hedefleri dinamik olarak bağlar. Bu, bağlama süresini hızlandırır ve ortaya çıkan ikili dosyaların boyutunu azaltır.off
: Tüm hedefleri çoğunlukla statik modda bağlar. linkopts parametresinde-static
ayarlanırsa hedefler tamamen statik olarak değişir.
--fission (yes|no|[dbg][,opt][,fastbuild])
C++ hata ayıklama bilgilerini, normalde yazılacağı .o dosyaları yerine özel .dwo dosyalarına yazan Fission'u etkinleştirir. Bu, bağlantıların giriş boyutunu önemli ölçüde azaltır ve bağlantı sürelerini kısaltabilir.
[dbg][,opt][,fastbuild]
olarak ayarlandığında (örnek: --fission=dbg,fastbuild
), Fission yalnızca belirtilen derleme modları grubu için etkinleştirilir. Bu, bazelrc ayarları için yararlıdır. yes
olarak ayarlandığında Fission evrensel olarak etkinleştirilir. no
olarak ayarlandığında Fission evrensel olarak devre dışı bırakılır. no
varsayılandır.
--force_ignore_dash_static
Bu işaret ayarlanırsa cc_*
kuralları BUILD dosyalarının linkopts bölümündeki tüm -static
seçenekleri yoksayılır. Bu, yalnızca C++ sertleştirme derlemeleri için bir geçici çözüm olarak tasarlanmıştır.
--[no]force_pic
Etkinleştirilirse tüm C++ derlemeleri konumdan bağımsız kod ("-fPIC") oluşturur, bağlantılar PIC olmayan kitaplıklar yerine önceden derlenmiş PIC kitaplıklarını tercih eder ve bağlantılar konumdan bağımsız yürütülebilir dosyalar ("-pie") oluşturur. Varsayılan olarak devre dışıdır.
--android_resource_shrinking
android_binary kuralları için kaynak küçültme işleminin yapılıp yapılmayacağını seçer. android_binary kurallarında shrink_resources özelliği için varsayılan değeri belirler. Daha fazla bilgi için ilgili kuralın dokümanlarına bakın. Varsayılan olarak kapalı değerine ayarlanır.
--custom_malloc=malloc-library-target
Belirtildiğinde, varsayılan değeri kullanan hedefler de dahil olmak üzere tüm malloc="target"
özelliklerini geçersiz kılarak her zaman belirtilen malloc uygulamasını kullanın (malloc
belirtilmez).
--crosstool_top=label
Bu seçenek, derleme sırasında tüm C++ derlemeleri için kullanılacak çapraz araç derleyici paketinin konumunu belirtir. Bazel, bu konumda bir CROSSTOOL dosyası arar ve --compiler
ayarlarını otomatik olarak belirlemek için bu dosyayı kullanır.
--host_crosstool_top=label
Belirtilmemişse Bazel, derleme sırasında çalıştırılan araçlar gibi ana makine yapılandırmasında kodu derlemek için --crosstool_top
değerini kullanır. Bu işaretin temel amacı, çapraz derlemeyi etkinleştirmektir.
--apple_crosstool_top=label
objc*, ios* ve apple* kurallarının geçişli deps
içinde C/C++ kurallarını derlemek için kullanılan çapraz araç. Bu işaret, söz konusu hedefler için --crosstool_top
değerinin üzerine yazar.
--android_crosstool_top=label
C/C++ kurallarını android_binary
kurallarının geçişli deps
içinde derlemek için kullanılacak çapraz araç. Bu, derlemedeki diğer hedefler için farklı bir çapraz araç gerekiyorsa yararlıdır. Varsayılan olarak, WORKSPACE dosyasında android_ndk_repository
kuralı tarafından oluşturulan çapraz araç kullanılır.
Ayrıca --fat_apk_cpu
adresini de inceleyin.
--compiler=version
Bu seçenek, derleme sırasında ikili programların derlenmesinde kullanılacak C/C++ derleyici sürümünü (gcc-4.1.0
gibi) belirtir. Özel bir çapraz araçla derlemek istiyorsanız bu işareti belirtmek yerine bir CROSSTOOL dosyası kullanmanız gerekir.
--android_sdk=label
Bu seçenek, Android ile ilgili kuralları derlemek için kullanılacak Android SDK/platform araç zincirini ve Android çalışma zamanı kitaplığını belirtir.
WORKSPACE dosyasında bir android_sdk_repository
kural tanımlanırsa Android SDK otomatik olarak seçilir.
--java_toolchain=label
Bu seçenek, Java kaynak dosyalarını derlemek için kullanılan java_toolchain etiketini belirtir.
--host_java_toolchain=label
Belirtilmemişse bazel, ana makine yapılandırmasında kodu derlemek için --java_toolchain
değerini kullanır (ör. derleme sırasında çalıştırılan araçlar için). Bu işaretin temel amacı, çapraz derlemeyi etkinleştirmektir.
--javabase=(label)
Bu seçenek, temel Java yüklemesinin etiketini bazel çalıştırma, bazel test ve java_binary
ile java_test
kuralları tarafından oluşturulan Java ikili programları için kullanılacak şekilde ayarlar. JAVABASE
ve JAVA
"Yap" değişkenleri bu seçenekten türetilir.
--host_javabase=label
Bu seçenek, ana Java kurulumunun etiketini, örneğin JavaBuilder ve Singlejar gibi ana makine derleme araçları için ana makine yapılandırmasında kullanılacak şekilde ayarlar.
Bu işlem, Java kaynak dosyalarını derlemek için kullanılan Java derleyicisini seçmez. Derleyici, --java_toolchain
seçeneği ayarlanarak seçilebilir.
Yürütme stratejisi
Bu seçenekler, Bazel'in derlemeyi nasıl yürüteceğini etkiler. Bu değişikliklerin, derleme işlemi tarafından oluşturulan çıkış dosyaları üzerinde önemli bir etkisi olmamalıdır. Genellikle ana etkileri derleme hızıdır.
--spawn_strategy=strategy
Bu seçenek, komutların nerede ve nasıl yürütüleceğini kontrol eder.
standalone
, komutların yerel alt işlemler olarak yürütülmesine neden olur. Bu değerin desteği sonlandırılmıştır. Lütfen bunun yerinelocal
sütunlarını kullanın.sandboxed
, komutların yerel makinedeki bir korumalı alanda yürütülmesine neden olur. Bu, tüm giriş dosyalarının, veri bağımlılıklarının ve araçlarınınsrcs
,data
vetools
özelliklerinde doğrudan bağımlılık olarak listelenmesini gerektirir. Bazel, korumalı alan yürütmeyi destekleyen sistemlerde varsayılan olarak yerel korumalı alanı etkinleştirir.local
, komutların yerel alt işlem olarak yürütülmesine neden olur.worker
, varsa komutların kalıcı çalışan kullanılarak yürütülmesine neden olur.docker
, komutların yerel makinedeki bir Docker korumalı alanında yürütülmesine neden olur. Bunun için Docker'ın yüklü olması gerekir.remote
, komutların uzaktan yürütülmesine neden olur. Bu seçenek yalnızca uzaktan yürütücü ayrı olarak yapılandırılmışsa kullanılabilir.
--strategy mnemonic=strategy
Bu seçenek, komutların nerede ve nasıl yürütüleceğini kontrol eder. --spawn_strategy (ve Genrule kısaltması içeren --genrule_strategy) seçeneğini kısaltma bazında geçersiz kılar. Desteklenen stratejiler ve etkileri için --spawn_strategy bölümüne bakın.
--strategy_regexp=<filter,filter,...>=<strategy>
Bu seçenek, açıklamaları belirli bir regex_filter
ile eşleşen komutları yürütmek için hangi stratejinin kullanılacağını belirtir. regex_filter eşleşmesiyle ilgili ayrıntılar için --per_file_copt bölümüne bakın. Desteklenen stratejiler ve etkileri için --spawn_strategy bölümüne bakın.
Açıklamayla eşleşen son regex_filter
kullanılır. Bu seçenek, stratejiyi belirtmek için diğer işaretleri geçersiz kılar.
- Örnek:
--strategy_regexp=//foo.*\\.cc,-//foo/bar=local
, açıklamaları //foo.*.cc ile eşleşiyorsa ancak //foo/bar ile eşleşmiyorsalocal
stratejisini kullanarak işlemleri çalıştırır. - Örnek:
--strategy_regexp='Compiling.*/bar=local' --strategy_regexp=Compiling=sandboxed
, "//foo/bar/baz derleniyor" komutunusandboxed
stratejisiyle çalıştırır ancak sırayı tersine çevirereklocal
ile çalıştırır. - Örnek:
--strategy_regexp='Compiling.*/bar=local,sandboxed'
,local
stratejisiyle "//foo/bar/baz derleniyor" komutunu çalıştırır ve başarısız olursasandboxed
stratejisine geçer.
--genrule_strategy=strategy
Bu, --strategy=Genrule=strategy
için kullanımdan kaldırılmış bir kısaltmadır.
--jobs=n
(-j)
Tam sayı bağımsız değişkeni alan bu seçenek, derlemenin yürütme aşaması sırasında eş zamanlı olarak yürütülmesi gereken işlerin sayısını sınırlandırır.
--progress_report_interval=n
Bazel, henüz tamamlanmamış işlerle (ör. uzun süreli testler) ilgili düzenli olarak bir ilerleme raporu yazdırır. Bu seçenek, raporlama sıklığını belirler. İlerleme durumu n
saniyede bir yazdırılır.
Varsayılan değer 0'dır. Bu, artımlı bir algoritma anlamına gelir: İlk rapor 10 saniye sonra, ardından 30 saniye sonra yazdırılır ve bundan sonra ilerleme durumu her dakika bir raporlanır.
Bazel, --curses
tarafından belirtildiği gibi imleç kontrolünü kullanırken ilerleme durumu her saniye raporlanır.
--local_{ram,cpu}_resources resources or resource expression
Bu seçenekler, Bazel'in yerel olarak çalıştırılacak derleme ve test etkinliklerini planlarken dikkate alabileceği yerel kaynak miktarını (MB cinsinden RAM ve mantıksal CPU çekirdeği sayısı) belirtir. Bu parametreler, bir tam sayı veya bir anahtar kelimeyi (HOST_RAM veya HOST_CPUS) ve isteğe bağlı olarak [-|*
float]
değerini (ör. --local_cpu_resources=2
, --local_ram_resources=HOST_RAM*.5
, --local_cpu_resources=HOST_CPUS-1
) alır. İşaretler bağımsızdır; bunlardan biri veya ikisi de ayarlanabilir. Bazel, varsayılan olarak RAM miktarını ve CPU çekirdek sayısını doğrudan yerel sistemin yapılandırmasından tahmin eder.
--[no]build_runfile_links
Varsayılan olarak etkinleştirilen bu seçenek, testler ve ikili programlar için çalıştırma dosyaları sembol bağlantılarının çıkış dizininde derlenip oluşturulmayacağını belirtir.
--nobuild_runfile_links
kullanmak, tüm hedeflerin derlenip derlenmediğini doğrulamak için çalıştırma dosyası ağaçlarını oluşturma yükü olmadan faydalı olabilir.
Testler (veya uygulamalar) çalıştırıldığında, çalışma zamanındaki veri bağımlılıkları tek bir yerde toplanır. Bazel'in çıkış ağacında bu "runfiles" ağacı genellikle karşılık gelen ikili programın veya testin eşdüzey bir örneğidir.
Test çalıştırma sırasında, $TEST_SRCDIR/workspace/packagename/filename
biçimindeki yollar kullanılarak çalışma dosyalarına erişilebilir.
Çalışma dosyaları ağacı, testlerin beyan edilmiş bağımlılığı olan tüm dosyalara erişebilmesini ve bundan fazlasının olmamasını sağlar. Varsayılan olarak, çalışma dosyası ağacı, gerekli dosyalara yönelik bir dizi sembolik bağlantı oluşturarak uygulanır. Bağlantı grubu büyüdükçe bu işlemin maliyeti de artar. Bazı büyük derlemelerde, özellikle her testin (veya uygulamanın) kendi çalışma dosyası ağacını gerektirmesi nedeniyle genel derleme süresine önemli ölçüde katkıda bulunabilir.
--[no]build_runfile_manifests
Varsayılan olarak etkinleştirilen bu seçenek, runfiles manifestlerinin çıkış ağacına yazılması gerekip gerekmediğini belirtir.
Bu özelliği devre dışı bırakmak --nobuild_runfile_links
anlamına gelir.
Runfile ağaçları bellek içi manifestlerden uzaktan oluşturulacağı için testler uzaktan yürütülürken devre dışı bırakılabilir.
--[no]discard_analysis_cache
Bu seçenek etkinleştirildiğinde Bazel, analiz önbelleğini yürütme başlamadan hemen önce atar. Böylece yürütme aşaması için ek bellek (yaklaşık %10) ayrılır. Bunun dezavantajı, sonraki artımlı derlemelerin daha yavaş olmasıdır. Hafıza tasarrufu modu hakkında da bilgi edinin.
--[no]keep_going
(-k)
GNU Make'de olduğu gibi, derlemenin yürütme aşaması ilk hatayla karşılaşıldığında durur. Bazen hatalarla karşılaşsanız bile mümkün olduğunca fazla derleme yapmaya çalışmak faydalı olabilir. Bu seçenek bu davranışı etkinleştirir ve belirtildiğinde derleme, önkoşulları başarıyla oluşturulmuş her hedefi oluşturmaya çalışır ancak hataları yoksayar.
Bu seçenek genellikle bir derlemenin yürütme aşamasıyla ilişkili olsa da analiz aşamasını da etkiler: Derleme komutunda birkaç hedef belirtilmişse ancak bunlardan yalnızca bazıları başarıyla analiz edilebiliyorsa --keep_going
belirtilmemişse derleme bir hatayla durdurulur. Bu durumda derleme, sadece başarıyla analiz edilen hedefler için yürütme aşamasına geçer.
--[no]use_ijars
Bu seçenek, Bazel tarafından java_library
hedeflerinin derlenme şeklini değiştirir. Bazel, bağımlı java_library
hedeflerini derlemek için java_library
çıktısını kullanmak yerine yalnızca özel olmayan üyelerin (herkese açık, korumalı ve varsayılan (paket) erişim yöntemleri ve alanları) imzalarını içeren arayüz jar'ları oluşturur ve bağımlı hedefleri derlemek için bu arayüz jar'larını kullanır. Bu sayede, yalnızca sınıfın bedenleri veya özel üyeleri ile ilgili değişiklikler yapıldığında yeniden derlemenin önlenmesi mümkün olur.
--[no]interface_shared_objects
Bu seçenek, arayüz paylaşılan nesnelerini etkinleştirir. Bu sayede ikili dosyalar ve diğer paylaşılan kitaplıklar, paylaşılan nesnenin uygulanması yerine arayüzüne bağlı olur. Yalnızca uygulama değiştiğinde Bazel, değiştirilen paylaşılan kitaplığa bağlı hedefleri gereksiz bir şekilde yeniden oluşturmaktan kaçınabilir.
Çıkış seçimi
Bu seçenekler, neyin oluşturulacağını veya test edileceğini belirler.
--[no]build
Bu seçenek, derlemenin yürütme aşamasının gerçekleşmesine neden olur ve varsayılan olarak açıktır. Bu seçenek devre dışı bırakıldığında yürütme aşaması atlanır ve yalnızca ilk iki aşama (yükleme ve analiz) gerçekleşir.
Bu seçenek, herhangi bir şey oluşturmadan BUILD dosyalarını doğrulamak ve girişlerdeki hataları tespit etmek için yararlı olabilir.
--[no]build_tests_only
Belirtiliyse Bazel yalnızca boyutları, zaman aşımı, etiket veya dil nedeniyle filtrelenmeyen *_test
ve test_suite
kurallarını çalıştırmak için gerekenleri oluşturur.
Belirtilen Bazel, komut satırında belirtilen diğer hedefleri yoksayar.
Bu seçenek varsayılan olarak devre dışıdır ve Bazel, testten filtrelenen *_test
ve test_suite
kuralları da dahil olmak üzere istenen her şeyi oluşturur. bazel test --build_tests_only foo/...
çalıştırmak, foo
ağacındaki tüm derleme hatalarını algılayamayabileceğinden bu bilgi faydalıdır.
--[no]check_up_to_date
Bu seçenek, Bazel'in derleme yapmamasına, yalnızca belirtilen tüm hedeflerin güncel olup olmadığını kontrol etmesine neden olur. Öyleyse derleme her zamanki gibi başarıyla tamamlanır. Ancak, güncel olmayan dosyalar derlenmez, bunun yerine bir hata bildirilir ve derleme başarısız olur. Bu seçenek, bir derlemenin kaynak düzenlemeden daha yeni yapılıp yapılmadığını belirlemek için (ör. göndermeden önce kontroller için) derleme maliyetine girmeden yararlı olabilir.
Ayrıca --check_tests_up_to_date
adresini de inceleyin.
--[no]compile_one_dependency
Bağımsız değişken dosyalarının tek bir bağımlılığını derleyin. Bu, IDE'lerdeki kaynak dosyalarının söz dizimini kontrol ederken (örneğin, düzenleme/oluşturma/test döngüsünde hataları mümkün olduğunca erken tespit etmek için kaynak dosyaya bağlı olan tek bir hedefi yeniden oluşturarak) faydalıdır. Bu bağımsız değişken, işaret olmayan tüm bağımsız değişkenlerin yorumlanma şeklini etkiler: Her bağımsız değişken, geçerli çalışma dizinine göre bir dosya hedefi etiketi veya düz bir dosya adı olmalıdır ve her kaynak dosya adına bağlı tek bir kural oluşturulmalıdır. Şunun için:
C++ ve Java kaynaklarında, aynı dil alanındaki kurallar tercih edilir. Aynı tercihe sahip birden fazla kural varsa BUILD dosyasında ilk görünen kural seçilir. Kaynak dosyaya referans vermeyen, açıkça adlandırılmış bir hedef kalıbı hatayla sonuçlanır.
--save_temps
--save_temps
seçeneği, derleyiciden gelen geçici çıkışların kaydedilmesine neden olur. Bunlara .s dosyaları (birleştirici kodu), .i (işleme öncesi C) ve .ii (işleme öncesi C++) dosyaları dahildir. Bu çıkışlar genellikle hata ayıklama için faydalıdır. Geçici dosyalar yalnızca komut satırında belirtilen hedef grubu için oluşturulur.
--save_temps
işareti şu anda yalnızca cc_* kuralları için kullanılabilir.
Bazel'in ek çıkış dosyalarının konumunu yazdırmasını sağlamak için --show_result n
ayarınızın yeterince yüksek olup olmadığını kontrol edin.
--build_tag_filters=tag[,tag]*
Belirtilirse Bazel yalnızca en az bir zorunlu etiketi olan (belirtilmişse) ve hariç tutulan etiketi olmayan hedefler oluşturur. Etiket filtresi oluşturma işlemi, etiket anahtar kelimelerinin virgülle ayrılmış listesi olarak belirtilir. İsteğe bağlı olarak, hariç tutulan etiketleri belirtmek için "-" işareti eklenir. Zorunlu etiketlerin önünde "+" işareti de bulunabilir.
Bazel, testleri çalıştırırken bu filtreyle eşleşmese bile derlenen ve çalıştırılan test hedefleri için --build_tag_filters
değerini yoksayar. Bu tür raporlar oluşturmamak için test hedeflerini --test_tag_filters
kullanarak veya açıkça hariç tutarak filtreleyin.
--test_size_filters=size[,size]*
Belirtilirse Bazel yalnızca belirtilen boyuttaki test hedeflerini test eder (veya --build_tests_only
de belirtilmişse derleyebilir). Test boyutu filtresi, izin verilen test boyutu değerlerinin (küçük, orta, büyük veya çok büyük) virgülle ayrılmış listesi olarak belirtilir. İsteğe bağlı olarak, hariç tutulan test boyutlarını belirtmek için "-" işareti eklenir. Örneğin,
% bazel test --test_size_filters=small,medium //foo:all
% bazel test --test_size_filters=-large,-enormous //foo:all
yalnızca //foo içindeki küçük ve orta boyutlu testleri test eder.
Varsayılan olarak test boyutu filtreleme uygulanmaz.
--test_timeout_filters=timeout[,timeout]*
Belirtilirse Bazel, belirtilen zaman aşımı değerine sahip hedefleri test eder (veya --build_tests_only
belirtilmişse derleme yapar). Test zaman aşımı filtresi, izin verilen test zaman aşımı değerlerinin (kısa, orta, uzun veya sonsuz) virgül ile ayrılmış listesi olarak belirtilir. İsteğe bağlı olarak, hariç tutulan test zaman aşımlarını belirtmek için "-" işareti eklenir. Örnek söz dizimi için --test_size_filters bölümüne bakın.
Varsayılan olarak, test zaman aşımı filtrelemesi uygulanmaz.
--test_tag_filters=tag[,tag]*
Belirtilirse Bazel, yalnızca en az bir gerekli etikete sahip (bunlardan herhangi biri belirtilmişse) ve hariç tutulan herhangi bir etiketi olmayan test hedeflerini test eder (veya --build_tests_only
belirtilmişse derler). Test etiket filtresi, etiket anahtar kelimelerinin virgülle ayrılmış listesi olarak belirtilir ve isteğe bağlı olarak hariç tutulan etiketleri belirtmek için "-" işareti ile başlar. Gerekli etiketlerin önünde "+" işareti de olabilir.
Örneğin,
% bazel test --test_tag_filters=performance,stress,-flaky //myproject:all
performance
veya stress
etiketiyle etiketlenmiş ancak flaky
etiketiyle etiketlenmemiş hedefleri test eder.
Test etiketi filtreleme varsayılan olarak uygulanmaz. Testin size
ve local
etiketlerine göre de bu şekilde filtreleme yapabileceğinizi unutmayın.
--test_lang_filters=lang[,lang]*
Resmi bir *_test
kuralının kullanıldığı diller için test dillerinin virgülle ayrılmış listesini belirtir (bu listelerin tam listesi için ansiklopedi oluşturma sayfasına göz atın). Hariç tutulan dilleri belirtmek için her dilin önüne isteğe bağlı olarak "-" eklenebilir. Her dil için kullanılan ad, *_test
kuralındaki dil önekiyle aynı olmalıdır (ör. cc
, java
veya sh
).
Belirtilirse Bazel yalnızca belirtilen dillerin test hedeflerini test eder (veya --build_tests_only
de belirtilmişse oluşturur).
Örneğin,
% bazel test --test_lang_filters=cc,java foo/...
foo/...
'de yalnızca C/C++ ve Java testlerini (sırasıyla cc_test
ve java_test
kuralları kullanılarak tanımlanır) test ederken
% bazel test --test_lang_filters=-sh,-java foo/...
sh_test
ve java_test
testleri hariç foo/...
'teki tüm testleri çalıştırır.
Test dili filtreleme varsayılan olarak uygulanmaz.
--test_filter=filter-expression
Test çalıştırıcısının çalıştırılacak testlerin bir alt kümesini seçmek için kullanabileceği bir filtreyi belirtir. Çağrıda belirtilen tüm hedefler oluşturulur, ancak ifadeye bağlı olarak bunlardan yalnızca bazıları yürütülebilir; bazı durumlarda yalnızca belirli test yöntemleri çalıştırılır.
filter-expression değerinin yorumu, testi çalıştırmaktan sorumlu test çerçevesine bağlıdır. Bu bir glob, alt dize veya
regexp olabilir. --test_filter
, farklı --test_arg
filtre bağımsız değişkenlerini iletmek için kullanışlı bir yöntemdir ancak tüm çerçeveler bunu desteklemez.
Ayrıntı düzeyi
Bu seçenekler, Bazel'in terminale veya ek günlük dosyalarına verdiği çıkışın ayrıntı düzeyini kontrol eder.
--explain=logfile
Dosya adı bağımsız değişkeni gerektiren bu seçenek, bazel build
'ün yürütme aşamasındaki bağımlılık kontrolcünün her derleme adımı için neden yürütüldüğünü veya güncel olduğunu açıklamasına neden olur. Açıklama logfile dosyasına yazılır.
Beklenmedik yeniden oluşturmalarla karşılaşıyorsanız bu seçenek nedeni anlamanıza yardımcı olabilir. Ardından, beklenmedik bir şekilde yürütülen bir yürütme adımı gördüğünüzde günlüğü inceleyin. Bu seçenek, performans açısından küçük bir cezaya neden olabilir. Bu nedenle, artık gerekli olmadığında bu seçeneği kaldırabilirsiniz.
--verbose_explanations
Bu seçenek, --explain seçeneği etkinleştirildiğinde oluşturulan açıklamaların ayrıntı düzeyini artırır.
Özellikle ayrıntılı açıklamalar etkinse ve bir çıkış dosyası, oluşturulmak için kullanılan komut değiştiği için yeniden oluşturulursa açıklama dosyasında yer alan çıkış, yeni komutun tüm ayrıntılarını içerir (en azından çoğu komut için).
Bu seçeneğin kullanılması, oluşturulan açıklama dosyasının uzunluğunu ve --explain
kullanmanın performans cezasını önemli ölçüde artırabilir.
--explain
etkinleştirilmezse --verbose_explanations
'un hiçbir etkisi olmaz.
--profile=file
Dosya adı bağımsız değişkeni alan bu seçenek, Bazel'in profil oluşturma verilerini bir dosyaya yazmasına neden olur. Ardından veriler, bazel analyze-profile
komutu kullanılarak analiz edilebilir veya ayrıştırılabilir. Derleme profili, Bazel'in build
komutunun zamanını nerede harcadığını anlamak için yararlı olabilir.
--[no]show_loading_progress
Bu seçenek, Bazel'in paket yükleme ilerleme mesajları yayınlamasına neden olur. Bu seçenek devre dışı bırakılırsa mesajlar gösterilmez.
--[no]show_progress
Bu seçenek, ilerleme mesajlarının görüntülenmesini sağlar; varsayılan olarak etkindir. Devre dışı bırakıldığında ilerleme durumu mesajları engellenir.
--show_progress_rate_limit=n
Bu seçenek, bazelin n saniyede en fazla bir ilerleme mesajı göstermesine neden olur. Burada n gerçek bir sayıdır.n
Bu seçeneğin varsayılan değeri 0,02'dir. Yani bazel, ilerleme mesajlarını 0,02 saniyede bir mesajla sınırlandırır.
--show_result=n
Bu seçenek, bazel build
komutunun sonunda sonuç bilgilerinin yazdırılmasını kontrol eder. Varsayılan olarak, tek bir derleme hedefi belirtilmişse Bazel, hedefin başarıyla güncellenip güncellenmediğini belirten bir mesaj ve güncellendiyse hedefin oluşturduğu çıkış dosyalarının listesini yazdırır. Birden fazla hedef belirtilmişse sonuç bilgileri gösterilmez.
Sonuç bilgileri tek bir hedefin veya birkaç hedefin derlemeleri için yararlı olsa da büyük derlemeler (ör. üst düzey bir proje ağacının tamamı) için bu bilgiler çok fazla olabilir ve dikkat dağıtıcı olabilir. Bu seçenek, bu bilgilerin kontrol edilmesine olanak tanır. --show_result
, tam sonuç bilgilerinin basılması gereken maksimum hedef sayısı olan bir tam sayı bağımsız değişkeni alır. Varsayılan değer 1'dir. Bu eşiğin üzerinde, tek tek hedefler için sonuç bilgisi gösterilmez. Dolayısıyla sıfır, sonuç bilgisinin her zaman atlanmasına neden olur. Çok büyük bir değer ise sonucun her zaman yazdırılmasına neden olur.
Kullanıcılar, küçük bir hedef grubu (örneğin, derleme-düzenleme-test döngüsü sırasında) ile büyük bir hedef grubu (örneğin, yeni bir çalışma alanı oluştururken veya regresyon testleri yaparken) arasında düzenli olarak geçiş yaptıklarında aralarında bir değer seçmek isteyebilirler. İlk durumda sonuç bilgileri çok yararlıyken ikinci durumda daha az yararlıdır. Tüm seçeneklerde olduğu gibi bu, .bazelrc
dosyası aracılığıyla dolaylı olarak belirtilebilir.
Dosyalar, derlenen yürütülebilir dosyaları çalıştırmak için dosya adını kopyalayıp kabuğa yapıştırmayı kolaylaştıracak şekilde yazdırılır. Her hedef için "güncel" veya "başarısız" mesajları, derlemeyi yöneten komut dosyaları tarafından kolayca ayrıştırılabilir.
--sandbox_debug
Bu seçenek, Bazel'in işlem yürütmek için korumalı alan kullanırken ek hata ayıklama bilgileri yazdırmasına neden olur. Bu seçenek, yürütülme sırasında işlemler tarafından görülebilen dosyaların incelenebilmesi için korumalı alan dizinlerini de korur.
--subcommands
(-s
)
Bu seçenek, Bazel'in yürütme aşamasının her komutu yürütmeden önce komut satırının tamamını yazdırmasına neden olur.
>>>>> # //examples/cpp:hello-world [action 'Linking examples/cpp/hello-world'] (cd /home/johndoe/.cache/bazel/_bazel_johndoe/4c084335afceb392cfbe7c31afee3a9f/bazel && \ exec env - \ /usr/bin/gcc -o bazel-out/local-fastbuild/bin/examples/cpp/hello-world -B/usr/bin/ -Wl,-z,relro,-z,now -no-canonical-prefixes -pass-exit-codes -Wl,-S -Wl,@bazel-out/local_linux-fastbuild/bin/examples/cpp/hello-world-2.params)
Mümkün olduğunda komutlar, Bourne kabuğu ile uyumlu bir söz dizimi içinde yazdırılır. Böylece kolayca kopyalanıp bir kabuk komut isteminde yapıştırılabilirler.
(Kavrayıcı parantezler, kabuğunuzu cd
ve exec
çağrılarına karşı korumak için sağlanmıştır; bunları kopyaladığınızdan emin olun!)
Ancak bazı komutlar (ör. sembolik bağlantı ağaçları oluşturma) Bazel'de dahili olarak uygulanır. Bunlar için görüntülenecek komut satırı yoktur.
--subcommands=pretty_print
, komutun bağımsız değişkenlerini tek bir satır yerine liste olarak yazdırmak için iletilebilir. Bu yöntem, uzun komut satırlarının daha okunabilir olmasını sağlayabilir.
Aşağıdaki --verbose_failures seçeneğini de inceleyin.
Alt komutları araç dostu biçimde bir dosyaya kaydetmek için bkz. --execution_log_json_file ve --execution_log_binary_file.
--verbose_failures
Bu seçenek, Bazel'in yürütme aşamasının başarısız olan komutlar için komut satırının tamamını yazdırmasına neden olur. Bu, hatalı bir derlemede hata ayıklamak için paha biçilmez bir rol oynayabilir.
Başarısız olan komutlar, kabuk istemine kopyalayıp yapıştırmaya uygun, Bourne kabuğuyla uyumlu bir söz diziminde yazdırılır.
Çalışma alanı durumu
Bazel ile derlenmiş ikili dosyaları "damgalamak" için bu seçenekleri kullanın: ikili dosyalara kaynak denetimi düzeltmesi veya Workspace ile ilgili diğer bilgiler gibi ek bilgiler yerleştirmek için. Bu mekanizmayı stamp
özelliğini destekleyen kurallarla (ör. genrule
, cc_binary
) kullanabilirsiniz.
--workspace_status_command=program
Bu işaret, Bazel'in her derlemeden önce çalıştıracağı bir ikili program belirtmenize olanak tanır. Program, çalışma alanının durumuyla ilgili bilgileri (ör. mevcut kaynak denetimi düzeltmesi) bildirebilir.
İşaretin değeri, yerel bir programın yolu olmalıdır. Linux/macOS'te bu, herhangi bir yürütülebilir dosya olabilir. Windows'da bu yerel bir ikili program, genellikle ".exe", ".bat" veya ".cmd" dosyası olmalıdır.
Program, standart çıkışa sıfır veya daha fazla anahtar/değer çifti (her satırda bir giriş) yazdırmalı ve ardından sıfır değerini döndürerek çıkmalıdır (aksi takdirde derleme başarısız olur). Anahtar adları herhangi bir şey olabilir ancak yalnızca büyük harf ve alt çizgi kullanılabilir. Anahtar adından sonraki ilk boşluk, anahtarı değerden ayırır. Değer, satırın geri kalanıdır (ek boşluklar dahil). Anahtar veya değer birden fazla satırı kaplamamalıdır. Anahtarlar yinelenmemelidir.
Bazel, anahtarları "kararlı" ve "değişken" olmak üzere iki gruba ayırır. ("Kararlı" ve "değişken" adları biraz sezgisel değildir. Bu nedenle bunlar hakkında fazla düşünmeyin.)
Bazel daha sonra anahtar/değer çiftlerini iki dosyaya yazar:
bazel-out/stable-status.txt
anahtar adınınSTABLE_
ile başladığı tüm anahtarları ve değerleri içerirbazel-out/volatile-status.txt
anahtarların geri kalanını ve değerlerini içerir
Sözleşme şu şekildedir:
"Kararlı" anahtarların değerleri mümkünse nadiren değişmelidir.
bazel-out/stable-status.txt
öğesinin içeriği değişirse Bazel, bu öğelere bağlı işlemleri geçersiz kılar. Başka bir deyişle, sabit bir anahtarın değeri değişirse Bazel damgalı işlemleri yeniden çalıştırır. Bu nedenle, kararlı durum zaman damgaları gibi öğeler içermemelidir. Çünkü bunlar her zaman değişir ve Bazel'in her derlemede damgalanmış işlemleri yeniden çalıştırmasına neden olur.Bazel her zaman aşağıdaki sabit anahtarları verir:
BUILD_EMBED_LABEL
:--embed_label
değerinin değeriBUILD_HOST
: Bazel'in çalıştığı ana makinenin adıBUILD_USER
: Bazel'in kullandığı kullanıcının adı
"Değişken" anahtarların değerleri sık sık değişebilir. Bazel, zaman damgalarında olduğu gibi bunların her zaman değişmesini bekler ve
bazel-out/volatile-status.txt
dosyasını gerektiği gibi günceller. Ancak, damgalanmış işlemlerin her zaman yeniden çalıştırılmasını önlemek için Bazel, değişken dosyanın hiç değişmediğini varsayar. Başka bir deyişle, içeriği değişen tek dosya değişken durum dosyasıysa Bazel, bu dosyaya bağlı işlemleri geçersiz kılmaz. İşlemlerin diğer girişleri değişirse Bazel bu işlemi yeniden çalıştırır ve işlem güncellenen değişken durumu görür. Ancak değişken durumunun değişmesi işlemi geçersiz kılmaz.Bazel her zaman aşağıdaki değişken anahtarları döndürür:
BUILD_TIMESTAMP
: Unix sıfır zamanından itibaren saniye cinsinden derleme zamanı (System.currentTimeMillis()
değerinin binde bire bölünmesiyle elde edilen değer)FORMATTED_DATE
: derlemenin zamanı UTC biçimindeyyyy MMM d HH mm ss EEE
(ör. 2023 Haz 2 01 44 29 Cuma) olarak biçimlendirilir.
Linux/macOS'te true
hiçbir şey yapmadığı, başarılı bir şekilde (sıfırla çıkar) sona erdiği ve hiçbir çıkış yazdırmadığı için --workspace_status_command=/bin/true
ile Workspace durumunun alınmasını devre dışı bırakabilirsiniz. Windows'ta aynı etkiyi elde etmek için MSYS'nin true.exe
yolunu iletebilirsiniz.
Workspace durumu komutu herhangi bir nedenle başarısız olursa (sıfır olmayan bir değerle çıkarsa) derleme başarısız olur.
Linux'ta Git kullanan örnek program:
#!/bin/bash echo "CURRENT_TIME $(date +%s)" echo "RANDOM_HASH $(cat /proc/sys/kernel/random/uuid)" echo "STABLE_GIT_COMMIT $(git rev-parse HEAD)" echo "STABLE_USER_NAME $USER"
Bu programın yolunu --workspace_status_command
ile geçtiğinizde kararlı durum dosyası STABLE satırlarını, değişken durum dosyası ise kalan satırları içerir.
--[no]stamp
Bu seçenek, stamp
kural özelliğiyle birlikte derleme bilgilerinin ikili dosyalar içine yerleştirilip yerleştirilmeyeceğini kontrol eder.
Damgalama, stamp
özelliği kullanılarak kural bazında açıkça etkinleştirilebilir veya devre dışı bırakılabilir. Ayrıntılı bilgi için lütfen Build Ansiklopedi'yi inceleyin. Bir kural stamp = -1
değerini (*_binary
kuralları için varsayılan değer) ayarlarsa bu seçenek, damga basma özelliğinin etkin olup olmayacağını belirler.
Bazel, bu seçenekten veya stamp
özelliğinden bağımsız olarak, ana makine yapılandırması için derlenen ikili dosyaları hiçbir zaman damgalamaz. stamp =
0
değerini (*_test
kuralları için varsayılan) ayarlayan kurallar için damgalama, --[no]stamp
özelliğinden bağımsız olarak devre dışı bırakılır. --stamp
belirtildiğinde, bağımlılıkları değişmemiş hedeflerin yeniden derlenmesi zorunlu kılınmaz.
Giriş değişkenliğini azalttığı ve derleme önbelleğe alma işlemini en üst düzeye çıkardığı için --nostamp
ayarı genellikle derleme performansı için istenilen bir ayardır.
Platform
Derlemelerin nasıl çalıştığını yapılandıran ana makine ve hedef platformları kontrol etmek ve Bazel kurallarının hangi yürütme platformlarını ve araç zincirlerini kullanabileceğini kontrol etmek için bu seçenekleri kullanın.
Platformlar ve Araçlar hakkında daha fazla bilgi edinin.
--platforms=labels
Geçerli komutun hedef platformlarını açıklayan platform kurallarının etiketleri.
--host_platform=label
Ana makine sistemini açıklayan platform kuralının etiketi.
--extra_execution_platforms=labels
İşlemleri çalıştırmak için yürütme platformu olarak kullanılabilen platformlar. Platformlar, tam hedefe göre veya bir hedef kalıbı olarak belirtilebilir. Bu platformlar, register_execution_platforms() tarafından WORKSPACE dosyasında belirtilen platformlardan önce dikkate alınır.
--extra_toolchains=labels
Araç zinciri çözümü sırasında dikkate alınacak araç zinciri kuralları. Araç zincirleri, tam hedefe göre veya hedef kalıbı olarak belirtilebilir. Bu araç zincirleri, WORKSPACE dosyasında register_toolchains() tarafından bildirilenlerden önce değerlendirilir.
--toolchain_resolution_debug=regex
Araç zinciri türü normal ifadeyle eşleşirse araç zincirlerini bulurken hata ayıklama bilgilerini yazdırın. Birden fazla normal ifade virgülle ayrılabilir. Normal ifade, başında -
kullanılarak reddedilebilir. Bu, Bazel veya Starlark kurallarının geliştiricilerine, eksik araç zincirleri nedeniyle hata ayıklama hatalarında yardımcı olabilir.
Çeşitli
--flag_alias=alias_name=target_path
Daha uzun Starlark derleme ayarlarını daha kısa bir ada bağlamak için kullanılan bir kolaylık işareti. Daha fazla bilgi için Starlark Yapılandırmaları başlıklı makaleyi inceleyin.
--symlink_prefix=string
Oluşturulan kolaylık simge bağlantılarının ön ekini değiştirir. Sembolik bağlantı ön ekinin varsayılan değeri bazel-
'tir. Bu değer, bazel-bin
, bazel-testlogs
ve bazel-genfiles
sembolik bağlantılarını oluşturur.
Sembolik bağlantılar herhangi bir nedenle oluşturulamazsa uyarı verilir ancak derleme yine de başarılı olarak kabul edilir. Özellikle, salt okuma veya yazma izniniz olmayan bir dizinde derleme yapmanıza olanak tanır. Derleme işleminin sonunda bilgi mesajlarında yazdırılan tüm yollar, yalnızca sembolik bağlantılar beklenen konumu gösteriyorsa sembolik bağlantıya göre kısa biçimi kullanır. Diğer bir deyişle, sembolik bağlantıların oluşturulduğundan emin olmasanız bile bu yolların doğruluğundan emin olabilirsiniz.
Bu seçeneğin yaygın olarak kullanılan bazı değerleri:
Sembol bağlantısı oluşturmayı engelle:
--symlink_prefix=/
, Bazel'inbazel-out
vebazel-<workspace>
sembol bağlantıları da dahil olmak üzere hiçbir sembol bağlantısı oluşturmasına veya güncellemesine neden olmaz. Sembolik bağlantı oluşturmayı tamamen engellemek için bu seçeneği kullanın.Dağınıklıktan kurtulun:
--symlink_prefix=.bazel/
, Bazel'in gizli bir dizin.bazel
içindebin
(vb.) adlı sembolik bağlantılar oluşturmasına neden olur.
--platform_suffix=string
Yapılandırma kısa adına, çıkış dizinini belirlemek için kullanılan bir sonek ekler. Bu seçenek farklı değerlere ayarlandığında dosyalar farklı dizinlere yerleştirilir. Örneğin, aksi takdirde birbirlerinin çıkış dosyalarını bozan derlemeler için önbellek isabet oranlarını iyileştirmek veya karşılaştırma için çıkış dosyalarını saklamak amacıyla.
--default_visibility=(private|public)
Bazel varsayılan görünürlük değişikliklerini test etmek için geçici işaret. Genel kullanıma yönelik değildir ancak eksiksiz olması için belgelenmiştir.
--[no]use_action_cache
Bu seçenek varsayılan olarak etkindir. Devre dışı bırakılırsa Bazel yerel işlem önbelleğini kullanmaz. Yerel işlem önbelleğini devre dışı bırakmak, temiz derlemeler için bellek ve disk alanından tasarruf sağlar, ancak ek derlemelerin yavaşlamasına neden olur.
--starlark_cpu_profile=_file_
Değeri dosyanın adı olan bu işaret, Bazel'in tüm Starlark iş parçacıklarının CPU kullanımıyla ilgili istatistikleri toplamasına ve profili, pprof biçiminde adlandırılmış dosyaya yazmasına neden olur.
Aşırı hesaplama nedeniyle yükleme ve analizin yavaşlamasına neden olan Starlark işlevlerini belirlemek için bu seçeneği kullanın. Örneğin:
$ bazel build --nobuild --starlark_cpu_profile=/tmp/pprof.gz my/project/... $ pprof /tmp/pprof.gz (pprof) top Type: CPU Time: Feb 6, 2020 at 12:06pm (PST) Duration: 5.26s, Total samples = 3.34s (63.55%) Showing nodes accounting for 3.34s, 100% of 3.34s total flat flat% sum% cum cum% 1.86s 55.69% 55.69% 1.86s 55.69% sort_source_files 1.02s 30.54% 86.23% 1.02s 30.54% expand_all_combinations 0.44s 13.17% 99.40% 0.44s 13.17% range 0.02s 0.6% 100% 3.34s 100% sorted 0 0% 100% 1.38s 41.32% my/project/main/BUILD 0 0% 100% 1.96s 58.68% my/project/library.bzl 0 0% 100% 3.34s 100% main
Aynı verilerin farklı görünümleri için pprof
komutlarını svg
,
web
ve list
deneyin.
Yayınlar için Bazel kullanma
Bazel hem yazılım mühendisleri tarafından geliştirme döngüsü sırasında hem de sürüm mühendisleri tarafından üretim için dağıtım için ikili programları hazırlarken kullanılır. Bu bölümde, Bazel kullanan sürüm mühendisleri için ipuçları listesi verilmiştir.
Önemli seçenekler
Bazel, sürüm derlemeleri için kullanıldığında derleme yapan diğer komut dosyalarında olduğu gibi aynı sorunlar ortaya çıkar. Daha fazla bilgi için Komut dosyalarından Bazel'i çağırma başlıklı makaleyi inceleyin. Özellikle aşağıdaki seçenekler önerilir:
Şu seçenekler de önemlidir:
--package_path
--symlink_prefix
: Birden fazla yapılandırma için derlemeleri yönetmek amacıyla her derlemeyi "64 bit" ve "32 bit" gibi farklı bir tanımlayıcıyla ayırt etmek yararlı olabilir. Bu seçenek,bazel-bin
(vb.) sembolik bağlantılarını birbirinden ayırır.
Test çalıştırma
Bazel ile test oluşturmak ve çalıştırmak için bazel test
yazıp test hedeflerinin adını yazın.
Varsayılan olarak bu komut, aynı anda derleme ve test etkinliği gerçekleştirir. Belirtilen tüm hedefleri (komut satırında belirtilen test dışı hedefler dahil) derler ve önkoşulları derlenir derlenmez *_test
ve test_suite
hedeflerini test eder. Yani test yürütme, derleme işlemiyle birlikte gerçekleşir. Bu genellikle önemli hız kazanımları
sağlar.
bazel test
için seçenekler
--cache_test_results=(yes|no|auto)
(-t
)
Bu seçenek "auto" (otomatik) olarak ayarlanırsa (varsayılan) Bazel yalnızca aşağıdaki koşullardan biri geçerliyse bir testi yeniden çalıştırır:
- Bazel, testte veya bağımlılıklarında değişiklikler algılar
- Test
external
olarak işaretlenir. --runs_per_test
ile birden fazla test çalıştırması istendi- test başarısız oldu.
"Hayır" ise tüm testler koşulsuz olarak yürütülür.
"Evet" ise önbelleğe alma davranışı, test hatalarını ve --runs_per_test
ile test çalıştırma işlemlerini önbelleğe alabilmesi dışında otomatik ile aynı olur.
Bu seçeneği .bazelrc
dosyalarında varsayılan olarak etkinleştiren kullanıcılar, belirli bir çalıştırmada varsayılan ayarı geçersiz kılmak için -t
(açık) veya -t-
(kapalı) kısaltmalarını kullanabilir.
--check_tests_up_to_date
Bu seçenek, Bazel'e testleri çalıştırmasını değil, yalnızca önbelleğe alınmış test sonuçlarını kontrol edip raporlamasını söyler. Daha önce derlenip çalıştırılmamış olan ya da test sonuçları güncel olmayan (örneğin, kaynak kodu veya derleme seçenekleri değiştiği için) testler varsa Bazel bir hata mesajı ("test sonucu güncel değil") bildirir, test durumunu "DURUM YOK" (renk çıkışı etkinse kırmızı renkte) olarak kaydeder ve sıfır dışında bir kod döndürür.
Bu seçenek, [--check_up_to_date](#check-up-to-date)
davranışını da ima eder.
Bu seçenek, gönderim öncesi kontroller için yararlı olabilir.
--test_verbose_timeout_warnings
Bu seçenek, bir testin zaman aşımı, testin gerçek yürütme süresinden önemli ölçüde daha uzunsa Bazel'e kullanıcıyı açıkça uyarmasını söyler. Bir testin zaman aşımı, kesintisiz olacak şekilde ayarlanmalıdır. Ancak çok fazla zaman aşımı olan bir test, beklenmedik şekilde ortaya çıkan gerçek sorunları gizleyebilir.
Örneğin, normalde bir veya iki dakika içinde yürütülen bir testin zaman aşımı süresi ETERNAL veya LONG olmamalıdır. Zira bunlar çok fazla cömert olabilir.
Bu seçenek, kullanıcıların iyi bir zaman aşımı değerine karar vermelerine veya mevcut zaman aşımı değerlerinin tutarlılığını kontrol etmelerine yardımcı olmak açısından kullanışlıdır.
--[no]test_keep_going
Varsayılan olarak tüm testler tamamlanana kadar çalıştırılır. Ancak bu işaret devre dışı bırakılırsa geçemeyen tüm testlerde derleme iptal edilir. Sonraki derleme adımları ve test çağrıları çalıştırılmaz ve devam eden çağrılar iptal edilir.
--notest_keep_going
ve --keep_going
öğelerini belirtmeyin.
--flaky_test_attempts=attempts
Bu seçenek, bir testin herhangi bir nedenle başarısız olması durumunda maksimum deneme sayısını belirtir. Başlangıçta başarısız olan ancak sonunda başarılı olan bir test, test özetinde FLAKY
olarak raporlanır. Bununla birlikte, Bazel çıkış kodu veya başarılı testlerin toplam sayısı söz konusu olduğunda başarılı kabul edilir. İzin verilen tüm denemelerde başarısız olan testler başarısız kabul edilir.
Varsayılan olarak (bu seçenek belirtilmediğinde veya varsayılan olarak ayarlandığında), normal testler için yalnızca tek bir denemeye, flaky
özelliği ayarlanmış test kuralları için ise 3 denemeye izin verilir. Test denemelerinin maksimum sınırını geçersiz kılmak için bir tam sayı değeri belirtebilirsiniz. Bazel, sistemin kötüye kullanımını önlemek için en fazla 10 test denemesine izin verir.
--runs_per_test=[regex@]number
Bu seçenek, her testin kaç kez yürütülmesi gerektiğini belirtir. Tüm test çalıştırmaları ayrı testler olarak değerlendirilir (yedek işlev her biri için ayrı ayrı uygulanır).
Başarısız çalıştırmaları olan bir hedefin durumu, --runs_per_test_detects_flakes
işaretinin değerine bağlıdır:
- Yoksa başarısız çalıştırmalardan biri, testin tamamının başarısız olmasına neden olur.
- Bu özellik mevcutsa ve aynı parçadan iki çalıştırma PASS ve FAIL döndürürse test, kararsız durumu alır (başka başarısız çalıştırmalar testin başarısız olmasına neden olmazsa).
Tek bir sayı belirtilirse tüm testler bu sayıda çalıştırılır.
Alternatif olarak, regex@number söz dizimi kullanılarak normal ifade de belirtilebilir. Bu, --runs_per_test
'ün normal ifadeyle eşleşen hedefler üzerindeki etkisini kısıtlar (--runs_per_test=^//pizza:.*@4
, tüm testleri //pizza/
altında 4 kez çalıştırır).
Bu --runs_per_test
biçimi birden fazla kez belirtilebilir.
--[no]runs_per_test_detects_flakes
Bu seçenek belirtilirse (varsayılan olarak belirtilmez) Bazel, --runs_per_test
aracılığıyla kararsız test parçalarını algılar. Bir veya daha fazla parça tek bir parçada başarısız olursa ve aynı kırık geçişi için bir ya da daha fazla koşu yaparsa hedef, işaretle birlikte "kesintisiz" olarak kabul edilir. Belirtilmemişse hedef, "başarısız" durumunu bildirir.
--test_summary=output_style
Test sonucu özetinin nasıl gösterileceğini belirtir.
short
, test başarısız olursa her testin sonuçlarını test çıkışını içeren dosyanın adıyla birlikte yazdırır. Bu, varsayılan değerdir.terse
,short
gibidir ancak daha kısadır: yalnızca geçemeyen testlerle ilgili bilgileri yazdırır.detailed
yalnızca her testi değil, başarısız olan her test durumunu yazdırır. Test çıkış dosyalarının adları atlanır.none
test özetini yazdırmıyor.
--test_output=output_style
Test çıkışının nasıl gösterilmesi gerektiğini belirtir:
summary
, her bir testin başarılı olup olmadığının bir özetini gösterir. Ayrıca, başarısız testlerin çıkış günlük dosyası adını gösterir. Özet, derlemenin sonunda yazdırılır (derleme sırasında, testler başladığında, başarılı olduğunda veya başarısız olduğunda yalnızca basit ilerleme mesajları gösterilir). Bu varsayılan davranıştır.errors
, başarısız testlerden gelen birleştirilmiş stdout/stderr çıkışını yalnızca test tamamlandıktan hemen sonra stdout'a gönderir. Böylece, eşzamanlı testlerden gelen test çıkışlarının birbirine karışması önlenir. Yukarıdaki özet çıktısına göre derleme sırasında bir özet yazdırır.all
,errors
ile benzerdir ancak başarılı olanlar da dahil olmak üzere tüm testlerin çıkışını yazdırır.streamed
, her testin stdout/stderr çıkışını gerçek zamanlı olarak aktarır.
--java_debug
Bu seçenek, bir Java testinin Java sanal makinesinin testi başlatmadan önce JDWP uyumlu bir hata ayıklayıcıdan bağlantı beklemesine neden olur. Bu seçenek --test_output=streamed
anlamına gelir.
--[no]verbose_test_summary
Varsayılan olarak bu seçenek etkindir. Bu durumda, test süreleri ve diğer ek bilgiler (test denemeleri gibi) test özetine yazdırılır. --noverbose_test_summary
belirtilirse test özeti yalnızca test adını, test durumunu ve önbelleğe alınmış test göstergesini içerir ve mümkün olduğunda 80 karakter içinde kalacak şekilde biçimlendirilir.
--test_tmpdir=path
Yerel olarak çalıştırılan testler için geçici dizini belirtir. Her test, bu dizin içindeki ayrı bir alt dizinde yürütülür. Her bazel test
komutunun başında dizin temizlenir.
Varsayılan olarak bazel bu dizini Bazel çıkış ana dizininin altına yerleştirir.
--test_timeout=seconds
VEYA --test_timeout=seconds,seconds,seconds,seconds
Yeni zaman aşımı değeri olarak belirtilen saniye sayısını kullanarak tüm testler için zaman aşımı değerini geçersiz kılar. Yalnızca bir değer sağlanırsa bu değer tüm test zaman aşımı kategorileri için kullanılır.
Alternatif olarak kısa, orta, uzun ve sonsuz testler (bu sırayla) için tek tek zaman aşımları belirten, virgülle ayrılmış dört değer sağlanabilir. Her iki biçimde de, test boyutlarından herhangi biri için sıfır veya negatif bir değer, Yazılım Testleri sayfasında tanımlandığı şekilde, belirli zaman aşımı kategorileri için varsayılan zaman aşımıyla değiştirilir. Varsayılan olarak Bazel, boyutun örtülü veya açık bir şekilde ayarlandığına bakılmaksızın zaman aşımı sınırını testin boyutundan çıkarıp tüm testler için bu zaman aşımlarını kullanır.
Zaman aşımı kategorisini boyutundan farklı olarak açıkça belirten testler, zaman aşımı boyut etiketi tarafından dolaylı olarak ayarlanmış gibi aynı değeri alır. Dolayısıyla, "uzun" bir zaman aşımı belirten "küçük" boyutlu bir test, açık bir zaman aşımı olmayan "büyük" testlerin sahip olduğu etkili zaman aşımına sahip olur.
--test_arg=arg
Komut satırı seçeneklerini/işaretlerini/bağımsız değişkenlerini her test işlemine iletir. Bu seçenek, birden fazla bağımsız değişken iletmek için birden çok kez kullanılabilir. Örneğin,
--test_arg=--logtostderr --test_arg=--v=3
.
--test_env=variable=_value_
VEYA --test_env=variable
Her test için test ortamına yerleştirilmesi gereken ek değişkenleri belirtir. value belirtilmezse bazel test
komutunu başlatmak için kullanılan kabuk ortamından devralınır.
Ortam, System.getenv("var")
(Java), getenv("var")
(C veya C++),
--run_under=command-prefix
Bu, test çalıştırıcısının test komutunu çalıştırmadan önce komutun önüne ekleyeceği bir ön eki belirtir. command-prefix, Bourne kabuğu dize oluşturma kuralları kullanılarak kelimelere bölünür ve ardından kelime listesi, yürütülecek komutun başına eklenir.
İlk kelime tam nitelikli bir etiketse (//
ile başlar) oluşturulur. Ardından etiket, diğer kelimelerle birlikte yürütülecek komutun başına eklenen karşılık gelen yürütülebilir konum ile değiştirilir.
Bazı noktalara dikkat edilmelidir:
- Test çalıştırmak için kullanılan PATH, ortamınızdaki PATH'ten farklı olabilir. Bu nedenle,
--run_under
komutu (command-prefix'taki ilk kelime) için mutlak yol kullanmanız gerekebilir. stdin
bağlı olmadığından--run_under
etkileşimli komutlar için kullanılamaz.
Örnekler:
--run_under=/usr/bin/strace --run_under='/usr/bin/strace -c' --run_under=/usr/bin/valgrind --run_under='/usr/bin/valgrind --quiet --num-callers=20'
Test seçimi
Çıkış seçimi seçenekleri bölümünde belirtildiği gibi, testleri boyuta, zaman aşımına, etikete veya dile göre filtreleyebilirsiniz. Kullanışlı bir genel ad filtresi, belirli filtre bağımsız değişkenlerini test çalıştırıcısına iletebilir.
bazel test
için diğer seçenekler
Söz dizimi ve kalan seçenekler tam olarak bazel build
ile aynıdır.
Yürütülebilir dosyaları çalıştırma
bazel run
komutu, tek bir hedef ve çalıştırmak için kullanılması dışında bazel build
komutuna benzer. Tipik bir oturum aşağıdaki gibidir:
% bazel run java/myapp:myapp -- --arg1 --arg2 Welcome to Bazel INFO: Loading package: java/myapp INFO: Loading package: foo/bar INFO: Loading complete. Analyzing... INFO: Found 1 target... ... Target //java/myapp:myapp up-to-date: bazel-bin/java/myapp:myapp INFO: Elapsed time: 0.638s, Critical Path: 0.34s INFO: Running command line: bazel-bin/java/myapp:myapp --arg1 --arg2 Hello there $EXEC_ROOT/java/myapp/myapp --arg1 --arg2
bazel run
, Bazel tarafından oluşturulan ikili dosyayı doğrudan çağırmaya benzer ancak aynı değildir ve davranışı, çağrılacak ikili dosyanın test olup olmadığına bağlı olarak değişir.
İkili dosya bir test değilse geçerli çalışma dizini, ikili dosyanın çalıştırma dosyaları ağacı olur.
İkili test olduğunda geçerli çalışma dizini, yürütme kökü olur ve testlerin genellikle çalıştırıldığı ortamın kopyalanması için iyi niyetli bir girişimde bulunulur. Ancak bu emülasyon mükemmel değildir ve birden fazla bölüme sahip testler bu şekilde çalıştırılamaz (bu sorunu gidermek için --test_sharding_strategy=disabled
komut satırı seçeneği kullanılabilir).
İkili dosya, aşağıdaki ek ortam değişkenlerini de kullanabilir:
BUILD_WORKSPACE_DIRECTORY
: Derlemenin çalıştırıldığı çalışma alanının kökü.BUILD_WORKING_DIRECTORY
: Bazel'in çalıştırıldığı mevcut çalışma dizini.
Örneğin, komut satırındaki dosya adlarını kullanıcı dostu bir şekilde yorumlamak için bu işlevler kullanılabilir.
bazel run
için seçenekler
--run_under=command-prefix
Bu, bazel test
için --run_under
seçeneğiyle aynı etkiye sahiptir (yukarıya bakın). Bununla birlikte, bazel test
tarafından çalıştırılan testler yerine bazel
run
tarafından çalıştırılan komut için geçerlidir ve etiket altında çalıştırılamaz.
Bazel'den günlük çıkışlarını filtreleme
Bazel, bazel run
ile bir ikili program çağırırken Bazel'in kendisinden ve çağrılan ikili programdan günlük kaydı çıkışını yazdırır. Günlüklerin daha az karmaşık olmasını sağlamak için --ui_event_filters
ve --noshow_progress
işaretlerini kullanarak Bazel'in çıkışlarını engelleyebilirsiniz.
Örneğin:
bazel run --ui_event_filters=-info,-stdout,-stderr --noshow_progress //java/myapp:myapp
Testleri yürütme
bazel run
, test ikililerini de çalıştırabilir. Bu, testi Test Yazma bölümünde açıklanan ortama yakın bir şekilde çalıştırma etkisine sahiptir. --test_*
bağımsız değişkenlerinden hiçbirinin, --test_arg
dışında bu şekilde bir test çalıştırırken etkisi olmadığını unutmayın.
Derleme çıkışlarını temizleme
clean
komutu
Bazel'de, Make'e benzer bir clean
komutu vardır.
Bu Bazel örneği tarafından gerçekleştirilen tüm derleme yapılandırmalarının çıkış dizinlerini veya bu Bazel örneği tarafından oluşturulan çalışma ağacının tamamını siler ve dahili önbellekleri sıfırlar. Herhangi bir komut satırı seçeneği olmadan yürütülürse tüm yapılandırmalar için çıkış dizini temizlenir.
Her Bazel örneğinin tek bir çalışma alanıyla ilişkili olduğunu unutmayın. Bu nedenle, clean
komutu, söz konusu çalışma alanındaki söz konusu Bazel örneğiyle yaptığınız tüm derlemelerdeki tüm çıkışları siler.
Bazel örneği tarafından oluşturulan çalışma ağacının tamamını tamamen kaldırmak için --expunge
seçeneğini belirleyebilirsiniz. --expunge
ile çalıştırıldığında temizleme komutu, derleme çıktısına ek olarak Bazel tarafından oluşturulan tüm geçici dosyaları içeren çıkış temel ağacının tamamını kaldırır. Ayrıca, temizleme işleminden sonra Bazel sunucusunu durdurur. Bu, shutdown
komutuna eşdeğerdir. Örneğin, bir Bazel örneğinin tüm disk ve bellek izlerini temizlemek için şunları belirtebilirsiniz:
% bazel clean --expunge
Alternatif olarak, --expunge_async
simgesini kullanarak arka planda silme işlemi yapabilirsiniz. Asenkron silme işlemi devam ederken aynı istemcide bir Bazel komutu çağırmak güvenlidir.
clean
komutu, öncelikle artık ihtiyaç duyulmayan çalışma alanlarının disk alanını geri kazanmak için sağlanır.
Bazel'in artımlı yeniden derlemeleri mükemmel olmayabilir. Bu nedenle, sorun oluştuğunda tutarlı bir durumu kurtarmak için clean
kullanılabilir.
Bazel'in tasarımı, bu sorunların düzeltilebilir olmasına ve bu hataların düzeltilmesinin yüksek öncelikli olmasına olanak tanır. Yanlış bir artımlı derleme bulursanız hata raporu gönderin ve clean
yerine araçları kullanarak hataları bildirin.
Bağımlılık grafiğini sorgulama
Bazel, derleme sırasında kullanılan bağımlılık grafiği hakkında soru sormak için bir sorgu dili içerir. Sorgu dili, iki komut tarafından kullanılır: query ve cquery. Bu iki komut arasındaki en büyük fark, query'nin yükleme aşamasından sonra, cquery'nin ise analiz aşamasından sonra çalıştırılmasıdır. Bu araçlar pek çok yazılım mühendisliği görevi için paha biçilmez bir yardımcıdır.
Sorgu dili, grafikler üzerinde cebirsel işlemler fikrine dayanır ve
Bazel Sorgu Referansı. Referans için, örnekler ve sorguya özel komut satırı seçenekleri için lütfen bu dokümana bakın.
Sorgu aracı çeşitli komut satırı seçeneklerini kabul eder. --output
, çıkış biçimini seçer.
--[no]keep_going
(varsayılan olarak devre dışıdır), sorgu aracının hata oluştuğunda ilerlemeye devam etmesine neden olur. Hata durumunda eksik bir sonuç kabul edilemiyorsa bu davranış devre dışı bırakılabilir.
Varsayılan olarak etkinleştirilen --[no]tool_deps
seçeneği, hedeflenmeyen yapılandırmalardaki bağımlılıkların, sorgunun çalıştığı bağımlılık grafiğine dahil edilmesine neden olur.
Varsayılan olarak etkinleştirilen --[no]implicit_deps
seçeneği, sorgu üzerinde çalıştığı bağımlılık grafiğine gizli bağımlılıkların dahil edilmesine neden olur. Örtük bağımlılık, BUILD dosyasında açıkça belirtilmeyen ancak bazel tarafından eklenen bir bağımlılıktır.
Örnek: "PEBL ağacındaki tüm testleri derlemek için gereken tüm genrules tanımlarının (BUILD dosyalarında) konumlarını gösterin."
bazel query --output location 'kind(genrule, deps(kind(".*_test rule", foo/bar/pebl/...)))'
İşlem grafiğini sorgulama
aquery
komutu, derleme grafiğinizde işlemler için sorgu göndermenize olanak tanır.
Analiz sonrası yapılandırılmış hedef grafiğinde çalışır ve işlemler, yapı taşları ve bunların ilişkileri hakkında bilgi sağlar.
Araç, çeşitli komut satırı seçeneklerini kabul eder.
--output
çıkış biçimini seçer. Varsayılan çıkış biçimi (text
) kullanıcılar tarafından okunabilir. Makine tarafından okunabilir biçim için proto
veya textproto
kullanın.
aquery komutunun normal bir Bazel derlemesinin üzerinde çalıştığı ve derleme sırasında kullanılabilen seçenek grubunu devraldığı özellikle belirtilmelidir.
Geleneksel query
'te de kullanılabilen işlevlerin aynısını destekler ancak siblings
, buildfiles
ve tests
'te de kullanılabilir.
Daha fazla bilgi için İşlem Grafiği Sorgusu başlıklı makaleyi inceleyin.
Çeşitli komutlar ve seçenekler
help
help
komutu, online yardım sunar. Varsayılan olarak, Bazel ile derleme bölümünde gösterildiği gibi mevcut komutların ve yardım konularının özetini gösterir.
Bir bağımsız değişken belirtmek, belirli bir konuyla ilgili ayrıntılı yardım gösterir. Konuların çoğu build
veya query
gibi Bazel komutlarıdır ancak komutlara karşılık gelmeyen bazı ek yardım konuları da vardır.
--[no]long
(-l
)
Varsayılan olarak bazel help [topic]
, yalnızca bir konuyla ilgili alakalı seçeneklerin özetini yazdırır. --long
seçeneği belirtilirse her bir seçeneğin türü, varsayılan değeri ve tam açıklaması da yazdırılır.
shutdown
Bazel sunucusu işlemleri, shutdown
komutu kullanılarak durdurulabilir. Bu komut, Bazel sunucusunun boşta kaldığında (örneğin, devam etmekte olan derlemeler veya diğer komutlar tamamlandıktan sonra) hemen çıkmasına neden olur. Daha fazla bilgi için İstemci/sunucu uygulaması başlıklı makaleyi inceleyin.
Bazel sunucuları, boşta kalma zaman aşımı süresinden sonra kendilerini durdurur. Bu nedenle bu komut nadiren gereklidir. Ancak belirli bir çalışma alanında başka derleme yapılmayacağı bilindiğinde komutlar için yararlı olabilir.
shutdown
, tam sayı bağımsız değişkeni (MB cinsinden) gerektiren bir seçenek olan --iff_heap_size_greater_than _n_
'u kabul eder. Bu ayar belirtilirse kapatma işlemi, önceden tüketilen bellek miktarına bağlı olur. Bu, çok sayıda derleme başlatan komut dosyaları için kullanışlıdır. Çünkü Bazel sunucusundaki herhangi bir bellek sızıntısı, sunucudaki bazı durumlarda hayali bir şekilde çökmesine neden olabilir. Koşullu yeniden başlatma işlemi, bu durumu önler.
info
info
komutu, Bazel sunucu örneğiyle veya belirli bir derleme yapılandırmasıyla ilişkili çeşitli değerleri yazdırır.
(Bu değerler, derlemeyi yöneten komut dosyaları tarafından kullanılabilir.)
info
komutu, aşağıdaki listedeki anahtarlardan birinin adı olan tek bir (isteğe bağlı) bağımsız değişkene de izin verir.
Bu durumda bazel info key
yalnızca söz konusu anahtarın değerini yazdırır. (Bu, sonucu sed -ne /key:/s/key://p
üzerinden aktarma ihtiyacını ortadan kaldırdığı için özellikle Bazel komut dosyası yazarken kullanışlıdır:
Yapılandırmadan bağımsız veriler
release
: bu Bazel örneği için sürüm etiketi veya yayınlanan bir ikili program değilse "geliştirme sürümü".workspace
temel çalışma alanı dizininin mutlak yolu.install_base
: geçerli kullanıcı için bu Bazel örneği tarafından kullanılan yükleme dizininin mutlak yoludur. Bazel, dahili olarak gerekli olan yürütülebilir dosyalarını bu dizinin altına yükler.output_base
: geçerli kullanıcı ve çalışma alanı kombinasyonu için bu Bazel örneği tarafından kullanılan temel çıkış dizinine giden mutlak yol. Bazel, tüm scratch ve derleme çıkışlarını bu dizinin altına yerleştirir.execution_root
: output_base altındaki yürütme kök dizininin mutlak yolu. Bu dizin, derleme sırasında çalıştırılan komutların erişebildiği tüm dosyaların köküdür ve bu komutların çalışma dizinidir. Workspace dizini yazılabilir durumdaysa bu dizine işaret edenbazel-<workspace>
adlı bir sembolik bağlantı yerleştirilir.output_path
: Derleme komutları sonucunda oluşturulan tüm dosyalar için kullanılan yürütme kökünün altındaki çıkış dizininin mutlak yoludur. Çalışma alanı dizini yazabiliyorsa buraya, bu dizini işaret edenbazel-out
adlı bir sembolik bağlantı yerleştirilir.server_pid
: Bazel sunucu sürecinin işlem kimliği.server_log
: Bazel sunucusunun hata ayıklama günlük dosyasının mutlak yolu. Bu dosya, Bazel sunucusunun kullanım süresi boyunca tüm komutlar için hata ayıklama bilgilerini içerir ve Bazel geliştiricileri ile ileri düzey kullanıcılar tarafından okunmak üzere tasarlanmıştır.command_log
: Komut günlüğü dosyasının mutlak yoludur. En son Bazel komutunun iç içe yerleştirilmiş stdout ve stderr akışlarını içerir.bazel info
çalıştırıldığında en son Bazel komutu olduğu için bu dosyanın içeriğinin üzerine yazılacağını unutmayın. Ancak--output_base
veya--output_user_root
seçeneklerinin ayarını değiştirmediğiniz sürece komut günlüğü dosyasının konumu değişmez.used-heap-size
,committed-heap-size
,max-heap-size
: Çeşitli JVM yığın boyutu parametrelerini raporlar. Sırasıyla: şu anda kullanılan bellek, şu anda sistemden JVM'ye uygun olması garanti edilen bellek, mümkün olan maksimum ayırma.gc-count
,gc-time
: Bu Bazel sunucusunun başlatılmasından bu yana yapılan toplam çöp toplama sayısı ve bu işlemlerin gerçekleştirilmesi için harcanan süre. Bu değerlerin her derlemenin başında sıfırlanmadığını unutmayın.package_path
: bazel tarafından paket aranacak, iki nokta üst üste ile ayrılmış bir yol listesi.--package_path
derleme komut satırı bağımsız değişkeniyle aynı biçime sahiptir.
Örnek: Bazel sunucusunun işlem kimliği.
% bazel info server_pid 1285
Yapılandırmaya özgü veriler
Bu veriler, bazel info
ürününe iletilen yapılandırma seçeneklerinden (ör. --cpu
, --compilation_mode
vb.) etkilenebilir. info
komutu, bağımlılık analizini kontrol eden tüm seçenekleri kabul eder. Bunun nedeni, bu seçeneklerin bazıları derlemenin çıkış dizininin konumunu, derleyici seçimini vb. belirler.
bazel-bin
,bazel-testlogs
,bazel-genfiles
: Derleme tarafından oluşturulan programların bulunduğubazel-*
dizinlerinin mutlak yolunu bildirir. Bu, her zaman olmasa da genellikle başarılı bir derleme sonrasında ana Workspace dizininde oluşturulanbazel-*
sembolik bağlantılarıyla aynıdır. Ancak çalışma alanı dizini salt okunur durumdaysabazel-*
sembolik bağlantısı oluşturulamaz. Simge bağlantısının varlığını varsaymak yerinebazel info
tarafından bildirilen değeri kullanan komut dosyaları daha sağlamdır.- Tamamlanmış "Make" ortamı.
--show_make_env
işareti belirtilirse geçerli yapılandırmadaki "Make" ortamındaki tüm değişkenler de (CC
,GLIBC_VERSION
vb.) görüntülenir. Bunlar, BUILD dosyalarındaki$(CC)
veyavarref("CC")
söz dizimi kullanılarak erişilen değişkenlerdir.
Örnek: mevcut yapılandırma için C++ derleyicisi.
Bu, "Make" ortamındaki $(CC)
değişkenidir. Bu nedenle --show_make_env
işareti gereklidir.
% bazel info --show_make_env -c opt COMPILATION_MODE opt
Örnek: Geçerli yapılandırma için bazel-bin
çıkış dizini. bazel-bin
sembolik bağlantısının herhangi bir nedenle oluşturulamadığı durumlarda bile (ör. salt okunur bir dizinden derliyorsanız) bu değerin doğru olduğu garanti edilir.
% bazel info --cpu=piii bazel-bin /var/tmp/_bazel_johndoe/fbd0e8a34f61ce5d491e3da69d959fe6/execroot/io_bazel/bazel-out/piii-opt/bin % bazel info --cpu=k8 bazel-bin /var/tmp/_bazel_johndoe/fbd0e8a34f61ce5d491e3da69d959fe6/execroot/io_bazel/bazel-out/k8-opt/bin
version
ve --version
version komutu, derlenen Bazel ikilisiyle ilgili sürüm ayrıntılarını (derlendiği değişiklik listesi ve tarih dahil) yazdırır. Bu bilgiler özellikle en son Bazel sürümüne sahip olup olmadığınızı belirlemek veya hata bildirmek için yararlıdır. İlginç değerlerden bazıları şunlardır:
changelist
: Bazel'in bu sürümünün yayınlandığı değişiklik listesi.label
: Bu Bazel örneğinin sürüm etiketi veya yayınlanmış bir ikili dosya değilse "geliştirme sürümü". Hata bildirme aşamasında çok faydalıdır.
Başka bağımsız değişken içermeyen bazel --version
, Bazel sunucusu başlatma veya sunucu arşivinin paketini açma yan etkisi olmadan bazel version --gnu_format
ile aynı çıktıyı verir. bazel --version
, çalışma alanı dizini gerektirmeden her yerden çalıştırılabilir.
mobile-install
mobile-install
komutu, uygulamaları mobil cihazlara yükler.
Şu anda yalnızca ART çalıştıran Android cihazlar desteklenmektedir.
Daha fazla bilgi için bazel mobile-install komutuna bakın.
Aşağıdaki seçenekler desteklenir:
--incremental
Politika ayarlanırsa Bazel uygulamayı aşamalı olarak, yani son derlemeden bu yana değişen bölümleri yüklemeye çalışır. Bu işlem, AndroidManifest.xml
'ten, yerel koddan veya Java kaynaklarından (Class.getResource()
tarafından referans verilenler gibi) referans verilen kaynakları güncelleyemez. Bu öğeler değişirse bu seçenek atlanmalıdır. Bazel'in ruhuna aykırı olarak ve Android platformunun sınırlamaları nedeniyle, bu komutun ne zaman yeterli olduğunu ve ne zaman tam yükleme gerektiğini bilmek kullanıcı sorumluluğundadır.
Marshmallow veya sonraki sürümlerin yüklü olduğu bir cihaz kullanıyorsanız --split_apks
işaretini kullanabilirsiniz.
--split_apks
Uygulamayı cihaza yüklemek ve güncellemek için bölünmüş APK'ların kullanılıp kullanılmayacağı.
Yalnızca Marshmallow veya sonraki sürümlerin yüklü olduğu cihazlarda çalışır. --split_apks
kullanılırken --incremental
işaretinin gerekli olmadığını unutmayın.
--start_app
Uygulamayı yükledikten sonra temiz bir durumda başlatır. --start=COLD
etiketine eş değer.
--debug_app
Yükleme işleminden sonra uygulamayı temiz durumda başlatmadan önce hata ayıklayıcının eklenmesini bekler.
--start=DEBUG
etiketine eş değer.
--start=_start_type_
Uygulamanın yüklendikten sonra nasıl başlatılacağı. Desteklenen _start_type_ler şunlardır:
NO
Uygulamayı başlatmaz. Bu varsayılan ayardır.COLD
Yükleme işleminden sonra uygulamayı temiz durumdan başlatır.WARM
Artımlı yüklemelerde uygulama durumunu korur ve geri yükler.DEBUG
Yüklemeden sonra uygulamayı temiz bir durumda başlatmadan önce hata ayıklayıcıyı bekler.
--adb=path
Kullanılacak adb
ikili programını belirtir.
Varsayılan olarak adb, --android_sdk
ile belirtilen Android SDK'sında kullanılır.
--adb_arg=serial
adb
için ek bağımsız değişkenler. Bunlar, komut satırında alt komuttan önce gelir ve genellikle hangi cihaza yükleneceğini belirtmek için kullanılır.
Örneğin, kullanılacak Android cihazı veya emülatörü seçmek için:
% bazel mobile-install --adb_arg=-s --adb_arg=deadbeef
adb
işlevi şu şekilde çağrılır:
adb -s deadbeef install ...
--incremental_install_verbosity=number
Artımlı yükleme için ayrıntı düzeyi. Hata ayıklama günlüklerinin konsola yazılması için 1 değerine ayarlayın.
dump
dump
komutu, Bazel sunucusunun dahili durumunun bir dökümünü stdout'a yazdırır. Bu komutun temel amacı Bazel geliştiricileri tarafından kullanılmasıdır. Bu nedenle, bu komutun çıkışı belirtilmez ve değişiklik gösterebilir.
Varsayılan olarak, komut yalnızca Bazel durumunun belirli alanlarını dökümde olası seçenekleri açıklayan yardım mesajını yazdırır. Dahili durumu dökmek için seçeneklerden en az biri belirtilmelidir.
Aşağıdaki seçenekler desteklenir:
--action_cache
, işlem önbellek içeriğini döküm haline getirir.--packages
, paket önbelleği içeriğini dökümü yapar.--skyframe
, dahili Bazel bağımlılık grafiğinin durumunu dökümü alır.--rules
, sayılar ve işlem sayıları dahil olmak üzere her kural ve özellik sınıfı için kural özetini dökümü yapar. Buna hem yerel hem de Starlark kuralları dahildir. Bellek takibi etkinse kuralların bellek tüketimi de yazdırılır.--skylark_memory
, belirtilen yola pprof uyumlu bir .gz dosyası atar. Bunun çalışması için bellek izlemeyi etkinleştirmeniz gerekir.
Bellek takibi
Bazı dump
komutları bellek izlemeyi gerektirir. Bu özelliği etkinleştirmek için Bazel'e başlangıç işaretleri iletmeniz gerekir:
--host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar
--host_jvm_args=-DRULE_MEMORY_TRACKER=1
java-agent, Bazel'e third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar
adresinde kaydedilir. Bu nedenle, $BAZEL
değerini Bazel deponuzun bulunduğu yere göre ayarladığınızdan emin olun.
Her komut için bu seçenekleri Bazel'e iletmeyi unutmayın. Aksi takdirde sunucu yeniden başlatılır.
Örnek:
% bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \ --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \ build --nobuild <targets> # Dump rules % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \ --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \ dump --rules # Dump Starlark heap and analyze it with pprof % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \ --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \ dump --skylark_memory=$HOME/prof.gz % pprof -flame $HOME/prof.gz
analyze-profile
analyze-profile
komutu, --profile
seçeneğini kullanarak derleme sırasında daha önce toplanan verileri analiz eder. Derleme yürütmenin analizini gerçekleştirmek veya verileri belirtilen biçimde dışa aktarmak için çeşitli seçenekler sunar.
Aşağıdaki seçenekler desteklenir:
--dump
, toplanan tüm verileri kullanıcı tarafından okunabilir bir biçimde gösterir. Ancak bu özellik henüz diğer biçimleri desteklemiyor.
Biçim ayrıntıları ve kullanım yardımı için Profil oluşturarak performans sorunlarını giderme başlıklı makaleyi inceleyin.
canonicalize-flags
Bazel komutu için bir seçenek listesi alan ve aynı etkiye sahip bir seçenek listesi döndüren canonicalize-flags
komutu. Yeni seçenek listesi kanoniktir. Örneğin, aynı etkiye sahip iki seçenek listesi aynı yeni listeyle standartlaştırılır.
Farklı komutlar arasında seçim yapmak için --for_command
seçeneği kullanılabilir. Şu anda yalnızca build
ve test
desteklenmektedir. Verilen komutun desteklemediği seçenekler hataya neden olur.
Örneğin:
% bazel canonicalize-flags -- --config=any_name --test_tag_filters="-lint" --config=any_name --test_tag_filters=-lint
Başlangıç seçenekleri
Bu bölümde açıklanan seçenekler, Bazel sunucu işlemi tarafından kullanılan Java sanal makinesinin başlatılmasını etkiler ve bu sunucu tarafından işlenen sonraki tüm komutlar için geçerlidir. Çalışan bir Bazel sunucusu varsa ve başlangıç seçenekleri eşleşmiyorsa sunucu yeniden başlatılır.
Bu bölümde açıklanan tüm seçenekler --key=value
veya --key value
söz dizimi kullanılarak belirtilmelidir. Ayrıca bu seçenekler, Bazel komutunun adından önce görünmelidir. Bunları bir .bazelrc
dosyasında listelemek için startup --key=value
kullanın.
--output_base=dir
Bu seçenek için bir yol bağımsız değişkeni gerekir. Bu bağımsız değişken, yazılabilir bir dizin belirtmelidir. Bazel, tüm çıkışını yazmak için bu konumu kullanır. Çıkış tabanı, istemcinin Bazel sunucusunu bulduğu anahtardır. Çıkış tabanını değiştirerek komutu işleyen sunucuyu değiştirirsiniz.
Varsayılan olarak çıkış tabanı, kullanıcının giriş adından ve çalışma alanı dizininin adından (aslında MD5 özeti) türetilir. Dolayısıyla normal bir değer şu şekilde görünür: /var/tmp/google/_bazel_johndoe/d41d8cd98f00b204e9800998ecf8427e
.
Örneğin:
OUTPUT_BASE=/var/tmp/google/_bazel_johndoe/custom_output_base % bazel --output_base ${OUTPUT_BASE}1 build //foo & bazel --output_base ${OUTPUT_BASE}2 build //bar
Bu komutta, iki Bazel komutu aynı anda (kabuk &
operatörü nedeniyle) çalışır ve her biri farklı bir Bazel sunucu örneği kullanır (farklı çıkış tabanları nedeniyle).
Buna karşılık, her iki komutta da varsayılan çıkış tabanı kullanılmışsa her iki istek de aynı sunucuya gönderilir. Bu sunucu, istekleri sırayla işler: Önce //foo
, ardından //bar
'un artımlı derlemesi oluşturulur.
--output_user_root=dir
Çıkış ve yükleme tabanlarının oluşturulduğu kök dizine işaret eder. Dizin mevcut olmamalı veya arayan kullanıcıya ait olmalıdır. Önceden bu özelliğin çeşitli kullanıcılar arasında paylaşılan bir dizine işaret etmesine izin veriliyordu ancak artık buna izin verilmiyor. 11100 numaralı sorun giderildikten sonra buna izin verilebilir.
--output_base
seçeneği belirtilirse çıkış tabanını hesaplamak için --output_user_root
kullanımını geçersiz kılar.
Yükleme tabanı konumu, --output_user_root
ve Bazel yerleşik ikili dosyalarının MD5 kimliğine göre hesaplanır.
Dosya sistemi düzeninizde daha iyi bir konum varsa Bazel'in tüm çıktıları (yükleme tabanı ve çıkış tabanı) için alternatif bir temel konum seçmek isterseniz --output_user_root
seçeneğini kullanabilirsiniz.
--server_javabase=dir
Bazel'in çalıştığı Java sanal makinesini belirtir. Değer, JDK veya JRE içeren dizinin yolu olmalıdır. Etiket olmamalıdır. Bu seçenek, herhangi bir Bazel komutundan önce görünmelidir. Örneğin:
% bazel --server_javabase=/usr/local/buildtools/java/jdk11 build //foo
Bu işaret, Bazel alt süreçleri tarafından kullanılan JVM'leri (ör. uygulamalar, testler, araçlar vb.) etkilemez. Bunun yerine --javabase veya --host_javabase yapılandırma seçeneklerini kullanın.
Bu işaret daha önce --host_javabase
(bazen "sol taraftaki" --host_javabase
olarak adlandırılır) olarak adlandırılıyordu ancak derleme işareti --host_javabase (bazen "sağ taraftaki" --host_javabase
olarak adlandırılır) ile karışıklık olmaması için yeniden adlandırıldı.
--host_jvm_args=string
Bazel'in kendisinin çalıştığı Java sanal makinesine iletilecek bir başlatma seçeneği belirtir. Bu, yığın boyutunu ayarlamak için kullanılabilir. Örneğin:
% bazel --host_jvm_args="-Xss256K" build //foo
Bu seçenek, bağımsız değişkenlerle birden çok kez kullanılabilir. Bu işaretin ayarlanmasına nadiren gerek olacağını unutmayın. Ayrıca, her biri ayrı bir JVM bağımsız değişkeni olarak yorumlanacak, boşlukla ayrılmış bir dize listesi de iletebilirsiniz. Ancak bu özellik yakında kullanımdan kaldırılacaktır.
Bu durum, Bazel'in alt süreçleri tarafından kullanılan JVM'leri (uygulamalar, testler, araçlar vb.) etkilemez. bazel
run
tarafından veya komut satırında çalıştırılan yürütülebilir Java programlarına JVM seçeneklerini iletmek için tüm java_binary
ve java_test
programlarının desteklediği --jvm_flags
bağımsız değişkenini kullanmanız gerekir. Testler için alternatif olarak bazel test --test_arg=--jvm_flags=foo ...
işlevini kullanın.
--host_jvm_debug
Bu seçenek, Java sanal makinesinin Bazel'in ana yöntemini çağırmadan önce JDWP uyumlu bir hata ayıklayıcıdan gelecek bağlantıyı beklemesine neden olur. Bu, öncelikle Bazel geliştiricileri tarafından kullanılmak üzere tasarlanmıştır.
--autodetect_server_javabase
Bu seçenek, Bazel'in başlangıçta yüklü bir JDK'yi otomatik olarak aramasına ve yerleşik JRE kullanılamıyorsa yüklü JRE'ye geri dönmesine neden olur.
--explicit_server_javabase
, Bazel'i çalıştırmak için açık bir JRE seçmek amacıyla kullanılabilir.
--batch
Toplu mod, Bazel'in standart istemci/sunucu modunu kullanmamasına neden olur. Bunun yerine tek bir komut için bazel Java işlemi çalıştırır. Bu mod; sinyal işleme, iş kontrolü ve ortam değişkeni devralmasıyla ilgili daha tahmin edilebilir anlamlar için kullanılır ve bazel'i bir Chrome hapishanesinde çalıştırmak için gereklidir.
Toplu mod, aynı output_base içinde doğru sıraya ekleme anlamlarını korur. Yani eşzamanlı çağrılar, çakışma olmadan sırayla işlenir. Çalışan bir sunucuya sahip bir istemcide toplu mod için Bazel çalıştırılırsa ilk olarak, komutu işlemeden önce sunucu sonlandırılır.
Bazel, toplu modda veya yukarıda açıklanan alternatiflerle daha yavaş çalışır. Bunun nedeni, diğerlerinin yanı sıra derleme dosyası önbelleği bellekte yerleşik olduğundan, art arda toplu çağrılar arasında korunmamasıdır. Bu nedenle, toplu modu kullanmak genellikle performansın daha az önemli olduğu durumlarda (ör. sürekli derlemeler) daha mantıklı olur.
--max_idle_secs=n
Bu seçenek, Bazel sunucu sürecinin son istemci isteğinden sonra çıkmadan önce saniye cinsinden ne kadar beklemesi gerektiğini belirtir. Varsayılan değer 10.800 (3 saat) şeklindedir. --max_idle_secs=0
, Bazel sunucusu işleminin süresiz olarak devam etmesine neden olur.
Bu seçenek, Bazel'i çağıran komut dosyaları tarafından, Bazel sunucu işlemlerinin kullanıcının makinesinde aksi takdirde çalışmadığından emin olmak için kullanılabilir.
Örneğin, bir göndermeden önce komut dosyası, kullanıcının bekleyen değişikliğinin istenmeyen bağımlılıklara neden olmaması için bazel query
işlevini çağırabilir. Bununla birlikte, kullanıcı söz konusu çalışma alanında yakın zamanda bir derleme yapmamışsa, gönderme öncesi komut dosyasının günün geri kalanında boşta kalması için Bazel sunucusu başlatması istenmeyen bir durumdur.
Sorgu isteğinde küçük bir --max_idle_secs
değeri belirtildiğinde, komut dosyası yeni bir sunucunun başlatılmasına neden olması durumunda söz konusu sunucunun hemen çıkmasını, ancak bunun yerine zaten çalışan bir sunucu varsa o sunucu normal süre boyunca boşta kalana kadar çalışmaya devam etmesini sağlayabilir. Elbette mevcut sunucunun boş zamanlayıcısı sıfırlanır.
--[no]shutdown_on_low_sys_mem
Politika etkinleştirilirse ve --max_idle_secs
pozitif bir süreye ayarlanırsa derleme sunucusu bir süre boşta kaldığında sistemde bellek azaldığında sunucuyu kapatın. Yalnızca Linux.
Derleme sunucusu, max_idle_secs değerine karşılık gelen bir boşta kalma kontrolü çalıştırmanın yanı sıra sunucu bir süre boşta kaldıktan sonra kullanılabilir sistem belleğini izlemeye başlar. Kullanılabilir sistem belleği kritik düzeyde düşük olursa sunucu kapanır.
--[no]block_for_lock
Etkinleştirilirse Bazel, devam etmeden önce sunucu kilidini tutan diğer Bazel komutlarının tamamlanmasını bekler. Devre dışı bırakılırsa Bazel, kilidi hemen alıp devam edemezse hatayla çıkar.
Geliştiriciler, aynı istemcide başka bir Bazel komutunun neden olduğu uzun bekleme sürelerini önlemek için bunu göndermeden önce yapılan kontrollerde kullanabilir.
--io_nice_level=n
En iyi çabayla IO planlaması için 0-7 arasında bir düzey ayarlar. 0 en yüksek öncelik, 7 en düşük önceliktir. Tahmini planlayıcı yalnızca 4. önceliğe kadar olan görevleri dikkate alabilir. Negatif değerler yoksayılır.
--batch_cpu_scheduling
Bazel için batch
CPU planlamasını kullanın. Bu politika, etkileşimli olmayan ancak iyi değerlerini düşürmek istemeyen iş yükleri için kullanışlıdır.
"man 2 sched_setscheduler" bölümüne bakın. Bu politika, Bazel veri akışı pahasına daha iyi sistem etkileşimi sağlayabilir.
Çeşitli seçenekler
--[no]announce_rc
Bazel'in başlatma sırasında bazelrc dosyasından okunan komut seçeneklerini duyurup bildirmeyeceğini kontrol eder. (Başlangıç seçenekleri koşulsuz olarak duyurulur.)
--color (yes|no|auto)
Bu seçenek, Bazel'in ekrandaki çıktısını vurgulamak için renk kullanıp kullanmayacağını belirler.
Bu seçenek yes
değerine ayarlanırsa renk çıkışı etkinleştirilir.
Bu seçenek auto
olarak ayarlanırsa Bazel, yalnızca çıkış bir terminale gönderiliyorsa ve TERM ortam değişkeni dumb
, emacs
veya xterm-mono
dışında bir değere ayarlanmışsa renkli çıkış kullanır.
Bu seçenek no
olarak ayarlanırsa çıkışın bir terminale gönderilip gönderilmediğine ve TERM ortam değişkeninin ayarına bakılmaksızın renkli çıkış devre dışı bırakılır.
--config=name
rc dosyalarından ek yapılandırma bölümünü seçer. Geçerli command
için, böyle bir bölüm varsa command:name
öğesindeki seçenekleri de alır. Birden fazla yapılandırma bölümünden işaret eklemek için birden çok kez belirtilebilir. Genişletmeler diğer tanımlara işaret edebilir (örneğin, genişletmeler zincirlenebilir).
--curses (yes|no|auto)
Bu seçenek, Bazel'in ekran çıkışında imleç kontrollerini kullanıp kullanmayacağını belirler. Bu sayede, daha az kaydırma gerektiren veriler elde edilir ve Bazel'den daha kompakt, okunması kolay bir çıkış akışı sağlanır. Bu yöntem --color
ile iyi çalışır.
Bu seçenek yes
olarak ayarlanırsa imleç denetimlerinin kullanımı etkinleştirilir.
Bu seçenek no
değerine ayarlanırsa imleç denetimlerinin kullanımı devre dışı bırakılır.
Bu seçenek auto
değerine ayarlanırsa imleç denetimlerinin kullanımı, --color=auto
ile aynı koşullar altında etkinleştirilir.
--[no]show_timestamps
Belirtilirse Basel tarafından oluşturulan her iletiye, iletinin gösterildiği zamanı belirten bir zaman damgası eklenir.