For Developers
From Geoikia-english
Contents |
Subversion
Geoide is Open source software. The source code can be viewed and downloaded with subversion.
SVN
In order to use the Geoide repositories you have to install a SVN client application:
- TortoiseSVN. This is a normal Windows installer.
It may be convenient to make SVN accessible from Eclipse as well:
- Install the Subclipse plugin. Do this in the usual way for Eclipse plugins: Eclipse -> Help -> Install new Software and choose the three required parts Subclipse, Subversion Client Adapter and Subversion JavaHL Native Library Adapter.
In order to access the Geoide repositories you have to use (beside SVN) SSH as well. Users can access a repository using any SVN client that supports SVN over SSH. The following URL should be used: 'http://repos.idgis.eu/svn/geoide/[project name]'.
Tools
The following tools have to be installed for developing Geoide web applications:
Eclipse
The newest version.
Flex Builder
Use Flex Builder to develop the Geoide Author client application. This can be downloaded from the site of Adobe or used from \\rijn\Download\Adobe\Flex\FB3_win.exe.
Also install the Subclipse plugin.
In order to be able to execute the buildscript, you have to adjust the file "build.properties":
- Change the location of FLEX-HOME and the location of the mTask Compiler.
In the standard installation of Flex Builder all Locales are lacking in order to be able to compile. Therefore
- copy the directories "de_DE", "en_US" en "nl_NL" to %FLEX-HOME%\sdks\3.0.0\frameworks\locale.
Flash FDT
Use Flash FDT in Eclipse for developing the Geoide client.
Add the update site "http://fdt.powerflasher.com/update" toe aan eclipse. Pick only the `FDT Basic` option. After restart of eclipse, and after selectiong the Flash FDT perspective, you´ll be asked to enter the licence code.
Postgres en PostGIS
Beside Postgres you have to install PostGIS as well.
Note that the installation of PostGIS explicitly is meant for the Postgres version. This is because a certain 'version' of PostGIS will be compiled to an installation of a specific version of Postgres. For instance you may use version 1.3.5. of Postgis for version 8.1 and 8.2 of Postgres, however this will be two different installations. Vice versa you may use Postgres version 8.2 for different versions of PostGIS (e.g. 1.3.5 and 1.4.0), which will be two different distributions of PostGIS.
Filling Database with Test Data
Next steps show how an sql-dump from the database can be loaded into a new databe.
1. New database:
- 1.1 Start PgAdmin III
- 1.2 Create a new database. If the definitions of PostGis are also exported in the sql-dump, then don't choose a template. Owner "postgres". Encoding is UTF-8.
2. Fill the Database:
- 2.1 Open a command line.
- 2.2 Navigate to the directory with the sql-dump
- 2.3 Be sure that the Postgres\bin directory is in the path (for instance: C:\Program Files\PostgreSQL\8.2\bin)
- 2.4 Run:
psql -d databasenaam -U postgres -f naam_van_export_bestand.sql
Developing the Geoide Client
Use Eclipse for developing the Geoide client. For compilation within Eclipse mtasc is used and FDT for code-hinting.
Setup of development environment in Eclipse:
1. Create an Eclipse workspace for the Geoide client
2. Import the geoide-client trunk from the SVN: geoide-client
3. Create a Flash project
4. For compilation with ant:
- 4.1 Adjust the "build.properties" in the map "build". This contains a number of local settings for mtasc:
mtasc=C:\\Program Files\\mtasc-1.13\\mtasc.exe mx_path='C:\\classesForMtascCompiling'
- Note that a patched version of the mx classes is used for compilation with mtasc. See http://osflash.org/mx_v2_components_patch
- 4.2 Change the "Edit configuration and launch settings" of the build.xml:
- Check the button "Run in the same JRE as the workspace"
- Put all jars of the build_lib in the classpath
Application Template
> Download and Installation Geoide-Demo-Application
