2、起步

2. 起步

2.1. 一分钟版本

从 Activiti website下载Activiti UI WAR后，以下几个步骤演示了默认设置的安装。你需要安装Java 运行时与 Apache Tomcat (实际上，任何Web容器都可以运行，因为我只用到了 servlet。但我们主要在 Tomcat 上测试).

• 将下载好的activiti-app.war 自制到Tomcat的 webapps目录

• 运行Tomcat的bin目录下 startup.bat或 startup.sh启动 Tomcat

• Tomcat启动好后，打开浏览器输入 http://localhost:8080/activiti-app.使用 admin 和密码test 登录.

就这么简单! Activiti 界面程序默认使用内存内数据库 H2 , 如果你想配置成其它数据库请阅读 the longer version.

2.2. Activiti 安装

安装Activiti前你先安装 Java runtime 和Apache Tomcat. 同样确保系统变量 JAVA_HOME 正确设置，设置方法取决操作系统。

让 Activiti UI 和 REST web 应用跑起来，只要将从下载页面当下来的 WAR 文件放到Tomcat安装目录下的webapps文件夹里。缺省状态下 UI 用的是内存内数据库。.

演示筒：

UserId	Password	Security roles
admin	test	admin

现在就可以访问应用程序了：

Webapp Name	URL	Description
Activiti UI	http://localhost:8080/activiti-app	流程引擎控制台. 用这个工具启动新的流程，分配、查看、申明任务等

注意 Activiti UI  app 演示安装尽可能简单、快速地展示Actiti功能。 不是说只有这种方式运用Activit。因为 Activiti 只是个jar包, 所以可以嵌入到任意 Java 运行环境: swing 、 Tomcat, JBoss, WebSphere, 等等. Or you could very well choose to run Activiti as a typical, 在典型的独立BPM 服务上运行Activi也是非常好的选择。有Java就有Activiti!

2.3. Activiti 数据库安装

Activiti UI 默认使用内存内的in-memory H2 数据. 要使用其它数据，需要修改WEB-INF/classes/META-INF/activiti-app下的activiti-app.properties文件。

2.4. 包含 Activiti jar 及其依赖

我们建议 Maven (or Ivy)管理Ativiti依赖包，因为这东西比较省事。这个链接 http://www.activiti.org/community.html#maven.repository 介绍了导入相关的包的内容。

你不想用 Maven 的话，可以自行加入相关的包。Activiti 下载包里包含一个 libs 的文件夹，里边包含了所有的 Activiti jar包(还有源码jar包). 这种方式不会推导出依赖项。必要的依赖如下 (用mvn dependency:tree生成的):

org.activiti:activiti-engine:jar:6.x
+- org.activiti:activiti-bpmn-converter:jar:6.x:compile
|  \- org.activiti:activiti-bpmn-model:jar:6.x:compile
|     +- com.fasterxml.jackson.core:jackson-core:jar:2.2.3:compile
|     \- com.fasterxml.jackson.core:jackson-databind:jar:2.2.3:compile
|        \- com.fasterxml.jackson.core:jackson-annotations:jar:2.2.3:compile
+- org.activiti:activiti-process-validation:jar:6.x:compile
+- org.activiti:activiti-image-generator:jar:6.x:compile
+- org.apache.commons:commons-email:jar:1.2:compile
|  +- javax.mail:mail:jar:1.4.1:compile
|  \- javax.activation:activation:jar:1.1:compile
+- org.apache.commons:commons-lang3:jar:3.3.2:compile
+- org.mybatis:mybatis:jar:3.3.0:compile
+- org.springframework:spring-beans:jar:4.1.6.RELEASE:compile
|  \- org.springframework:spring-core:jar:4.1.6.RELEASE:compile
+- joda-time:joda-time:jar:2.6:compile
+- org.slf4j:slf4j-api:jar:1.7.6:compile
+- org.slf4j:jcl-over-slf4j:jar:1.7.6:compile

注意mail.jar只在 mail service task.中用到。

 Activiti source code模块上，使用 mvn dependency:copy-dependencies 可以很容易的下载所有的依赖。

2.5. 后续步骤

使用 Activiti UI 的各项操作是一个不错的方法用来理解 Activiti 的概念和功能.不过Activiti的主要目的是在你的应用中启用强大的BPM 和workflow 。接下来的章节，帮助你熟悉Activiti编程。

• The chapter on configuration 教你如何配置 Activiti 以及如何获取ProcessEngine 类的实例，这是引擎所有功能中的中心访问点。 *The API chapter 指引你在服务中使用 Activiti’s API. *要是兴趣了解 BPMN 2.0这种流程格式在Activiti engine上的编写? 那就跳到 BPMN 2.0 section.