Seth Tisue edited this page Nov 30, 2016 · 42 revisions
Clone this wiki locally

What is this? Why?

see the README

Who maintains this?

Primarily the Scala team at Lightbend, with help from:

  • the maintainers of the included libraries (you?)
  • the dbuild maintainers and others at Lightbend and EPFL

See the repo commit log to see who specifically has been most active recently.

Where does this run?

A community build is typically run as part of Scala's CI infrastructure, as documented in the scala-jenkins-infra README.

The community builds are (as of October 2016) now included in our nightly-build jobs on Jenkins.

Build results are viewable on scala-ci.typesafe.com. (For example, see the 2.12.x results.)

Sometimes we manually trigger runs in order to test a pull request in the scala/scala repo.

Can I run it locally?

Sure, just clone the repo and ./run.sh.

For more details, see Local runs.

What variations of the build exist?

There are currently four:

Scala version JDK version branch name Jenkins job
2.11.x 6 2.11.x link
2.11.x 8 2.11.x-jdk8 link
2.12.x 8 2.12.x link
2.13.x 8 2.13.x link

We also have branches where all projects are frozen at fixed SHAs. These were the SHAs used to test Scala before a release, so the branch names correspond to Scala version numbers (2.12.0, 2.12.1, etc).

Further details on these variations is here.

Is my project eligible?

See Eligibility.

Is Scala.js supported?

Sorry, not yet. We do build Scala.js itself and run its tests, but we cannot (yet?) build Scala.js-based projects.

Of course, many projects support both JVM Scala and Scala.js. That's not a problem for the community build; we just disable the Scala.js portion.

How do I add my project?

On the 2.12.x branch, edit community.build and project-refs.conf and submit a PR with the change. (The PR doesn't necessarily need to be fully baked; it can be a starting point for conversation and collaboration.)

The dbuild documentation might help.

See also Maintenance for a great deal of relevant practical advice.

How do I help maintain the community build?

See Maintenance.

Where I can talk to someone about this?

Good starting places for new folks to ask general questions about this include:

Detailed technical discussion can happen on https://gitter.im/scala/community-builds.

And of course, we can also talk using issues and pull requests in this repo.