Aşağıdaki işlevler şuradan yüklenebilir:
@bazel_tools//tools/build_defs/repo:http.bzl
HTTP üzerinden dosya ve arşiv indirme kuralları.
Kurulum
Bu kuralları bir modül uzantısında kullanmak için, .bzl dosyanıza yükleyin ve daha sonra,
daha fazla bilgi edinin. Örneğin, http_archive
kullanmak için:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
def _my_extension_impl(mctx):
http_archive(name = "foo", urls = [...])
my_extension = module_extension(implementation = _my_extension_impl)
Alternatif olarak, bu depo kurallarını MODULE.bazel dosyanızda
use_repo_rule
:
http_archive = use_repo_rule("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(name = "foo", urls = [...])
http_archive
http_archive(name, add_prefix, auth_patterns, build_file, build_file_content, canonical_id, integrity, netrc, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches, remote_file_integrity, remote_file_urls, remote_patch_strip, remote_patches, repo_mapping, sha256, strip_prefix, type, url, urls, workspace_file, workspace_file_content)
Bazel deposunu sıkıştırılmış arşiv dosyası olarak indirir, arşiv dosyasını açar, ve hedeflerini bağlama için kullanılabilir hale getirir.
Şu dosya uzantılarını destekler: "zip"
, "jar"
, "war"
, "aar"
, "tar"
,
"tar.gz"
, "tgz"
, "tar.xz"
, "txz"
, "tar.zst"
, "tzst"
, tar.bz2
, "ar"
,
veya "deb"
.
Örnekler:
Mevcut depoda bir sohbet programının kaynak kodunu içerdiğini varsayalım.
~/chat-app
dizininde kök olarak oluşturuldu. Bir SSL kitaplığına bağlı olması gerekir
Bu URL'yi http://example.com/openssl.zip adresinde bulabilirsiniz. Bu .zip
dosyası
şu dizin yapısını içerir:
WORKSPACE
src/
openssl.cc
openssl.h
Kullanıcı, yerel depoda openssl.BUILD
dosyası oluşturur.
şu hedef tanımını içerir:
cc_library(
name = "openssl-lib",
srcs = ["src/openssl.cc"],
hdrs = ["src/openssl.h"],
)
~/chat-app
deposundaki hedefler
şu satırlar ~/chat-app/WORKSPACE
öğesine eklenir:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "my_ssl",
url = "http://example.com/openssl.zip",
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
build_file = "@//:openssl.BUILD",
)
Ardından hedefler bağımlılık olarak @my_ssl//:openssl-lib
değerini belirtir.
Özellikler
name |
Ad; zorunlu
Bu depo için benzersiz bir ad. |
add_prefix |
String; isteğe bağlı
Depo dizinine göre hedef dizin. "strip_prefix" uygulandıktan sonra arşiv bu dizinde açılır (varsa) arşive eklenir. Örneğin, "file" "add_prefix = "bar" ise "foo-1.2.3/src/foo.h"nin paketi "bar/src/foo.h" ile kaldırılır ve `strip_prefix = "foo-1.2.3"`). |
auth_patterns |
Sözlük: Dize -> String; isteğe bağlı
Ana makine adlarını özel yetkilendirme kalıplarıyla eşleştiren isteğe bağlı bir dikte.
Bir URL'nin ana makine adı bu diktede mevcutsa değer,
oluşturarak, http isteği için yetkilendirme başlığını oluşturabilirsiniz. Bu sayede, özel
kimlik doğrulama şemalarını kullanıma sunduk.
Kalıp şu anda 2 jetonu desteklemektedir: auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" }. netrc: machine storage.cloudprovider.com password RANDOM-TOKENNihai HTTP isteği aşağıdaki başlığa sahip olur: Authorization: Bearer RANDOM-TOKEN |
build_file |
Etiket; isteğe bağlı
Bu kod deposu için BUILD dosyası olarak kullanılacak dosya.Bu özellik mutlak bir etikettir (ana depo için "@//" kullanın). Dosyanın BUILD olarak adlandırılmasına gerek yoktur, ancak şöyle olabilir: (BUILD.new-repo-name gibi bir ad, onu deponun gerçek BUILD dosyalarından ayırt etmek için işe yarayabilir. Build_file veya build_file_content ikisi belirtilebilir ancak ikisi birden belirtilemez. |
build_file_content |
String; isteğe bağlı
Bu depo için BUILD dosyasının içeriği. Build_file veya build_file_content ikisi belirtilebilir ancak ikisi birden belirtilemez. |
canonical_id |
String; isteğe bağlı
İndirilen dosyanın standart kimliği. Belirtilir ve boş değilse Bazel, ile aynı standart kimliğe sahip bir istek tarafından önbelleğe eklenmiş olması gerekir. Belirtilmemişse veya boşsa Bazel, varsayılan olarak dosyanın URL'lerini standart kimlik. Bu şekilde, sık karşılaşılan bir hata olan URL'leri karmayı günceller. Böylece, yerel olarak başarılı olan ancak başarısız olan derlemeler makinelerde dosya önbellekte bulunmaz. Bu davranış, --repo_env=BAZEL_HTTP_RULES_URLS_AS_DEFAULT_CANONICAL_ID=0. |
integrity |
String; isteğe bağlı
İndirilen dosyanın Alt Kaynak Bütünlüğü biçiminde beklenen sağlama toplamı. Bu değer, indirilen dosyanın sağlama toplamıyla eşleşmelidir. _Bu bir güvenlik riski uzak dosyalar değişebileceğinden sağlama toplamı dahil etmemek._ En iyisi bunu alanı, derlemenizi hermetik olmayan hale getirir. Hedeflerinize göre geliştirme yapmak daha kolaydır, ancak gönderimden önce bu özellik veya "sha256" ayarlanmalıdır. |
netrc |
String; isteğe bağlı
Kimlik doğrulama için kullanılacak .netrc dosyasının konumu |
patch_args |
Dize listesi; isteğe bağlı
Yama aracına verilen bağımsız değişkenler. Varsayılan olarak -p0 değerine ayarlanır ancak git tarafından oluşturulan yamalar için genellikle -p1 değeri gerekir. Birden fazla -p bağımsız değişkeni belirtilirse son bağımsız değişken geçerli olur. -p dışındaki bağımsız değişkenler belirtilirse Bazel, Bazel'da yerel yama uygulaması yerine yama komut satırı aracını kullanmak için yedeklenir. Yama komut satırı aracına geri dönülürken ve patch_tool özelliği belirtilmediyse "patch" kullanılır. Bu durum yalnızca "yamalar" özelliğindeki yama dosyalarını etkiler. |
patch_cmds |
Dize listesi; isteğe bağlı
Yamalar uygulandıktan sonra Linux/Macos'ta uygulanacak Bash komutları dizisi. |
patch_cmds_win |
Dize listesi; isteğe bağlı
Yamalar uygulandıktan sonra Windows'da uygulanacak Powershell komutları dizisi. Bu özellik ayarlanmazsa patch_cmds Windows'da yürütülür ve bu da Bash ikili programının mevcut olmasını gerektirir. |
patch_tool |
String; isteğe bağlı
Kullanılacak yama(1) yardımcı programı. Bu belirtilirse Bazel, Bazel'de yerel yama uygulaması yerine belirtilen yama aracını kullanır. |
patches |
Etiket listesi; isteğe bağlı
Arşiv çıkarıldıktan sonra yama olarak uygulanacak dosyaların listesi. Varsayılan olarak, fuzz eşleme ve ikili yamayı desteklemeyen Bazel'da yerel yama uygulamasını kullanır. Ancak "yama_aracı" özelliği belirtilirse veya "patch_args" özelliğinde "-p" dışında bağımsız değişkenler varsa Bazel, yama komut satırı aracını kullanmaya devam eder. |
remote_file_integrity |
Sözlük: Dize -> String; isteğe bağlı
Dosya göreli yollarının (anahtar) bütünlük değeriyle (değer) eşlemesi. Bu göreli yollar, "remote_file_urls" özelliğindeki dosyalarla (anahtar) eşlenmelidir. |
remote_file_urls |
Sözlük: Dize -> Dize listesi; isteğe bağlı
İndirilecek ve depoda yer paylaşımlı dosyalar olarak kullanıma sunulacak URL'ler (değer) listesinin göreli yollarının (anahtar) eşlemesi. Bu, mevcut bir deponun üzerine WORKSPACE veya BUILD.bazel dosyaları eklemek istediğinizde kullanışlıdır. Dosyalar, yamaları "yamalar" özelliğine uygulamadan önce indirilir ve URL listesinin tümü aynı dosyanın olası yansıtmaları olmalıdır. URL'ler, biri başarılı olana kadar sırayla denenir. |
remote_patch_strip |
Tam sayı; isteğe bağlı
Uzak yamalarda dosya adından çıkarılacak baştaki eğik çizgi sayısı. |
remote_patches |
Sözlük: Dize -> String; isteğe bağlı
Yama dosyası URL'sinin bütünlük değeriyle eşlemesi; arşiv çıkarıldıktan sonra ve "yamalar" özelliğinden yama dosyaları uygulanmadan önce uygulanır. Bazel'da yerel yama uygulamasını kullanır. Yama şeridi numarasını "remote_patch_strip" ile belirtebilirsiniz. |
repo_mapping |
Sözlük: Dize -> String; zorunlu
Yerel depo adından genel depo adına bir sözlük. Bu sayede, bu deponun bağımlılıkları için çalışma alanı bağımlılık çözümü üzerinde kontrol sahibi olursunuz. Örneğin, ""@foo": "@bar"" girişi, bu deponun "@foo" öğesine bağlı olduğu her durumda (örneğin, @foo//some:target'a bağlı olan bir bağımlılığın aslında genel olarak tanımlanan "@bar" ("@bar//some:target") içindeki bağımlılığı çözmesi gerektiğini belirtir. |
sha256 |
String; isteğe bağlı
İndirilen dosyanın beklenen SHA-256'sı. Bu, indirilen dosyanın SHA-256'sıyla eşleşmelidir. _Bu bir güvenlik riski uzak dosyalar değişebildiğinden SHA-256'yı hariç tutun._ En iyisi, bunu alanı, derlemenizi hermetik olmayan hale getirir. Hedeflerinize göre geliştirme yapmak daha kolaydır, ancak gönderim işleminden önce bu özellik veya "integrity" ayarlanmalıdır. |
strip_prefix |
String; isteğe bağlı
Ayıklanan dosyalardan alınacak dizin ön eki. Birçok arşivde, yararlı bilgilerin tümünü içeren üst düzey bir dizin dosya arşivde. Bu ön eki defalarca belirtmek zorunda kalmak yerine "build_file"da bulunan bu alan, onu tüm öğelerden ayırmak için kullanılabilir. dosyalar. Örneğin, altında "WORKSPACE" dosyası bulunur ve girdiğiniz gerçek kodu içeren "src/", "lib/" ve "test/" dizinleri düşünmelisiniz. "foo-lib-1.2.3" dizinini oluşturun. Bu dizin dışında dosya bulunması durumunda, bunlar silindi ve erişilemez durumda (ör. üst düzey bir lisans dosyası). Buna şunlar dâhildir: önekle başlayan ancak dizinde bulunmayan dosyalar/dizinler (ör. `foo-lib-1.2.3.release-notes`). Belirtilen önek arşivdeki bir dizinle eşleşirse Bazel bir hata döndürecektir. |
type |
String; isteğe bağlı
İndirilen dosyanın arşiv türü. Varsayılan olarak, arşiv türü URL'yi tıklayın. Dosyanın uzantısı yoksa takip etmek için: `"zip"`, `"jar"`, `"war"`, `"aar"`, `"tar"`, `"tar.gz"`, `"tgz"`, `"tar.xz"`, `"txz"`, `"tar.zst"`, `"tzst"`, `"tar.bz2"`, `"ar"` veya `"deb"`. |
url |
String; isteğe bağlı
Bazel'in kullanımına sunulacak dosyanın URL'si. Bu bir dosya, http veya https URL'si olmalıdır. Yönlendirmeler takip edilir. Kimlik doğrulama desteklenmiyor. İzin verilen url'leri kullanarak daha fazla esneklik elde edebilirsiniz. ifadesini girin. |
urls |
Dize listesi; isteğe bağlı
Bazel'ın kullanımına sunulacak dosyanın URL'lerinin listesi. Her giriş bir dosya, http veya https URL'si olmalıdır. Yönlendirmeler takip edilir. Kimlik doğrulama desteklenmiyor. URL'ler, başarılı olana kadar sırayla denenir. Bu nedenle önce yerel yansıtmaları listelemeniz gerekir. Tüm indirme işlemleri başarısız olursa kural başarısız olur. |
workspace_file |
Etiket; isteğe bağlı
Bu depo için "WORKSPACE" dosyası olarak kullanılacak dosya. "workspace_file" veya "workspace_file_content"den biri belirtilebilir ya da ikisi birden belirtilemez. |
workspace_file_content |
String; isteğe bağlı
Bu depo için WORKSPACE dosyasının içeriği. "workspace_file" veya "workspace_file_content"den biri belirtilebilir ya da ikisi birden belirtilemez. |
http_file
http_file(name, auth_patterns, canonical_id, downloaded_file_path, executable, integrity, netrc, repo_mapping, sha256, url, urls)
Bir URL'den dosya indirir ve dosyayı dosya olarak kullanılabilmesini sağlar grubu.
Örnekler: Özel kurallarınız için bir Debian paketine sahip olmanız gerektiğini varsayalım. Bu paket http://example.com/package.deb adresinde bulabilirsiniz. Ardından WORKSPACE dosyası:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_file")
http_file(
name = "my_deb",
url = "http://example.com/package.deb",
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
)
Hedefler, bu dosyaya bağımlı bir bağımlılık olarak @my_deb//file
belirtir.
Özellikler
name |
Ad; zorunlu
Bu depo için benzersiz bir ad. |
auth_patterns |
Sözlük: Dize -> String; isteğe bağlı
Ana makine adlarını özel yetkilendirme kalıplarıyla eşleştiren isteğe bağlı bir dikte.
Bir URL'nin ana makine adı bu diktede mevcutsa değer,
oluşturarak, http isteği için yetkilendirme başlığını oluşturabilirsiniz. Bu sayede, özel
kimlik doğrulama şemalarını kullanıma sunduk.
Kalıp şu anda 2 jetonu desteklemektedir: auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" }. netrc: machine storage.cloudprovider.com password RANDOM-TOKENNihai HTTP isteği aşağıdaki başlığa sahip olur: Authorization: Bearer RANDOM-TOKEN |
canonical_id |
String; isteğe bağlı
İndirilen dosyanın standart kimliği. Belirtilir ve boş değilse Bazel, ile aynı standart kimliğe sahip bir istek tarafından önbelleğe eklenmiş olması gerekir. Belirtilmemişse veya boşsa Bazel, varsayılan olarak dosyanın URL'lerini standart kimlik. Bu şekilde, sık karşılaşılan bir hata olan URL'leri karmayı günceller. Böylece, yerel olarak başarılı olan ancak başarısız olan derlemeler makinelerde dosya önbellekte bulunmaz. Bu davranış, --repo_env=BAZEL_HTTP_RULES_URLS_AS_DEFAULT_CANONICAL_ID=0. |
downloaded_file_path |
String; isteğe bağlı
İndirilen dosyaya atanan yol |
executable |
Boole; isteğe bağlı
İndirilen dosyanın yürütülebilir hale gelip gelmediği. |
integrity |
String; isteğe bağlı
İndirilen dosyanın Alt Kaynak Bütünlüğü biçiminde beklenen sağlama toplamı. Bu değer, indirilen dosyanın sağlama toplamıyla eşleşmelidir. _Bu bir güvenlik riski uzak dosyalar değişebileceğinden sağlama toplamı dahil etmemek._ En iyisi bunu alanı, derlemenizi hermetik olmayan hale getirir. Hedeflerinize göre geliştirme yapmak daha kolaydır, ancak gönderimden önce bu özellik veya "sha256" ayarlanmalıdır. |
netrc |
String; isteğe bağlı
Kimlik doğrulama için kullanılacak .netrc dosyasının konumu |
repo_mapping |
Sözlük: Dize -> String; zorunlu
Yerel depo adından genel depo adına bir sözlük. Bu sayede, bu deponun bağımlılıkları için çalışma alanı bağımlılık çözümü üzerinde kontrol sahibi olursunuz. Örneğin, ""@foo": "@bar"" girişi, bu deponun "@foo" öğesine bağlı olduğu her durumda (örneğin, @foo//some:target'a bağlı olan bir bağımlılığın aslında genel olarak tanımlanan "@bar" ("@bar//some:target") içindeki bağımlılığı çözmesi gerektiğini belirtir. |
sha256 |
String; isteğe bağlı
İndirilen dosyanın beklenen SHA-256'sı. Bu, indirilen dosyanın SHA-256'sıyla eşleşmelidir. _Bu bir güvenlik riski uzak dosyalar değişebildiğinden SHA-256'yı hariç tutun._ En iyisi, bunu alanı, derlemenizi hermetik olmayan hale getirir. Hedeflerinize göre geliştirme yapmak daha kolaydır, ancak gönderimden önce ayarlanmalıdır. |
url |
String; isteğe bağlı
Bazel'in kullanımına sunulacak dosyanın URL'si. Bu bir dosya, http veya https URL'si olmalıdır. Yönlendirmeler takip edilir. Kimlik doğrulama desteklenmiyor. İzin verilen url'leri kullanarak daha fazla esneklik elde edebilirsiniz. ifadesini girin. |
urls |
Dize listesi; isteğe bağlı
Bazel'ın kullanımına sunulacak dosyanın URL'lerinin listesi. Her giriş bir dosya, http veya https URL'si olmalıdır. Yönlendirmeler takip edilir. Kimlik doğrulama desteklenmiyor. URL'ler, başarılı olana kadar sırayla denenir. Bu nedenle önce yerel yansıtmaları listelemeniz gerekir. Tüm indirme işlemleri başarısız olursa kural başarısız olur. |
http_jar
http_jar(name, auth_patterns, canonical_id, downloaded_file_name, integrity, netrc, repo_mapping, sha256, url, urls)
URL'den bir jar dosyası indirir ve java_import olarak kullanılabilir hale getirir
İndirilen dosyaların uzantısı .jar olmalıdır.
Örnekler:
Mevcut deponun
~/chat-app
dizini. Kullanılabilen bir SSL kitaplığına bağlı olması gerekir.
http://example.com/openssl-0.2.jar
Aşağıdaki satırlar açıksa ~/chat-app
deposundaki hedefler bu hedefe bağlı olabilir.
~/chat-app/WORKSPACE
oynatma listesine eklendi:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_jar")
http_jar(
name = "my_ssl",
url = "http://example.com/openssl-0.2.jar",
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
)
Hedefler, bu jar dosyasına bağımlı bir bağımlılık olarak @my_ssl//jar
belirtir.
"file:///path/to/file"ı kullanarak geçerli sistemdeki (localhost) dosyalara referans verebilirsiniz
yapmanız gerekmez. Windows kullanıyorsanız "file:///c:/path/to/file"ı kullanın. İkisinde de
örneklerde, üç eğik çizgiye (/
) dikkat edin. İlk iki eğik çizgi file://
, üçüncü eğik çizgi ise
biri dosyanın mutlak yoluna aittir.
Özellikler
name |
Ad; zorunlu
Bu depo için benzersiz bir ad. |
auth_patterns |
Sözlük: Dize -> String; isteğe bağlı
Ana makine adlarını özel yetkilendirme kalıplarıyla eşleştiren isteğe bağlı bir dikte.
Bir URL'nin ana makine adı bu diktede mevcutsa değer,
oluşturarak, http isteği için yetkilendirme başlığını oluşturabilirsiniz. Bu sayede, özel
kimlik doğrulama şemalarını kullanıma sunduk.
Kalıp şu anda 2 jetonu desteklemektedir: auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" }. netrc: machine storage.cloudprovider.com password RANDOM-TOKENNihai HTTP isteği aşağıdaki başlığa sahip olur: Authorization: Bearer RANDOM-TOKEN |
canonical_id |
String; isteğe bağlı
İndirilen dosyanın standart kimliği. Belirtilir ve boş değilse Bazel, ile aynı standart kimliğe sahip bir istek tarafından önbelleğe eklenmiş olması gerekir. Belirtilmemişse veya boşsa Bazel, varsayılan olarak dosyanın URL'lerini standart kimlik. Bu şekilde, sık karşılaşılan bir hata olan URL'leri karmayı günceller. Böylece, yerel olarak başarılı olan ancak başarısız olan derlemeler makinelerde dosya önbellekte bulunmaz. Bu davranış, --repo_env=BAZEL_HTTP_RULES_URLS_AS_DEFAULT_CANONICAL_ID=0. |
downloaded_file_name |
String; isteğe bağlı
Jartona atanan dosya adı indirildi |
integrity |
String; isteğe bağlı
İndirilen dosyanın Alt Kaynak Bütünlüğü biçiminde beklenen sağlama toplamı. Bu değer, indirilen dosyanın sağlama toplamıyla eşleşmelidir. _Bu bir güvenlik riski uzak dosyalar değişebileceğinden sağlama toplamı dahil etmemek._ En iyisi bunu alanı, derlemenizi hermetik olmayan hale getirir. Hedeflerinize göre geliştirme yapmak daha kolaydır, ancak gönderimden önce bu özellik veya "sha256" ayarlanmalıdır. |
netrc |
String; isteğe bağlı
Kimlik doğrulama için kullanılacak .netrc dosyasının konumu |
repo_mapping |
Sözlük: Dize -> String; zorunlu
Yerel depo adından genel depo adına bir sözlük. Bu sayede, bu deponun bağımlılıkları için çalışma alanı bağımlılık çözümü üzerinde kontrol sahibi olursunuz. Örneğin, ""@foo": "@bar"" girişi, bu deponun "@foo" öğesine bağlı olduğu her durumda (örneğin, @foo//some:target'a bağlı olan bir bağımlılığın aslında genel olarak tanımlanan "@bar" ("@bar//some:target") içindeki bağımlılığı çözmesi gerektiğini belirtir. |
sha256 |
String; isteğe bağlı
İndirilen dosyanın beklenen SHA-256'sı. Bu, indirilen dosyanın SHA-256'sıyla eşleşmelidir. _Bu bir güvenlik riski uzak dosyalar değişebildiğinden SHA-256'yı hariç tutun._ En iyisi, bunu alanı, derlemenizi hermetik olmayan hale getirir. Hedeflerinize göre geliştirme yapmak daha kolaydır, ancak gönderim işleminden önce bu özellik veya "integrity" ayarlanmalıdır. |
url |
String; isteğe bağlı
Bazel'in kullanımına sunulacak dosyanın URL'si. Bu bir dosya, http veya https URL'si olmalıdır. Yönlendirmeler takip edilir. Kimlik doğrulama desteklenmiyor. İzin verilen url'leri kullanarak daha fazla esneklik elde edebilirsiniz. ifadesini girin. URL ".jar" ile bitmelidir. |
urls |
Dize listesi; isteğe bağlı
Bazel'ın kullanımına sunulacak dosyanın URL'lerinin listesi. Her giriş bir dosya, http veya https URL'si olmalıdır. Yönlendirmeler takip edilir. Kimlik doğrulama desteklenmiyor. URL'ler, başarılı olana kadar sırayla denenir. Bu nedenle önce yerel yansıtmaları listelemeniz gerekir. Tüm indirme işlemleri başarısız olursa kural başarısız olur. Tüm URL'ler ".jar" ile bitmelidir. |