Ekstra İşlem Kuralları

. Sorun bildir Kaynağı göster Gece · 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Kurallar

action_listener
extra_action

action_listener

action_listener(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, extra_actions, features, licenses, mnemonics, restricted_to, tags, target_compatible_with, testonly, visibility)

UYARI: Ekstra işlemler kullanımdan kaldırılmıştır. Tekliflerinizi otomatikleştirmek ve optimize etmek için en önemli özellikler .

action_listener kuralı kendiliğinden çıkış sağlamaz. Bunun yerine, araç geliştiricilerin Derleme sistemine extra_action, Eylemden extra_action tarihine eşleme sağlayarak .

Bu kuralın bağımsız değişkenleri, işlem anımsatıcılarını extra_action kuralları.

Şu seçeneği belirterek --experimental_action_listener=<label>, derleme dosya eklemek için belirtilen action_listener öğesini kullanır Derleme grafiğine extra_action atlar.

Örnek

action_listener(
    name = "index_all_languages",
    mnemonics = [
        "Javac",
        "CppCompile",
        "Python",
    ],
    extra_actions = [":indexer"],
)

action_listener(
    name = "index_java",
    mnemonics = ["Javac"],
    extra_actions = [":indexer"],
)

extra_action(
    name = "indexer",
    tools = ["//my/tools:indexer"],
    cmd = "$(location //my/tools:indexer)" +
          "--extra_action_file=$(EXTRA_ACTION_FILE)",
)

Bağımsız değişkenler

Özellikler

Özellikler
`name`	Ad; zorunlu Bu hedef için benzersiz bir ad.
`extra_actions`	Etiket listesi; zorunlu `extra_action` hedefin listesi bu `action_listener` derleme grafiğine eklenmelidir. Ör. `[ "//my/tools:analyzer" ]`
`mnemonics`	Dize listesi; zorunlu Bu `action_listener` adlı kullanıcının dinlemesi gereken işlem hatırlatıcılarının listesi örneğin, `[ "Javac" ]`. Anımsatıcılar herkese açık bir arayüz değildir. Anımsatıcıların ve eylemlerinin değişmeyeceğinin garantisi yoktur.

name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

extra_actions

Etiket listesi; zorunlu

extra_action hedefin listesi bu action_listener derleme grafiğine eklenmelidir. Ör. [ "//my/tools:analyzer" ]

mnemonics

Dize listesi; zorunlu

Bu action_listener adlı kullanıcının dinlemesi gereken işlem hatırlatıcılarının listesi örneğin, [ "Javac" ].

Anımsatıcılar herkese açık bir arayüz değildir. Anımsatıcıların ve eylemlerinin değişmeyeceğinin garantisi yoktur.

extra_action

Kural kaynağını görüntüle

extra_action(name, data, cmd, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, out_templates, requires_action_output, restricted_to, tags, target_compatible_with, testonly, toolchains, tools, visibility)

UYARI: Ekstra işlemler kullanımdan kaldırılmıştır. Tekliflerinizi otomatikleştirmek ve optimize etmek için en önemli özellikler .

extra_action kuralı anlamlı bir çıktı oluşturmuyor normal derleme hedefi olarak belirtilir. Bunun yerine, araç geliştiricilerin seçeneğini kullanabilirsiniz.

Ayrıntılar için action_listener sayfasını ziyaret edin. extra_action etkinleştirme hakkında daha fazla bilgi edinin.

extra_action'ler komut satırı olarak çalışır. Komut satırı aracı, $(Extra_ACTION_FILE) biçiminde protokol arabelleği içeren bir dosyaya erişim orijinal işlemle ilgili ayrıntılı bilgi içeren bir satır öğesi ekleyin. Ayrıca, orijinal işlemin erişebildiği tüm giriş dosyalarına da erişebilir. extra_actions_base.proto sayfasına bakın. Protokol arabelleğinde depolanan verilere ilişkin ayrıntılara bakın. Her bir proto dosyası ExtraActionInfo mesajı içerir.

Diğer tüm işlemlerde olduğu gibi ekstra işlemler de korumalı alana alınır ve buna uygun şekilde tasarlanmalıdır.

Bağımsız değişkenler

Özellikler
`name`	Ad; zorunlu Bu hedef için benzersiz bir ad. Bu kurala, `extra_actions` bağımsız değişkeninde `label` tarafından başvurabilirsiniz Toplam `action_listener` kural.
`cmd`	String; zorunlu Çalıştırılacak komut. Örneğin, aşağıdakilere sahip genrule cmd özelliği farklar: Buluşsal etiket genişletmesi yok. Yalnızca $(location ...) değerini kullanan etiketler genişletilir. Dizeye, `out_templates` öğesinden oluşturulan çıkışların tekrarı özelliğini gönderin. `$(output out_template)` tarihinin tümü dosyanın yolu, `label` ile belirtilir. Ör. out_template `$(ACTION_ID).analysis` `$(output $(ACTION_ID).analysis)` ile eşleştirilebilir. Bu, `$(location)` ile aynı ikame olacaktır farklı bir kapsamda.
`out_templates`	Dize listesi; varsayılan değer `[]` `extra_action` komutuyla oluşturulan dosyalar için şablon listesi. Şablonda aşağıdaki değişkenler kullanılabilir: $(ACTION_ID), bu `extra_action` öğesini benzersiz şekilde tanımlayan bir kimlik. Benzersiz bir çıkış dosyası oluşturmak için kullanılır.
`requires_action_output`	Boole; varsayılan değer `False` Bu `extra_action` öğesinin, orijinal işlem bu `extra_action` girdisi olarak mevcut olacaktır. True (varsayılan false) değerindeyse extra_action, orijinal işlem çıkışları, girişlerinin bir parçası olarak kullanılabilir.
`tools`	Etiket listesi; varsayılan değer `[]` Bu kural için `tool` bağımlılıkların listesi. Daha fazla bilgi için bağımlılıkların tanımını inceleyin ekleyebilirsiniz. Derleme sistemi, `extra_action` komutu; kullanılarak oluşturulurlar. `exec`yapılandırma çünkü derleme sırasında bir araç olarak çalışmak zorundadır. Bir kişinin yolculuğu `tools` hedefi `//x:y` kullanılarak elde edilebilir: `$(location //x:y)`. Tüm araçlar ve bunların veri bağımlılıkları tek bir ağaçta birleştirilir komutun göreli yolları kullanabileceği yerdir. Çalışma dizini kökü oluşturacaktır.