入门

    入门指南和模板工程

    最好的学习Akka的方法是下载并且尝试一下其中的Akka模板工程。

    下载

    下载Akka有几种方法。你可以通过下载Typesafe平台来下载Akka（如前所述）。你可以下载包含微内核的完整发布包（包含所有的模块）。或者也可以使用构建工具如Maven或SBT从Akka Maven仓库下载依赖。

    模块

    Akka的模块化做得非常好，它为不同的功能提供了不同的Jar包。

    • akka-actor – 标准Actor, 类型Actor，IO Actor等。
    • 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还没有足够稳定到被认为已经固定了。你可以通过在我们的邮件组里进行反馈，来加速试验模块发布的进程。

    实际的jar包文件名会加上版本号，如akka-actor_2.10-2.3.6.jar（对其他模块也是类似）。

    查看Akka模块之间的jar依赖的详情在依赖这一节中。

    使用发布版

    从http://akka.io/downloads 下载发布包并解压.

    使用快照版

    Akka的每日快照发布在 http://repo.akka.io/snapshots/， 版本号中包含 SNAPSHOT 和时间戳. 你可以选择一个快照版，可以决定何时升级到一个新的版本。Akka快照仓库也可以在 找到，此处还包含Akka模块依赖的其它仓库。

    Akka发布包包含微内核。要运行微内核，将你应用的jar包放到 目录下并运行 bin 目录下的脚本即可。

    使用构建工具

    Akka可以与支持Maven仓库的构建工具一起使用。

    Maven仓库

    对Akka 2.1-M2 及以后的版本：

    Maven Central

    对以前的Akka 版本：

    通过Maven使用Akka

    通过Maven使用Akka最简单的入门是检出中的模板工程“Akka Main in Java”。

    由于Akka已经发布到Maven中心仓库了（自2.1-M2版本起），所以直接在POM文件中加入Akka依赖即可。例如。这是akka-actor的依赖：

    注意：对快照版本，SNAPSHOT和时间戳都在版本号中。

    通过SBT使用Akka

    通过SBT使用Akka最简单的入门是检出“Akka/SBT”模板工程。

    通过SBT使用Akka的要点:

    SBT安装指导

    注意：以上的libraryDependencies设置需要SBT 0.12.x或更高的版本。如果你使用更老版本的SBT，需要这样设置：

    Using Akka with Gradle

    需要 1.4 及以上的版本来使用 Scala 插件

    建好SBT项目并使用 来创建Eclipse项目。

    通过IntelliJ IDEA使用Akka

    建好SBT项目并使用 来创建IntelliJ IDEA 项目。

    通过NetBeans使用Akka

    建好SBT项目并使用 来创建NetBeans项目。

    你也应该使用nbscala提供的scala IDE支持

    不要使用scala编译器的-optimize选项

    警告

    Akka并没有在scala编译器的-optimize选项下编译和测试过。尝试过这种方式的用户发现了Akka的奇怪行为。

    从源码编译

    Akka使用Git并托管在 。

    具体请参考 。

    需要帮助?

    如果有问题，你可以在 获得帮助。

    感谢你成为Akka社区的一部分。