rules_ios
is community developed Bazel rules
that enable you to do iOS development with Bazel end to end.
It seamlessly Bazel builds iOS applications originally written under Xcode with
minimal-to-no code changes. It often re-uses ideas and code from rules_swift
and rules_apple
and it isn't tied to untested or unused features. It generates
Xcode projects that just work and makes using Apple Silicon with Bazel a
breeze.
Learn more at bazel-ios.github.io
Looking for the CocoaPods/Carthage rules? See this section.
Click here for the documentation.
rules_ios depends on rules_apple and rules_swift which are often affected by changes in Bazel itself. This means you generally need to update these rules and rules_ios as you update Bazel.
See the following table for supported release versions.
Bazel release | Minimum supported rules version | Final supported rules version |
---|---|---|
7.* | 4.4.0 | current |
6.* | 2.0.0 | current |
5.* | 1.0.0 | 3.2.2 |
4.* | 1.0.0 | 1.0.0 |
rules_ios depends on rules_apple, we attempt to maintain compatibility with most versions of rules_apple until it becomes too difficult to do so.
See the following table for supported rules_apple release versions.
rules_apple release | Minimum supported rules version | Final supported rules version |
---|---|---|
3.5.1 | 4.3.1 | current |
3.* | 3.* | 4.2.1 |
2.* | 2.* | 3.2.2 |
1.* | 1.0.0 | 3.2.2 |
Add the Bazel module to your MODULE.bazel
file:
See the latest release for an up-to-date snippet!
bazel_dep(name = "rules_ios", version = "x.x.x", repo_name = "build_bazel_rules_ios")
Add the following lines to your WORKSPACE
file.
See the latest release for an up-to-date snippet!
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
# See https://github.com/bazel-ios/rules_ios/releases/latest
http_archive(
name = "build_bazel_rules_ios",
sha256 = "4faa33a671f615500d3ec0d04d89e390103bcc1abb5e973c8fb1c2510af85985",
url = "https://github.com/bazel-ios/rules_ios/releases/download/1.0.1/rules_ios.1.0.1.tar.gz",
)
load(
"@build_bazel_rules_ios//rules:repositories.bzl",
"rules_ios_dependencies"
)
rules_ios_dependencies()
load(
"@build_bazel_rules_apple//apple:repositories.bzl",
"apple_rules_dependencies",
)
apple_rules_dependencies()
load(
"@build_bazel_rules_swift//swift:repositories.bzl",
"swift_rules_dependencies",
)
swift_rules_dependencies()
load(
"@build_bazel_apple_support//lib:repositories.bzl",
"apple_support_dependencies",
)
apple_support_dependencies()
load(
"@com_google_protobuf//:protobuf_deps.bzl",
"protobuf_deps",
)
protobuf_deps()
rules_ios pulls a vetted sha of rules_apple
and rules_swift
- you can find the versions in repositories.bzl
.
rules_ios supports all the primitives like apps, extensions, app clips, and widgets
For example, create an iOS app like so:
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"],
)
See rules_xcodeproj.
Static frameworks with Xcode semantics - easily port existing apps to Bazel
# Builds a static 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"],
)
rules_ios builds frameworks as static or dynamic - just flip
link_dynamic
apple_framework(
name = "Dynamic",
srcs = glob(["dynamic/*.swift"]),
bundle_id = "com.example.a",
infoplists = ["Info.plist"],
link_dynamic = True,
platforms = {"ios": "12.0"},
deps = [":Static"],
)
Easily test iOS applications with Bazel - ui and unit testing rules
load("//rules:test.bzl", "ios_unit_test")
ios_unit_test(
name = "Unhosted",
srcs = ["some.swift"],
minimum_os_version = "12.0",
deps = [":Dynamic"]
)
See the tests directory for tested use cases.
Debugging does not work in sandbox mode, due to issue #108. The workaround for now is to disable sandboxing in the .bazelrc file.
Bazel version required by current rules is here
Xcode 13 and above supported, to find the last SHA
with support for older versions see the list of git tags.
The existing CocoaPods and Carthage rules have been removed for maintenance reasons, instead use these other solutions:
For information on contributing / maintaining this repository see: CONTRIBUTING.md