diff --git a/getting-started.html b/getting-started.html index 225c0afc..3cc521c8 100644 --- a/getting-started.html +++ b/getting-started.html @@ -11,17 +11,20 @@ base_url: "../"

This page will help you to get started with EWF. We will first see how to install EWF and then how to compile and run the venerable Hello World example.

Installation

-

EiffelStudio 7.2

-

EWF is already included in EiffelStudio 7.2: you don't have to do anything in this case! - This is the recommanded solution if you are a new developer or are new to Eiffel.

-

Other EiffelStudio versions

-

If you have another version of EiffelStudio than 7.2, you have to

+

Download

+

Follow these steps to download and install EWF on your computer:

    -
  1. dowload EWF
    2. -
  2. create a directory where you will put your custum Eiffel libraries
    3. -
  3. extract EWF in the newly created directory
    4. -
  4. define the environment variable EIFFEL_LIBRARY to point to the newly created directory
    5. +
  5. Dowload the archive
    6. +
  6. Create a directory where you will put your custom Eiffel libraries
    7. +
  7. Extract EWF in the newly created directory
    8. +
  8. Define the environment variable EIFFEL_LIBRARY to point to the newly created directory
+

EiffelStudio

+

EWF version 0.2 is included in EiffelStudio 7.2 and version 0.3 is included in EiffelStudio 7.3. + We recommand to use the latest EWF version (0.3 as of this writing) even if you are using EiffelStudio 7.2.

+
+ Note: The version that comes with EiffelStudio 7.3 does not include the examples. +

Source code

The source code is available on Github. You can get it by running the command:

@@ -30,34 +33,7 @@ base_url: "../"

The hello world example is located in the directory $ISE_EIFFEL/contrib/examples/web/ewf/simple. Just double click on the simple.ecf file and select the simple target or if you prefer the command line, run the command:

estudio -config simple.ecf -target simple
-

Once the project is compiled, we will adapt the root class to point to port number 9090.

-
- Note: By default, the application listens on port 80, which is often already used by standard webservers (Apache, nginx, ...). - Moreover, on Linux, ports below 1024 can only be opened by root. -
-

To do this, we will redefine the feature initialize as follows:

- 
-class
-	APPLICATION
-
-inherit
-	WSF_DEFAULT_SERVICE
-		redefine
-			initialize
-		end
-
-create
-	make_and_launch
-
-feature {NONE} -- Initialization
-
-	initialize
-			-- Initialize current service
-		do
-			set_service_option ("port", 9090)
-		end
-
-

After one more compile, you can now launch the application and point your browser to http://localhost:9090. +

Once the project is compiled, you can launch the application and point your browser to http://localhost:9090. You should now see a simple page with Hello World.