Akka requires that you have Java 1.6 or later installed on you machine.
The best way to start learning Akka is to download the Typesafe Stack and either try out the Akka Getting Started Tutorials or check out one of Akka Template Projects. Both comes in several flavours depending on your development environment preferences.
There are several ways to download Akka. You can download it as part of the Typesafe Stack (as described above). You can download the full distribution with microkernel, which includes all modules. Or you can use a build tool like Maven or SBT to download dependencies from the Akka Maven repository.
Akka is very modular and has many JARs for containing different features.
akka-actor-2.0.4-SNAPSHOT.jar
-- Standard Actors, Typed Actors and much moreakka-remote-2.0.4-SNAPSHOT.jar
-- Remote Actorsakka-slf4j-2.0.4-SNAPSHOT.jar
-- SLF4J Event Handler Listenerakka-testkit-2.0.4-SNAPSHOT.jar
-- Toolkit for testing Actorsakka-kernel-2.0.4-SNAPSHOT.jar
-- Akka microkernel for running a bare-bones mini application serverakka-<storage-system>-mailbox-2.0.4-SNAPSHOT.jar
-- Akka durable mailboxes
How to see the JARs dependencies of each Akka module is described in the dependencies
section. Worth noting is that akka-actor
has zero external dependencies (apart from the scala-library.jar
JAR).
Download the release you need from http://akka.io/downloads and unzip it.
The Akka nightly snapshots are published to http://akka.io/snapshots/ and are versioned with both SNAPSHOT
and timestamps. You can choose a timestamped version to work with and can decide when to update to a newer version. The Akka snapshots repository is also proxied through http://repo.typesafe.com/typesafe/snapshots/ which includes proxies for several other repositories that Akka modules depend on.
The Akka distribution includes the microkernel. To run the microkernel put your application jar in the deploy
directory and use the scripts in the bin
directory.
More information is available in the documentation of the microkernel (microkernel-java
, microkernel-scala
).
Akka can be used with build tools that support Maven repositories. The Akka Maven repository can be found at http://akka.io/realeses/ and Typesafe provides http://repo.typesafe.com/typesafe/releases/ that proxies several other repositories, including akka.io.
The simplest way to get started with Akka and Maven is to check out the Akka/Maven template project.
Summary of the essential parts for using Akka with Maven:
- Add this repository to your
pom.xml
:
<repository>
<id>typesafe</id>
<name>Typesafe Repository</name>
<url>http://repo.typesafe.com/typesafe/releases/</url>
</repository>
- Add the Akka dependencies. For example, here is the dependency for Akka Actor 2.0.4-SNAPSHOT:
<dependency>
<groupId>com.typesafe.akka</groupId>
<artifactId>akka-actor</artifactId>
<version>2.0.4-SNAPSHOT</version>
</dependency>
Note: for snapshot versions both SNAPSHOT
and timestamped versions are published.
The simplest way to get started with Akka and SBT is to check out the Akka/SBT template project.
Summary of the essential parts for using Akka with SBT:
SBT installation instructions on https://github.com/harrah/xsbt/wiki/Setup
build.sbt
file:
name := "My Project"
version := "1.0"
scalaVersion := "2.9.1"
resolvers += "Typesafe Repository" at "http://repo.typesafe.com/typesafe/releases/"
libraryDependencies += "com.typesafe.akka" % "akka-actor" % "2.0.4-SNAPSHOT"
Setup SBT project and then use sbteclipse to generate Eclipse project.
Setup SBT project and then use sbt-idea to generate IntelliJ IDEA project.
Akka uses Git and is hosted at Github.
- Akka: clone the Akka repository from http://github.com/akka/akka
Continue reading the page on building-akka
If you have questions you can get help on the Akka Mailing List.
You can also ask for commercial support.
Thanks for being a part of the Akka community.