Sources

From APIDesign

(Difference between revisions)
Jump to: navigation, search
(13 intermediate revisions not shown.)
Line 1: Line 1:
-
== Environment ==
+
The [[TheAPIBook|Practical API Design]] book comes with huge amount of additional [[sources]]. All of them, including their history, are available online. This page provides basic information for those who want to study them.
-
In order to use the sample sources you need:
+
=== Environment ===
-
* JDK 1.6.0 - necessary for compilation and execution
+
-
* Ant 1.7.0 - allows simple compilation and execution from command line
+
-
* NetBeans IDE 6.0 - all projects are configured to smoothly open in NetBeans IDE
+
-
== Download ==
+
In order to use the sample sources you may need:
 +
* [[JDK]] 1.6.0 - necessary for compilation and execution
 +
* [[Ant]] 1.8.1 - allows simple compilation and execution from command line
 +
* [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE
-
Download the sources [http://www.apidesign.org/sources/apidesign-111.zip apidesign-111.zip], unzip them on your local computer. Start NetBeans IDE and open individual projects as needed.
+
=== Download ===
-
== Review feedback ==
+
The sources for sample examples are processed, verified and published daily on API Design [http://hudson.apidesign.org/job/samples continuous build server]. Download the latest version of apidesign-XYZ.zip, unzip it on your local computer. Start [[NetBeans]] IDE and open individual projects as needed. History of all the modifications can be found in our [[Mercurial]] [http://source.apidesign.org/hg/apidesign/ repository]. To obtain them use:
-
Would be good to have a README file telling the user to run <tt>build.xml</tt> before opening the projects in the IDE. Otherwise the projects have unsolvable broken references.
+
<source lang="bash">
 +
hg clone http://source.apidesign.org/hg/apidesign/
 +
</source>
-
The README file should also list all example directories with a one-line description for each directory. Similarly, there should be a README file in each directory describing that example (in a bit more detail than one line).
+
=== Usage ===
-
The build fails on JDK 1.5 because of <tt>ServiceLoader</tt> usages. This needs to be mentioned somewhere, and <tt>build.xml</tt> should perhaps skip that example when building on 1.5.
+
You need to run <tt>build.xml</tt> before opening the projects in the IDE. Otherwise the projects have unsolvable broken references.
-
--[[User:AndreiBadea|AndreiBadea]] 07:35, 15 April 2008 (UTC)
+
The build fails on JDK 1.5 because of <tt>ServiceLoader</tt> usages. This needs to be mentioned somewhere, and <tt>build.xml</tt> should perhaps skip that example when building on 1.5.

Revision as of 22:59, 16 July 2010

The Practical API Design book comes with huge amount of additional sources. All of them, including their history, are available online. This page provides basic information for those who want to study them.

Environment

In order to use the sample sources you may need:

  • JDK 1.6.0 - necessary for compilation and execution
  • Ant 1.8.1 - allows simple compilation and execution from command line
  • NetBeans IDE 6.9 - all projects are configured to smoothly open in NetBeans IDE

Download

The sources for sample examples are processed, verified and published daily on API Design continuous build server. Download the latest version of apidesign-XYZ.zip, unzip it on your local computer. Start NetBeans IDE and open individual projects as needed. History of all the modifications can be found in our Mercurial repository. To obtain them use:

hg clone http://source.apidesign.org/hg/apidesign/

Usage

You need to run build.xml before opening the projects in the IDE. Otherwise the projects have unsolvable broken references.

The build fails on JDK 1.5 because of ServiceLoader usages. This needs to be mentioned somewhere, and build.xml should perhaps skip that example when building on 1.5.

Personal tools
buy