入门
准备工作
Akka要求你安装了 Java 1.6或更高版本。
入门指南和模板工程
最好的学习Akka的方法是下载“Typesafe Activator”并且尝试一下其中的Akka模板工程。
下载
下载Akka有几种方法。你可以通过下载Typesafe平台来下载Akka（如前所述）。你可以下载包含微内核的完整发布包（包含所有的模块）。或者也可以使用构建工具如Maven或SBT从Akka Maven仓库下载依赖。
模块
Akka的模块化做得非常好，它为不同的功能提供了不同的Jar包。
- akka-actor – 标准Actor, 类型Actor，IO Actor等。
- akka-agent – Agent，与 Scala STM 集成
- akka-camel – Apache Camel 集成
- akka-cluster – 集群成员管理，弹性路由器。
- akka-kernel – Akka 微内核来运行简单应用服务器
- akka-osgi – 在OSGi容器中使用Akka的基本组件，包含akka-actor类
- akka-osgi-aries – Aries 的actor系统蓝图
- akka-remote.jar – 远程Actor
- akka-slf4j.jar – SLF4J日志(事件总线监听器)
- akka-testkit.jar – Actor系统的测试工具包
- akka-zeromq – ZeroMQ 集成
除了这些稳定的模块之外，还有一些虽然趋于稳定但仍然被标记为“实验”的模块。这并不是说他们的功能不符合预期，而主要的意思是他们的API还没有足够稳定到被认为已经固定了。你可以通过在我们的邮件组里进行反馈，来加速试验模块发布的进程。
- akka-contrib – 一系列的Akka贡献，他们有可能被加入核心模块中，详情见外部贡献。
实际的jar包文件名会加上版本号，如akka-actor_2.10-2.3.6.jar（对其他模块也是类似）。
查看Akka模块之间的jar依赖的详情在依赖这一节中。
使用发布版
从http://akka.io/downloads 下载发布包并解压.
使用快照版
Akka的每日快照发布在 http://repo.akka.io/snapshots/， 版本号中包含 SNAPSHOT 和时间戳. 你可以选择一个快照版，可以决定何时升级到一个新的版本。Akka快照仓库也可以在 http://repo.typesafe.com/typesafe/snapshots/ 找到，此处还包含Akka模块依赖的其它仓库。
警告
不鼓励直接使用Akka快照版（SNAPSHOT）、每日构建版（nightly）和里程碑版（milestone），除非你知道自己在做什么。
微内核
Akka发布包包含微内核。要运行微内核，将你应用的jar包放到 deploy 目录下并运行 bin 目录下的脚本即可。
关于微内核的更多文档在 微内核(Scala) / 微内核(Java)。
使用构建工具
Akka可以与支持Maven仓库的构建工具一起使用。
Maven仓库
对Akka 2.1-M2 及以后的版本：
对以前的Akka 版本：
通过Maven使用Akka
通过Maven使用Akka最简单的入门是检出“Typesafe Activator”中的模板工程“Akka Main in Java”。
由于Akka已经发布到Maven中心仓库了（自2.1-M2版本起），所以直接在POM文件中加入Akka依赖即可。例如。这是akka-actor的依赖：
<dependency>
<groupId>com.typesafe.akka</groupId>
<artifactId>akka-actor_2.10</artifactId>
<version>2.3.6</version>
</dependency>
注意：对快照版本，SNAPSHOT和时间戳都在版本号中。
通过SBT使用Akka
通过SBT使用Akka最简单的入门是检出“Akka/SBT”模板工程。
通过SBT使用Akka的要点:
SBT安装指导 https://github.com/harrah/xsbt/wiki/Setup
build.sbt 文件:
name := "My Project"
version := "1.0"
scalaVersion := "2.10.4"
resolvers += "Typesafe Repository" at "http://repo.typesafe.com/typesafe/releases/"
libraryDependencies +=
"com.typesafe.akka" %% "akka-actor" % "2.3.6"
注意：以上的libraryDependencies设置需要SBT 0.12.x或更高的版本。如果你使用更老版本的SBT，libraryDependencies需要这样设置：
libraryDependencies +=
"com.typesafe.akka" % "akka-actor_2.10" % "2.3.6"
Using Akka with Gradle
需要 Gradle 1.4 及以上的版本来使用 Scala 插件
apply plugin: 'scala'
repositories {
mavenCentral()
}
dependencies {
compile 'org.scala-lang:scala-library:2.10.4'
}
tasks.withType(ScalaCompile) {
scalaCompileOptions.useAnt = false
}
dependencies {
compile group: 'com.typesafe.akka', name: 'akka-actor_2.10', version: '2.3.6'
compile group: 'org.scala-lang', name: 'scala-library', version: '2.10.4'
}
通过Eclipse使用Akka
建好SBT项目并使用 sbteclipse 来创建Eclipse项目。
通过IntelliJ IDEA使用Akka
建好SBT项目并使用 sbt-idea 来创建IntelliJ IDEA 项目。
通过NetBeans使用Akka
建好SBT项目并使用 nbsbt 来创建NetBeans项目。
你也应该使用nbscala提供的scala IDE支持
不要使用scala编译器的-optimize选项
警告
Akka并没有在scala编译器的
-optimize选项下编译和测试过。尝试过这种方式的用户发现了Akka的奇怪行为。
从源码编译
Akka使用Git并托管在 Github。
- Akka: 从 http://github.com/akka/akka 克隆 Akka 的资源库
具体请参考 构建Akka。
需要帮助?
如果有问题，你可以在 Akka Mailing List 获得帮助。
也可以寻求 商业支持。
感谢你成为Akka社区的一部分。