Goal-C 規則

回報問題查看原始碼 Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

規則

objc_import
objc_library

objc_import

objc_import(name, deps, hdrs, alwayslink, archives, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, includes, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

這項規則會以 .a 檔案格式封裝已編譯的靜態資料庫。您也可以使用 objc_library 支援的相同屬性，匯出標頭和資源。

引數

屬性
`name`	名稱；必填這個目標的專屬名稱。
`deps`	標籤清單；預設為 `[]` 這個目標依賴的目標清單。
`hdrs`	標籤清單；預設為 `[]` 這個程式庫發布的 C、C++、Objective-C 和 Objective-C++ 標頭檔案清單，供依附規則中的來源納入。這些標頭會說明程式庫的公開介面，並可供此規則或相關規則中的來源加入。不應由此程式庫的用戶端納入的標頭，應改列在 srcs 屬性中。如果已啟用模組，這些模組會從來源中個別編譯。
`alwayslink`	布林值；預設值為 `False` 如果為 1，則任何依附 (直接或間接) 於此程式庫的套件或二進位檔，都會連結 `srcs` 和 `non_arc_srcs` 中列出的檔案的所有物件檔案，即使其中有些檔案不含由二進位檔參照的符號也一樣。如果二進位檔中的程式碼並未明確呼叫您的程式碼 (例如，如果您的程式碼註冊接收某些服務提供的回呼)，這項功能就很實用。
`archives`	標籤清單 (必要) 提供給依賴此目標的 Objective-C 目標的 `.a` 檔案清單。
`includes`	字串清單；預設為 `[]` 要新增至這個目標和所有依附目標的 `#include/#import` 搜尋路徑清單。這項功能可支援第三方和開放原始碼程式庫，這些程式庫未在 `#import/#include` 陳述式中指定整個工作區路徑。路徑會相對於套件目錄解讀，除了實際的用戶端根目錄外，還會納入 genfiles 和 bin 根目錄 (例如 `blaze-genfiles/pkg/includedir` 和 `blaze-out/pkg/includedir`)。與 COPTS 不同的是，這些標記會新增至此規則和所有依附此規則的規則。(注意：不是依附的規則！)請務必謹慎操作，因為這可能會造成廣泛的影響。如有疑問，請改為在 COPTS 中加入「-iquote」標記。
`sdk_dylibs`	字串清單；預設為 `[]` 要連結的 SDK .dylib 程式庫名稱。例如「libz」或「libarchive」。如果二進位檔的依附元件樹狀結構中含有任何 C++ 或 Objective-C++ 來源，系統會自動加入「libc++」。連結二進位檔時，系統會使用該二進位檔的傳遞依附元件圖表中所列的所有程式庫。
`sdk_frameworks`	字串清單；預設為 `[]` 要連結的 SDK 架構名稱 (例如「AddressBook」、「QuartzCore」)。連結頂層 Apple 二進位檔時，系統會連結該二進位檔的傳遞依附元件圖表中列出的所有 SDK 架構。
`sdk_includes`	字串清單；預設為 `[]` 要新增至這個目標和所有依附目標的 `#include/#import` 搜尋路徑清單，其中每個路徑都相對於 `$(SDKROOT)/usr/include`。
`textual_hdrs`	標籤清單；預設為 `[]` 這個規則中來源檔案或這個程式庫的使用者，會將 C、C++、Objective-C 和 Objective-C++ 檔案納入標頭的清單。與 HDR 不同，這些檔案不會從來源中單獨編譯。
`weak_sdk_frameworks`	字串清單；預設為 `[]` 要以弱連結方式連結的 SDK 架構名稱。例如「MediaAccessibility」。與一般連結的 SDK 架構不同，如果在執行階段中未出現弱連結架構的符號，就不會發生錯誤。

objc_library

查看規則來源

objc_library(name, deps, srcs, data, hdrs, alwayslink, compatible_with, copts, defines, deprecation, distribs, enable_modules, exec_compatible_with, exec_properties, features, implementation_deps, includes, linkopts, module_map, module_name, non_arc_srcs, pch, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, stamp, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

這項規則會從指定的 Objective-C 來源檔案產生靜態程式庫。

引數

屬性
`name`	名稱；必填這個目標的專屬名稱。
`deps`	標籤清單；預設為 `[]` 這個目標依賴的目標清單。
`srcs`	標籤清單；預設為 `[]` 系統會處理 C、C++、Objective-C 和 Objective-C++ 來源檔案和標頭檔案，以及/或 (`.s`、`.S` 或 `.asm`) 組合來源檔案，以建立資料庫目標。這些是您提交的檔案，以及任何產生的檔案。來源檔案會使用 Clang 編譯成 .o 檔案。標頭檔案可由此目標的 srcs 屬性中的任何來源或標頭納入/匯入，但不能由 hdrs 或任何依賴此規則的目標中的標頭納入/匯入。此外，您也可以將預先編譯的 .o 檔案當做 srcs。請小心確保提供的 .o 檔案與建構作業的架構一致，以免發生缺少符號連結器錯誤。
`hdrs`	標籤清單；預設為 `[]` 這個程式庫發布的 C、C++、Objective-C 和 Objective-C++ 標頭檔案清單，供依附規則中的來源納入。這些標頭會說明程式庫的公開介面，並可供此規則或相關規則中的來源加入。不應由此程式庫的用戶端納入的標頭，應改列在 srcs 屬性中。如果已啟用模組，這些模組會從來源中個別編譯。
`alwayslink`	布林值；預設值為 `False` 如果為 1，則任何依附 (直接或間接) 於此程式庫的套件或二進位檔，都會連結 `srcs` 和 `non_arc_srcs` 中列出的檔案的所有物件檔案，即使其中有些檔案不含由二進位檔參照的符號也一樣。如果二進位檔中的程式碼並未明確呼叫您的程式碼 (例如，如果您的程式碼註冊接收某些服務提供的回呼)，這項功能就很實用。
`copts`	字串清單；預設為 `[]` 要傳遞至編譯器的額外標記。適用於 "Make variable" 替換和 Bourne shell 符記化。這些標記只會套用至這個目標，而不會套用至這個目標所依賴的目標，或依賴這個目標的目標。請注意，對於產生的 Xcode 專案，系統會剖析使用 copts 中「-I」標記指定的目錄路徑，並在相對路徑前方加上「$(WORKSPACE_ROOT)/」(如果是相對路徑)，然後將其新增至相關聯 Xcode 目標的標頭搜尋路徑。
`defines`	字串清單；預設為 `[]` 要傳遞至編譯器的額外 `-D` 標記。這些值應為 `KEY=VALUE` 或 `KEY` 形式，且不僅會傳遞至此目標的編譯器 (如 `copts`)，還會傳遞至此目標的所有 `objc_` 依附元件。適用於 "Make variable" 替換和 Bourne shell 符記化。
`enable_modules`	布林值；預設值為 `False` 啟用 clang 模組支援功能 (透過 -fmodules)。將此值設為 1 可讓您 @import 系統標頭和其他目標： @import UIKit; @import path_to_package_target;
`implementation_deps`	標籤清單；預設為 `[]` 程式庫目標依附的其他程式庫清單。與 `deps` 不同，這些程式庫的標頭和包含路徑 (以及所有傳遞依附元件) 只用於編譯這個程式庫，而非依附於此程式庫的程式庫。使用 `implementation_deps` 指定的程式庫仍會在依附此程式庫的二進位檔目標中連結。
`includes`	字串清單；預設為 `[]` 要新增至這個目標和所有依附目標的 `#include/#import` 搜尋路徑清單。這項功能可支援第三方和開放原始碼程式庫，這些程式庫未在 `#import/#include` 陳述式中指定整個工作區路徑。路徑會相對於套件目錄解讀，除了實際的用戶端根目錄外，還會納入 genfiles 和 bin 根目錄 (例如 `blaze-genfiles/pkg/includedir` 和 `blaze-out/pkg/includedir`)。與 COPTS 不同的是，這些標記會新增至此規則和所有依附此規則的規則。(注意：不是依附的規則！)請務必謹慎操作，因為這可能會造成廣泛的影響。如有疑問，請改為在 COPTS 中加入「-iquote」標記。
`linkopts`	字串清單；預設為 `[]` 要傳遞至連結器的額外旗標。
`module_map`	標籤；預設為 `None` 這個目標的自訂 Clang 模組對應。我們不建議使用自訂模組對應圖。大多數使用者應使用 Bazel 產生的模組地圖。如果指定此選項，Bazel 就不會為此目標產生模組對應表，而是會將提供的模組對應表傳遞給編譯器。
`module_name`	字串；預設為 `""` 設定此目標的模組名稱。根據預設，模組名稱是目標路徑，其中所有特殊符號都會替換為 _，例如 //foo/baz:bar 可匯入為 foo_baz_bar。
`non_arc_srcs`	標籤清單；預設為 `[]` 系統會處理 Objective-C 檔案清單，以建立不使用自動參照計數 (ARC) 的程式庫目標。這個屬性中的檔案會以與 srcs 屬性中的檔案類似的方式處理，但編譯時不會啟用 ARC。
`pch`	標籤；預設為 `None` 標頭檔案，用於在每個要編譯的來源檔案 (ARC 和非 ARC) 前方加上此檔案。我們強烈建議您不要在 BUILD 檔案中使用 pch 檔案，且應將其視為已淘汰的功能。由於 PCH 檔案並未實際預先編譯，因此這並非版本構建速度的強化功能，而只是全域依附元件。從建構效率的角度來看，您其實最好直接在需要的來源中加入所需項目。
`sdk_dylibs`	字串清單；預設為 `[]` 要連結的 SDK .dylib 程式庫名稱。例如「libz」或「libarchive」。如果二進位檔的依附元件樹狀結構中含有任何 C++ 或 Objective-C++ 來源，系統會自動加入「libc++」。連結二進位檔時，系統會使用該二進位檔的傳遞依附元件圖表中所列的所有程式庫。
`sdk_frameworks`	字串清單；預設為 `[]` 要連結的 SDK 架構名稱 (例如「AddressBook」、「QuartzCore」)。連結頂層 Apple 二進位檔時，系統會連結該二進位檔的傳遞依附元件圖表中列出的所有 SDK 架構。
`sdk_includes`	字串清單；預設為 `[]` 要新增至這個目標和所有依附目標的 `#include/#import` 搜尋路徑清單，其中每個路徑都相對於 `$(SDKROOT)/usr/include`。
`stamp`	布林值；預設值為 `False`
`textual_hdrs`	標籤清單；預設為 `[]` 這個規則中來源檔案或這個程式庫的使用者，會將 C、C++、Objective-C 和 Objective-C++ 檔案納入標頭的清單。與 HDR 不同，這些檔案不會從來源中單獨編譯。
`weak_sdk_frameworks`	字串清單；預設為 `[]` 要以弱連結方式連結的 SDK 架構名稱。例如「MediaAccessibility」。與一般連結的 SDK 架構不同，如果在執行階段中未出現弱連結架構的符號，就不會發生錯誤。