setup local development system

• if you plan to install the html5/php target, it is much better to use a 64 bit OS since mongodb is severely restricted with 32 bit.

• check out genapp source code and a test instance

  cd ~
  svn co svn://svn.genapp.rocks/svn/base/genapp genapp
  svn co svn://svn.genapp.rocks/svn/base/genapptest YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC
  

• set your environment
  • bash

     export GENAPP=$HOME/genapp
     export PATH=$GENAPP/bin:$PATH
    

    • this could be put into a .bashrc fle
  • csh/tcsh

     setenv GENAPP $HOME/genapp
     setenv PATH $GENAPP/bin:$PATH
    

• what follows is all in YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC subdirectory

• copy directives.json.template to directives.json and edit
• for html5 target language: copy appconfig.json.template to appconfig.json and edit

• the test layout
  • in bin/ are module executables (demo ones are currently in PERL, but they can be any command line program)
  • in modules/ are the module definition JSON files

• running the tool

    genapp
  

• this will generate the code into subdirectories under output/
  • each target language will have its own subdirectory (e.g. output/html5, output/qt3 etc)

• language specific notes
  • html5:
    • you will need to have a LAMPS stack installed - follow this carefully! and this directory becomes the webroot
    • you will also need ​imagemagick installed
    • it should be available immediately if the web server is correctly setup
    • the web browser client may need to clear their cache
      • there are plugins for single button cache clearing for most browsers which is useful during development

• qt3,4,5
  • it must be managed carefully to keep multiple versions of qt, so most users will pick one, but all three can co-exist if you make sure you have appropriate environments setup for compiling
    • for example, on our test box gw106.iu.xsede.org
      • to setup qt3 environment:

           . /etc/qt/3
        

      • to use qt4 environment, you must use qmake-qt4 instead of qmake
      • to run the qt applications, you must export the DISPLAY to an appropriate X11 host (either explicitly or via ssh X11 forwarding)
  • note you will also need the qwt toolkit installed and configured to work with qt
  • after generating code, from relevant qt subdirectory (and with correct environment), you will find a directory YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC, change to it

       qmake -project
       qmake
       make
    

• this should generate the executable
  • if you get errors, it may be that you don't have the right version of qt or qwt set properly in your environment
• to run

     cd ..
     YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC/YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC
  

• java
  • you will need a JDK Java 8 installed
  • after running genapp.pl, from the output/java directory, you should be able to run ./run_YOUR_APPLICATION_NAME