Bu sayfada, Bazel'ın kaynaktan nasıl yükleneceği açıklanmakta ve sık karşılaşılan sorunlarla ilgili sorun giderme ipuçları sağlanmaktadır.
Bazel'ı kaynaktan oluşturmak 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
GitHub sürüm sayfasından veya Bazelisk kullanarak Bazel'in en son sürümünü 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 klonlayabilirsiniz
Ö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 program,
bazel-bin/src/bazel-dev
(veya Windows'dabazel-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 verilmiştir.
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. Bir terminale bazel
yazarak
bu komutu çalıştırabileceğinizden emin olun.
Neden: GitHub kaynak ağacından Bazel oluşturmak için önceden var olan bir Bazel ikili programı gerekir. Paket yöneticisinden bir uygulama yükleyebilir veya GitHub'dan bir uygulama indirebilirsiniz. Bkz. Bazel'i Yükleme. (Dilerseniz Scratch'tan (bootstrap)) derleme yapabilirsiniz.)
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 büyük bir sorun değildir.
bazel
yazmak yerine tam yolu yazmanız gerekir.Bazel ikilisinin kendisi
bazel
(Unixes'te) veyabazel.exe
(Windows'da) olarak adlandırılmamış olabilir.Bu büyük bir sorun değildir. İkili dosyayı yeniden adlandırabilir veya
bazel
yerine ikili programın adını yazabilirsiniz.İkili program yürütülebilir olmayabilir (Unix'te).
chmod +x /path/to/bazel
komutunu çalıştırarak ikili programı yürütülebilir hale getirmeniz gerekir.
2. Adım: GitHub'dan Bazel'ın kaynaklarını 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 yerden çıkarın.
Örneğin, ana dizininizin altında bir
bazel-src
dizini oluşturun ve bu dizini oradan çıkarın.
3. adım: Ön koşulları yükleyin
Önyükleme için belirtilen ön koşulları (aşağıya bakın) yükleyin: JDK, C++ derleyici, MSYS2 (Windows'da derleme yapıyorsanız).
4a Adımı: Ubuntu Linux, macOS ve Unix benzeri diğer sistemlerde Bazel'i oluşturun
Windows'a yönelik talimatlar için Windows'da Bazel oluşturma başlıklı makaleye bakın.
Hedef: Özel bir Bazel ikili programı (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'ın kaynaklarını çıkardığınız (veya klonladığınız) dizine ekler.Örneğin, ana dizininizin altındaki kaynakları ayıkladı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 program oluşturmak için
bazel build //src:bazel --compilation_mode=opt
çalıştırabilirsiniz. Ancak derlemesi 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 (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, ana dizininizin altındaki kaynakları ayıkladıysanız şu komutu çalıştırın:
cd %USERPROFILE%\bazel-src
Bazel'ı 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: Derlenen ikili programı yükleyin
Aslında yüklenecek bir şey yok.
Önceki adımın çıktısı, bağımsız bir Bazel ikili programıdır. Bunu herhangi bir dizine kopyalayıp hemen kullanabilirsiniz. (Söz konusu dizin PATH üzerindeyse faydalıdır; böylece her yerde "bazel" çalıştırabilirsiniz.)
Bazel'ı sıfırdan derleme (önyükleme)
Ayrıca, mevcut bir Bazel ikili programını kullanmadan, Bazel'ı sıfırdan derleyebilirsiniz.
1. Adım: Bazel'in kaynaklarını (dağıtım arşivi) indirin
(Bu adım tüm platformlar için aynıdır.)
bazel-<version>-dist.zip
uygulamasını GitHub'dan indirin (örneğin,bazel-0.28.1-dist.zip
).İlgi:
- Tek ve mimariden bağımsız bir 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 önyüklemek 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 ile oluşturulan imzayı doğrulamanız gerekir.
2a Adımı: Ubuntu Linux, macOS ve Unix benzeri diğer sistemlerde Bootstrap Bazel
Windows'a yönelik talimatlar için Windows'da Bootstrap Bazel sayfasına bakın.
2.1. Ön koşulları yükleme
Durma
sıkıştırma, sıkıştırmayı açma
C++ araç zinciri oluşturma
JDK. Sürüm 11 gerekir.
Python. Sürüm 2 ve 3 desteklenir, bunlardan birinin yüklenmesi 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 Bootstrap Bazel
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. Bunu istediğiniz yere kopyalayabilir 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
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.
2b Adımı: Windows'da Bootstrap Bazel
Unix benzeri sistemlerle ilgili talimatlar için Ubuntu Linux, macOS ve diğer Unix benzeri sistemlerde Bootstrap Bazel sayfasına bakın.
2.1. Ön koşulları yükleme
Sıkıştırma ve sıkıştırılmış dosya açma için MSYS2 paketleri. MSYS2 kabuğunda aşağıdaki komutu çalıştırın:
pacman -S zip unzip patch
Visual C++ derleyici. Visual Studio 2015 veya daha yeni bir sürümün bir parçası olarak ya da en yeni Visual Studio 2017 için Derleme Araçları'nı yükleyerek Visual C++ derleyicisini yükleyin.
JDK. Sürüm 11 gerekir.
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 Bootstrap Bazel
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) yolunu ayarlayın. Bunlardan birini ayarlamak yeterli olur.BAZEL_SH
: MSYS2bash.exe
yolu. Aşağıdaki örneklerde verilen komuta bakın.Bunu
C:\Windows\System32\bash.exe
olarak ayarlamayın. (Linux için Windows Alt Sistemi'ni yüklediyseniz bu dosyayı da alırsınız.) 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 kullanarak):
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 çıktı, output/bazel.exe
konumuna yerleştirilir. Bu, yerleşik JDK'ya sahip olmayan bağımsız bir Bazel ikili programı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 (cmd.exe
) veya Powershell'den
çalıştırabilirsiniz.