Bazel 教學課程：建構 iOS 應用程式

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

本教學課程將說明如何使用 Bazel 建構簡單的 iOS 應用程式。

課程內容

在本教學課程中，您將瞭解以下內容：

• 安裝 Bazel 和 Xcode，並下載範例專案，設定環境
• 設定 Bazel 工作區，其中包含應用程式的原始碼，以及可識別工作區目錄頂層的 WORKSPACE 檔案
• 更新 WORKSPACE 檔案，以便包含對必要外部依附元件的參照
• 建立 BUILD 檔案
• 執行 Bazel，為模擬器和 iOS 裝置建構應用程式
• 在模擬器和 iOS 裝置上執行應用程式

設定環境

如要開始使用，請安裝 Bazel 和 Xcode，並取得範例專案。

安裝 Bazel

請按照安裝操作說明安裝 Bazel 及其依附元件。

安裝 Xcode

下載並安裝 Xcode。Xcode 包含 Bazel 建構 Apple 應用程式所需的編譯器、SDK 和其他工具。

取得範例專案

您也需要從 GitHub 取得教學課程的範例專案。GitHub 存放區有兩個分支：source-only 和 main。source-only 分支只包含專案的來源檔案。您將在本教學課程中使用這個分支中的檔案。main 分支包含來源檔案和已完成的 Bazel WORKSPACE 和 BUILD 檔案。完成教學課程步驟後，您可以使用這個分支中的檔案檢查自己的工作。

在指令列中輸入下列內容，即可取得 source-only 分支中的檔案：

cd $HOME
git clone -b source-only https://github.com/bazelbuild/examples

git clone 指令會建立名為 $HOME/examples/ 的目錄。這個目錄包含幾個 Bazel 範例專案。本教學課程的專案檔案位於 $HOME/examples/tutorial/ios-app 中。

設定工作區

工作區是包含一或多個軟體專案來源檔案的目錄，以及 WORKSPACE 檔案和 BUILD 檔案，其中包含 Bazel 用來建構軟體的指示。工作區域也可能包含輸出目錄的符號連結。

工作區目錄可位於檔案系統的任何位置，且會在根目錄中顯示 WORKSPACE 檔案。在本教學課程中，您的工作區目錄為 $HOME/examples/tutorial/，其中包含您在上一個步驟中從 GitHub 存放區複製的範例專案檔案。

注意： Bazel 本身不會強制規定如何在工作區中整理來源檔案。本教學課程中的範例來源檔案會依據目標平台的慣例進行排序。

為了方便起見，請立即設定 $WORKSPACE 環境變數，以便參照工作區目錄。在指令列中輸入：

export WORKSPACE=$HOME/examples/tutorial

建立 WORKSPACE 檔案

每個工作區都必須在頂層工作區目錄中，設有名為 WORKSPACE 的文字檔案。這個檔案可能為空白，也可能包含建構軟體所需的外部依附元件參照。

目前，您將建立空白的 WORKSPACE 檔案，用於識別工作區目錄。在後續步驟中，您將更新檔案以新增外部依附元件資訊。

在指令列中輸入以下內容：

touch $WORKSPACE/WORKSPACE
open -a Xcode $WORKSPACE/WORKSPACE

這會建立並開啟空白的 WORKSPACE 檔案。

更新 WORKSPACE 檔案

如要建構 Apple 裝置的應用程式，Bazel 需要從 GitHub 存放區提取最新的 Apple 建構規則。如要啟用這項功能，請在 WORKSPACE 檔案中新增下列 git_repository 規則：

load("@bazel_tools//tools/build_defs/repo:git.bzl", "git_repository")

git_repository(
    name = "build_bazel_rules_apple",
    remote = "https://github.com/bazelbuild/rules_apple.git",
    tag = "0.19.0",
)

git_repository(
    name = "build_bazel_rules_swift",
    remote = "https://github.com/bazelbuild/rules_swift.git",
    tag = "0.13.0",
)

git_repository(
    name = "build_bazel_apple_support",
    remote = "https://github.com/bazelbuild/apple_support.git",
    tag = "0.7.2",
)

git_repository(
    name = "bazel_skylib",
    remote = "https://github.com/bazelbuild/bazel-skylib.git",
    tag = "0.9.0",
)

注意： 「請務必在 tag 屬性中使用最新版本的 build_apple 規則。請務必檢查 rules_apple 專案中所需的最新依附元件。

注意： 您必須將 git_repository 規則中的 name 屬性值設為 build_bazel_rules_apple，否則建構作業會失敗。

查看來源檔案

查看位於 $WORKSPACE/ios-app/UrlGet 中的應用程式原始碼檔案。再次提醒，您現在只需查看這些檔案，熟悉應用程式的結構。您不需要編輯任何來源檔案，即可完成本教學課程。

建立 BUILD 檔案

在指令列提示中，開啟新的 BUILD 檔案進行編輯：

touch $WORKSPACE/ios-app/BUILD
open -a Xcode $WORKSPACE/ios-app/BUILD

新增規則載入陳述式

如要建構 iOS 目標，Bazel 需要在每次建構作業執行時，從 GitHub 存放區載入建構規則。如要讓這些規則可供專案使用，請在 BUILD 檔案的開頭加入下列載入陳述式：

load("@build_bazel_rules_apple//apple:ios.bzl", "ios_application")

您只需要載入 ios_application 規則，因為 objc_library 規則已建構至 Bazel 套件中。

新增 objc_library 規則

Bazel 提供多項建構規則，可用於建構 iOS 平台的應用程式。在本教學課程中，您會先使用 objc_library 規則，告訴 Bazel 如何從應用程式原始碼和 Xib 檔案建構靜態資料庫。接著，您將使用 ios_application 規則，告知系統如何建構應用程式二進位檔和 .ipa 套件。

注意： 本教學課程將介紹 Bazel 中 Objective-C 規則的最低用途。舉例來說，您必須使用 ios_application 規則建構多架構 iOS 應用程式。

請將以下內容新增到 BUILD 檔案中：

objc_library(
    name = "UrlGetClasses",
    srcs = [
         "UrlGet/AppDelegate.m",
         "UrlGet/UrlGetViewController.m",
         "UrlGet/main.m",
    ],
    hdrs = glob(["UrlGet/*.h"]),
    data = ["UrlGet/UrlGetViewController.xib"],
)

請注意規則名稱 UrlGetClasses。

新增 ios_application 規則

ios_application 規則會建構應用程式二進位檔，並建立 .ipa 套件檔案。

請將以下內容新增到 BUILD 檔案中：

ios_application(
    name = "ios-app",
    bundle_id = "Google.UrlGet",
    families = [
        "iphone",
        "ipad",
    ],
    minimum_os_version = "9.0",
    infoplists = [":UrlGet/UrlGet-Info.plist"],
    visibility = ["//visibility:public"],
    deps = [":UrlGetClasses"],
)

注意： 請將 minimum_os_version 屬性更新為您計畫支援的最低 iOS 版本。

請注意，deps 屬性如何參照您在上述 BUILD 檔案中新增的 UrlGetClasses 規則輸出內容。

接著，請儲存並關閉檔案。您可以將 BUILD 檔案與 GitHub 存放區 main 分支中的完成範例進行比較。

建構及部署應用程式

您現在可以建構應用程式，並將其部署至模擬器和 iOS 裝置。

注意： 應用程式會獨立啟動，但需要後端伺服器才能產生輸出內容。請參閱範例專案目錄中的 README 檔案，瞭解如何建構後端伺服器。

已建構的應用程式位於 $WORKSPACE/bazel-bin 目錄中。

本教學課程的完成版 WORKSPACE 和 BUILD 檔案位於 GitHub 存放區的主分支中。您可以將自己的作品與完成的檔案進行比較，以便取得其他協助或排解問題。

為模擬器建構應用程式

請確認目前的工作目錄位於 Bazel 工作區中：

cd $WORKSPACE

接著輸入下列指令，建構範例應用程式：

bazel build //ios-app:ios-app

Bazel 會啟動並建構範例應用程式。在建構程序期間，輸出內容會顯示類似以下內容：

INFO: Found 1 target...
Target //ios-app:ios-app up-to-date:
  bazel-bin/ios-app/ios-app.ipa
INFO: Elapsed time: 0.565s, Critical Path: 0.44s

找出建構輸出內容

.ipa 檔案和其他輸出內容位於 $WORKSPACE/bazel-bin/ios-app 目錄中。

在模擬器中執行及偵錯應用程式

您現在可以使用 iOS 模擬器，從 Xcode 執行應用程式。首先，使用 Tulsi 產生 Xcode 專案。

接著，在 Xcode 中開啟專案，選擇 iOS 模擬工具做為執行階段配置，然後按一下「Run」。

注意： 如果您在 Xcode 中修改任何專案檔案 (例如新增或移除檔案，或新增或變更依附元件)，就必須使用 Bazel 重新建構應用程式、在 Tulsi 中重新產生 Xcode 專案，然後在 Xcode 中重新開啟專案。

為裝置建構應用程式

如要建構應用程式，讓應用程式在 iOS 裝置上安裝及啟動，Bazel 需要該裝置型號的適當佈建設定檔。請完成下列步驟：

1. 前往 Apple Developer Account，並下載裝置適用的適當佈建設定檔。詳情請參閱 Apple 說明文件。

2. 將設定檔移至 $WORKSPACE。

3. (選用) 將設定檔新增至 .gitignore 檔案。

4. 在 BUILD 檔案的 ios_application 目標中新增下列程式碼行：

   provisioning_profile = "<your_profile_name>.mobileprovision",
   

注意： 請確認設定檔正確無誤，以便在裝置上安裝應用程式。

接著，為您的裝置建構應用程式：

bazel build //ios-app:ios-app --ios_multi_cpus=armv7,arm64

這會將應用程式建構為肥厚二進位檔。如要針對特定裝置架構進行建構，請在建構選項中指定該架構。

如要針對特定 Xcode 版本進行建構，請使用 --xcode_version 選項。如要針對特定 SDK 版本進行建構，請使用 --ios_sdk_version 選項。在大多數情況下，--xcode_version 選項就足夠了。

如要指定所需的最低 iOS 版本，請在 BUILD 檔案的 ios_application 建構規則中加入 minimum_os_version 參數。

您也可以使用 Tulsi，透過 GUI 而非指令列建構應用程式。

在裝置上安裝應用程式

如要在裝置上安裝應用程式，最簡單的方法是啟動 Xcode 並使用 Windows > Devices 指令。從左側清單中選取已插入的裝置，然後按一下「已安裝的應用程式」下方的「新增」 (加號) 按鈕，並選取您建構的 .ipa 檔案，即可新增應用程式。

如果應用程式無法在裝置上安裝，請確認您在 BUILD 檔案中指定正確的佈建設定檔 (前一個部分的步驟 4)。

如果應用程式無法啟動，請確認您的裝置屬於佈建設定檔。Xcode 中 Devices 畫面上的 View Device Logs 按鈕可能會提供其他資訊，說明發生錯誤的原因。

延伸閱讀

詳情請參閱 GitHub 存放區的主要分支。