PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Overview
  • Direct use of the external component
  • Definition
  • Caution
  • Simple distribution of an external component
  • Definition
  • To distribute an external component, you must provide:
  • Distribution via a setup procedure
  • Definition
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
Once the external component was created, checked and generated, it can be made available to the developers. Several methods are available:
  • Direct use of the external component
    Example: the external component is directly used on the computer of the developer who created the component.
  • Simple distribution, by providing the necessary files.
    Example: the external component is intended to be used within the same company by several developers. In this case, the necessary files can be copied onto a network drive.
  • Distribution via the SCM: This distribution mode allows the projects found in the SCM to directly use a component published in the SCM. See SCM and components for more details.
    Example: A company shares several projects via the SCM. The projects used to create the external components and the projects that use the components share the same SCM.
  • Distribution via a setup program (with a setup procedure of the component similar to the one used for the applications).
    Example: This distribution mode is recommended if the external component is intended to be sold or distributed on a large scale, with regular updates.
Direct use of the external component

Definition

The external component is created and used on the same computer.
When importing the external component into a project, all you have to do is select the WDI file corresponding to the component. This file is found in the EXE directory of the component project. The generation directory corresponds to the directory associated with the project configuration whose type is external component.

Caution

The files referenced in the <ComponentName>.WDO file will be automatically copied into the EXE directory of the project that uses the component.
If the external component uses specific files (data files, text files, etc.), a <ComponentName>.WDO file must be created (or completed) once the component is generated. This file contains the list of external files (data files, text files, ...) used by the component. See WDO file for more details.
Simple distribution of an external component

Definition

The simple distribution of an external component consists in providing by simple copy the files required for the component to operate. The files are copied into a specific directory. This directory can be found on a network server for example.
When the external component is imported into a project, all you have to do is select the WDI file corresponding to the component in the distribution directory.

To distribute an external component, you must provide:

  • The files automatically generated by WINDEV, WEBDEV or WINDEV Mobile (<ComponentName>.WDK and <ComponentName>.WDI)
  • If necessary, the specific files handled by the component (data files, initialization files, ...) as well as <ComponentName>.WDO. The <ComponentName>.WDO file contains the list of files that must be supplied with the component. See Distribution of advanced component: the WDO file for more details.
Distribution via a setup procedure

Definition

The distribution of external components via a setup procedure consists in supplying a setup program to the users of the external component. This program installs all the files required for using the external component in the directory specified by the user.
This setup mode is used to automatically manage:
  • the WDO file and the setup of specific files (data files, ...) used by the external component.
  • the setup of specific tools (MDAC, ODBC driver for HFSQL, ...).
  • the automatic update of the data files used by the external component (if necessary).
  • the uninstall program of the external component.
To propose a setup procedure for an external component:
  1. Create the setup procedure of the external component:
    • directly via the "Workshop .. External Component .. Create the setup procedure of a component" option.
    • from the list of components generated from the project ("Workshop .. External component .. List of components generated from this project", "Setup" button).
    Create the setup procedure of the external component:
    • via the quick access buttons:
    • from the list of components generated from the project:
      • On the "Project" pane, in the "Project" group, expand "List of elements" and select "List of generated components".
      • Click the "Setup" button.
  2. In the wizard planes, specify:
    • the setup media of the external component.
    • the languages proposed in the setup procedure.
    • the default setup directory of component.
    • the optional modules to install. You have the ability to modify the list of files that will be distributed with the external component. The WDO file will be automatically created from this list.
    • ...
By default, the files required to install an external component are created in the INSTALL COMPO sub-directory of the project.
Reminder: When creating the setup program of an application, the necessary files are created in the INSTALL directory of the project.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment