wiki:setup_dev_system

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

Last modified 4 months ago Last modified on Mar 14, 2018, 9:29:32 AM