Current release: 1.6.0
Current RC release: v1.6.0-RC-2
Main branch: master
For more information about release and changelogs please see Changelog or refer to the Github Releases page.
Overview
rules_kotlin supports the basic paradigm of *_binary, *_library, *_test of other Bazel
language rules. It also supports jvm, android, and js flavors, with the prefix kt_jvm
and kt_js, and kt_android typically applied to the rules.
Support for kotlin's -Xfriend-paths via the associates= attribute in the jvm allow access to
internal members.
Also, kt_jvm_* rules support the following standard java_* rules attributes:
data
resource_jars
runtime_deps
resources
resources_strip_prefix
exports
Android rules also support custom_package for R.java generation, manifest=, resource_files, etc.
Other features:
Persistent worker support.
Mixed-Mode compilation (compile Java and Kotlin in one pass).
Configurable Kotlinc distribution and version
Configurable Toolchain
Support for all recent major Kotlin releases.
Javascript is reported to work, but is not as well maintained (at present)
In the project's WORKSPACE, declare the external repository and initialize the toolchains, like
this:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
rules_kotlin_version="1.6.0"rules_kotlin_sha="a57591404423a52bd6b18ebba7979e8cd2243534736c5c94d35c89718ea38f94"http_archive(
name="io_bazel_rules_kotlin",
urls= ["https://github.com/bazelbuild/rules_kotlin/releases/download/v%s/rules_kotlin_release.tgz"%rules_kotlin_version],
sha256=rules_kotlin_sha,
)
load("@io_bazel_rules_kotlin//kotlin:repositories.bzl", "kotlin_repositories")
kotlin_repositories() # if you want the default. Otherwise see custom kotlinc distribution belowload("@io_bazel_rules_kotlin//kotlin:core.bzl", "kt_register_toolchains")
kt_register_toolchains() # to use the default toolchain, otherwise see toolchains below
BUILD files
In your project's BUILD files, load the Kotlin rules and use them like so:
and then in your WORKSPACE file, instead of kt_register_toolchains() do
register_toolchains("//:kotlin_toolchain")
Custom kotlinc distribution (and version)
To choose a different kotlinc distribution (1.3 and 1.4 variants supported), do the following
in your WORKSPACE file (or import from a .bzl file:
load("@io_bazel_rules_kotlin//kotlin:repositories.bzl", "kotlin_repositories", "kotlinc_version")
kotlin_repositories(
compiler_release=kotlinc_version(
release="1.6.21", # just the numeric versionsha256="632166fed89f3f430482f5aa07f2e20b923b72ef688c8f5a7df3aa1502c6d8ba"
)
)
Third party dependencies
(e.g. Maven artifacts)
Third party (external) artifacts can be brought in with systems such as rules_jvm_external or bazel_maven_repository or bazel-deps, but make sure the version you use doesn't naively use java_import, as this will cause bazel to make an interface-only (ijar), or ABI jar, and the native ijar tool does not know about kotlin metadata with respect to inlined functions, and will remove method bodies inappropriately. Recent versions of rules_jvm_external and bazel_maven_repository are known to work with Kotlin.
Development Setup Guide
As of 1.5.0, to use the rules directly from the rules_kotlin workspace (i.e. not the release artifact)
require the use of release_archive repository. This repository will build and configure the current
workspace to use rules_kotlin in the same manner as the released binary artifact.
In the project's WORKSPACE, change the setup:
# Use local check-out of repo rules (or a commit-archive from github via http_archive or git_repository)local_repository(
name="release_archive",
path="../path/to/rules_kotlin_clone/src/main/starlark/release_archive",
)
load("@release_archive//:repository.bzl", "archive_repository")
archive_repository(
name="io_bazel_rules_kotlin",
local_path="../path/to/rules_kotlin_clone/"
)
load("@io_bazel_rules_kotlin//kotlin:repositories.bzl", "kotlin_repositories", "versions")
kotlin_repositories()
load("@io_bazel_rules_kotlin//kotlin:core.bzl", "kt_register_toolchains")
kt_register_toolchains()
To use rules_kotlin from head without cloning the repository, (caveat emptor, of course), change the
rules to this:
You can optionally override compiler flags at the target level by providing an alternative set of kt_kotlinc_options or kt_javac_options in your target definitions.
Compiler flags that are passed to the rule definitions will be taken over the toolchain definition.
Additionally, you can add options for both tracing and timing of the bazel build using the kt_trace and kt_timings flags, for example:
bazel build --define=kt_trace=1
bazel build --define=kt_timings=1
kt_trace=1 will allow you to inspect the full kotlinc commandline invocation, while kt_timings=1 will report the high level time taken for each step.
Kotlin compiler plugins
The kt_compiler_plugin rule allows running Kotlin compiler plugins, such as no-arg, sam-with-receiver and allopen.
For example, you can add allopen to your project like this:
load("@io_bazel_rules_kotlin//kotlin:core.bzl", "kt_compiler_plugin")
load("@io_bazel_rules_kotlin//kotlin:jvm.bzl", "kt_jvm_library")
kt_compiler_plugin(
name="open_for_testing_plugin",
id="org.jetbrains.kotlin.allopen",
options= {
"annotation": "plugin.allopen.OpenForTesting",
},
deps= [
"@com_github_jetbrains_kotlin//:allopen-compiler-plugin",
],
)
kt_jvm_library(
name="user",
srcs= ["User.kt"], # The User class is annotated with OpenForTestingplugins= [
":open_for_testing_plugin",
],
deps= [
":open_for_testing", # This contains the annotation (plugin.allopen.OpenForTesting)
],
)
Full examples of using compiler plugins can be found here.
Examples
Examples can be found in the examples directory, including usage with Android, Dagger, Node-JS, Kotlin compiler plugins, etc.
History
These rules were initially forked from pubref/rules_kotlin, and then re-forked from bazelbuild/rules_kotlin. They were merged back into this repository in October, 2019.
License
This project is licensed under the Apache 2.0 license, as are all contributions
Contributing
See the CONTRIBUTING doc for information about how to contribute to
this project.
客服电话
APP下载
官方微信
请发表评论