Google Git
Sign in
bazel / rules_kotlin / 326661e7e705d14e754abc2765837aa61bddf205
commit326661e7e705d14e754abc2765837aa61bddf205[log] [tgz]
authorChristian Edward Gruber <christianedwardgruber@gmail.com>Tue Mar 19 17:09:56 2019 -0700
committerstr <46765986+10-10-11@users.noreply.github.com>Tue Mar 19 17:09:56 2019 -0700
tree324576c3d72ecd6f783f400b16620cabd611a0b9
parentda1232eda2ef90d4375e2d1677b32c7ddf09e8a1 [diff]
Have the no-srcs android_library in android.bzl use exports= instead of deps= (#153)

* Add IntelliJ With Blaze and AndroidStudio With Blaze files to gitignore.

* Make the no-srcs android_library use `exports=` instead of the now-deprecated (for this use-case anyway) `deps=`
2 files changed
tree: 324576c3d72ecd6f783f400b16620cabd611a0b9
  1. .bazelci/
  2. docs/
  3. examples/
  4. kotlin/
  5. scripts/
  6. src/
  7. third_party/
  8. .bazelproject
  9. .bazelrc
  10. .gitignore
  11. AUTHORS
  12. BUILD
  13. CODEOWNERS
  14. CONTRIBUTING.md
  15. CONTRIBUTORS
  16. LICENSE
  17. Makefile
  18. README.md
  19. WORKSPACE
README.md

Build status

Skydoc documentation

Announcements

  • February 20, 2019. Future directions of rules_kotlin.
  • August 14, 2018. Js support. No documentation yet but see the nested example workspace examples/node.
  • August 14, 2018. Android support. No documentation but it's a simple integration. see kotlin/internal/jvm/android.bzl.
  • Jun 29, 2018. The commits from this date forward are compatible with bazel >=0.14. JDK9 host issues were fixed as well some other deprecations. I recommend skipping 0.15.0 if you are on a Mac.
  • May 25, 2018. Test “friend” support. A single friend dep can be provided to kt_jvm_test which allows the test to access internal members of the module under test.
  • February 15, 2018. Toolchains for the JVM rules. Currently this allow tweaking:
    • The JVM target (bytecode level).
    • API and Language levels.
    • Coroutines, enabled by default.
  • February 9, 2018. Annotation processing.
  • February 5, 2018. JVM rule name change: the prefix has changed from kotlin_ to kt_jvm_.

Overview

These rules were initially forked from pubref/rules_kotlin. Key changes:

  • Replace the macros with three basic rules. kt_jvm_binary, kt_jvm_library and kt_jvm_test.
  • Use a single dep attribute instead of java_dep and dep.
  • Add support for the following standard java rules attributes:
    • data
    • resource_jars
    • runtime_deps
    • resources
    • resources_strip_prefix
    • exports
  • Persistent worker support.
  • Mixed-Mode compilation (compile Java and Kotlin in one pass).

Quick Guide

This section just contains a quick overview. Consult the generated documentation. Note: Skydoc documentation is no longer being generated. Comprehensive documentation will have to wait till the new documentation generation tool is ready. A contribution to port the documentation to the RST format like rules_go has would be very welcome !

WORKSPACE

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 = "67f4a6050584730ebae7f8a40435a209f8e0b48e"

http_archive(
    name = "io_bazel_rules_kotlin",
    urls = ["https://github.com/bazelbuild/rules_kotlin/archive/%s.zip" % rules_kotlin_version],
    type = "zip",
    strip_prefix = "rules_kotlin-%s" % rules_kotlin_version
)

load("@io_bazel_rules_kotlin//kotlin:kotlin.bzl", "kotlin_repositories", "kt_register_toolchains")
kotlin_repositories()
kt_register_toolchains()

BUILD files

In your project's BUILD files, load the kotlin rules and use them like so:

load("@io_bazel_rules_kotlin//kotlin:kotlin.bzl", "kt_jvm_library")

kt_jvm_library(
    name = "package_name",
    srcs = glob(["*.kt"]),
    deps = [
        "//path/to/dependency",
    ],
)

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.