目前唯一支援的外掛程式類型是註解處理工具。
成員
JavaPluginInfo
JavaPluginInfo JavaPluginInfo(runtime_deps, *, processor_class, data=[], generates_api=False)
JavaPluginInfo
建構函式。
參數
參數 | 說明 |
---|---|
runtime_deps
|
sequence of JavaInfos ;必要包含註解處理工具的程式庫。 |
processor_class
|
string; or None ;必要Java 編譯器使用做為註解處理工具進入點的完整類別名稱。 |
data
|
sequence of Files; or depset of Files ;
default = []此註解處理工具在執行期間需要的檔案。 |
generates_api
|
default = False 在這個註解處理工具產生 API 程式碼時,請設為 true。 這類註解處理工具會先套用至 Java 目標,再產生標頭 jar (包含方法簽章)。如果沒有 API 外掛程式,系統就會從來源產生標頭 jar,進而減少關鍵路徑。 警告:這個參數會影響建構效能,請只在必要時使用。 |
api_generating_plugins
JavaPluginData JavaPluginInfo.api_generating_plugins傳回由這個目標定義或匯出的 API 產生外掛程式相關資料。
這些註解處理工具會在產生標頭 jar (含有方法簽章) 前套用至 Java 目標。如果沒有 API 外掛程式,系統就會從來源產生標頭 jar,藉此減少關鍵路徑。
api_generating_plugins
是 plugins
的子集。
java_outputs
list JavaPluginInfo.java_outputs傳回此 Java/Java 類似目標的輸出資訊。
外掛程式
JavaPluginData JavaPluginInfo.plugins傳回應套用目標所有外掛程式的相關資料。
這通常是 java_plugin
本身,或是匯出一或多個外掛程式的 java_library
。
java_library
會使用這個欄位的所有外掛程式執行註解處理,這些外掛程式會顯示在 deps
和 plugins
屬性中。
to_json
string JavaPluginInfo.to_json()已淘汰。這個 API 已淘汰,並將在近期內移除。請勿完全仰賴它。
---incompatible_struct_has_no_methods
已停用這項功能。使用此旗標確認您的程式碼是否與即將移除的程式碼相容。透過結構參數建立 JSON 字串。只有在所有結構元素 (遞迴) 是字串、整數、布林值、其他結構體、這些型別清單,或是含有這些類型字串鍵和值的字典時,才能使用此方法。字串中的引號和新行會逸出。範例:
struct(key=123).to_json() # {"key":123} struct(key=True).to_json() # {"key":true} struct(key=[1, 2, 3]).to_json() # {"key":[1,2,3]} struct(key='text').to_json() # {"key":"text"} struct(key=struct(inner_key='text')).to_json() # {"key":{"inner_key":"text"}} struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json() # {"key":[{"inner_key":1},{"inner_key":2}]} struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json() # {"key":{"inner_key":{"inner_inner_key":"text"}}}。
已淘汰:請改用 json.encode(x) 或 json.encode_indent(x)。這適用於結構體以外的值,不會影響結構欄位命名空間。
to_proto
string JavaPluginInfo.to_proto()已淘汰。這個 API 已淘汰,並將在近期內移除。請勿完全仰賴它。
---incompatible_struct_has_no_methods
已停用這項功能。使用此旗標確認您的程式碼是否與即將移除的程式碼相容。透過 struct 參數建立簡訊。只有在所有結構元素 (遞迴) 是字串、整數、布林值、其他結構體、字典或這些類型的清單時,才能使用此方法。字串中的引號和新行會逸出。結構鍵會依排序順序疊代。範例:
struct(key=123).to_proto() # key: 123 struct(key=True).to_proto() # key: true struct(key=[1, 2, 3]).to_proto() # key: 1 # key: 2 # key: 3 struct(key='text').to_proto() # key: "text" struct(key=struct(inner_key='text')).to_proto() # key { # inner_key: "text" # } struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto() # key { # inner_key: 1 # } # key { # inner_key: 2 # } struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto() # key { # inner_key { # inner_inner_key: "text" # } # } struct(foo={4: 3, 2: 1}).to_proto() # foo: { # key: 4 # value: 3 # } # foo: { # key: 2 # value: 1 # }
已淘汰:請改用 proto.encode_text(x)。