本頁說明如何使用 Bazel 建構或測試 Xcode 專案。這項服務 說明 Xcode 和 Bazel 之間的差異 ，將 Xcode 專案轉換為 Bazel 專案。並提供解決常見錯誤的疑難排解解決方案。
Xcode 和 Bazel 的差異
Bazel 需要您明確指定每個建構目標及其 依附元件，再加上透過建構規則所對應的建構設定。
Bazel 要求專案所依附的所有檔案必須位於工作區目錄中，或是在
WORKSPACE檔案中指定為匯入檔案。使用 Bazel 建構 Xcode 專案時，
BUILD檔案會成為可靠的來源。如果您是在 Xcode 處理專案，則必須產生 新版與BUILD檔案相符的 Xcode 專案 rules_xcodeproj 每當您更新BUILD檔案時。BUILD檔案有某些變更 將依附元件新增至目標，就不必重新產生 這能加快開發速度如果您未使用 Xcode，bazel build和bazel test指令會提供建構和測試功能，但有特定限制，請參閱本指南後續說明。
事前準備
開始之前，請先執行下列操作：
如果您尚未安裝 Bazel，請先完成安裝。
如果您不熟悉 Bazel 及其概念，請完成 iOS 應用程式教學課程。您應瞭解 Bazel 工作區，包括
WORKSPACE和BUILD檔案，以及目標、建構規則和 Bazel 套件等概念。分析並瞭解專案的依附元件。
分析專案依附元件
與 Xcode 不同，Bazel 要求您在 BUILD 檔案中明確宣告每個目標的所有依附元件。
如要進一步瞭解外部依附元件，請參閱 使用外部依附元件。
使用 Bazel 建構或測試 Xcode 專案
如要使用 Bazel 建構或測試 Xcode 專案，請按照下列步驟操作：
-
a. 新增應用程式目標
b. (選用) 新增測試目標
c. 新增程式庫目標
步驟 1：建立 WORKSPACE 檔案
在新目錄中建立 WORKSPACE 檔案。這個目錄會成為 Bazel
。如果專案未使用任何外部依附元件，這個檔案可以是空白。如果專案依附的檔案或套件不在專案的其中一個目錄中，請在 WORKSPACE 檔案中指定這些外部依附元件。
步驟 2：(實驗功能) 整合 SwiftPM 依附元件
如要將 SwiftPM 依附元件與 swift_bazel 整合到 Bazel 工作區， 您必須按照這些教學課程的說明，將這些檔案轉換為 Bazel 套件。
步驟 3：建立 BUILD 檔案
定義工作區和外部依附元件後，請
建立 BUILD 檔案，告知 Bazel 專案如何結構。在 Bazel 工作區的根目錄中建立 BUILD 檔案，並將其設為執行專案的初始建構作業，如下所示：
提示：如要進一步瞭解套件和其他 Bazel 概念，請參閱 工作區、套件及目標。
步驟 3a：新增應用程式目標
新增 macos_application 或 ios_application 規則目標。這個目標會分別建構 macOS 或 iOS 應用程式套件。
在目標中，至少指定下列項目：
bundle_id：應用程式的軟體包 ID (reverse-DNS 路徑，後接應用程式名稱) 二進位檔案。provisioning_profile：Apple 開發人員帳戶中的佈建設定檔 (如果是為 iOS 裝置建構)。families(僅限 iOS) - 是否建構適用於 iPhone、iPad、 或兩者並行infoplists- 要合併至最終 Info.plist 檔案的 .plist 檔案清單。minimum_os_version- 提供的 macOS 或 iOS 最低版本 應用程式。這可確保 Bazel 使用 正確的 API 級別
步驟 3b：(選用) 新增測試目標
Bazel 的 Apple 建構規則支援在 iOS 和 macOS 上執行程式庫單元測試，以及在 macOS 上執行應用程式測試。針對 iOS 上的應用程式測試或任一平台上的 UI 測試，Bazel 會建構測試輸出內容，但測試必須透過使用 rules_xcodeproj 產生的專案在 Xcode 中執行。新增測試目標，如下所示：
macos_unit_test：在 macOS 上執行程式庫和應用程式單元測試。ios_unit_test，在 iOS 上執行程式庫式單元測試。針對需要 iOS 裝置的測試 Bazel 會建構測試輸出內容，但不會執行測試。您必須 產生含有規則_xcodeproj 的 Xcode 專案 並在 Xcode 內進行測試ios_ui_test來建構使用 Xcode 在 iOS 模擬器中執行使用者介面測試所需的輸出內容。您必須使用 rules_xcodeproj 產生 Xcode 專案，並在 Xcode 中執行測試。Bazel 無法原生執行 UI 測試。
至少請為 minimum_os_version 屬性指定值。雖然 bundle_identifier 和 infoplists 等其他封裝屬性預設為最常用的值，但請確保這些預設值與專案相容，並視需要調整。針對需要 iOS 裝置的測試
模擬工具，也會將 ios_application 目標名稱指定為
test_host 屬性。
步驟 3c：新增程式庫目標
為每個 Objective-C 程式庫新增 objc_library 目標，並為每個應用程式和/或測試依附的 Swift 程式庫新增 swift_library 目標。
新增程式庫目標如下：
將應用程式程式庫目標新增為應用程式的依附元件 目標。
將測試程式庫目標新增為測試目標的依附元件。
在
srcs屬性中列出實作來源。請在
hdrs屬性中列出標頭。
您可以直接在 rules_apple 範例目錄中瀏覽各種應用程式類型的現有範例。例如：
如要進一步瞭解建構規則，請參閱「Bazel 適用的 Apple 規則」。
此時建議您測試建構項目：
bazel build //:<application_target>
步驟 4：(選用) 細分版本
如果專案很大，或隨著專案的成長，請考慮將其分割成多個 Bazel 套件。更精細的篩選維度可提供下列功能：
提高建構作業的增量程度
提高建構工作的平行處理能力，
方便日後的使用者維護
更有效地控管目標和套件中的原始碼。這可避免程式庫包含實作細節，導致資料外洩至公用 API 的問題。
細分專案的訣竅：
將每個程式庫放入專屬的 Bazel 套件中。請從需要最少依附元件的依附元件開始，然後逐步向上瀏覽依附元件樹狀結構。
新增
BUILD檔案並指定目標時，請將這些新目標新增至依附這些目標的目標的deps屬性。glob()函式不會跨越套件邊界，因此隨著套件數量增加，glob()比對的檔案數量也會減少。將
BUILD檔案新增至main目錄時，也請將BUILD檔案新增至對應的test目錄。在所有套件中強制執行健康的瀏覽權限限制。
每次對
BUILD檔案進行重大變更後，請建構專案，並修正遇到的建構錯誤。
步驟 5：執行版本
執行已完成遷移的版本，確保不會發生錯誤或警告。個別執行每個應用程式和測試目標，以便更輕鬆找出發生錯誤的來源。
例如：
bazel build //:my-target
步驟 6：使用 rules_xcodeproj 產生 Xcode 專案
使用 Bazel 進行建構時，WORKSPACE 和 BUILD 檔案會成為建構作業的真實來源。如要讓 Xcode 瞭解這項資訊，您必須使用 rules_xcodeproj 產生與 Bazel 相容的 Xcode 專案。
疑難排解
當 Bazel 與所選 Xcode 版本不同步時，就可能發生錯誤，例如在套用更新時。如果您在使用 Xcode 時遇到錯誤，例如「Xcode 版本必須指定才能使用 Apple CROSSTOOL」，請嘗試以下幾種方法。
手動執行 Xcode 並接受所有條款及細則。
使用 Xcode 選取功能來指出正確的版本、接受授權，並清除 Bazel 的狀態。
sudo xcode-select -s /Applications/Xcode.app/Contents/Developersudo xcodebuild -licensebazel sync --configure
- 如果這個方法無效，也可以嘗試執行
bazel clean --expunge。