Bu sayfada, Bazel'in kaynaktan nasıl yükleneceği açıklanmakta ve sık karşılaşılan sorunlarla ilgili sorun giderme ipuçları verilmektedir.
Bazel'i kaynaktan derlemek için aşağıdakilerden birini yapabilirsiniz:
Dosyayı, önyükleme olarak bilinen mevcut bir Bazel ikili programı olmadan derleyin.
Bazel kullanarak Bazel oluşturma
Özet
En son Bazel sürümünü GitHub sürüm sayfasından veya Bazelisk ile edinin.
GitHub'dan Bazel'ın kaynaklarını indirin ve bir yere çıkarın. Alternatif olarak, https://github.com/bazelbuild/bazel adresinden kaynak ağacını git ile kopyalayabilirsiniz.
Önyüklemeyle aynı ön koşulları yükleyin (Unix benzeri sistemler veya Windows için bkz.)
Bazel kullanarak bir Bazel geliştirme derlemesi oluşturun:
bazel build //src:bazel-dev
(veya Windows'dabazel build //src:bazel-dev.exe
)Elde edilen ikili dosya
bazel-bin/src/bazel-dev
(veya Windows'tabazel-bin\src\bazel-dev.exe
) konumundadır. İstediğiniz yere kopyalayıp başka bir yüklemeye gerek kalmadan hemen kullanabilirsiniz.
Ayrıntılı talimatları aşağıda bulabilirsiniz.
1. Adım: En son Bazel sürümünü edinin
Hedef: Bazel'in yayınlanan bir sürümünü yükleyin veya indirin. Terminalde bazel
yazarak çalıştırabildiğinizden emin olun.
Nedeni: Bazel'i bir GitHub kaynak ağacından derlemek için önceden oluşturulmuş bir Bazel ikilisine ihtiyacınız vardır. Paket yöneticisinden bir tane yükleyebilir veya GitHub'dan bir tane indirebilirsiniz. Bazel'i yükleme başlıklı makaleyi inceleyin. (Alternatif olarak sıfırdan (bootstrap) da oluşturabilirsiniz.)
Sorun giderme:
Bir terminale
bazel
yazarak Bazel'i çalıştıramıyorsanız:Belki de Bazel ikili programınızın dizini PATH üzerinde değildir.
Bu önemli bir sorun değil.
bazel
yazmak yerine tam yolu yazmanız gerekir.Bazel ikili dosyası
bazel
(Unix'te) veyabazel.exe
(Windows'ta) olarak adlandırılmıyor olabilir.Bu önemli bir sorun değil. İkili dosyayı yeniden adlandırabilir veya
bazel
yerine ikili dosyanın adını yazabilirsiniz.İkili program yürütülebilir olmayabilir (Unix'te).
chmod +x /path/to/bazel
komutunu çalıştırarak ikili dosyayı yürütülebilir hale getirmeniz gerekir.
2. Adım: Bazel'in kaynaklarını GitHub'dan indirin
Git hakkında bilginiz varsa Git clone'u kullanabilirsiniz https://github.com/bazelbuild/bazel
Diğer durumlarda:
En son kaynakları ZIP dosyası olarak indirin.
İçeriği bir yere ayıklayın.
Örneğin, ana dizininizde bir
bazel-src
dizini oluşturun ve dosyaları buraya çıkarın.
3. adım: Ön koşulları yükleyin
İlk başlatma için gereken ön koşullarla aynı ön koşulları (aşağıya bakın) yükleyin: JDK, C++ derleyicisi, MSYS2 (Windows'da derliyorsanız) vb.
4a. adım: Ubuntu Linux, macOS ve Unix benzeri diğer sistemlerde Bazel'i derleyin
Windows'a yönelik talimatlar için Windows'da Bazel oluşturma başlıklı makaleye bakın.
Hedef: Özel bir Bazel ikili dosyası (bazel-bin/src/bazel-dev
) oluşturmak için Bazel'i çalıştırın.
Talimatlar:
Bash terminali başlatın
cd
dosyasını, Bazel'in kaynaklarını ayıkladığınız (veya kopyaladığınız) dizine kopyalayın.Örneğin, kaynakları ana dizininizdeki bir klasöre çıkardıysanız şu komutu çalıştırın:
cd ~/bazel-src
Bazel'ı kaynaktan derleyin:
bazel build //src:bazel-dev
Alternatif olarak, daha küçük bir ikili oluşturmak için
bazel build //src:bazel --compilation_mode=opt
çalıştırabilirsiniz ancak bu işlemin derlenmesi daha yavaştır.Çıkış değeri
bazel-bin/src/bazel-dev
(veyabazel-bin/src/bazel
) olur.
4b Adımı: Windows'da Bazel oluşturun
Unix benzeri sistemlerle ilgili talimatlar için Ubuntu Linux, macOS ve diğer Unix benzeri sistemlere göz atın.
Hedef: Özel bir Bazel ikili programı oluşturmak için Bazel'i çalıştırın
(bazel-bin\src\bazel-dev.exe
).
Talimatlar:
Komut İstemi'ni başlatın (Başlat Menüsü > Çalıştır > "cmd.exe")
cd
dosyasını Bazel'ın kaynaklarını çıkardığınız (veya klonladığınız) dizine ekler.Örneğin, kaynakları ana dizininizdeki bir klasöre çıkardıysanız şu komutu çalıştırın:
cd %USERPROFILE%\bazel-src
Bazel'i kaynaktan derleyin:
bazel build //src:bazel-dev.exe
Alternatif olarak daha küçük bir ikili program oluşturmak için
bazel build //src:bazel.exe --compilation_mode=opt
komutunu çalıştırabilirsiniz; ancak derleme işlemi daha yavaştır.Çıkış
bazel-bin\src\bazel-dev.exe
(veyabazel-bin\src\bazel.exe
) olur.
5. adım: Oluşturulan ikili dosyayı yükleyin
Aslında yüklenecek bir şey yok.
Önceki adımın çıktısı, bağımsız bir Bazel ikili programıdır. Dosyayı herhangi bir dizine kopyalayıp hemen kullanabilirsiniz. ("bazel"i her yerde çalıştırabilmeniz için bu dizinin PATH'inizde olması faydalıdır.)
Bazel'i sıfırdan derleme (boot-strapping)
Ayrıca, mevcut bir Bazel ikili programını kullanmadan, Bazel'ı sıfırdan derleyebilirsiniz.
1. Adım: Bazel kaynaklarını (dağıtım arşivi) indirin
(Bu adım tüm platformlar için aynıdır.)
bazel-<version>-dist.zip
dosyasını GitHub'dan indirin (ör.bazel-0.28.1-dist.zip
).İlgi:
- Tek bir mimariden bağımsız dağıtım arşivi vardır. Mimari veya işletim sistemine özel dağıtım arşivleri yoktur.
- Bu kaynaklar, GitHub kaynak ağacıyla aynı değildir. Bazel'i başlatmak için dağıtım arşivini kullanmanız gerekir. GitHub'dan klonlanan bir kaynak ağacını kullanamazsınız. (Dağıtım arşivi, önyükleme için gerekli olan, oluşturulmuş kaynak dosyalarını içerir ve normal Git kaynak ağacının parçası değildir.)
Diskteki bir yerde dağıtım arşivini açın.
Bazel'in sürüm anahtarı 3D5919B448457EE0 tarafından oluşturulan imzayı doğrulamanız gerekir.
2a. adım: Ubuntu Linux, macOS ve Unix benzeri diğer sistemlerde Bazel'i başlatın
Windows talimatları için Windows'da Bazel'i başlatma başlıklı makaleyi inceleyin.
2.1. Ön koşulları yükleme
Durma
sıkıştırma, sıkıştırmayı açma
C++ araç zinciri oluşturma
JDK. 11 sürümü gereklidir.
Python. 2 ve 3 sürümleri desteklenir. Bunlardan birini yüklemeniz yeterlidir.
Örneğin, Ubuntu Linux'ta bu gereksinimleri aşağıdaki komutu kullanarak yükleyebilirsiniz:
sudo apt-get install build-essential openjdk-11-jdk python zip unzip
2.2. Unix'te Bazel'i temellendirme
Bir kabuk veya Terminal penceresi açın.
cd
öğesini, dağıtım arşivini açtığınız dizine ekleyin.Derleme komut dosyasını çalıştırın:
env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh
.
Derlenen çıktı, output/bazel
konumuna yerleştirilir. Bu, yerleşik JDK'ya sahip olmayan bağımsız bir Bazel ikili programıdır. Bu dosyayı kopyalayıp istediğiniz yere yerleştirebilir veya yerinde kullanabilirsiniz. İşinizi kolaylaştırmak için bu ikili programı, PATH
üzerindeki bir dizine (ör. Linux'taki /usr/local/bin
) kopyalayın.
bazel
ikilisini yeniden üretilebilir şekilde derlemek için "Derleme komut dosyasını çalıştır" adımında da SOURCE_DATE_EPOCH
değerini ayarlayın.
2. Adım (b): Windows'da Bazel'i temel hazırlayın
Unix benzeri sistemlerle ilgili talimatlar için Ubuntu Linux, macOS ve diğer Unix benzeri sistemlerde Bazel'i başlatma başlıklı makaleyi inceleyin.
2.1. Gerekli ön koşulları yükleme
Sıkıştırma ve açma için MSYS2 paketleri. MSYS2 kabuğunda aşağıdaki komutu çalıştırın:
pacman -S zip unzip patch
Visual C++ derleyicisi. Visual C++ derleyiciyi Visual Studio 2015 veya daha yeni bir sürümün parçası olarak ya da en son Visual Studio 2017 için Derleme Araçları'nı yükleyerek yükleyin.
JDK. 11 sürümü gereklidir.
Python. Sürüm 2 ve 3 desteklenir, bunlardan birinin yüklenmesi yeterlidir. Yerel Windows sürümüne ihtiyacınız vardır (https://www.python.org adresinden indirilebilir). MSYS2'de pacman aracılığıyla yüklenen sürümler çalışmaz.
2.2. Windows'da Bazel'i temellendirme
MSYS2 kabuğunu açın.
Aşağıdaki ortam değişkenlerini ayarlayın:
BAZEL_VS
veyaBAZEL_VC
(aynı değildir): Visual Studio dizininin (BAZEL_VS) veya Visual C++ dizininin (BAZEL_VC) yoluna ayarlanır. Bunlardan birini ayarlamak yeterli olur.BAZEL_SH
: MSYS2'nin yolubash.exe
. Aşağıdaki örneklerde verilen komuta bakın.Bu değeri
C:\Windows\System32\bash.exe
olarak ayarlamayın. (Linux için Windows alt sistemini yüklediyseniz bu dosyaya sahipsiniz.) Bazel,bash.exe
özelliğinin bu sürümünü desteklemiyor.PATH
: Python dizinini ekleyin.JAVA_HOME
: JDK dizinine ayarlayın.
Örnek (BAZEL_VS kullanılarak):
export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools" export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))" export PATH="/c/python27:$PATH" export JAVA_HOME="C:/Program Files/Java/jdk1.8.0_112"
veya (BAZEL_VC kullanılarak):
export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC" export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))" export PATH="/c/python27:$PATH" export JAVA_HOME="C:/Program Files/Java/jdk1.8.0_112"
cd
öğesini, dağıtım arşivini açtığınız dizine ekleyin.Derleme komut dosyasını çalıştırın:
env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh
Derlenen çıkış output/bazel.exe
içine yerleştirilir. Bu, yerleşik JDK içermeyen, kendi kendine yeten bir Bazel ikili dosyasıdır. Bunu istediğiniz yere kopyalayabilir veya
yerinde kullanabilirsiniz. Size kolaylık sağlaması için bu ikili programı PATH
dosyanızdaki bir dizine kopyalayın.
bazel.exe
ikili programını yeniden oluşturulabilir bir şekilde derlemek için "Derleme komut dosyasını çalıştırma" adımında SOURCE_DATE_EPOCH
değerini de ayarlayın.
Bazel'i MSYS2 kabuğundan çalıştırmanız gerekmez. Bazel'i Komut İstemi'nden (cmd.exe
) veya PowerShell'den çalıştırabilirsiniz.