You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@syncope.apache.org by il...@apache.org on 2016/12/30 14:46:06 UTC
svn commit: r1776579 - /syncope/site/building.html
Author: ilgrosso
Date: Fri Dec 30 14:46:06 2016
New Revision: 1776579
URL: http://svn.apache.org/viewvc?rev=1776579&view=rev
Log:
Publishing updated build instructions
Modified:
syncope/site/building.html
Modified: syncope/site/building.html
URL: http://svn.apache.org/viewvc/syncope/site/building.html?rev=1776579&r1=1776578&r2=1776579&view=diff
==============================================================================
--- syncope/site/building.html (original)
+++ syncope/site/building.html Fri Dec 30 14:46:06 2016
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Apache Syncope Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20161227" />
+ <meta name="Date-Revision-yyyymmdd" content="20161230" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Syncope – Building</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.5.min.css" />
@@ -261,6 +261,7 @@
<ul class="toc">
<li><a href="#Prerequisites">Prerequisites</a></li>
<li><a href="#Building_Syncope">Building Syncope</a></li>
+<li><a href="#Building_documentation">Building documentation</a></li>
<li><a href="#More_build_profiles">More build profiles</a>
<ul>
<li><a href="#fitcore-reference">fit/core-reference</a>
@@ -290,8 +291,7 @@
<li><a href="#JRebel">JRebel</a></li></ul></li>
<li><a href="#ideeclipsebundlesorg.apache.syncope.ide.eclipse.tests">ide/eclipse/bundles/org.apache.syncope.ide.eclipse.tests</a>
<ul>
-<li><a href="#Eclipse_IDE_Plugin">Eclipse IDE Plugin</a></li></ul></li></ul></li>
-<li><a href="#Building_documentation">Building documentation</a></li></ul>
+<li><a href="#Eclipse_IDE_Plugin">Eclipse IDE Plugin</a></li></ul></li></ul></li></ul>
</div>
@@ -319,36 +319,48 @@
<h2><a name="Building_Syncope"></a>Building Syncope</h2>
<p>
- Before building Syncope, you need to setup an environment variable to give Maven more memory.<br />
+ Before building Syncope, you need to setup an environment variable to give Maven more memory.
+ </p>
+
+<p>
On Unix
</p>
<div class="source"><pre class="prettyprint">export MAVEN_OPTS="-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m"</pre></div>
+
+
+<p>
On Windows
-
+ </p>
<div class="source"><pre class="prettyprint">set MAVEN_OPTS=-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m</pre></div>
<p>
- To build Syncope simply execute (from within the check-out directory):
+ To build Syncope simply execute (from within the top-level source directory):
</p>
-<div class="source"><pre class="prettyprint">$ mvn install</pre></div>
- or
-
<div class="source"><pre class="prettyprint">$ mvn clean install</pre></div>
- for subsequent runs.<br />
- To build Syncope without running any test do:
-
-<div class="source"><pre class="prettyprint">$ mvn -PskipTests</pre></div>
- <b>Important</b>: For subsequent builds (e.g., after code changes are made),
- run <tt>mvn clean</tt> first to build from scratch, before using one of the <tt>mvn install</tt>
- commands above.
- (You may also wish to run <tt>git pull</tt> after running <tt>mvn clean</tt> but before running
- <tt>mvn install</tt>.)
+
+
+<p>
+ To build Syncope without running any test nor check do:
+ </p>
+<div class="source"><pre class="prettyprint">$ mvn -PskipTests,all</pre></div>
</div>
<div class="section">
+<h2><a name="Building_documentation"></a>Building documentation</h2>
+
+<p>
+ To build Syncope documentation execute (from within the top-level source directory):
+ </p>
+<div class="source"><pre class="prettyprint">$ mvn -N -P site clean generate-resources</pre></div>
+ The documentation artifacts are now be available under <tt>target/generated-docs/</tt>.
+
+ </div>
+
+
+<div class="section">
<h2><a name="More_build_profiles"></a>More build profiles</h2>
<p>
@@ -381,6 +393,15 @@
<div class="source"><pre class="prettyprint">$ mvn -Pdebug</pre></div>
+
+<p>
+ Once started in debug mode, individual test methods can be executed as follows (the
+ <a class="externalLink" href="https://maven.apache.org/surefire/maven-surefire-plugin/examples/single-test.html">
+ Maven Surefire Plugins rules</a> apply here):
+ </p>
+<div class="source"><pre class="prettyprint">$ mvn test -Dtest=UserITCase#list</pre></div>
+
+
</div>
<div class="section">
<h4><a name="JRebel"></a>JRebel</h4>
@@ -503,6 +524,15 @@ $ mvn -Pjrebel</pre></div>
<div class="source"><pre class="prettyprint">$ mvn -Pdebug</pre></div>
+
+<p>
+ Once started in debug mode, the test cases can be executed as follows:
+ </p>
+<div class="source"><pre class="prettyprint">$ cd target/enduser-test
+$ nodejs/node/node nodejs/bin/protractor protractor-conf.js</pre></div>
+ where the actual tests to be run can be selected by modifying the <tt>protractor-conf.js</tt> content.
+
+
</div>
<div class="section">
<h4><a name="JRebel"></a>JRebel</h4>
@@ -525,18 +555,6 @@ $ mvn -Pjrebel</pre></div>
<div class="source"><pre class="prettyprint">$ mvn -Peclipse-it</pre></div>
</div></div>
</div>
-
-
-<div class="section">
-<h2><a name="Building_documentation"></a>Building documentation</h2>
-
-<p>
- To build Syncope documentation execute (from within the check-out directory):
- </p>
-<div class="source"><pre class="prettyprint">$ mvn -N -P site clean generate-resources</pre></div>
- The documentation artifacts are now be available under <tt>target/generated-docs/</tt>.
-
- </div>
</div>
@@ -561,6 +579,9 @@ $ mvn -Pjrebel</pre></div>
<a href="https://travis-ci.org/apache/syncope">
<img src="https://api.travis-ci.org/apache/syncope.png" style="vertical-align: top"/>
</a>
+ <a href="https://ci.appveyor.com/project/ApacheSoftwareFoundation/syncope">
+ <img src="https://ci.appveyor.com/api/projects/status/k3moao48iilrq2pw?svg=true" style="vertical-align: top"/>
+ </a>
</div>
</div>