Skip to content

Files

Latest commit

15aa523 · Nov 7, 2024

History

History
Cannot retrieve ahead/behind information for this branch.

Folders and files

NameName
Last commit message
Last commit date
Nov 7, 2024
Jul 10, 2024
Jun 27, 2024
Nov 7, 2024
Oct 29, 2024
Jul 12, 2024
Nov 7, 2024
Sep 25, 2024
Jun 3, 2024
Oct 17, 2023
Nov 6, 2023
Jan 10, 2023
Mar 29, 2017
Jan 31, 2024
Nov 6, 2023
Feb 13, 2023
Mar 29, 2017
Nov 2, 2023
Oct 22, 2024
Jan 9, 2024
Jan 23, 2024
Feb 16, 2023
Jun 14, 2018
Feb 23, 2024

Apple Rules for Bazel

This repository contains rules for Bazel that can be used to bundle applications for Apple platforms.

These rules handle the linking and bundling of applications and extensions (that is, the formation of an .app with an executable and resources, archived in an .ipa). Compilation is still performed by the existing objc_library rule in Bazel, and by the swift_library rule available from rules_swift.

If you are looking for an easy way to build mixed language frameworks, check out rules_ios.

Reference documentation

Click here for the reference documentation for the rules and other definitions in this repository.

Quick setup

Copy the latest MODULE.bazel or WORKSPACE snippet from the releases page.

Examples

Minimal example:

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

swift_library(
    name = "MyLibrary",
    srcs = glob(["**/*.swift"]),
    data = [":Main.storyboard"],
)

# Links code from "deps" into an executable, collects and compiles resources
# from "deps" and places them with the executable in an .app bundle, and then
# outputs an .ipa with the bundle in its Payload directory.
ios_application(
    name = "App",
    bundle_id = "com.example.app",
    families = [
        "iphone",
        "ipad",
    ],
    infoplists = [":Info.plist"],
    minimum_os_version = "15.0",
    deps = [":MyLibrary"],
)

See the examples directory for sample applications.

Supported bazel versions

rules_apple and rules_swift are often affected by changes in bazel itself. This means you generally need to update these rules as you update bazel.

You can also see the supported bazel versions in the notes for each release on the releases page.

Besides these constraints this repo follows semver as best as we can since the 1.0.0 release.

Bazel release Minimum supported rules version Final supported rules version Supporting Branch
8.x (most recent rolling) 2.* current master
7.x 2.* current master
6.x 2.* current master
5.x 0.33.0 1.* bazel/5.x
4.x 0.30.0 0.32.0 N/A
3.x 0.20.0 0.21.2 N/A