This content may then be generated and deployed as Web Apps, Hybrid Apps or Native Apps. The complete Visual Studio and/or VS-Xamarin projects enable onward development in a native environment using all the power and versatility of Visual Studio (and VS-Xamarin) as required. In doing so, the developer is given the best of both worlds - quick and easy application construction along with unrestricted enhancement and customization capabilities.
The Generator Profile allows you to select from different profiles that define which database which respoitory objects (files) are associated with. You can add as many generator profiles as you need to define different options for your app.
New Evoke apps have a default generator profile provided for you as standard (or a starting point), this is called Profile1 and the name can be changed or more profiles added if you wish to map other databases to Entities or files in Evoke.
You can generate your App Design into a Visual Studio project simply by clicking the big green "Start Code Generation" button, but first you must ensure you have set up the Visual Studio settings and the Entity mappings.
In the Code Generation section you are able to select the .NET environment for the app that you are generating:
.Net Classic - allows the resultant web app can be hosted in a Windows enviroment.
.Net Core - allows the resultant web app can be hosted in a Linux enviroment.
As part of this process Evoke creates a backup copy of the entire Visual Studio solution before beginning to overwrite any files, this is so that if the generation fails to complete for any reason then the Visual Studio solution is reverted back to the state it was in prior to the generation starting and the backup copy removed.
There are several reasons that you may not want this backup copy taken such as a) disk space restrictions b) not having full read/write/delete permissions on that file folder in Windows Explorer, etc. in this case you can select the "Supress backup" option before a code generation and the backup copy will not be take. Consequently, if the generation fails for any reason then the Visual Studio solution will not be restored to its previous state.
Before generating a Web App, you will need to set the Visual Studio settings in Evoke. Default values are provided, however, you can set:
Root NameSpace - the name that you wish to give your Visual Studio solution
Target Folder - the location, on your computer, where the actual folders containing the Visual Studio solution and projects will be created/stored. Web and repository Folders will be created in this location.
Clear Target Folder - Evoke preserves any customisation that you have added to Visual Studio each time you generate the App. However, there may be times that you wish to clear all customisation automatically when you generate the app.
launch VS on Completion - Evoke can automatically open and load up the App project in Visual Studio so that no Visual Studio actions (other than the build) are required.
Generate Repository CRUD
Repository CRUD (Create, Read, Update, Delete) code is only required to be generated for MultiValue Datbases. If you are using a SQL database that this selection can be ignored.
One of the main purposes of the generated .NET code is to invoke the relevant DataBASIC subroutines residing on your MultiValue database server. The specific server-side routine that is called and the data that is passed to it depends entirely upon the type of repository related action that has occurred within the UI. The app generator can create the initial content of these server-side routines (known as CRUD routines - Create, Read, Update and Delete) and you are then able to add your own code as necessary in order to implement the required database file access logic. The app generator, when instructed, will install the CRUD routines into a file called EVOKE.CRUD.BP, please also review the instructions for creating this program file. The naming and content of these CRUD routines is based on the data entities created within the app designer. Each data entity will be represented by 2 routines called EV.CRUD.xxx and EV.CRUD.xxx.CUSTOM, where xxx represents the name of the data entity. The EV.CRUD.xxx routine is "owned" by the app generator, that is, you should not amend its content. Conversely, the EV.CRUD.xxx.CUSTOM routine (referred to hereafter as the "custom CRUD routine" is "owned" by you, and will only be modified by the generator once - i.e. when it is first created by the generator. The structure of each custom CRUD routine is covered in the following section.
The generated DataBASIC CRUD routine
A simple example of customising the Evoke generated CRUD code is provided here however, the BlueFinity support team will be happy to assist further.
Generate App In the Web App section of Evoke you can click the "Start Code Generation" and Evoke will validate your entire App project, displaying both warnings and hard errors that it finds, and then generate an entire Visual Studio Solution.
Visual StudioWhen generating your app you have created two folders (Repository and Web) on your local computer at the path entered in the "target folder" in your visual studio setting section.
Open Visual Studio and selection the open solution option (or if you have selected "launch VS on completion" in the Visual Studio settings section then it will have automatically opened Visual Studio and your Evove App solution).