Bazel iOS 规则使用教程

项目介绍

rules_ios 是一个开源项目，旨在为 iOS 应用程序和框架提供 Bazel 构建规则。该项目允许开发者使用 Bazel 来构建和测试 iOS 应用，支持各种 iOS 原语，如应用扩展、App Clips 和小组件。rules_ios 依赖于 rules_apple 和 rules_swift，并尝试保持与这些规则的兼容性。

项目快速启动

安装 Bazel

首先，确保你已经安装了 Bazel。你可以通过以下命令安装 Bazel：

brew install bazel

添加 rules_ios 到你的项目

在你的 WORKSPACE 文件中添加以下内容：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "build_bazel_rules_ios",
    url = "https://github.com/bazel-ios/rules_ios/archive/refs/tags/x.x.x.zip",
    strip_prefix = "rules_ios-x.x.x",
)

load("@build_bazel_rules_ios//rules:repositories.bzl", "rules_ios_dependencies")

rules_ios_dependencies()

创建一个 iOS 应用

在你的 BUILD 文件中添加以下内容：

load("@build_bazel_rules_ios//rules:app.bzl", "ios_application")

ios_application(
    name = "iOS-App",
    srcs = glob(["*.swift"]),
    bundle_id = "com.example.ios-app",
    minimum_os_version = "12.0",
    visibility = ["//visibility:public"],
)

构建应用

使用以下命令构建你的 iOS 应用：

bazel build //path/to/your:iOS-App

应用案例和最佳实践

使用静态框架

rules_ios 支持构建静态框架，这对于移植现有应用到 Bazel 非常有用。以下是一个示例：

load("@build_bazel_rules_ios//rules:framework.bzl", "apple_framework")

apple_framework(
    name = "Static",
    srcs = glob(["static/*.swift"]),
    bundle_id = "com.example.b",
    data = ["Static.txt"],
    infoplists = ["Info.plist"],
    platforms = {"ios": "12.0"},
    deps = ["//tests/ios/frameworks/dynamic/c"],
)

生成 Xcode 项目

rules_ios 支持生成 Xcode 项目，方便开发者使用 Xcode 进行开发。以下是一个示例：

load("@build_bazel_rules_ios//rules:xcodeproj.bzl", "xcodeproj")

xcodeproj(
    name = "MyXcode",
    bazel_path = "bazelisk",
    deps = [":iOS-App"],
)

典型生态项目

rules_apple

rules_apple 是 rules_ios 的主要依赖之一，提供了构建 Apple 平台应用的规则。

rules_swift

rules_swift 提供了构建 Swift 代码的规则，与 rules_ios 紧密集成。

rules_xcodeproj

rules_xcodeproj 是一个用于生成 Xcode 项目的规则集，rules_ios 与之合作，以更好地集成 Xcode 项目生成功能。

通过以上步骤和示例，你可以快速上手使用 rules_ios 来构建和开发 iOS 应用。希望这篇教程对你有所帮助！