Building the DemoApp Project

The DemoApp project's "src" directory is the project's input directory. All of the project's files (resources, programs, etc) will be added to and modified in this directory.

The DemoApp project's output directory is called "compiled". When a resource is built the ProvideX builder scans it and compiles or copies it from the input directory to the output directory.

Note: You should never directly edit files in the output directory because the builder will delete these files and discard any changes you make without warning. All of your work is done in the input directory and the builder will copy, create directories, move, etc., the resource in the output directory.

Modify / Add / Delete Resources

Create, modify, and delete resources to see impact in the output folder of the project.

  1. In the Project Explorer view, select the DemoApp project's output directory: DemoApp > compiled.

  2. Right click the compiled folder and from the context menu select Delete.  Click OK to confirm. The project now contains the source directory only.



  3. In the Project Explorer view, select DemoApp > src > prog > menuevnt.pvc.pvxsrc.

  4. Double click on menuevnt.pvc.pvxsrc to open the file in the ProvideX Editor

  5. Change the file in some way; e.g., add a comment to the end of the file

    ! A comment

  6. Save the file by typing Ctrl+S or select the File> Save menu item.

  7. The ProvideX builder will perform an incremental build and only the menuevnt.pvc file will be processed. The project's output directory was deleted in step 1 and 2 above so the ProvideX builder will create the output directory, any subdirectories required, and then the compiled menuevnt.pvc program.


  8. In the Navigator view, select the directory DemoApp/src/prog.

  9. Right click on the prog directory and from the context menu select New > Folder. The New Folder wizard dialogue will appear.

  10. Type "my_dir" in the Folder name field.


    Eclipse will create a new folder called "my_dir" in the DemoApp/src/prog directory and the ProvideX builder will create the directory DemoApp/compiled/prog/my_dir.


  11. Right click on the DemoApp/src/prog/menuevnt.pvc.pvxsrc file and from the context menu select Move...

  12. The Folder Selection dialogue will appear. Select the DemoApp/compiled/prog/my_dir directory.


    Eclipse will move the menuevnt.pvc.pvxsrc source file to the "my_dir" directory and do an incremental build.

  13. Perform a clean build to make sure the changes we've made to the input directory are reflected in the output directory. Select the menu item Project > Clean... to build the entire project.

  14. The Clean dialogue will appear; click Clean all projects so it is not checked.

  15. Select the DemoApp project and click OK to force every resource in the project to be built.

    Now that the project has been built, the output directory will contain every file found in the input directory, and the directory structure will match the input directory. The ASCII text files that contain ProvideX source code have been compiled into ProvideX Tokenized Program files. The project's data files, NOMADS libraries, and any other resources have been examined and then copied to the output directory.

Clean Up

In order to continue with this tutorial we must return the DemoApp project to its original state - we must move menuevnt.pvc.pvt back to DemoApp/src/prog and delete the DemoApp/src/prog/my_dir directory.

  1. Select the directory DemoApp/src/prog/my_dir.

  2. Right click the DemoApp/src/prog/my_dir folder and, from the context menu, select Delete. Click OK to confirm.

  3. Right click the DemoApp project and select Restore from local history...

  4. The Restore from Local History dialogue will appear. Select src/prog/menuevnt.pvc.pvxsrc item from the Check files to restore from local history list.

  5. Click the Restore button.

  6. Follow steps 13, 14, and 15 above to perform a clean build.

Next Section: Resources and ProvideX Source Code