從 Xcode 遷移至 Bazel

回報問題 查看來源 。 。 。 。 夜間。 。 7.3 。 。 7.2 。 。 7.1 。 。 7.0 。 。 6.5

本頁說明如何使用 Bazel 建構或測試 Xcode 專案。這項服務 說明 Xcode 和 Bazel 之間的差異,並提供 將 Xcode 專案轉換為 Bazel 專案它同時提供疑難排解服務 修正常見錯誤

Xcode 和 Bazel 之間的差異

  • Bazel 需要您明確指定每個建構目標及其 依附元件,再加上透過建構規則所對應的建構設定。

  • Bazel 要求專案所處的所有檔案 工作區目錄或指定為 MODULE.bazel 中的依附元件 檔案。

  • 使用 Bazel 建構 Xcode 專案時,BUILD 檔案會成為 可靠結果。如果您是在 Xcode 處理專案,則必須產生 新版與 BUILD 檔案相符的 Xcode 專案 rules_xcodeproj 每當您更新 BUILD 檔案時。BUILD 檔案有某些變更 將依附元件新增至目標,就不必重新產生 這能加快開發速度如果您不是使用 Xcode, bazel buildbazel test 指令提供建構與測試功能 以及本指南稍後會說明的某些限制。

事前準備

開始之前,請先執行下列操作:

  1. 如果您尚未安裝 Bazel,請先完成安裝。

  2. 如果您不熟悉 Bazel 及其概念,請填妥 iOS 應用程式 教學課程)。您應該瞭解 Bazel 工作區 包含 MODULE.bazelBUILD 檔案,以及 包括目標、建構規則和 Bazel 套件

  3. 分析並瞭解專案的依附元件。

分析專案依附元件

與 Xcode 不同的是,Bazel 會要求您明確宣告 BUILD 檔案中的每個目標。

如要進一步瞭解外部依附元件,請參閱使用外部依附元件。 依附元件

使用 Bazel 建構或測試 Xcode 專案

如要使用 Bazel 建構或測試 Xcode 專案,請按照下列步驟操作:

  1. 建立 MODULE.bazel 檔案

  2. (實驗功能) 整合 SwiftPM 依附元件

  3. 建立 BUILD 檔案:

    a. 新增應用程式目標

    b. (選用) 新增測試目標

    c. 新增程式庫目標

  4. (選用) 將建構作業精細化

  5. 執行建構

  6. 使用 Rules_xcodeproj 產生 Xcode 專案

步驟 1:建立 MODULE.bazel 檔案

在新目錄中建立 MODULE.bazel 檔案。這個目錄會變成 Bazel 工作區根目錄。如果專案沒有使用外部依附元件,則這個檔案 可以是空的如果專案依附的檔案或套件不在 專案的目錄,請在 MODULE.bazel 檔案。

步驟 2:(實驗功能) 整合 SwiftPM 依附元件

如要在 Bazel 工作區中整合 SwiftPM 依附元件,請使用 swift_bazel,您必須 如下文所述,將模型轉換為 Bazel 套件 教學課程 ,直接在 Google Cloud 控制台實際操作。

步驟 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 版本 規則支援執行 單元和使用者介面測試。新增測試目標,如下所示:

  • macos_unit_test敬上 在 macOS 上執行以程式庫和應用程式為基礎的單元測試。

  • ios_unit_test敬上 以便在 iOS 上建構及執行程式庫單元測試。

  • ios_ui_test敬上 在 iOS 模擬器中建構及執行使用者介面測試。

  • 有類似的測試規則 tvOSwatchOSvisionOS

請至少指定 minimum_os_version 屬性的值。雖然 其他包裝屬性,例如 bundle_identifierinfoplists 預設為最常用的值,請確保這些預設值能相容 並視需求進行調整針對需要 iOS 裝置的測試 模擬工具,也會將 ios_application 目標名稱指定為 test_host 屬性。

步驟 3c:新增程式庫目標

為每個項目新增 objc_library 目標 Objective-C 程式庫 swift_library 目標。

新增資料庫目標如下:

  • 將應用程式程式庫目標新增為應用程式的依附元件 目標。

  • 將測試程式庫目標新增為測試目標的依附元件。

  • srcs 屬性中列出實作來源。

  • 請在 hdrs 屬性中列出標頭。

,瞭解如何調查及移除這項存取權。

您可以直接在 GCP 中瀏覽各類型應用程式的現有範例 rules_apple 範例 目錄。例如:

如要進一步瞭解建構規則,請參閱 Apple 規則: Bazel

此時,建議您測試版本:

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 建構時,MODULE.bazelBUILD 檔案會成為來源檔案 確切的建構內容如要讓 Xcode 瞭解此狀況,您必須產生 與 Bazel 相容的 Xcode 專案 rules_xcodeproj ,直接在 Google Cloud 控制台實際操作。

疑難排解

當 Bazel 與所選 Xcode 版本未同步,就會發生 Bazel 錯誤 例如套用更新如果您遇到這種情況,請嘗試以下做法 Xcode 發生錯誤,例如「必須指定 Xcode 版本 請使用 Apple CROSSTOOL」。

  • 手動執行 Xcode 並接受所有條款及細則。

  • 使用 Xcode 選取表示正確版本、接受授權,以及 清除 Bazel 的狀態

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  sudo xcodebuild -license
  bazel sync --configure
  • 如果這個方法無效,也可以嘗試執行 bazel clean --expunge
,瞭解如何調查及移除這項存取權。