本頁說明如何使用 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 專案如何結構。創作
BUILD 檔案，並將其設定為執行
執行這個專案：
提示：如要進一步瞭解套件和其他 Bazel 概念，請參閱 工作區、套件及目標。
步驟 3a：新增應用程式目標
新增macos_application
或 ios_application
規則目標。這個目標會分別建構 macOS 或 iOS 應用程式套件。
在目標中，至少指定下列項目：
bundle_id：應用程式的軟體包 ID (reverse-DNS 路徑，後接應用程式名稱) 二進位檔案。provisioning_profile- 來自 Apple Developer 的佈建設定檔 帳戶 (若為 iOS 裝置建構)。families(僅限 iOS) - 是否建構適用於 iPhone、iPad、 或兩者並行infoplists- 要合併到最終 Info.plist 檔案的 .plist 檔案清單。minimum_os_version- 提供的 macOS 或 iOS 最低版本 應用程式。這可確保 Bazel 使用 正確的 API 級別
步驟 3b：(選用) 新增測試目標
Bazel 的 Apple 建構規則支援 在所有 Apple 平台上執行單元和使用者介面測試新增測試目標，如下所示：
macos_unit_test：在 macOS 上執行程式庫和應用程式單元測試。ios_unit_test以便在 iOS 上建構及執行程式庫單元測試。ios_ui_test在 iOS 模擬器中建構及執行使用者介面測試。
請至少指定 minimum_os_version 屬性的值。雖然
其他包裝屬性，例如 bundle_identifier 和 infoplists
預設為最常用的值，請確保這些預設值能相容
並視需求進行調整針對需要 iOS 裝置的測試
模擬工具，也會將 ios_application 目標名稱指定為
test_host 屬性。
步驟 3c：新增程式庫目標
新增objc_library
一個目標為 Objective-C 程式庫，另一個則是 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 版本未同步，就會發生 Bazel 錯誤 例如套用更新如果您遇到這種情況，請嘗試以下做法 Xcode 發生錯誤，例如「必須指定 Xcode 版本 請使用 Apple CROSSTOOL」。
手動執行 Xcode 並接受所有條款及細則。
使用 Xcode 選取表示正確版本、接受授權，以及 清除 Bazel 的狀態
sudo xcode-select -s /Applications/Xcode.app/Contents/Developersudo xcodebuild -licensebazel sync --configure
- 如果這個方法無效，也可以嘗試執行
bazel clean --expunge。